Guia prático · n8n & Pagamentos
Como integrar Webhooks de Pix e Cartão (Stripe, Mercado Pago, Asaas e Hotmart) no n8n com entrega via WhatsApp
Aprenda a processar webhooks de gateways de pagamento no n8n com verificação de status real na API e disparo na Evolution API.
Neste guia passo a passo
1. Arquitetura e pré-requisitos no ambiente
2. Passo a passo de implementação e validação
3. Boas práticas de produção, segurança e escala
1. Arquitetura e pré-requisitos no ambiente
Confiar apenas no payload recebido no webhook sem reconsultar o status do pagamento na API oficial do gateway (ou validar a assinatura HMAC) abre brecha para fraudes. No n8n, fazemos a dupla checagem em milissegundos.
- Conta e chave de API de produção no seu gateway (Stripe, Mercado Pago, Asaas, Pagar.me ou Hotmart).
- Tabela de pedidos/clientes no PostgreSQL ou NocoDB para registrar a transação.
2. Passo a passo de implementação e validação
- Crie um nó Webhook (POST) no n8n e cadastre a URL de produção (
/webhook/...) no painel do gateway para os eventosPAYMENT_CONFIRMED/checkout.session.completed. - Logo após o Webhook, faça um HTTP Request (GET) na API oficial do gateway usando o
payment_idrecebido para confirmar que o status realmente consta comopaid/approved. - Consulte seu PostgreSQL/Redis para garantir que esse
payment_idainda não foi processado (idempotência). - Libere o acesso do cliente no seu sistema e envie a mensagem de confirmação com recibo via Evolution API no WhatsApp.
3. Boas práticas de produção, segurança e escala
Para cobranças Pix com vencimento ou boleto, crie um segundo fluxo agendado que envia um lembrete amigável no WhatsApp 30 minutos antes do código Pix expirar.
- Salve o payload bruto do webhook em uma tabela
webhook_logspor 30 dias para auditoria financeira.
Quer colocar n8n & Pagamentos em produção hoje com 30% OFF no plano anual?
Suba sua VPS NVMe em São Paulo (6,6ms) com instalador em 1 clique, SSL automático e suporte humano no WhatsApp. Equivale a R$ 69,30/mês no plano anual com o cupom BLACK30 (ou R$ 99/mês no mensal).
Mais tutoriais sobre Automação & Workflows (n8n)
You Secure