Configure Asaas payments on Nuvemshop

After installing the Asaas module, adjust the rules that will be applied to the payments displayed in the Nuvemshop checkout.

In this step, you can review installments, interest, discounts, bank slip due date, and Pix expiration.

Before you start

Confirm that:

• the Asaas module is installed and active;
• the store is connected to the correct Asaas account;
• a valid Production API Key is configured;
• Asaas is available among the store's payment methods.

If you have not yet completed the installation, see Installing the module.

Access the settings

In the Nuvemshop admin panel:

1. Go to Settings > Payment Methods.
2. Locate Asaas.
3. Click Edit.

Changes made in this area will be applied to the store's next sales.

Review the payment rules

The module settings include:

For the accepted Pix expiration formats and the initial installment configuration, see Installing the module.

Minimum installment amount

Define the lowest amount allowed for each installment of a credit card purchase.

For example, for a purchase of R$ 60.00:

• a minimum amount of R$ 20.00 allows up to 3 installments;
• a higher minimum amount may reduce the number of installments available.

The final limit also depends on the maximum number of installments configured in the module.

Discounts by payment method

You can configure different discounts for:

• credit card;
• bank slip;
• Pix.

The discount is applied when the buyer selects the corresponding payment method at checkout.

Review the final amount shown to the customer whenever you change this setting.

Save and validate the changes

After completing the adjustments:

1. save the settings;
2. make a controlled test purchase;
3. select each changed payment method;
4. confirm the options displayed at checkout;
5. validate the final purchase amount;
6. for credit card, check the number of installments and the interest applied;
7. confirm that the order is updated after the payment changes.

Expected result

The checkout should display only the conditions configured for each payment method.

For credit card, the number of installments must respect the maximum limit and the minimum amount per installment. Discounts must be reflected in the amount shown to the buyer.

Common errors

Installments do not appear as expected

Check:

• the maximum number of installments;
• the minimum amount configured per installment;
• the total purchase amount.

The minimum amount may reduce the number of installments available at checkout.

Discount different from expected

Confirm the rule configured for the selected payment method and validate the final amount directly at checkout.

Order not updated after payment

Synchronization between Asaas and Nuvemshop happens automatically through Webhooks.

In case of temporary unavailability, the update may occur a few moments after the financial event.

See the Nuvemshop FAQ for other integration behaviors.

Next steps

• See the Nuvemshop FAQ
• Review the module installation
• See the integration overview