Adicione o nó do PayPal ao seu fluxo no Canvas, configure seus inputs e teste pagamentos em Sandbox.
Uma vez conectada a integração, o nó do PayPal fica disponível no Canvas e permite criar experiências de cobrança com WebView incorporado dentro do fluxo conversacional.
Abra no Brain Studio o fluxo onde você quer incorporar a cobrança com PayPal.
2
Adicionar o nó PayPal
Adicione o PayPal pela barra de ferramentas do Canvas, pelo nó Pagamentos ou pelos provedores de pagamento disponíveis uma vez instalada a integração.O ponto exato pode variar conforme você iniciou a instalação pelo Marketplace, Jelou Agent, nó de pagamentos no Canvas ou template.
3
Conectar o nó ao ponto de cobrança
Conecte o nó do PayPal depois que o fluxo já tiver o valor, os dados do comprador e a confirmação da compra.
4
Abrir o painel de configuração
Selecione o nó para abrir o painel lateral direito, preencher os inputs e revisar as saídas disponíveis.
Nó PayPal com o painel lateral de configuração aberto
Permite definir a mensagem que acompanha o botão de pagamento na conversa.Se ativado, habilita Header, Body e Footer quando estiverem disponíveis na sua versão do nó.
Título da mensagem do botão de pagamento.Aparece quando Personalizar textos do botão de pagamento está ativo e o campo está disponível na sua versão do nó.
Texto principal da mensagem do botão de pagamento.Aparece quando Personalizar textos do botão de pagamento está ativo e o campo está disponível na sua versão do nó.
Define se a compra inclui um produto físico que exige dados de envio.Se estiver em Sim, o nó exige preencher os campos de envio.
Se estiver em Não, esses campos não são obrigatórios.Use Sim apenas quando a compra incluir um produto físico que deva ser enviado.
Se você vende serviços, produtos digitais ou cobranças sem envio físico, selecione Não.
Email do comprador que usará o checkout.Em Sandbox, deve ser o email de uma conta Sandbox Personal do PayPal.
Em produção, use o email real do comprador.
O bloco Ambiente mostra se o PayPal opera em Desenvolvimento ou Produção.Se a integração estiver em Desenvolvimento, a partir daqui você pode iniciar o fluxo para Passar para produção.Se a integração estiver em Produção, o bloco reflete que o PayPal já opera com credenciais produtivas.
Não passe para produção sem ter credenciais Live e webhook Live configurados no PayPal.
Define o nome da variável onde o Brain Studio salvará o JSON completo de resposta do nó.
Use para rastreabilidade, validações posteriores ou decisões do fluxo.
Pagamento bem-sucedido
É acionado quando o PayPal confirma que o pagamento/captura foi concluído corretamente.Recomendações:
confirmar o pedido
emitir comprovante ou notificação
atualizar o status da compra nos seus sistemas
Pagamento pendente
É acionado quando a transação fica em status pendente.Recomendações:
informar o usuário que o pagamento está em revisão/processo
evitar criar uma segunda cobrança enquanto o status é resolvido
Mensagem de pagamento enviada
É acionado quando a mensagem com o botão de pagamento é enviada corretamente na conversa.Esta saída não confirma o pagamento. Apenas indica que a mensagem com o botão de pagamento foi enviada corretamente na conversa.Você pode conectar esta saída a um AI Agent de suporte pós-envio da mensagem de pagamento para auxiliar o usuário enquanto ele decide abrir o checkout ou se tiver dúvidas antes de pagar.Recomendações:
resolver dúvidas sobre como abrir o botão de pagamento
ajudar se o WebView não carregar ou o usuário não entender o passo
evitar criar uma nova cobrança sem contexto
não confirmar pagamentos a partir desta saída
Exemplo de prompt (referencial):
Atue como "Suporte de Pagamento", um assistente breve para ajudar o usuário depois de receber uma mensagem com botão de pagamento dentro do WhatsApp.Contexto:O usuário acabou de receber uma mensagem com botão de pagamento para abrir um checkout em WebView. Seu papel é responder dúvidas simples antes que o usuário complete o pagamento.────────────────────INTERRUPÇÃO IMEDIATA────────────────────Se a última mensagem ou evento recebido contiver sinais de resultado de pagamento, NÃO responda.Sinais de resultado de pagamento:- pagamento bem-sucedido, pagamento aprovado, pagamento concluído- pagamento pendente- pagamento falhou, rejeitado, recusado ou negado- erro de pagamento- confirmação automática do provedor- recibo, comprovante, número de operação, transaction ID, payment ID- mensagens com estrutura de comprovante, valores, método de pagamento ou status finalQuando detectar qualquer um desses sinais, interrompa sua execução imediatamente. O resultado do pagamento deve ser tratado pelas saídas oficiais do nó de pagamento, não por este agente.────────────────────COMPORTAMENTO────────────────────- Se o usuário não fez uma pergunta nem relatou um problema, não responda.- Se o usuário tiver uma dúvida, responda de forma breve, clara e útil.- Não confirme pagamentos.- Não invente status de pagamento.- Não recalcule valores.- Não prometa estornos, aprovações, reembolsos nem prazos de liquidação.- Não gere novos links nem novas cobranças.- Se o usuário precisar de ajuda humana, indique que pode aguardar o suporte ou continuar pelo canal definido pelo fluxo.────────────────────O QUE VOCÊ PODE RESPONDER────────────────────Você pode ajudar com:- como abrir o botão de pagamento- o que fazer se o WebView não carregar- o que fazer se o usuário fechou o checkout- dúvidas básicas sobre preencher o formulário de pagamento- orientação geral se o pagamento aparecer pendente ou rejeitado, sem confirmar o status────────────────────RESPOSTAS SUGERIDAS────────────────────Se o usuário perguntar como pagar:"Abra o botão de pagamento e siga as instruções do checkout. Quando terminar, volte a esta conversa."Se o WebView não carregar:"Tente abrir o botão novamente e verifique sua conexão. Se o problema continuar, tente mais tarde ou peça ajuda neste mesmo chat."Se o usuário disser que o pagamento foi rejeitado:"Você pode revisar os dados inseridos e tentar novamente. Se o problema continuar, use outro método de pagamento ou solicite ajuda por este canal."Se o usuário disser que já pagou:Não confirme o pagamento. Não responda se a mensagem parecer um resultado automático ou comprovante. Se for apenas uma frase do usuário, responda:"Obrigado. Vamos aguardar a confirmação do pagamento para continuar."────────────────────ENCERRAMENTO────────────────────Se o usuário disser que não precisa mais de ajuda, responda breve:"Perfeito. Se precisar de algo mais, estarei por aqui."
Pagamento falhou
É acionado quando o pagamento falha, é rejeitado, negado ou não é concluído.Recomendações:
permitir nova tentativa controlada
oferecer rota de suporte ou um caminho alternativo
Erro
É acionado em caso de erros técnicos, erros do provedor ou falhas de comunicação durante a criação ou o processamento do pagamento.Recomendações:
registrar o erro
exibir mensagem de contingência
tentar novamente de forma controlada e escalar caso persista
Se o PayPal estiver conectado com credenciais de desenvolvimento/Sandbox, o checkout deve ser concluído com uma conta compradora de teste do PayPal.A conta Personal representa o comprador e a conta Business representa o comércio em testes.
PayPal Sandbox: usar uma conta Personal para testar pagamentos
1
Abrir Sandbox Accounts
No PayPal Developer Dashboard, vá em Testing Tools → Sandbox Accounts.
2
Selecionar uma conta Personal
Escolha uma conta Personal de Sandbox e pegue o email.Esse email será o comprador de teste.
3
Revisar ou alterar a senha
Abra os detalhes da conta Personal e use Change password se precisar atualizá-la.Para facilitar testes internos, você pode definir uma senha temporária conhecida pelo seu time de QA.
Não use essa senha em contas reais nem em produção.
4
Verificar o ambiente de desenvolvimento
Na aba Avançado, confirme se o PayPal está operando em Desenvolvimento antes de executar o teste.
5
Configurar o Email do comprador no nó
No nó do PayPal, use o email da conta Sandbox Personal em Email do comprador ou mapeie-o a partir de uma variável de teste.
6
Testar pelo WhatsApp
Dispare o fluxo pelo WhatsApp, abra o checkout WebView do PayPal e faça login com a conta Sandbox Personal.
Checkout do PayPal no WhatsApp usando uma conta Sandbox Personal
7
Validar a saída do fluxo
Verifique por qual saída o fluxo continua:
Pagamento bem-sucedido
Pagamento pendente
Pagamento falhou
Erro
Em Sandbox, o pagamento é fictício e não move dinheiro real.
Se o PayPal foi instalado com credenciais de desenvolvimento/Sandbox, você pode iniciar a passagem para produção pela aba Avançado do nó PayPal no Canvas ou pela página de PayPal no Marketplace.Em ambos os casos, é aberto o mesmo modal para inserir credenciais produtivas e confirmar a configuração correspondente.Antes de operar com pagamentos reais:
Garanta que você tem credenciais Live e webhook Live corretamente configurados.
Se você instalou o PayPal com credenciais Sandbox/desenvolvimento, teste com uma conta compradora Sandbox.Se instalou o PayPal com credenciais Live/produção, use dados reais de comprador.
O Email do comprador é crítico em Sandbox
Em testes, o campo Email do comprador deve pertencer a uma conta Sandbox Personal do PayPal.Se usar um email real em Sandbox, o checkout pode falhar ou não continuar pela saída esperada.
Evite pagamentos duplicados
Em cenários pendentes ou de falha, informe com clareza o usuário antes de iniciar uma nova tentativa de cobrança.Mantenha uma lógica de nova tentativa controlada para evitar cobranças repetidas.
Webhooks e status do pagamento
O status final do pagamento depende dos webhooks do PayPal configurados no mesmo ambiente das credenciais usadas pelo nó.
