Magento

Magento is an open-source e-commerce platform designed for creating and managing highly customizable online stores.

Asaas provides an official module for Magento 2.3 and 2.4, allowing payments to be processed directly through the store using bank slips, Pix and credit cards, including installment payments.

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

When to use

This integration is recommended for operations that want to:

• use Asaas as the payment gateway for a Magento store;
• offer payments via Pix, bank slips and credit cards;
• provide credit card installments;
• use an official module without the need for additional development;
• centralize the financial processing of the operation in the Asaas account;
• automate order updates through communication between Magento and Asaas.

The solution is suitable for both small operations and stores with higher sales volumes.

How the integration works

After installing the Asaas module in Magento, orders placed in the store are processed through the configured Asaas account.

A typical journey follows this flow:

Create an Asaas account
↓
Install the Asaas module
↓
Configure the API Key
↓
Configure payment methods
↓
Publish the store
↓
Receive orders
↓
Process payments through Asaas
↓
Automatically update orders

Requirements

Before installing the module, it is necessary that:

• the store is running Magento 2.3 or 2.4;
• the environment has a compatible PHP version;
• there is an active Asaas account;
• the account API Key is available;
• the environment is prepared for module installation.

Available payment methods

The integration allows payments through:

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

📘

Important

The available payment methods are defined in the module settings and can be enabled or disabled individually.

Important behaviors

When using the integration, consider that:

• payments are processed through the Asaas account configured in the module;
• store orders are automatically updated after financial events;
• communication between Magento and Asaas uses webhooks;
• Pix and bank slips have configurable expiration periods;
• installments are available only for credit card payments;
• Production and Development environments use different API Keys.

Best practices

• Always use the API Key corresponding to the configured environment.
• Validate payment methods before making the store available.
• Test the complete flow in a staging environment.
• Monitor order updates after installation.
• Periodically review the module settings.

Next steps

To complete the integration, refer to the content in this section:

• Module installation.
• Initial settings.
• Frequently Asked Questions (FAQ).