FAQ - Magento

This section gathers the most common questions about the integration between Magento and Asaas.

The official module allows you to use Asaas as the store's payment gateway, processing orders through Pix, bank slips and credit cards.

In addition to frequently asked questions, this page presents important behaviors, limitations and recommendations for using the integration.

Important integration rules

Before using the module, consider that:

• payments are processed by the Asaas account configured in Magento;
• the environment selected in the module must match the API Key being used;
• order updates depend on webhook communication;
• installments are available only for credit cards;
• Pix and bank slips have configurable expiration periods;
• buyer notifications can be enabled or disabled.

Important settings and parameters

Does the module provide a test environment?

Yes.

It is possible to use the Asaas development environment, as long as the corresponding API Key is used and the environment is correctly configured in the module.

📘

Recommended

Before publishing changes to production, perform tests in the development environment.

Which payment methods are available?

The module supports:

• Pix;
• bank slips;
• credit cards;
• installment credit card payments.

Is it possible to configure installments?

Yes.

The maximum number of installments and the applied interest rates can be configured directly in the module settings.

📘

Important

Installment rules directly influence the amount displayed to the buyer during checkout.

How are orders updated?

Whenever a financial event occurs on a charge, Asaas sends a notification through the configured webhook.

This process allows Magento orders to be updated automatically.

Typical flow:

Order created
↓
Charge created in Asaas
↓
Payment completed
↓
Webhook sent
↓
Magento updates the order

Which events normally update orders?

Among the most common events are:

• payment confirmed;
• pending payment;
• bank slip expiration;
• Pix expiration;
• cancellation;
• refund.

Is it possible to enable or disable buyer notifications?

Yes.

The module allows you to define whether buyers will receive email notifications regarding payment status changes.

What happens if the webhook is incorrect?

Payments will continue to be processed normally by Asaas.

However, orders may no longer be updated automatically in Magento.

In these situations, discrepancies may occur between the financial status and the order status.

What are the most common errors?

Invalid API Key

This may occur when the key belongs to another environment or was copied incorrectly.

Order is not updated

This is usually related to webhook configuration.

Expired Pix

This may occur when the configured expiration period is insufficient for the operation.

Expired bank slip

This may occur when the configured number of days is too short.

Installments unavailable

This may occur when installment rules have not been configured correctly.

Problems after updating Magento

It is recommended to validate module compatibility and perform tests before updating the store in production.

Best practices

📘

Recommended

• Use the API Key corresponding to the correct environment.
• Test the complete flow after changing settings.
• Validate webhook functionality.
• Review installment settings.
• Monitor the first sales after changing module settings.
• Keep backups up to date before updating Magento.

Related content

• Magento module installation.
• Initial settings.
• API Keys.
• Asaas account configuration.