12 de novembro de 2026

Como gerar cobrança Pix no n8n e confirmar o pagamento automaticamente

Gere uma cobrança Pix no n8n com o nó HTTP Request e confirme o pagamento pelo nó Webhook, sem conferir comprovante. Funciona no n8n Cloud.

por Lucas Aquino

Cobrar por Pix e conferir comprovante na mão não escala: o pedido trava, o time perde tempo e print falso passa. No n8n dá para gerar o Pix, mandar para o cliente e liberar o pedido quando o pagamento cai, tudo no mesmo fluxo. Este guia usa só nós nativos (HTTP Request e Webhook) com a API da AbacatePay, então funciona em qualquer n8n, inclusive no n8n Cloud. O conceito por trás está em confirmar pagamento Pix automaticamente.

O fluxo em 3 passos: pedido, Pix e confirmação

São dois workflows no n8n:

  1. Workflow de cobrança: um gatilho de pedido (formulário, mensagem, linha nova na planilha ou um Webhook do seu site) → nó HTTP Request cria o Pix na AbacatePay → o fluxo manda o Pix Copia e Cola e o QR Code para o cliente.
  2. Workflow de confirmação: nó Webhook recebe o aviso transparent.completed da AbacatePay → confere o secret → libera o pedido.

São dois porque o pagamento chega depois, numa requisição separada, quando o cliente paga no app do banco. Se o conceito de webhook for novo, veja o que é webhook de pagamento.

Antes de começar

Roteiro de testes: como testar o gateway no sandbox.

Passo 1: gerar a cobrança Pix com o nó HTTP Request

Configure o nó

No workflow de cobrança, depois do gatilho, adicione um HTTP Request:

Body mínimo (o valor vai em centavos: R$ 97,00 = 9700):

{ "method": "PIX", "data": { "amount": 9700 } }

Body com os campos opcionais mais úteis:

{
  "method": "PIX",
  "data": {
    "amount": 9700,
    "description": "Pedido 1042",
    "expiresIn": 3600,
    "externalId": "pedido-1042",
    "customer": {
      "name": "Maria Santos",
      "email": "maria@exemplo.com"
    }
  }
}

Para usar o valor e o número do pedido que vieram do gatilho, arraste o campo do painel de entrada para o lugar de amount e de externalId: o n8n monta a expressão sozinho. expiresIn é a validade do QR em segundos (mínimo de 300), e o valor mínimo de uma cobrança é R$ 1,00. A descrição não aceita emoji. Use Using JSON: com “Using Fields Below”, o n8n manda os valores como texto.

O que volta

A resposta traz, dentro de data:

Campo O que é
id ID da cobrança (começa com pix_char_)
status PENDING até o pagamento
brCode Pix Copia e Cola
brCodeBase64 Imagem do QR Code
expiresAt Quando o QR deixa de valer

Guarde o id e o seu externalId: são eles que ligam o pagamento ao pedido. Por trás do nó, é a mesma chamada de como gerar QR Code Pix via API. Veja também a API Pix.

Passo 2: mandar o Pix para o cliente

Com o brCode e o brCodeBase64 na mão, o próximo nó manda o Pix pelo canal que você já usa: e-mail, chat do site, Telegram ou WhatsApp, pela ferramenta de WhatsApp que você já conecta no n8n. Mande o Copia e Cola como texto (o cliente cola no app do banco) e o QR como imagem. A AbacatePay gera o Pix e avisa o pagamento; quem manda a mensagem é o seu fluxo. Mais ideias em como receber pagamento pelo WhatsApp.

Falar com o time para cobrar Pix pelo n8n

Passo 3: confirmar o pagamento com o nó Webhook

Crie o Webhook no n8n

Num workflow novo, adicione um nó Webhook com o método POST. Ele tem duas URLs: a Test URL só funciona enquanto o editor está ouvindo (“Listen for Test Event”); a Production URL passa a valer quando você publica o workflow. Copie a Production URL para cadastrar na AbacatePay.

Cadastre a URL na AbacatePay

No painel, vá em Integração → Webhooks → Criar webhook e escolha Webhook v2. Preencha:

Um webhook não pode ser editado: para trocar a URL, o secret ou os eventos, crie outro e exclua o antigo. Modo Teste e produção têm webhooks separados. Mais em webhooks da AbacatePay.

Confira o secret antes de qualquer ação

Cada aviso da AbacatePay traz o secret que você cadastrou, no header X-Webhook-Secret e na URL (?webhookSecret=). É ele que prova que o aviso veio da AbacatePay. No n8n, há dois jeitos de conferir:

A assinatura no header X-Webhook-Signature (HMAC-SHA256 do corpo) garante que o conteúdo não foi alterado. Para validá-la num nó Code, siga os exemplos da documentação de segurança dos webhooks.

Filtre o evento e libere o pedido

O n8n entrega o aviso dividido em body, headers e query. Siga só se body.event for transparent.completed e body.data.transparent.status for PAID (é o status do Pix pago). Depois, ache o pedido por body.data.transparent.externalId e libere: marque como pago, mande o produto, avise o cliente. A AbacatePay espera uma resposta 2xx em até 30 segundos; deixe o Webhook responder logo e faça o trabalho pesado nos nós seguintes.

Evite processar duas vezes

Se a resposta falhar, a AbacatePay tenta de novo, com o mesmo id de evento. Guarde o body.id de cada aviso processado (numa planilha ou banco) e pule se ele já existir. Um reenvio manual pelo painel chega com id novo, então confira também se o pedido já está pago antes de liberar. O porquê está em confirmar pagamento Pix automaticamente.

Testando sem dinheiro de verdade

No Modo Teste, nenhum Pix é cobrado de verdade:

  1. Crie o Pix pelo HTTP Request com a chave abc_dev_ e anote o data.id.
  2. Simule o pagamento de um destes jeitos:
    • com outro HTTP Request: POST https://api.abacatepay.com/v2/transparents/simulate-payment?id= seguido do id da cobrança, com a mesma credencial;
    • ou pela CLI da AbacatePay: abacatepay payments simulate <id-da-cobrança>.
  3. Veja o transparent.completed chegar no Webhook do n8n, com devMode: true.

Se o seu n8n roda no seu computador, a CLI encaminha os avisos do Modo Teste para ele: abacatepay listen --forward-to seguido da URL local do Webhook. Para ir para produção, troque para a chave abc_prod_ e crie o webhook de novo com o Modo Teste desligado. Roteiro completo: como testar o gateway no sandbox.

4 automações prontas para montar

E o nó AbacatePay da comunidade?

Existe um nó da comunidade, o pacote n8n-nodes-abacatepay-community, no GitHub da AbacatePay, com operações de cliente, cobrança, Pix e cupom e um gatilho de pagamentos.

Atenção antes de usar: ele só entra no n8n self-hosted (Settings > Community Nodes, por quem é Owner ou Admin), porque o n8n Cloud não aceita nós da comunidade não verificados. A última versão é de novembro de 2025: ele chama a API v1, e o gatilho usa nomes de evento anteriores aos webhooks v2. Para um fluxo novo, use HTTP Request + Webhook com a API v2, como neste guia. Se quiser testar o nó, faça no Modo Teste e volte para os nós nativos se algo não bater.

Quanto custa

Integrar não custa nada. Na AbacatePay, você paga R$ 0,80 por Pix pago, o dinheiro cai na hora e não há mensalidade. O custo do n8n depende do seu plano: consulte a página de preços oficial do n8n. Todas as taxas em /pricing.

n8n, Zapier ou Make?

O n8n cria a cobrança e confere o secret com nós nativos, e ainda roda self-hosted. Se você só quer registrar cada venda paga numa planilha ou CRM, sem montar requisição, o Zapier e o Make resolvem pelo webhook: veja automatizar vendas com Zapier e Make. Para cobrar pedindo em português a um agente de IA, veja cobrar com Pix usando agente de IA e pagamentos agênticos. Todas as opções estão nas integrações da AbacatePay com n8n, Zapier e Make.

Perguntas frequentes

Dá para gerar Pix no n8n Cloud?

Sim, com os nós nativos HTTP Request e Webhook, como neste guia. O nó da comunidade não entra no n8n Cloud, que só aceita nós da comunidade verificados.

Preciso instalar algum nó?

Não. HTTP Request e Webhook já vêm no n8n. A cobrança sai da API da AbacatePay e a confirmação chega pelo webhook.

Qual evento avisa que o Pix foi pago?

transparent.completed, para o Pix criado pela API. Se você vende por checkout ou link de pagamento, o evento é checkout.completed.

Como sei que o aviso veio mesmo da AbacatePay?

Conferindo o secret que chega no header X-Webhook-Secret (e na URL). Para garantir também que o corpo não foi alterado, valide a assinatura X-Webhook-Signature seguindo a documentação de segurança.

Quanto custa receber Pix pelo n8n?

Integrar é grátis. Na AbacatePay, você paga R$ 0,80 por Pix pago, sem mensalidade. O plano do n8n é à parte.

Checklist antes de ligar a automação

  1. Guarde a chave numa credencial do n8n, nunca no corpo do nó.
  2. Crie o Pix com externalId igual ao número do pedido.
  3. Cadastre a Production URL do Webhook como Webhook v2, com secret de 32+ caracteres.
  4. Confira o secret antes de liberar qualquer pedido.
  5. Guarde o id de cada aviso para não processar duas vezes.
  6. Teste tudo no Modo Teste e recrie o webhook na produção.

Fale com o time e automatize suas cobranças Pix no n8n

Leia também: automatizar vendas com Zapier e Make · como gerar QR Code Pix via API · confirmar pagamento Pix automaticamente · o que é webhook de pagamento · como testar o gateway no sandbox · cobrar com Pix usando agente de IA · precisa de CNPJ? MEI também vale · integrações · webhooks · CLI

Você pode se interessar por