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.
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 no Marketplace (barra lateral)
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.
Ferramenta Stripe com saídas disponíveis
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.
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.
Texto de fechamento ou aviso legal da mensagem que acompanha o botão de pagamento.
Pagamento bem-sucedido
Ativado quando o provedor confirma que a transação foi processada com sucesso.Este é o ponto oficial de confirmação de pagamento dentro do fluxo.Exemplos de uso:
Emitir nota fiscal
Ativar assinatura
Liberar produto ou serviço
Atualizar status do pedido em sistema externo
Pagamento pendente
Ativado quando o provedor informa que a transação está em estado pendente.Isso pode depender do método de pagamento e de validações adicionais.Atualmente, monitorar a mudança de estado de pendente para aprovado requer lógica adicional (por exemplo, um webhook ou verificação de status subsequente).
Pagamento falhou
Ativado quando a transação foi rejeitada ou recusada.Recomendações:
Informar o usuário
Permitir nova tentativa
Reutilizar o mesmo nó do Stripe
Erro HTTP
Ativado quando ocorre um erro de comunicação com o provedor (timeout, rede ou resposta inválida).
Código de erro
Ativado quando o provedor retorna um código de erro interno durante a criação ou processamento do pagamento.
Entrega do CTA bem-sucedida
Ativado quando o botão de pagamento foi enviado com sucesso na conversa.Indica que a mensagem com o botão foi exibida com sucesso no WhatsApp.Pode ser conectado a um AI Agent que auxilia o usuário enquanto ele decide concluir o pagamento.Exemplo de prompt (referência):
Act as a payment assistant.The user has just received a button to complete their payment.Do not send proactive messages.Only respond if the user asks a question.Help them understand how to complete the payment and resolve related questions.
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.
Ferramentas disponíveis
Criar Cliente
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
Criar Payment Intent
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
Consultar status do 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
Listar transações
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
Processar reembolso
Processa um reembolso total ou parcial de uma cobrança ou PaymentIntent.Opções disponíveis:
