> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Uso e configuração
> Adicione o nó do Wompi ao seu fluxo no Canvas, configure seus inputs e teste pagamentos em Sandbox.
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** dentro do fluxo conversacional.
Se você ainda não instalou a integração, siga primeiro [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/wompi/conectar-no-brain-studio).
***
## Adicionar o nó ao Canvas
Abra no Brain Studio o fluxo onde você quer incorporar a cobrança com 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.
Conecte o nó do Wompi depois que o fluxo já tiver o valor, os dados do comprador e a confirmação da compra.
Selecione o nó para abrir o painel lateral direito, preencher os **inputs** e revisar as **saídas** disponíveis.
***
## Configurar o nó
### Dados do pagamento
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ó.
Texto de fechamento 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 descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.
Valor sobre o qual incide o IVA.
Valor isento de impostos. Se não se aplicar, use `0`.
Nome completo do comprador. Idealmente, deve vir de uma variável capturada anteriormente no fluxo.
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.
### 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.
Indica que o checkout do Wompi é aberto como **WebView incorporado** dentro da experiência conversacional.
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.
Define a moeda da cobrança.
Para o Wompi Colômbia, normalmente você usará `COP`.
Define a porcentagem de IVA aplicada à operação de cobrança.
Campo opcional para salvar uma referência interna como ID do pedido, sequencial, user ID ou booking ID.
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.
É acionado quando o Wompi confirma que a transação foi aprovada.
Recomendações:
* confirmar o pedido
* emitir comprovante ou atualizar o status em sistemas externos
É acionado quando a transação fica em processo ou requer confirmação posterior.
Recomendações:
* informar o usuário com clareza
* evitar criar uma segunda cobrança enquanto o status é resolvido
* aguardar a atualização por evento, quando aplicável
É 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):**
```txt theme={null}
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 final
Quando 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 será direcionado conforme o fluxo de suporte definido pelo comércio.
────────────────────
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."
```
É acionado quando a transação foi rejeitada, recusada, negada ou não foi concluída.
Recomendações:
* permitir nova tentativa controlada
* oferecer suporte ou um caminho alternativo
É 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
***
## 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.
Verifique se o Wompi está instalado com credenciais que tenham os prefixos `pub_test_`, `prv_test_`, `test_events_` e `test_integrity_`.
Na aba **Avançado**, verifique se o ambiente corresponde a desenvolvimento/teste.
Use um email e nome de teste ou controlado nos campos **Email do comprador** e **Nome completo do comprador**.
Dispare o fluxo pelo WhatsApp, abra o checkout WebView do Wompi e selecione um meio de pagamento de teste.
Verifique por qual saída o fluxo continua:
* **Pagamento bem-sucedido**
* **Pagamento pendente**
* **Pagamento falhou**
* **Erro**
***
## 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](https://docs.wompi.co/docs/colombia/datos-de-prueba-en-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](/pt/guias/integracoes/pagamentos/provedores/wompi/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.
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
Revise a disponibilidade, moeda, meios de pagamento e considerações comerciais do Wompi.