Base de Conhecimento

Stripe no n8n: automatize cobranças e pagamentos

  • stripe, n8n, pagamentos, webhook, automação, cobrança
  • Usuários acharam útil: 0

Entenda o que o nó Stripe cobre e o que fica para o HTTP Request. Monte o Stripe Trigger no modo teste, preencha o Signature Secret e trate evento repetido antes da produção.

Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 8 min de leitura

Arte da Eleven Host: janela de terminal com o título: Stripe no n8n: automatize cobranças e pagamentos

Capa da Redação Eleven Host para o guia: Stripe no n8n: automatize cobranças e pagamentos Arte: Eleven Host

Usar stripe no n8n é receber eventos de pagamento da Stripe e mexer em clientes, cupons e cobranças dentro de fluxos automáticos: o nó Stripe chama a API da Stripe, e o Stripe Trigger inicia o fluxo quando um evento acontece na conta.

Sem o Signature Secret preenchido na credencial, o Stripe Trigger não verifica a assinatura e aceita evento de quem tiver a URL do webhook.

Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n é a 2.47.7, publicada em 13/11/2026. A verificação de assinatura do Stripe Trigger existe a partir do n8n 2.25.7 e 2.26.2.

O que é o nó Stripe

O nó Stripe do n8n consome a API da Stripe, e o Stripe Trigger trata eventos da Stripe por webhooks. Os dois usam a credencial Stripe API.

O nó de ação cobre um conjunto pequeno de recursos, e parte dos recursos da Stripe fica de fora. Mais adiante, a seção sobre o que o nó não faz mostra o caminho pelo HTTP Request.

Para quem serve

Serve para quem cobra pela Stripe e roda o n8n na própria VPS: avisar a equipe de um pagamento confirmado, cadastrar cliente novo ou reagir a uma cobrança que falhou. Para quem está começando com servidor, há o artigo sobre servidor VPS. O n8n e a Stripe não fazem parte do catálogo da Eleven Host.

Servidores VPS aparecem em seis opções no catálogo da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos

Recursos e operações do nó Stripe

O campo Resource traz oito recursos, e o padrão é Balance. No editor, a operação de listagem se chama Get Many, e não "Get all", como aparece em algumas páginas da documentação.

O que cada recurso aceita

  • Balance: só Get, que traz o saldo da conta;
  • Charge: Create, Get, Get Many e Update. O Create pede Customer ID, Amount, Currency Name or ID e Source ID;
  • Coupon: Create e Get Many. No Create, o Discount Type aceita Fixed Amount (in Cents) ou Percent, com Percent Off de 1 a 100;
  • Customer: Create, Delete, Get, Get Many e Update. O único campo obrigatório do Create é Name; o Email é adicional;
  • Customer Card, Source e Token, com poucas operações cada, e Meter Event, só com Create, para uso medido.

Nas listagens, o campo Limit começa em 50 e vai de 1 até 1000.

O recurso Token pede número de cartão digitado no n8n. Recomendamos não usá-lo com cartão real, porque o dado do cartão passaria pelo seu próprio servidor.

O Stripe Trigger e os eventos

No Stripe Trigger, o campo Events é obrigatório e aceita mais de um evento, escolhidos numa lista de 152 opções. A opção * é o curinga, que dispara a cada evento da conta.

Entre os eventos da lista, com o rótulo do editor, estão Checkout Session.completed, Payment Intent.succeeded, Payment Intent.payment_failed, Invoice Paid, Invoice Payment_failed, Customer Subscription.deleted e Charge Refunded.

Alguns eventos não estão na lista, como checkout.session.async_payment_succeeded e payment_link.created. Nesse caso, dá para escolher * e filtrar o evento dentro do fluxo.

O que o nó Stripe não faz

O nó não tem recurso para Payment Intent, Checkout Session, Payment Link, Subscription, Invoice, Price, Product nem Refund. Logo, não cria cobrança por Pix ou boleto, link de pagamento, assinatura ou fatura, e não faz reembolso.

Para essas ações, a documentação do n8n indica o nó HTTP Request: em Authentication, escolha Predefined Credential Type, selecione Stripe e a credencial salva.

Stripe no Brasil: Pix e boleto

Em 16/11/2026, o Brasil consta entre os países em que a Stripe está disponível. Contas no Brasil aceitam Pix de pagamento único, em reais, com mínimo de R$ 0,50 e liquidação em até 2 dias úteis. O Pix Automático não está disponível no Brasil.

O boleto vale só para contas no Brasil e em reais, a partir de R$ 5,00. Ele vence em 3 dias por padrão e a confirmação é assíncrona, normalmente no próximo dia útil. A Stripe não faz reembolso de boleto.

Nenhum dos dois sai pelo nó Stripe. Como a confirmação do boleto chega depois, recomendamos escolher * com filtro no fluxo ou Payment Intent.succeeded.

Passo 1: n8n atualizado e URL pública em HTTPS

Antes de tudo, atualize o n8n: a verificação de assinatura do Stripe Trigger existe a partir da 2.25.7 e da 2.26.2. O Stripe Trigger é um webhook, e quem chama é a Stripe. Por isso o n8n precisa de uma URL pública em HTTPS com certificado válido, e a Stripe exige HTTPS em produção. Redirecionamento 3xx conta como falha.

Se o n8n roda atrás de um proxy, defina a variável de ambiente N8N_WEBHOOK_URL com o endereço público, como https://n8n.exemplo.com/. A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0 e gera aviso no log.

Passo 2: começar no modo teste e criar a credencial

Os objetos de um modo não existem no outro, então use uma credencial por modo. Comece pelo modo teste (área restrita), cuja chave tem o prefixo sk_test_; a de produção começa com sk_live_.

No n8n, crie a credencial Stripe API, com os campos ocultos Secret Key e Signature Secret. A chave publicável, com prefixo pk_, não serve nesta credencial. A chave de produção aparece uma única vez.

A Stripe recomenda chaves restritas (rk_), com só as permissões necessárias. O n8n informa que não testou a credencial com chave restrita. Por isso, recomendamos testar a chave restrita no modo teste antes de levá-la à produção.

Mantenha a chave só na credencial do n8n. A Stripe orienta não colocá-la em código nem em arquivo versionado e não enviá-la por e-mail ou chat.

Passo 3: montar o fluxo com o Stripe Trigger e ativar

Crie um workflow, adicione o Stripe Trigger, selecione a credencial e escolha os eventos, por exemplo Payment Intent.succeeded. Depois publique o fluxo, o que cria o webhook na Stripe.

Passo 4: copiar o Signature Secret

No painel da Stripe, abra Workbench > Webhooks (em painéis antigos, Developers > Webhooks) e entre no webhook com a descrição "Created by n8n for workflow ID". Em Signing secret, clique em Click to reveal e copie o valor, que começa com whsec_. Cole em Signature Secret na credencial do n8n.

Cada webhook tem o seu segredo, e o do modo teste é diferente do de produção. Com o campo preenchido, o n8n confere o cabeçalho Stripe-Signature e responde 401 a pedido sem assinatura, forjado ou com mais de 5 minutos. O fluxo não roda nesses casos.

Passo 5: gerar um evento de teste

Com o fluxo publicado e o segredo preenchido, provoque no modo teste a ação que gera o evento e confira as execuções no n8n. Se o evento não aparecer, veja os problemas comuns mais abaixo.

Passo 6: repetir em produção com outra credencial

Só depois do teste, repita os passos com a chave de produção em uma segunda credencial: o webhook de produção tem outro whsec_, que vai no Signature Secret dela. Se o fluxo for desativado e reativado, confira no painel se o whsec_ colado continua o do webhook.

Um fluxo que aguenta repetição

Quando a entrega falha, a Stripe tenta de novo: em produção, por até três dias; na área restrita, são três tentativas em poucas horas. A ordem de entrega não é fixa, e o mesmo evento pode chegar mais de uma vez. Guarde o ID do evento e ignore o que já foi processado, para não liberar o mesmo pedido duas vezes.

Exemplos para começar

Um exemplo: pedido pago. Um Stripe Trigger com Payment Intent.succeeded segue para um passo que confere se o ID do evento já foi gravado, depois para a planilha ou o sistema de pedidos e para o aviso à equipe.

Um exemplo: cliente novo. Um Webhook ou formulário alimenta o nó Stripe com Customer e Create, usando Name e, em Additional Fields, Email, e o resultado segue para o CRM. Para uma loja, veja o artigo WooCommerce no n8n: automatize pedidos da loja.

São exemplos de montagem, não fluxos testados. Confira o resultado no seu servidor, no modo teste.

Problemas comuns

  • O Trigger não dispara: a URL não é pública, o HTTPS não é válido ou um proxy redireciona o pedido;
  • Erro 401: o Signature Secret é de outro webhook ou do outro modo, ou o relógio do servidor está fora da tolerância de 5 minutos;
  • Pedido liberado duas vezes: o fluxo não guarda o ID do evento;
  • Erro 429: chamadas demais, como um laço com Return All.

Limites da API

A API da Stripe aceita até 100 requisições por segundo em produção e 25 por segundo na área restrita. Ao passar do limite, ela responde com o erro 429, e recomendamos usar Limit ou o filtro por Email em vez de Return All em conta grande.

Sobre servidores virtuais

Um servidor virtual (VPS) é uma máquina virtual hospedada na nuvem.

Um catálogo de seis planos de VPS está aberto para consulta na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja

Perguntas frequentes

O nó Stripe do n8n cria cobrança por Pix ou boleto?

Não. O nó não tem Payment Intent, Checkout Session, Payment Link, Subscription, Invoice nem Refund. Essas ações passam pelo HTTP Request com a credencial da Stripe.

O Stripe Trigger é seguro sem configurar nada?

Não. Sem o Signature Secret, o nó não verifica a assinatura, e quem tiver a URL consegue mandar evento falso. Preencha o campo com o whsec_ do webhook.

A Stripe entrega o evento uma vez só e na ordem?

Não. O mesmo evento pode chegar mais de uma vez e fora de ordem, por isso o fluxo deve guardar o ID do evento.

Esta resposta lhe foi útil?

Artigos Relacionados