NuvemShop

Nuvemshop is an e-commerce platform that allows you to create and manage online stores without requiring custom development.

Asaas has an official integration with Nuvemshop, acting as the store's payment gateway. With this integration, orders placed on the platform are processed by Asaas, allowing payments via Pix, bank slip, and credit card directly at checkout.

This section brings together the content required to install, configure, and operate the integration between Nuvemshop and Asaas.

When to use

This integration is recommended for stores that want to:

• use Asaas as the Nuvemshop payment gateway;
• accept payments via Pix, bank slip, and credit card;
• offer installment payments for credit card purchases;
• use a ready-made module without the need for custom development;
• centralize the financial processing of sales in the Asaas account.

How the integration works

After installing the Asaas module in Nuvemshop, customer orders start being processed through the Asaas account configured in the integration.

A typical journey follows the flow below:

Create an Asaas account
↓
Install the Asaas module in Nuvemshop
↓
Configure the API Key
↓
Define payment methods
↓
Publish the store
↓
Receive orders
↓
Process payments through Asaas
↓
Receive automatic notifications from the operation

Requirements

Before installing the module, it is necessary that:

• the store is active on Nuvemshop;
• the store plan is compatible with external payment methods;
• there is an active Asaas account;
• the Asaas account API Key is available;
• the desired payment methods have been defined.

Available payment methods

The integration allows you to receive payments through:

• Pix;
• bank slip;
• one-time credit card payments;
• installment credit card payments.

📘

Important

Currently, debit card payments and recurring charges are not supported by the Nuvemshop integration.

Important settings

During module configuration, it is possible to define:

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

These settings directly influence the behavior of the store checkout.

Important behaviors

When using the integration, consider that:

• payments are processed through the configured Asaas account;
• Nuvemshop orders receive automatic payment updates;
• webhooks are used to synchronize both platforms;
• installment sales are only allowed for credit card payments;
• recurring subscriptions are not supported by the platform.

Best practices

• Always use a valid production API Key.
• Test the payment methods before publishing the store.
• Properly define Pix and bank slip expiration periods.
• Review installment rules before making them available to customers.
• Keep your Asaas account information up to date.
• Monitor store notifications after installation.

Next steps

To complete the integration setup, refer to the contents of this section:

• Installing the Asaas module.
• Initial settings.
• Frequently Asked Questions (FAQ).