Integrate Asaas with Nuvemshop

Use the official Asaas integration to process payments in your Nuvemshop store by Pix, bank slip (boleto), and credit card, without building your own integration.

The module uses transparent checkout and keeps Nuvemshop orders automatically synchronized with payment changes in Asaas.

What the integration supports

Installments are available only for credit card.

Before installing

Confirm that:

• your Nuvemshop store is active;
• the store uses at least the Essencial plan;
• you have administrative access to the store;
• you have an Asaas Production account or will open one during the module installation.

How it works

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
A["Install the Asaas module"] --> B["Connect the Production account"]
B --> C["Configure the payment methods"]
C --> D["Make a test purchase"]
D --> E["Process the payment in Asaas"]
E --> F["Receive the update via Webhook"]
F --> G["Update the order in Nuvemshop"]

classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

class A inicio
class B,C,D,E,F validacao
class G sucesso

linkStyle default stroke:#94A3B8,stroke-width:2px

The communication required to synchronize orders is configured automatically during installation. You do not need to implement polling to track payment changes.

What can be configured

After installing the module, you can define rules such as:

• bank slip due date;
• Pix expiration period;
• maximum number of card installments;
• interest by number of installments;
• minimum amount per installment;
• discounts for Pix, bank slip, and credit card.

The detailed settings are in Initial settings.

Choose where to continue

Haven't installed the module yet?

Go to Installing the module.

This step connects the store to the Asaas Production account and lets you enter the API Key.

Already installed and want to adjust the checkout?

Go to Initial settings.

Configure installments, interest, discounts, bank slip due date, and Pix expiration.

Need to check limitations or specific behaviors?

See the FAQ - Nuvemshop.

Next steps

• Install the Asaas module
• Configure the payment methods
• See the Nuvemshop FAQ