Skip to main content
Com a integração conectada, o nó Payphone fica disponível no Canvas e permite criar experiências de cobrança com WebView embarcado dentro do fluxo conversacional.
Se ainda não instalou a integração, comece por Conectar no Brain Studio.

​
Adicionar o nó ao Canvas

1

Abrir seu fluxo no Canvas

Abra no Brain Studio o fluxo onde deseja incorporar a cobrança com Payphone.
2

Adicionar o nó Payphone

Adicione Payphone pela barra de ferramentas do Canvas, pelo nó Pagamentos ou pelos provedores disponíveis após a instalaçã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ó Payphone depois que o fluxo já tiver valor, dados do comprador e confirmação da compra.
4

Abrir o painel de configuração

Selecione o nó para abrir o painel lateral direito. Complete as abas Dados do pagamento e Avançado e revise as saídas no nó do Canvas.Se faltarem campos obrigatórios, o nó exibe Configuração incompleta. Revise os campos do nó. e o badge de ambiente (Desenvolvimento ou Produção).

​
Configurar o nó

Nó Payphone no Canvas com aba Dados do pagamento aberta no painel lateral

Aba Dados do pagamento: personalização, valores e dados do comprador

​
boolean
padrão:"false"
Ative para definir as mensagens que acompanham seu botão de pagamento.Quando ativo, habilita os campos Header, Body e Footer.
​
string
Título da mensagem do botão de pagamento.Exibido quando Personalização está ativa.
​
string
Texto principal da mensagem do botão de pagamento.Exibido quando Personalização está ativa.
​
string
obrigatório
Texto descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.
​
number
obrigatório
Valor sobre o qual incide IVA. Apenas números, em dólares (USD).
​
number
obrigatório
Valor isento de impostos. Apenas números. Se não aplicável, use 0.
​
string
obrigatório
Nome do comprador no checkout.Em Desenvolvimento, pode usar dados de teste. Em Produção, use o nome real capturado no fluxo.
​
string
obrigatório
Sobrenome do comprador no checkout.Em Desenvolvimento, pode usar dados de teste. Em Produção, use o sobrenome real capturado no fluxo.
​
string
obrigatório
Email do comprador no checkout.Em Produção, use o email real capturado no fluxo.

​
Saídas do nó

As saídas aparecem no nó Payphone no Canvas. Conecte-as conforme o resultado que deseja tratar no fluxo.
Ativada quando o Payphone confirma que a transação foi aprovada.Recomendações:
  • confirmar o pedido
  • emitir comprovante ou notificação
  • atualizar status da compra nos seus sistemas
Ativada quando a transação fica em processamento ou requer confirmação posterior.Recomendações:
  • informar o usuário com clareza
  • evitar criar uma segunda cobrança enquanto o status não for resolvido
Ativada quando a mensagem com botão de pagamento é enviada com sucesso na conversa.Esta saída não confirma o pagamento. Indica apenas que o botão foi enviado no WhatsApp.Você pode conectar esta saída a um AI Agent de suporte pós-envio da mensagem de pagamento para assistir o usuário enquanto decide abrir o checkout ou se tiver dúvidas antes de pagar.Recomendações:
  • responder dúvidas sobre como abrir o botão de pagamento
  • ajudar se o WebView não carregar
  • não confirmar pagamentos a partir desta saída
Ativada quando a transação foi rejeitada, recusada ou não concluída.Recomendações:
  • permitir nova tentativa controlada
  • oferecer suporte ou caminho alternativo
Ativada em erros técnicos, erros do provedor ou falhas de comunicação durante criação ou processamento do pagamento.Recomendações:
  • registrar o erro
  • exibir mensagem de contingência
  • tentar novamente de forma controlada e escalar se persistir

​
Testar pagamentos

Se o Payphone estiver conectado em ambiente de teste, valide o fluxo antes de passar para produção.
No modo teste, a cobrança depende da aplicação no Payphone Developer estar em Teste e do nó em Desenvolvimento. O Payphone usa as mesmas credenciais nos dois cenários.
1

Confirmar ambiente no Brain Studio

Verifique se a integração foi instalada em ambiente de teste e se o nó mostra Desenvolvimento na aba Avançado.
2

Alinhar Payphone Developer

No portal Payphone Developer, selecione Teste no seletor de ambiente da aplicação.Revise Obtendo credenciais — Modo de teste e produção.
3

Completar dados do comprador

Em Dados do pagamento, preencha Nome(s) do comprador, Sobrenome(s) do comprador e Email do comprador com dados de teste ou variáveis do fluxo.
4

Testar pelo WhatsApp

Dispare o fluxo pelo WhatsApp, abra o checkout WebView do Payphone e complete um pagamento de teste.
5

Validar a saída do fluxo

Verifique por qual saída o fluxo continua:
  • Mensagem de pagamento enviada (apenas envio do botão)
  • Pagamento bem-sucedido
  • Pagamento pendente
  • Pagamento falhou
  • Erro

​
Passar para produção

Se instalou o Payphone em ambiente de teste, pode iniciar a passagem para produção pela aba Avançado do nó Payphone no Canvas ou pela página Payphone no Marketplace. O modal pede apenas confirmação: as credenciais atuais são mantidas. Detalhes em Conectar no Brain Studio — Passar para produção. Antes de operar com pagamentos reais:
  • Altere a aplicação no Payphone Developer para Produção.
  • Confirme se Percentual de IVA e Moeda (USD) no nó estão coerentes com sua operação.
  • Substitua dados de teste por dados reais do comprador (nome, sobrenome, email).
  • Lembre-se do custo de $0.10 USD por transação em produção, descontado do saldo no Brain Studio.
  • Execute um teste real de valor baixo antes de escalar.

​
Considerações importantes

Para a cobrança funcionar corretamente, alinhe:
  1. Ambiente da instalação no Brain Studio (teste ou produção)
  2. Ambiente do nó (Desenvolvimento ou Produção)
  3. Seletor Teste / Produção no Payphone Developer
Se um não coincidir, o fluxo pode falhar ou dar resultados inconsistentes.
Token e Store ID não mudam entre teste e produção. Passar para produção no Brain Studio não substitui credenciais; apenas muda o modo de operação.
O Payphone exige nome, sobrenome e email do comprador em Dados do pagamento. Em produção, use dados reais capturados no fluxo.
O IVA aplicado é definido na instalação. O Percentual de IVA do nó deve ser coerente. A moeda é USD.
Se um pagamento ficar pendente, informe o usuário e evite iniciar uma segunda cobrança até resolver o status. O fluxo continuará por Pagamento bem-sucedido ou Pagamento falhou quando o Payphone atualizar o resultado.

​
Próximo passo

Cobertura e preços

Revise disponibilidade, meios de pagamento e tarifas de referência do Payphone.