Pular para o conteúdo principal
Uma vez conectada a integração, o nó do Wompi fica disponível no Canvas e permite criar experiências de cobrança com WebView incorporado ou confirmação externa dentro do fluxo conversacional.
Se você ainda não instalou a integração, siga primeiro Conectar no Brain Studio.

Adicionar o nó ao Canvas

1

Abrir o seu fluxo no Canvas

Abra no Brain Studio o fluxo onde você quer incorporar a cobrança com Wompi.
2

Adicionar o nó Wompi

Adicione o Wompi 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 Wompi 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ó Wompi no Canvas com o painel lateral de configuração aberto

Nó Wompi com o painel lateral de configuração aberto


Configurar o nó

Dados do pagamento

boolean
padrão:"false"
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ó.
string
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ó.
string
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ó.
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 o IVA.
number
obrigatório
Valor isento de impostos. Se não se aplicar, use 0.
string
obrigatório
Nome completo do comprador. Idealmente, deve vir de uma variável capturada anteriormente no fluxo.Aplica-se quando a Experiência de pagamento é Pagamento WebView.
string
obrigatório
Email do comprador que usará o checkout.Em Sandbox, pode ser um email de teste ou controlado. Em produção, deve ser o email real do comprador.Aplica-se quando a Experiência de pagamento é Pagamento WebView.
string
obrigatório
Define se o titular do pagamento é Pessoa física ou Pessoa jurídica.É obrigatório quando a Experiência de pagamento é Pagamento Confirmação Externa.
string
Nome da pessoa titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa. Se o fluxo não o enviar, o agente conversacional pede diretamente ao pagador.
string
Sobrenome da pessoa titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa.
string
Número da cédula se o titular for pessoa física, ou NIT se for empresa.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa.
string
E-mail do titular do pagamento.Aplica-se quando a Experiência de pagamento é Pagamento Confirmação Externa.
string
Telefone do pagador cadastrado no Nequi.Aplica-se somente quando o pagador escolhe Nequi dentro de Pagamento Confirmação Externa. Se você não o enviar pelo fluxo, o agente solicita diretamente na conversa antes de gerar o pagamento.
Campo Telefone para Nequi no nó Wompi, com o placeholder Telefone do pagador no Nequi

Campo Telefone para Nequi, visível quando o pagamento é feito com Nequi

Painel lateral do nó Wompi na aba Dados do pagamento mostrando Tipo de pessoa, Nome do titular, Sobrenome do titular, Número de documento ou NIT e E-mail

Dados do pagamento com a Experiência de pagamento Confirmação Externa: Tipo de pessoa, Nome do titular, Sobrenome do titular, Número de documento ou NIT e E-mail

Avançado

O bloco Ambiente mostra se o Wompi 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 Wompi já opera com credenciais produtivas.
O ambiente depende das credenciais instaladas. Não passe para produção sem preparar credenciais produtivas e configurar a URL de Eventos correspondente no Wompi.
string
obrigatório
Define como o pagador conclui a transação. Opções disponíveis:
  • Pagamento WebView — abre o checkout do Wompi como WebView incorporado dentro da conversa.
  • Pagamento Confirmação Externa — um agente conversacional guia o pagador para concluir o pagamento com Nequi ou PSE, fora do WhatsApp.
Nó Wompi na aba Avançado mostrando o campo Experiência de pagamento com as opções Pagamento WebView e Pagamento Confirmação Externa

Campo Experiência de pagamento na aba Avançado do nó Wompi

number
Define quanto tempo o botão de pagamento permanece válido depois de enviado.Os valores disponíveis dependem da configuração visível no Brain Studio.
string
obrigatório
Define a moeda da cobrança.Para o Wompi Colômbia, normalmente você usará COP.
number
Define a porcentagem de IVA aplicada à operação de cobrança.
string
Campo opcional para salvar uma referência interna como ID do pedido, sequencial, user ID ou booking ID.
string
Define o nome da variável onde o Brain Studio salvará o JSON completo de resposta do nó.
Útil para rastreabilidade, validações posteriores ou decisões do fluxo.

Como funciona a confirmação externa

Quando você seleciona Pagamento Confirmação Externa em Experiência de pagamento, o nó ativa internamente um agente conversacional que guia o pagador antes de gerar a cobrança.
1

O agente pergunta o método de pagamento

O agente pergunta ao pagador qual método quer usar: PSE ou Nequi.
Conversa de WhatsApp em que o agente do Wompi pergunta se o pagamento será feito com PSE ou Nequi

O agente pergunta o método de pagamento

2

O agente completa os dados faltantes

Se o fluxo não enviar Nome do titular, Sobrenome do titular, Número de documento ou NIT ou E-mail, o agente os solicita na conversa. Com PSE, também pede o tipo de documento e o banco.Se o método escolhido for Nequi e o Telefone para Nequi não tiver sido enviado, o agente o solicita especificamente antes de continuar.
Conversa de WhatsApp em que o agente do Wompi pede o número de telefone para concluir um pagamento com Nequi

O agente pede o telefone associado ao pagamento com Nequi quando falta no fluxo

3

O agente confirma os dados antes de continuar

O agente mostra um resumo com os dados registrados e pede para responder Confirmar para continuar, ou indicar qual dado corrigir. O resumo varia conforme o método escolhido:
  • PSE: método de pagamento, titular, documento, e-mail e banco.
  • Nequi: método de pagamento, titular, documento, e-mail e telefone.
Conversa de WhatsApp com o resumo de dados para um pagamento com PSE e a instrução de responder Confirmar

Resumo de confirmação para um pagamento com PSE

Conversa de WhatsApp com o resumo de dados para um pagamento com Nequi e a instrução de responder Confirmar

Resumo de confirmação para um pagamento com Nequi

4

O pagador conclui o pagamento fora do WhatsApp

Conforme o método escolhido:
  • PSE: o agente entrega um botão Prosseguir com o pagamento que abre um formulário seguro para autorizar a transferência pelo banco escolhido.
  • Nequi: o agente envia a solicitação de pagamento para o app Nequi do pagador, que deve abri-lo e aprovar o pagamento.

Confirmação externa com Wompi

5

O Brain Studio continua o fluxo conforme o resultado

O Wompi notifica o status do pagamento por meio de eventos e o nó continua pela saída correspondente (Pagamento bem-sucedido, Pagamento pendente, Pagamento falhou ou Erro), igual à experiência WebView.
Com Pagamento Confirmação Externa, o pagamento é concluído fora do WhatsApp (no formulário do PSE ou no app Nequi). O nó não abre WebView dentro do chat.

Testar pagamentos em Sandbox

Se o Wompi estiver conectado com credenciais Sandbox, você pode testar o checkout com os dados de teste publicados pelo Wompi.
Em Sandbox, o pagamento é fictício e não move dinheiro real.
1

Confirmar credenciais Sandbox

Verifique se o Wompi está instalado com credenciais que tenham os prefixos pub_test_, prv_test_, test_events_ e test_integrity_.
2

Configurar o nó no ambiente de teste

Na aba Avançado, verifique se o ambiente corresponde a desenvolvimento/teste e confirme a Experiência de pagamento que deseja testar (Pagamento WebView ou Pagamento Confirmação Externa).
3

Preencher dados do comprador

Com Pagamento WebView, use um email e nome de teste ou controlado nos campos Email do comprador e Nome completo do comprador.Com Pagamento Confirmação Externa, escolha o Tipo de pessoa e preencha (ou deixe que o agente solicite) Nome do titular, Sobrenome do titular, Número de documento ou NIT, E-mail e, se usar Nequi, Telefone para Nequi.
4

Testar pelo WhatsApp

Dispare o fluxo pelo WhatsApp.
  • Com Pagamento WebView, abra o checkout do Wompi e selecione um meio de pagamento de teste.
  • Com Pagamento Confirmação Externa, escolha PSE ou Nequi quando o agente perguntar e siga o fluxo até confirmar.
5

Validar a saída do fluxo

Verifique por qual saída o fluxo continua:
  • Pagamento bem-sucedido
  • Pagamento pendente
  • Pagamento falhou
  • Erro
Animação do checkout WebView do Wompi aberto a partir do WhatsApp para concluir um pagamento de teste em Sandbox

Checkout do Wompi no WhatsApp usando dados de teste Sandbox


Dados de teste em Sandbox

Os dados de teste só se aplicam quando a integração está instalada com credenciais Sandbox e o nó é executado no ambiente de teste.
Para testar pagamentos com cartão em Sandbox:
  • Aprovado: 4242 4242 4242 4242
  • Recusado: 4111 1111 1111 1111
Use qualquer data de expiração futura e um CVC de 3 dígitos.Se usar outro cartão, o status final pode ser ERROR.
Para testar pagamentos com Nequi:
  • Aprovado: 3991111111
  • Recusado: 3992222222
Qualquer outro número pode gerar uma transação com status ERROR.
No checkout do Wompi, use os bancos de teste disponíveis:
  • Banco que aprova: gera uma transação aprovada.
  • Banco que recusa: gera uma transação recusada.
O Wompi também publica dados de teste para meios como Botón Bancolombia, Bancolombia QR, Puntos Colombia, DaviPlata, BNPL Bancolombia e outros métodos disponíveis conforme a conta.Consulte a documentação oficial do Wompi sobre dados de teste em Sandbox para revisar o detalhe atualizado.

Passar para produção

Se você instalou o Wompi com credenciais de desenvolvimento/Sandbox, pode iniciar a passagem para produção pela aba Avançado do nó Wompi no Canvas ou pela página de Wompi 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 de Produção completas: chave pública, chave privada, segredo de eventos e segredo de integridade. Confirme também se a URL de Eventos está corretamente configurada no Wompi.
  • Use o fluxo Passar para produção descrito em Conectar no Brain Studio.
  • Substitua no nó qualquer dado de teste por dados reais do fluxo.
  • Em produção, use o email e o nome reais do comprador.
  • Execute um teste real de baixo valor antes de escalar.

Considerações importantes

Se você instalou o Wompi com credenciais Sandbox, teste com dados de teste. Se instalou com credenciais de Produção, use dados reais.
O status final do pagamento depende dos eventos que o Wompi envia para a Jelou. Se a URL de Eventos não estiver configurada no ambiente correto, o fluxo pode não avançar pela saída esperada.
Em cenários pendentes ou de falha, informe com clareza antes de iniciar outra tentativa de cobrança. Mantenha tentativas controladas.
Com Pagamento Confirmação Externa, o pagamento não ocorre dentro do WhatsApp. Seu fluxo deve tratar Pagamento pendente e as saídas finais sem assumir confirmação imediata, assim como com outros provedores de confirmação externa.
Cartões, telefones e bancos de teste só se aplicam em Sandbox. Em produção, o usuário deve usar dados reais.

Próximo passo

Cobertura e preços

Revise a disponibilidade, moeda, meios de pagamento e considerações comerciais do Wompi.