Stripe no n8n: automatize cobranças e pagamentos
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

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.