Nó Stripe

O nó de workflow Stripe cria uma Checkout Session via API REST do Stripe. Use-o para gerar uma URL de página de pagamento hospedada e enviá-la aos clientes no WhatsApp, e-mail ou qualquer canal da sua automação.

ID do nó no editor: stripe_checkout
Endpoint da API: POST https://api.stripe.com/v1/checkout/sessions

O que faz

• Chama a API de Checkout Sessions do Stripe com os itens de linha, modo e URLs de redirecionamento que você configurar
• Retorna o id da sessão, a url de checkout hospedada e o status
• Suporta pagamentos únicos (modo payment) e assinaturas (modo subscription)
• Autentica com sua Secret key do Stripe (sk_test_... ou sk_live_...)

Pré-requisitos

1. Uma conta Stripe
2. Secret key em Developers → API keys no Stripe Dashboard
3. Chave de integração stripe_secret_key salva em Configurações → Chaves de API

Para um guia completo de configuração da conta, consulte Como integrar o Stripe.

Como configurar

Etapa 1 — Adicionar o nó

1. Abra Automações e edite seu workflow
2. Na paleta, abra a categoria Payments
3. Arraste Stripe para o canvas
4. Conecte-o após o gatilho ou nós de preparação de dados

Etapa 2 — Definir credenciais de integração

1. Acesse Configurações → Chaves de API
2. Em Chaves de integração, adicione:
   • Nome: stripe_secret_key
   • Valor: sua Secret key do Stripe (sk_test_... para sandbox, sk_live_... para produção)
3. Salve

O nó envia Authorization: Bearer {{stripe_secret_key}} automaticamente.

Etapa 3 — Configurar os campos do nó

Clique duas vezes no nó Stripe e preencha:

Exemplo — produto único (BRL):

[
  {
    "price_data": {
      "currency": "brl",
      "product_data": { "name": "Consultation — {{contact.name}}" },
      "unit_amount": 15000
    },
    "quantity": 1
  }
]

Exemplo — usando um Stripe Price ID:

[{ "price": "price_1ABC123", "quantity": 1 }]

Todos os campos JSON suportam variáveis de workflow, por exemplo {{variables.product_name}} ou {{trigger.body.amount}}.

Etapa 4 — Usar a URL de checkout

Adicione um nó Send message (WhatsWave) após o Stripe e inclua o link de pagamento:

Hi {{contact.name}}! Complete your payment here: {{stripe_1.url}}

Substitua stripe_1 pelo ID do seu nó no canvas.

Etapa 5 — Testar e ativar

1. Use chaves do modo de teste do Stripe e cartões de teste
2. Execute o workflow manualmente ou dispare-o com dados de teste
3. Abra o Histórico de execuções e confirme que url está presente na saída do nó
4. Ative o workflow quando estiver pronto; troque para chaves live em produção

Saídas do nó

Referencie em nós posteriores: {{stripe_1.url}}, {{input.url}} (se o Stripe for o nó anterior).

Confirmação de pagamento (webhook)

O nó Stripe cria a sessão; ele não escuta a conclusão do pagamento. Para reagir quando o pagamento for bem-sucedido:

1. Crie um segundo workflow com gatilho Webhook
2. No Stripe Dashboard → Developers → Webhooks, adicione um endpoint apontando para sua URL de webhook do WhatsWave
3. Inscreva-se em checkout.session.completed (e opcionalmente invoice.paid para assinaturas)
4. No workflow de confirmação, envie uma mensagem de agradecimento no WhatsApp ou atualize o CRM

Consulte Como integrar o Stripe — seção de webhook e Webhooks recebidos.

Dicas e boas práticas

• Sempre teste no sandbox com sk_test_... antes de trocar para chaves live
• Armazene a Secret key apenas em Chaves de integração — nunca em rótulos de nós ou mensagens de chat
• Use Success URL com parâmetro de query (por exemplo ?session_id={CHECKOUT_SESSION_ID}) se seu site precisar verificar a sessão
• Para assinaturas, crie Products e Prices no Stripe primeiro e depois referencie IDs de price nos line items
• Combine com nós Condition para ramificar com base em {{input.status}} ao encadear múltiplas chamadas de API
• Registre o id da sessão em um campo personalizado do card do CRM para conciliação

Exemplos de casos de uso

Follow-up de vendas após card do CRM ir para "Proposta enviada"

1. Gatilho de CRM ou Webhook quando o card entra na coluna
2. Stripe — criar checkout com o valor cotado
3. Enviar WhatsApp — "Sua proposta está pronta: {{stripe_1.url}}"

Onboarding de assinatura

1. Webhook do formulário de cadastro com e-mail do cliente
2. Stripe — modo subscription, line item com Price ID recorrente
3. Enviar WhatsApp — link de pagamento
4. Workflow de webhook separado em checkout.session.completed — mensagem de boas-vindas + atualização do CRM

Checkout assistido por agente

1. Agente de IA qualifica o lead e define variables.checkout_amount
2. Nó Variable formata o valor em centavos
3. Stripe — line items dinâmicos a partir de variáveis
4. Send message com URL de checkout

FAQ

Por que o nó retorna 401 Unauthorized?
A Secret key está ausente, incorreta ou não se chama stripe_secret_key. Verifique a chave em Configurações → Chaves de API e confirme que começa com sk_.

Posso usar Publishable key (pk_) em vez de Secret key?
Não. A criação de Checkout Session exige a Secret key no lado do servidor.

Por que url está vazio na saída?
Verifique os logs de execução para detalhes do erro do Stripe. Causas comuns: JSON inválido em line items, valor abaixo do mínimo ou moeda ausente.

Este nó cobra o cartão diretamente?
Não. Ele cria uma Checkout Session — o cliente conclui o pagamento na página hospedada do Stripe.

Como ofereço PIX ou Boleto no Stripe?
Ative esses métodos de pagamento no Stripe Dashboard para o Brasil; eles aparecem no Checkout quando configurados na sua conta Stripe.

Qual a diferença entre este nó e o nó HTTP?
Este nó pré-configura o endpoint do Stripe, o header de autenticação e os campos comuns. Use o nó HTTP genérico apenas para endpoints do Stripe não suportados.

Referência da API

Relacionados

• Visão geral de pagamentos
• Como integrar o Stripe
• Variáveis em workflows