FAQ - magento

Consulte as principais dúvidas sobre ambientes, meios de pagamento, parcelamento e sincronização entre Magento e Asaas.

Para instalar ou alterar o módulo, utilize os guias específicos indicados nas respostas.

O módulo possui ambiente de testes?

Sim.

Selecione o ambiente Desenvolvimento no módulo e utilize a API Key correspondente ao ambiente de testes.

Produção e ambiente de testes utilizam credenciais diferentes.

Consulte Configurações iniciais para configurar o ambiente e a API Key.

Quais formas de pagamento estão disponíveis?

O módulo suporta:

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

Os meios de pagamento podem ser habilitados ou desabilitados individualmente nas configurações do módulo.

É possível configurar parcelamento?

Sim.

O parcelamento está disponível para cartão de crédito.

Você pode definir a quantidade máxima de parcelas e o percentual de juros aplicado conforme a opção escolhida pelo comprador.

Consulte Configurações iniciais para ajustar essas regras.

Como os pedidos são atualizados após o pagamento?

A integração utiliza Webhooks para enviar ao Magento as alterações das cobranças processadas pelo Asaas.

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Pedido criado no Magento"] --> B["Criar cobrança no Asaas"]
    B --> C["Cliente realiza o pagamento"]
    C --> D["Asaas envia o Webhook"]
    D --> E["Magento atualiza o pedido"]

    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

Não é necessário implementar consultas periódicas à API para acompanhar os pedidos criados pelo módulo.

O que acontece se o Webhook estiver incorreto?

O processamento financeiro pode continuar normalmente no Asaas, mas o Magento pode deixar de receber as atualizações automáticas do pedido.

Nesse cenário, o status da cobrança no Asaas pode ficar diferente do status exibido no Magento.

Revise a URL para Webhooks de cobrança em Configurações iniciais.

Posso habilitar ou desabilitar notificações ao comprador?

Sim.

A opção Habilitar notificações entre Asaas e comprador controla o envio de e-mails relacionados às alterações de status dos pagamentos.

Essa configuração é independente da atualização dos pedidos via Webhook.

Posso alterar a validade do Pix e do boleto?

Sim.

O módulo permite configurar:

• Dias de validade do boleto: quantidade de dias adicionada à data atual para definir o vencimento;
• Dias de validade do Pix: quantidade de dias adicionada à data atual para definir a validade do pagamento.

Esses valores são configurados separadamente para cada meio de pagamento.

O que verificar quando a API Key é recusada?

Confirme se:

• a chave foi copiada integralmente;
• a chave continua ativa;
• a credencial pertence ao ambiente selecionado no módulo.

Produção e ambiente de testes utilizam chaves diferentes.

Se necessário, crie uma nova credencial conforme o guia de Chaves de API.

Por que o pedido não foi atualizado?

Verifique primeiro se o pagamento foi atualizado na conta Asaas.

Se estiver correto no Asaas, revise a configuração do Webhook no Magento. Uma URL ausente ou incorreta pode impedir a sincronização automática do pedido.

Por que o Pix expirou ou o boleto venceu?

Verifique os dias de validade configurados para o respectivo meio de pagamento.

Se o prazo não atende à operação, ajuste-o em Configurações iniciais.

Por que o parcelamento não aparece?

Revise:

• se o cartão de crédito está habilitado;
• a quantidade máxima de parcelas;
• os percentuais de juros configurados.

O que fazer antes de atualizar o Magento?

Valide a compatibilidade do módulo em um ambiente de homologação e mantenha um backup atualizado antes de aplicar a alteração em Produção.

Se o comportamento mudar após a atualização, revise também a instalação e as configurações do módulo.

Próximos passos

• Revise as configurações do módulo
• Revise a instalação do módulo
• Consulte a visão geral da integração Magento
• Gerencie suas chaves de API