Magento

Use o módulo oficial do Asaas para processar pagamentos por Pix, boleto bancário e cartão de crédito em lojas Magento 2.3.x e 2.4.x.

A integração cria as cobranças na conta Asaas configurada e utiliza Webhooks para manter os pedidos do Magento atualizados após alterações nos pagamentos.

Recursos disponíveis

Antes de começar

Confirme que:

• sua loja utiliza Magento 2.3.x ou 2.4.x;
• o ambiente utiliza PHP 7.1.x ou superior;
• você possui uma conta Asaas ativa;
• o ambiente permite instalar módulos pelo Composer ou pelo diretório da aplicação;
• você possui permissão para executar os comandos necessários do Magento.

A API Key será configurada após a instalação e deve corresponder ao ambiente selecionado no módulo.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Instalar o módulo"] --> B["Configurar ambiente e API Key"]
    B --> C["Habilitar formas de pagamento"]
    C --> D["Cliente realiza o pedido"]
    D --> E["Criar cobrança no Asaas"]
    E --> F["Processar o pagamento"]
    F --> G["Receber Webhook"]
    G --> H["Atualizar pedido no Magento"]

    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,E,F,G validacao
    class H sucesso

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

As atualizações dos pedidos dependem da URL de Webhook configurada no módulo. Utilize essa comunicação para acompanhar mudanças nos pagamentos em vez de consultas periódicas à API.

Escolha por onde continuar

Ainda não instalou o módulo

Siga para Instalando o módulo.

Nesse guia você encontra:

• versões e requisitos;
• instalação pelo Adobe Marketplace;
• instalação via Composer;
• instalação pelo diretório da aplicação;
• comandos necessários para concluir a instalação.

Já instalou e precisa configurar os pagamentos

Siga para Configurações iniciais.

Nessa etapa você configura:

• ambiente de operação;
• API Key;
• URL de Webhook;
• formas de pagamento;
• parcelamento e juros;
• validade do boleto e do Pix;
• notificações ao comprador.

Precisa consultar limitações ou resolver uma dúvida

Consulte o FAQ - Magento.

Ambientes

O módulo permite selecionar:

• Desenvolvimento para testes;
• Produção para operações reais.

Cada ambiente utiliza sua própria API Key. A credencial configurada deve pertencer ao mesmo ambiente selecionado no módulo.

Antes de publicar alterações em Produção, valide a criação da cobrança, o pagamento e a atualização automática do pedido em ambiente de desenvolvimento.

Próximos passos

• Instale o módulo Asaas
• Configure os meios de pagamento
• Consulte o FAQ do Magento