FAQ - Magento

Find answers to the most common questions about environments, payment methods, installments, and synchronization between Magento and Asaas.

To install or change the module, use the specific guides indicated in the answers.

Does the module have a test environment?

Yes.

Select the Desenvolvimento (Development) environment in the module and use the API Key corresponding to the test environment.

Production and the test environment use different credentials.

See Initial settings to configure the environment and the API Key.

Which payment methods are available?

The module supports:

• Pix;
• bank slip (boleto);
• credit card in a single payment;
• credit card in installments.

Payment methods can be enabled or disabled individually in the module settings.

Is it possible to configure installments?

Yes.

Installments are available for credit card.

You can define the maximum number of installments and the interest percentage applied according to the option chosen by the buyer.

See Initial settings to adjust these rules.

How are orders updated after payment?

The integration uses Webhooks to send Magento the changes to the charges processed by Asaas.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Order created in Magento"] --> B["Create charge in Asaas"]
    B --> C["Customer makes the payment"]
    C --> D["Asaas sends the Webhook"]
    D --> E["Magento updates the order"]

    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 validacao
    class E sucesso

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

There is no need to implement periodic API queries to track the orders created by the module.

What happens if the Webhook is incorrect?

Financial processing may continue normally in Asaas, but Magento may stop receiving automatic order updates.

In this scenario, the charge status in Asaas may differ from the status displayed in Magento.

Review the URL for payment Webhooks in Initial settings.

Can I enable or disable notifications to the buyer?

Yes.

The Enable notifications between Asaas and the buyer option controls the sending of emails related to payment status changes.

This setting is independent of order updates via Webhook.

Can I change the validity of Pix and bank slips?

Yes.

The module allows you to configure:

• Bank slip validity days: number of days added to the current date to set the due date;
• Pix validity days: number of days added to the current date to set the validity of the payment.

These values are configured separately for each payment method.

What should I check when the API Key is rejected?

Confirm that:

• the key was copied in full;
• the key is still active;
• the credential belongs to the environment selected in the module.

Production and the test environment use different keys.

If necessary, create a new credential following the API Keys guide.

Why was the order not updated?

First check whether the payment was updated in the Asaas account.

If it is correct in Asaas, review the Webhook configuration in Magento. A missing or incorrect URL can prevent the automatic synchronization of the order.

Why did the Pix expire or the bank slip become overdue?

Check the validity days configured for the respective payment method.

If the period does not suit your operation, adjust it in Initial settings.

Why are installments not showing?

Review:

• whether credit card is enabled;
• the maximum number of installments;
• the configured interest percentages.

What should I do before updating Magento?

Validate the module's compatibility in a staging environment and keep an up-to-date backup before applying the change in Production.

If the behavior changes after the update, also review the module installation and settings.

Next steps

• Review the module settings
• Review the module installation
• See the Magento integration overview
• Manage your API keys