Magento

O Magento é uma plataforma de e-commerce open-source desenvolvida para criação e gerenciamento de lojas virtuais altamente personalizáveis.

O Asaas possui módulo oficial para Magento 2.3 e 2.4, permitindo processar pagamentos diretamente pela loja utilizando boleto bancário, Pix e cartão de crédito, incluindo pagamentos parcelados.

Esta seção reúne os conteúdos necessários para instalar, configurar e operar a integração entre Magento e Asaas.

Quando utilizar

A integração é indicada para operações que desejam:

• utilizar o Asaas como gateway de pagamentos da loja Magento;
• disponibilizar pagamentos via Pix, boleto bancário e cartão de crédito;
• oferecer parcelamento no cartão de crédito;
• utilizar um módulo oficial sem necessidade de desenvolvimento adicional;
• centralizar o processamento financeiro da operação na conta Asaas;
• automatizar a atualização dos pedidos através da comunicação entre Magento e Asaas.

A solução é indicada tanto para pequenas operações quanto para lojas com maior volume de vendas.

Como funciona a integração

Após a instalação do módulo do Asaas no Magento, os pedidos realizados na loja passam a ser processados pela conta Asaas configurada.

Uma jornada típica segue o fluxo:

Criar conta Asaas
↓
Instalar módulo do Asaas
↓
Configurar API Key
↓
Configurar formas de pagamento
↓
Publicar a loja
↓
Receber pedidos
↓
Processar pagamentos pelo Asaas
↓
Atualizar automaticamente os pedidos

Requisitos para utilização

Antes de instalar o módulo, é necessário que:

• a loja esteja operando com Magento 2.3 ou 2.4;
• o ambiente possua versão compatível do PHP;
• exista uma conta Asaas ativa;
• a API Key da conta esteja disponível;
• o ambiente esteja preparado para instalação do módulo.

Formas de pagamento disponíveis

A integração permite receber pagamentos através de:

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

📘

Importante

Os meios de pagamento disponíveis são definidos nas configurações do módulo e podem ser habilitados ou desabilitados individualmente.

Comportamentos importantes

Ao utilizar a integração, considere que:

• os pagamentos são processados pela conta Asaas configurada no módulo;
• os pedidos da loja são atualizados automaticamente após alterações financeiras;
• a comunicação entre Magento e Asaas utiliza webhooks;
• Pix e boleto possuem prazo de validade configurável;
• parcelamentos são aplicados apenas para cartão de crédito;
• os ambientes de Produção e Desenvolvimento utilizam API Keys diferentes.

Boas práticas

• Utilizar sempre a API Key correspondente ao ambiente configurado.
• Validar os meios de pagamento antes de disponibilizar a loja.
• Testar o fluxo completo em ambiente de homologação.
• Monitorar as atualizações dos pedidos após a instalação.
• Revisar periodicamente as configurações do módulo.

Próximos passos

Para concluir a integração, consulte os conteúdos desta seção:

• Instalação do módulo.
• Configurações iniciais.
• Perguntas frequentes (FAQ).