Configurações iniciais

Após instalar o módulo do Asaas no Magento, é necessário realizar algumas configurações para habilitar os meios de pagamento e definir o comportamento das cobranças geradas pela integração.

Essas configurações determinam como Pix, boleto bancário e cartão de crédito serão apresentados ao comprador e influenciam diretamente a experiência de compra e o fluxo financeiro da operação.

Quando realizar estas configurações

Esta etapa deve ser executada após a instalação do módulo Asaas.

É indicada para lojas que desejam:

• habilitar Pix, boleto bancário e cartão de crédito;
• configurar parcelamentos e juros;
• definir o prazo de vencimento das cobranças;
• controlar notificações enviadas aos compradores;
• sincronizar automaticamente os pedidos entre Magento e Asaas.

Dependências para utilização

Antes de prosseguir, é necessário que:

• o módulo do Asaas já esteja instalado;
• a conta Asaas esteja ativa;
• a API Key esteja disponível;
• o Magento esteja operando normalmente;
• as permissões necessárias para administração da loja estejam disponíveis.

📘

Importante

As configurações descritas nesta página somente funcionarão após a instalação correta do módulo.

Comportamentos importantes

As configurações realizadas nesta etapa influenciam diretamente o funcionamento da integração.

Entre os principais comportamentos estão:

• atualização automática dos pedidos através de Webhooks;
• geração das cobranças na conta Asaas configurada;
• controle do prazo de vencimento do boleto;
• controle da validade do Pix;
• parcelamento do cartão de crédito com juros configuráveis;
• envio opcional de notificações para os compradores.

Parâmetros importantes

Exemplo de fluxo da integração

Pedido criado no Magento
↓
Cobrança criada no Asaas
↓
Cliente realiza o pagamento
↓
Webhook enviado pelo Asaas
↓
Magento atualiza o status do pedido

Impactos operacionais

As configurações realizadas nesta etapa impactam diretamente:

• a experiência do comprador;
• o comportamento do checkout;
• o vencimento das cobranças;
• a conciliação financeira da operação;
• a atualização automática dos pedidos.

Alterações incorretas podem causar divergências entre o pagamento e o pedido no Magento.

Ao acessar o painel administrativo do Magento, no menu lateral clique em Lojas, depois clique em Configuração, na sequência clique em Clientes, depois Configurações de Cliente, depois acesse a opção Opções de Nome e Endereço.

Em Número de Linhas em Endereço você deve informar o número 4, conforme imagem abaixo:

Depois, acesse novamente o menu Lojas, na sequência clique em Configuração, no sub-menu Vendas clique em Formas de Pagamento. Será carregada a tela para configurar os meios de pagamento do site.

Como habilitar o Asaas no seu site

Ao expandir o meio de pagamento "Asaas pagamentos", você encontrará a opção que ativa o módulo por completo. Basta selecionar "Sim" para realizar a ativação.

Em seguida temos as configurações gerais, configurações de cartão de crédito, configurações de boleto e configurações de Pix.

📘

Importante

Para que todas as configurações a seguir funcionem, todo o passo a passo anterior deve ter sido seguido.

Configurações Gerais

• Api Key

  • Chave de integração da conta Asaas. Os tokens de produção e sandbox são distintos. Para gerar sua Api Key, acesse a sua conta Asaas (no ambiente requerido), e no menu do usuário, acesse a opção "Integrações". Nessa tela, clique em "Gerar nova Chave de API", e copie todo o conteúdo da chave exibida.

• Ambiente

  • Seleciona qual versão de ambiente que o site estará apontando. Os ambientes disponíveis são: Desenvolvimento e Produção.

• URL para Webhooks de cobrança

  • URL a ser informada no Webhook de cobrança no site do Asaas, para que no momento de aprovação do pagamento, o status do pedido seja alterado.

• Ordem de exibição

  • Ordem de exibição dos métodos de pagamento habilitados no módulo sendo mostrados na tela de Checkout.

• Habilitar notificações entre Asaas e comprador

  • Habilita mensagens via e-mail informando as alterações de status de pagamento.

Configurações Cartão de Crédito

• Habilitado

  • Habilita ou desabilita o método de pagamento com cartão de crédito.

• Parcelas

  • Este campo, além de trazer a quantidade máxima de parcelamento permitida, também adiciona um percentual de juros em cada parcela caso o cliente opte.

• Tipo do Cartão de Crédito

  • Seleciona e exibe no formulário de cartão de crédito as bandeiras disponíveis para pagamento.

Configurações de Boleto

• Habilitado

  • Habilita ou desabilita o método de pagamento com boleto.

• Dias de validade do boleto

  • Pega a data atual e adiciona a quantidade solicitada de dias para o vencimento do boleto.

• Instruções ao usuário

  • Mensagem exibida na tela de agradecimento após finalização do pedido.

Configurações de Pix

• Habilitado

  • Habilita ou desabilita o método de pagamento via Pix.

• Dias de validade do Pix

  • Pega a data atual e adiciona a quantidade solicitada de dias para o vencimento do Pix.

• Instruções ao usuário

  • Mensagem exibida na tela de agradecimento após finalização do pedido.

Erros comuns

API Key inválida

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

Pedido não é atualizado automaticamente

Normalmente está relacionado a problemas na configuração do webhook.

Pix expirado

Pode ocorrer quando a validade configurada é insuficiente para a operação.

Boleto vencido

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

Cartão não permite parcelamento

Pode ocorrer quando o número máximo de parcelas ou os juros não foram configurados.

Boas práticas

📘

Recomendado

• Utilizar a API Key correspondente ao ambiente correto.
• Testar todos os meios de pagamento após concluir a configuração.
• Validar o funcionamento do webhook.
• Revisar parcelamentos e juros antes de publicar a loja.
• Monitorar os primeiros pedidos após alterações nas configurações.

Conteúdos relacionados

• Instalação do módulo Magento.
• API Keys.
• Configuração da conta Asaas.
• FAQ da integração Magento + Asaas.