Asaas — Integração de Cobranças
Receba pagamentos via cartão, boleto e Pix de forma automatizada, com atualização de status em tempo real.
Como funciona a integração?
O módulo conecta sua loja ao Asaas através de uma chave de API. Uma vez configurado, o sistema cria cobranças automaticamente e recebe atualizações via webhooks — isso significa que quando um cliente paga, o pedido muda para "Pago" sem que você precise dar baixa manual.
Nota: A integração centraliza Cartão de Crédito, Boleto Bancário e Pix em um único gateway.
1 Atenção e Segurança
- • Chave de API: Trate a chave de API como uma senha. Se ela for comprometida, gere uma nova imediatamente no painel do Asaas e atualize aqui.
- • Métodos Ativos: Ative apenas as formas de pagamento (Pix, Boleto, Cartão) que você realmente deseja oferecer e processar.
- • Webhooks: Para que o retorno automático funcione, seu servidor não pode bloquear as notificações do Asaas (verifique firewall ou regras de IP).
2 Passo a Passo de Configuração
-
01Obter Credencial: Acesse sua conta no Asaas, vá em Configurações de Integração e copie a Chave da API.
-
02Conectar: Na loja, cole a chave no campo principal do módulo Asaas.
-
03Regras de Cobrança: Defina valores mínimos, número máximo de parcelas e juros (se aplicável), conforme sua política comercial.
-
04Métodos: Use os toggles laterais para ativar quais opções aparecerão no checkout: Cartão, Boleto e/ou Pix.
-
05Ativar: Clique em Salvar e Ativar. Após configurar, faça uma compra de teste para validar o fluxo.
3 Seções de Configuração
Credenciais
Campo para inserir a API Key. É a "senha" que permite à loja conversar com o Asaas.
Regras de Cobrança
Configurações financeiras como parcelamento (sem juros ou com juros) e valor mínimo de parcela.
Métodos Ativos
Controles individuais para habilitar ou desabilitar Pix, Boleto e Cartão de Crédito separadamente.
Webhooks
Card informativo sobre o status da notificação automática. Confirma se o sistema está pronto para receber o retorno do pagamento.
Dica: Se tiver dúvidas sobre falhas de notificação (ex: pedido pago no banco mas pendente na loja), verifique a disponibilidade do endpoint de webhooks ou consulte o log de entrega no suporte do Asaas.