> ## 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.

# Usar o gateway no Brain Studio

> Configure o nó Pagamentos no Brain Studio para cobrar com um gateway personalizado dentro de um fluxo conversacional.

Quando seu gateway personalizado está criado, conectado e **ativo**, fica disponível no seletor do nó **Pagamentos** dentro do Brain Studio.

## Configuração do nó

| Campo                          | Descrição                                                                                                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Gateway de pagamento**       | Seletor com seus gateways personalizados ativos. Fica desabilitado se sua empresa não tiver credenciais do JelouPayments ou se houver um erro de autorização. |
| **Tempo de espera (segundos)** | Quanto tempo o fluxo espera antes de continuar pelo branch **Tempo de espera esgotado**.                                                                      |
| **Dados do cliente**           | Mapeia variáveis do fluxo para os campos do cliente (referência, nomes, e-mail, telefone, documento, endereço, país).                                         |
| **Valor**                      | Mapeia variáveis do fluxo para os campos do valor (valores tributáveis/não tributáveis, imposto, moeda, descrição).                                           |
| **Salvar resposta**            | Salva, de forma opcional, a resposta do gateway em uma variável do fluxo.                                                                                     |

<Note>
  Este seletor lista apenas gateways personalizados conectados em **Pagamentos**. Não mistura provedores do catálogo nem outras credenciais da empresa.
</Note>

## Saídas do nó

O nó Pagamentos expõe seis saídas que você deve conectar no seu fluxo:

| Saída                    | Significado                                                                              |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| Erro geral               | Qualquer erro não tratado ao executar o nó.                                              |
| Mensagem enviada         | O paylink foi enviado ao cliente.                                                        |
| Pagamento bem-sucedido   | O pagamento foi confirmado como bem-sucedido (por webhook ou por verificação de status). |
| Pagamento pendente       | O pagamento continua pendente de confirmação.                                            |
| Pagamento falhou         | O pagamento foi confirmado como falho.                                                   |
| Tempo de espera esgotado | O tempo de espera configurado se esgotou sem uma resolução.                              |

<Tip>
  O mapeamento **Sucesso / Falha / Nenhum** que você definiu ao configurar o webhook e a verificação de status do gateway determina apenas as saídas **Pagamento bem-sucedido**, **Pagamento pendente** e **Pagamento falhou** — por isso é importante deixá-lo bem configurado ao [criar o gateway](/pt/guias/integracoes/pagamentos/personalizados/criar-gateway).
</Tip>

<Warning>
  Não deixe sem tratamento os branches **Pagamento falhou** e **Tempo de espera esgotado** — sem eles, o cliente pode ficar sem resposta se a cobrança não for concluída.
</Warning>

## Casos de uso

<AccordionGroup>
  <Accordion title="PSP local não disponível no catálogo de provedores">
    Um negócio que opera com um PSP regional que não está no catálogo de provedores do Jelou: define seu endpoint de checkout como gateway personalizado e mapeia as respostas do webhook para as saídas do nó Pagamentos, sem depender de o Jelou construir uma integração dedicada.
  </Accordion>

  <Accordion title="Confirmação por consulta ativa de status">
    Um negócio cujo PSP não oferece webhooks confiáveis: ativa **Verificar status com o PSP no retorno** ao criar o gateway, e o fluxo usa a saída **Pagamento pendente** enquanto o Jelou consulta o status da transação.
  </Accordion>

  <Accordion title="Migração progressiva a partir de um provedor do catálogo">
    Um negócio que já usa um provedor do catálogo, mas precisa adicionar um PSP adicional para outro país ou método de pagamento: configura o gateway personalizado em paralelo e seleciona um ou outro no nó Pagamentos de acordo com o fluxo ou segmento de clientes.
  </Accordion>
</AccordionGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Como funciona" href="/pt/guias/integracoes/pagamentos/personalizados/como-funciona" icon="diagram-project">
    Revise o overview e os requisitos de compatibilidade.
  </Card>

  <Card title="Catálogo de provedores" href="/pt/guias/integracoes/pagamentos/provedores" icon="credit-card">
    Verifique se seu PSP já tem uma integração pronta para usar.
  </Card>
</CardGroup>