FAQ - magento

Esta seção reúne as principais dúvidas sobre a integração entre Magento e Asaas.

O módulo oficial permite utilizar o Asaas como gateway de pagamentos da loja, processando pedidos através de Pix, boleto bancário e cartão de crédito.

Além das perguntas mais frequentes, esta página apresenta comportamentos importantes, limitações e recomendações para utilização da integração.

Regras importantes da integração

Antes de utilizar o módulo, considere que:

• os pagamentos são processados pela conta Asaas configurada no Magento;
• o ambiente selecionado no módulo deve corresponder à API Key utilizada;
• as atualizações dos pedidos dependem da comunicação via webhook;
• o parcelamento está disponível apenas para cartão de crédito;
• Pix e boleto possuem prazo de validade configurável;
• as notificações ao comprador podem ser habilitadas ou desabilitadas.

Configurações e parâmetros importantes

O módulo possui ambiente de testes?

Sim.

É possível utilizar o ambiente de desenvolvimento do Asaas, desde que seja utilizada a API Key correspondente e o ambiente esteja configurado corretamente no módulo.

📘

Recomendado

Antes de publicar alterações em produção, realize testes em ambiente de desenvolvimento.

Quais formas de pagamento estão disponíveis?

O módulo suporta:

• Pix;
• boleto bancário;
• cartão de crédito;
• cartão de crédito parcelado.

É possível configurar parcelamento?

Sim.

O número máximo de parcelas e os juros aplicados podem ser configurados diretamente nas configurações do módulo.

📘

Importante

As regras de parcelamento influenciam diretamente o valor apresentado ao comprador durante o checkout.

Como os pedidos são atualizados?

Quando ocorre uma alteração financeira na cobrança, o Asaas envia uma notificação através do webhook configurado.

Esse processo permite atualizar automaticamente os pedidos no Magento.

Fluxo típico:

Pedido criado
↓
Cobrança criada no Asaas
↓
Pagamento realizado
↓
Webhook enviado
↓
Magento atualiza o pedido

Quais eventos normalmente atualizam os pedidos?

Entre os principais eventos estão:

• pagamento confirmado;
• pagamento pendente;
• vencimento do boleto;
• expiração do Pix;
• cancelamento;
• estorno.

É possível habilitar ou desabilitar notificações ao comprador?

Sim.

O módulo permite definir se os compradores receberão notificações por e-mail referentes às alterações de status dos pagamentos.

O que acontece se o webhook estiver incorreto?

Os pagamentos continuarão sendo processados normalmente no Asaas.

Porém, os pedidos poderão deixar de ser atualizados automaticamente no Magento.

Nesses casos, podem ocorrer divergências entre o status financeiro e o status do pedido.

Quais são os erros mais comuns?

API Key inválida

Pode ocorrer quando a chave pertence a outro ambiente ou foi copiada incorretamente.

Pedido não é atualizado

Normalmente está relacionado à configuração do webhook.

Pix expirado

Pode ocorrer quando o prazo configurado é insuficiente para a operação.

Boleto vencido

Pode ocorrer quando a quantidade de dias configurada é muito pequena.

Parcelamento indisponível

Pode ocorrer quando as regras de parcelamento não foram configuradas corretamente.

Problemas após atualização do Magento

Recomenda-se validar a compatibilidade do módulo e realizar testes antes de atualizar a loja em produção.

Boas práticas

📘

Recomendado

• Utilizar a API Key correspondente ao ambiente correto.
• Testar o fluxo completo após alterações nas configurações.
• Validar o funcionamento do webhook.
• Revisar as configurações de parcelamento.
• Monitorar as primeiras vendas após alterações no módulo.
• Manter backups atualizados antes de atualizar o Magento.

Conteúdos relacionados

• Instalação do módulo Magento.
• Configurações iniciais.
• API Keys.
• Configuração da conta Asaas.