> ## 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 Deuna ao seu fluxo no Canvas e configure seus inputs e outputs.
Após conectar a integração no Marketplace com o **Punto de Venta**, o **Api Key**, o **Api Secret**, o **IVA** e a **Moneda**, o nó do **Deuna** fica disponível no seu workspace para uso dentro dos fluxos no Canvas.
O nó processa o pagamento pelo Deuna e expõe o status final da transação para que o seu fluxo continue com base no resultado.
***
## Adicionar o nó ao Canvas
Na barra lateral esquerda do Brain Studio, abra a pasta **Marketplace**.
Se a integração estiver corretamente conectada, você verá o **Deuna** listado como provedor disponível.
Arraste o **Deuna** da barra lateral para o seu fluxo no Canvas.
Ao soltar, o bloco do nó será criado com os outputs disponíveis.
Selecione o nó no Canvas para abrir o painel de configuração no lado direito.
A partir daí, você pode preencher os **inputs** e revisar os **outputs** disponíveis.
***
## Configurar o nó
Define o nome da variável onde o Brain Studio armazenará a **resposta JSON completa** do nó.
Útil para logs, validações, rastreabilidade ou decisões posteriores no fluxo.
Define a modalidade de cobrança.
Atualmente, apenas o valor `payment` (cobrança única) é suportado.
Define o ambiente no qual a cobrança será executada.
**Valores disponíveis:** `DEV`, `PROD`
O ambiente deve corresponder às credenciais usadas ao conectar o Deuna no Marketplace.
Se você usar credenciais de desenvolvimento com `PROD`, ou vice-versa, o pagamento não será processado corretamente.
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`
Texto descritivo da cobrança.
Exemplos:
* número do pedido
* nome do produto ou serviço
* referência interna do pagamento
Valor da cobrança sujeito a impostos.
Este valor é somado ao valor isento de impostos para calcular o total do pagamento.
Você pode usar `0` se não for aplicável.
Valor da cobrança não sujeito a impostos.
Este valor é somado ao valor tributável para calcular o total do pagamento.
Você pode usar `0` se não for aplicável.
Informações adicionais para rastreabilidade ou referência interna.
Você pode usar este campo para correlacionar o pagamento com um pedido, conciliação ou auditoria.
Se você selecionar **Sim**, campos adicionais serão habilitados para personalizar a mensagem que acompanha o botão de pagamento.
**Campos disponíveis:**
* `Header` (obrigatório)
* `Body` (obrigatório)
* `Footer` (obrigatório)
Permite personalizar completamente a mensagem exibida ao usuário antes de pagar na carteira Deuna.
Título da mensagem que acompanha o botão de pagamento.
Texto principal da mensagem que acompanha o botão de pagamento.
Texto de encerramento ou esclarecimento da mensagem que acompanha o botão de pagamento.
Acionado quando o Deuna confirma que a transação foi processada corretamente.
Este é o ponto oficial de confirmação do pagamento dentro do fluxo.
Exemplos de uso:
* emitir uma nota fiscal
* ativar uma assinatura
* liberar um produto ou serviço
* atualizar o status do pedido em um sistema externo
Acionado quando a transação foi rejeitada ou recusada.
Recomendações:
* informar o usuário
* permitir uma nova tentativa
* redirecionar para outro método de pagamento
Acionado quando o Deuna retorna um código de erro interno durante a criação ou o processamento do pagamento.
Acionado quando ocorre um erro de comunicação com o provedor, como timeout, problema de rede ou resposta inválida.
Acionado quando o botão de pagamento foi enviado corretamente na conversa.
Este output não confirma o pagamento. Indica apenas que o usuário recebeu o CTA e pode continuar o processo na carteira Deuna.
**Recomendação de implementação:**
Conecte este output a um **AI Agent** ou a um bloco de suporte conversacional. Assim, se o usuário tiver dúvidas ou precisar de ajuda durante o pagamento, a conversa não perde a continuidade.
Exemplos de uso:
* responder perguntas sobre o pagamento
* indicar que o usuário deve concluir a transação na carteira Deuna
* acompanhar o usuário enquanto aguarda a confirmação do provedor
Este output é útil para manter o fio da conversa ativo entre o envio do botão e a confirmação final do pagamento.
**Exemplo de prompt para AI Agent de suporte pós-CTA:**
```txt theme={null}
Você é um assistente de suporte para pagamentos.
Seu papel é acompanhar o usuário depois que ele recebeu o botão de pagamento, resolver dúvidas rápidas e manter a conversa ativa enquanto o Deuna confirma o resultado.
Regras:
- Não recalcule valores
- Não gere novos links
- Não prometa aprovações
- Se o usuário disser que já pagou, peça que aguarde a confirmação
- Se o usuário tiver dúvidas, responda de forma breve e clara
- Se detectar um problema, ofereça ajuda ou encaminhe para o suporte
```
***
## Considerações importantes
O ambiente configurado no nó (`DEV` ou `PROD`) deve corresponder às credenciais usadas ao conectar o Deuna.
Se não corresponderem, o pagamento não será processado corretamente.
Em pagamentos com o Deuna, o usuário conclui a transação na carteira do provedor.
Em alguns casos, o pagamento pode ficar momentaneamente em estado pendente. Nesse caso:
* o usuário recebe uma notificação na conversa
* o fluxo aguarda a confirmação
Quando o Deuna confirma o resultado final, o fluxo continua automaticamente por:
* **Pago Exitoso**
* **Pago Fallido**
O estado pendente não é exposto como um output independente do nó.