Pular para o conteúdo principal
Após a integração ser conectada no Marketplace, o Stripe fica disponível no seu workspace para uso dentro dos seus fluxos e AI Agents.
É a primeira vez que você implementa uma cobrança? Siga primeiro o guia Tutorial: Implementando sua primeira cobrança pelo WhatsApp, que guia você passo a passo do zero até a produção.

​
Três modalidades de uso

WebView Embutido

Botão de pagamento com checkout em WebView

Nativo no chat

Captura de cartão na conversa

Ferramentas avançadas / MCP

Acesso completo à API via MCP
Esta página abrange as três modalidades. Use os cards para ir diretamente à que você precisa.

​
WebView Embutido

Esta é a modalidade recomendada para começar. O usuário recebe um link ou botão de pagamento que abre o checkout do Stripe em um WebView dentro do WhatsApp.

​
Adicionar o nó ao Canvas

1

Localize a integração no Marketplace

Na barra lateral esquerda do Brain Studio, abra a pasta Marketplace.Se a integração estiver corretamente conectada, você verá o Stripe listado como provedor disponível.
Stripe visível na pasta Marketplace dentro da barra lateral do Brain Studio
2

Arraste o nó para o Canvas

Arraste o Stripe da barra lateral para o seu fluxo no Canvas.Ao soltá-lo, o bloco do nó será criado com suas saídas disponíveis.
Nó do Stripe adicionado ao Canvas mostrando suas saídas
3

Abra o painel de configuração

Selecione o nó no Canvas para abrir seu painel de configuração no lado direito.A partir daí você pode preencher as entradas e revisar as saídas disponíveis.

​
Configurar o nó no Canvas

​
Salvar resultado como
string
Define o nome da variável onde o Brain Studio armazenará a resposta JSON completa do nó.
Útil se você quiser usar a resposta posteriormente (logs, validações, rastreabilidade ou decisões do fluxo).
​
Tipo de pagamento
string
padrão:"payment"
Define o tipo de cobrança.Valores disponíveis: payment (pagamento único), subscription (assinatura)
Se nada for selecionado, payment será utilizado.
​
Ambiente
string
obrigatório
Define o ambiente de execução do pagamento.Valores disponíveis: Test, Production
Deve corresponder à API Key usada para instalar o Stripe no Marketplace (Teste vs Produção).
​
Expiração do botão de pagamento [minutos]
number
Define por quanto tempo o botão de pagamento é válido a partir do momento em que é enviado ao usuário.Valores disponíveis: 10, 20, 30, 60
​
Moeda
string
obrigatório
Moeda para a cobrança.
A moeda disponível depende do país e da configuração da conta Stripe conectada.
​
Motivo do pagamento
string
obrigatório
Texto descritivo para a cobrança (por exemplo, número do pedido ou descrição do produto/serviço).
Idealmente use com variáveis do fluxo para que fique alinhado com o contexto da conversa.
​
Metadados do pagamento
string
Informações adicionais para rastreabilidade ou referência interna.
Você pode usá-lo para correlação com seu pedido, reconciliação ou auditoria de pagamentos.
​
E-mail do comprador
string
obrigatório
O e-mail do comprador. Deve ter sido coletado anteriormente no fluxo e passado aqui como variável.
​
Personalizar texto do botão de pagamento
boolean
padrão:"false"
Se você selecionar Sim, campos adicionais são habilitados para personalizar a mensagem que acompanha o botão de pagamento.Campos habilitados quando ativado:
  • Cabeçalho (obrigatório)
  • Corpo (obrigatório)
  • Rodapé (obrigatório)
Quando esta opção está ativa, você pode modificar completamente a mensagem que o usuário verá antes de abrir o checkout.
​
Cabeçalho
string
Título da mensagem que acompanha o botão de pagamento.
​
Corpo
string
Texto principal da mensagem que acompanha o botão de pagamento.
​
Rodapé
string
Texto de fechamento ou aviso legal da mensagem que acompanha o botão de pagamento.

​
Nativo no chat

O Stripe também pode operar com uma experiência nativa de pagamento com cartão dentro do chat.
Esta modalidade requer habilitação especial. Se você quiser ativá-la, entre em contato conosco em [email protected].

Pagamentos – Pagamento com cartão (documentação técnica)

Referência técnica para implementar a experiência nativa.

​
Ferramentas avançadas / MCP

Além do uso no Canvas via ferramentas nativas, o Stripe expõe um conjunto de ferramentas avançadas que podem ser usadas em implementações mais técnicas ou fluxos personalizados. Essas ferramentas permitem interagir diretamente com os serviços do Stripe a partir do seu fluxo.
Cria um novo registro de cliente na sua conta Stripe.Os clientes podem ser associados a:
  • Métodos de pagamento
  • Assinaturas
  • Faturas
Útil para:
  • Registrar um cliente antes de processar pagamentos
  • Implementar modelos de assinatura
  • Gerenciar histórico de pagamentos por cliente
Cria um PaymentIntent no Stripe.
  • O valor é enviado em centavos (exemplo: 15000 = $150.00)
  • Retorna:
    • client_secret
    • payment_intent_id
Útil para:
  • Iniciar um pagamento de um cliente
  • Integrações personalizadas
  • Controle avançado do ciclo de pagamento
Obtém o status atual de um pagamento por:
  • PaymentIntent ID
  • Charge ID
Retorna detalhes como:
  • Status
  • Valor
  • Método de pagamento
  • URL do recibo
Útil para:
  • Verificar se um cliente concluiu o pagamento
  • Implementar validações adicionais
  • Consultas pós-transação
Lista transações de saldo recentes na conta Stripe:
  • Cobranças
  • Reembolsos
  • Transferências
  • Pagamentos
Suporta:
  • Filtro por data (timestamps Unix)
  • Paginação
Útil para:
  • Revisar atividade recente
  • Reconciliação contábil
  • Auditoria de movimentos
Processa um reembolso total ou parcial de uma cobrança ou PaymentIntent.Opções disponíveis:
  • Valor específico (para reembolsos parciais)
  • Motivo (duplicate, fraudulent, requested_by_customer)
Os reembolsos geralmente aparecem na conta do cliente em 5 a 10 dias úteis.Útil para:
  • Gestão pós-venda
  • Cancelamentos
  • Políticas de devolução