Pular para o conteúdo principal
Após conectar a integração no Marketplace com o Access Token, o Store ID, o IVA e a Moeda, o nó do Payphone fica disponível no seu workspace para usar dentro dos seus fluxos no Canvas.

Adicionar o nó ao Canvas

1

Localizar a integração no Marketplace

No painel lateral esquerdo do Brain Studio, abra a pasta Marketplace.Se a integração estiver corretamente conectada, você verá o Payphone listado como provedor disponível.
Payphone visível na pasta Marketplace dentro do painel lateral do Brain Studio
2

Arrastar o nó para o Canvas

Arraste o Payphone do painel lateral para o seu fluxo no Canvas.Ao soltá-lo, o bloco do nó será criado com seus outputs disponíveis.
3

Abrir o painel de configuração

Selecione o nó no Canvas para abrir o seu painel de configuração no lado direito.A partir daí você poderá preencher os inputs e revisar os outputs disponíveis.
Painel lateral de configuração do nó do Payphone exibindo todos os campos disponíveis

Configurar o nó

Salvar resultado como
string
Define o nome da variável onde o Brain Studio armazenará o JSON completo de resposta do nó.
Útil se você quiser usar a resposta posteriormente (logs, validações, rastreabilidade ou decisões do fluxo).
Modalidade de cobrança [pagamento único por padrão]
string
padrão:"payment"
Define a modalidade de cobrança.Para esta integração, o valor padrão é payment.
Ambiente
string
obrigatório
Define o ambiente no qual a cobrança será executada.Valores disponíveis: DEV, PROD
O valor configurado aqui deve corresponder ao ambiente selecionado na aplicação dentro do Payphone Developer.Se você configurar DEV no nó, mas a aplicação estiver em produção, ou vice-versa, o fluxo pode falhar ou gerar resultados inconsistentes.
Expiração do botão de pagamento [minutos]
number
Define por quanto tempo o botão de pagamento permanece válido a partir do momento em que é enviado ao usuário.Valores disponíveis: 10, 20, 30, 60
Motivo do pagamento
string
obrigatório
Texto descritivo da cobrança.Exemplos:
  • número do pedido
  • nome do produto ou serviço
  • referência interna do pagamento
Valor sujeito a impostos
number
obrigatório
Informe o valor a cobrar que está sujeito a impostos.Aceita valores numéricos em dólares, incluindo decimais quando aplicável.
Valor isento de impostos
number
obrigatório
Informe o valor a cobrar que está isento de impostos.Aceita valores numéricos em dólares, incluindo decimais quando aplicável.
Metadados do pagamento
string
Informações adicionais para rastreabilidade ou referência interna.
Você pode usar este campo para correlacionar o pagamento com um pedido, uma cotação ou uma operação de conciliação.
Personalizar textos 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 ao ativar:
  • Header (obrigatório)
  • Body (obrigatório)
  • Footer (obrigatório)
Quando esta opção está ativa, você pode modificar completamente a mensagem que o usuário verá antes de abrir o checkout.
Header
string
Título da mensagem que acompanha o botão de pagamento.
Body
string
Texto principal da mensagem que acompanha o botão de pagamento.

Considerações importantes

Se você configurar o nó em DEV, a aplicação no Payphone Developer também deve estar em Teste.Se você configurar o nó em PROD, a aplicação no Payphone Developer deve estar em Produção.
Quando um pagamento fica inicialmente pendente, o agente informa o usuário sobre esse status por meio da mensagem correspondente.Se o Payphone atualizar o resultado posteriormente, o fluxo continua pelo output final correspondente:
  • Pagamento bem-sucedido
  • Pagamento com falha
O estado pendente não é exposto como um output independente do nó.