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

# Como funciona

> Cobre com qualquer PSP compatível no Brain Studio, sem esperar uma integração dedicada.

Se o gateway de pagamento que você precisa no seu projeto **não está** entre as [integrações de pagamento nativas](/pt/guias/integracoes/pagamentos/provedores) da Jelou, você pode configurá-lo você mesmo como **gateway personalizado**.

Para isso, você precisa da **documentação técnica do seu PSP** e das **API keys ou tokens** dele (igual ao BYOK, mas você define quais chaves o provedor pede). Com isso, você descreve a integração uma vez em **Pagamentos** e cobra a partir do nó **Pagamentos** no Brain Studio, usando a experiência de [WebView embutido](/pt/guias/integracoes/pagamentos/experiencias/checkout-webview).

## Resumo da integração

<Tabs>
  <Tab title="O que é">
    * Configura-se em **Pagamentos → Integrações** com o botão **Adicionar gateway**
    * Fica disponível no nó **Pagamentos** do Brain Studio quando está ativo
    * Não exige código de backend para cada provedor novo

    <Note>
      Você configura o gateway em **Pagamentos**. Depois o seleciona no nó **Pagamentos** do Brain Studio para cobrar no fluxo.
    </Note>
  </Tab>

  <Tab title="Experiência">
    * **WebView embutido:** Sim
    * **Nativa no chat:** Não
    * **Confirmação externa:** Não

    <Note>
      O usuário conclui o pagamento dentro do checkout do PSP no WebView.
      A captura e o processamento de dados sensíveis ocorrem na infraestrutura do provedor.
    </Note>
  </Tab>

  <Tab title="Requisitos">
    Seu PSP deve conseguir:

    * Criar uma cobrança com **uma única chamada HTTP** (GET, POST, PUT ou PATCH)
    * Expor um endpoint em uma **URL pública**
    * Responder em **JSON** com um **id de transação** e uma **URL de checkout (paylink)**
    * Autenticar-se com **cabeçalhos estáticos** (Bearer, API key, Basic, etc.)

    Se também informar o resultado por **webhook** ou permitir **consultar o status**, o Jelou pode confirmar o pagamento automaticamente. Sem nenhum dos dois, ainda é possível enviar o paylink, mas a confirmação fica limitada.

    <Warning>
      Não oferece suporte a pagamentos recorrentes, cancelamento do pedido a partir do Jelou, tokenização de cartão nem checkout embutido com SDK do PSP.
    </Warning>
  </Tab>
</Tabs>

## Assistente de compatibilidade

Antes de montar o assistente, use este **prompt com o seu LLM** (ChatGPT, Claude, Cursor ou outro). Copie da documentação, cole como instruções e **adicione a documentação técnica do seu PSP** (URL, PDF ou texto). O modelo diz se é compatível e o que preencher em cada etapa do cadastro.

<Steps>
  <Step title="Copie o prompt">
    <Card title="Ver e copiar o prompt" icon="copy" href="/pt/guias/integracoes/pagamentos/personalizados/prompt-compatibilidade">
      Abra na documentação e copie com o botão do bloco de código.
    </Card>
  </Step>

  <Step title="Cole no seu LLM">
    Use como instruções do assistente (system prompt ou primeira mensagem).
  </Step>

  <Step title="Anexe a documentação do PSP">
    Compartilhe a **URL**, o **PDF** ou o **texto** da API do seu provedor. Sem isso, o assistente não consegue avaliar a compatibilidade.
  </Step>

  <Step title="Peça o veredito">
    Solicite o veredito e o mapeamento campo a campo do assistente. Use como base ao [criar o gateway](/pt/guias/integracoes/pagamentos/personalizados/criar-gateway).
  </Step>
</Steps>

<Note>
  Se o seu PSP não passar no checklist (por exemplo OAuth com refresh, SOAP/XML ou um fluxo multi-etapa obrigatório), escreva para [marketplace@jelou.ai](mailto:marketplace@jelou.ai) para avaliar uma integração dedicada ou outras opções.
</Note>

## Quando usar

* Seu PSP **não está** nas [integrações nativas](/pt/guias/integracoes/pagamentos/provedores) e você não pode (ou não quer) esperar uma integração dedicada.
* Você quer cobrar na conversa com [WebView embutido](/pt/guias/integracoes/pagamentos/experiencias/checkout-webview) usando o checkout desse provedor.
* Sua equipe técnica consegue descrever a API do PSP (criação de cobrança + chaves) e você a configura no assistente.

## Como funciona

<Frame caption="Em Pagamentos → Integrações, o botão &#x22;Adicionar gateway&#x22; abre o assistente de cadastro.">
  <img src="https://mintcdn.com/jelouai/5kQz7Vl-QmvhNoPW/assets/images/integraciones/pagos/personalizadas/agregar-pasarela.png?fit=max&auto=format&n=5kQz7Vl-QmvhNoPW&q=85&s=1ca15c648c91db50d51fe4cae01d22f3" alt="Tela de Integrações em Pagamentos, com o botão Adicionar gateway destacado no canto superior direito" width="1766" height="887" data-path="assets/images/integraciones/pagos/personalizadas/agregar-pasarela.png" />
</Frame>

<Steps>
  <Step title="Descreva a integração">
    Em **Pagamentos**, um administrador completa o assistente: credenciais, requisição, webhook e retorno.
  </Step>

  <Step title="O Jelou salva a configuração">
    O gateway fica associado à sua empresa e pronto para testar ou editar em Integrações.
  </Step>

  <Step title="Use no Brain Studio">
    Quando o gateway está **ativo**, selecione-o no nó **Pagamentos** para cobrar dentro da conversa.
  </Step>
</Steps>

## Antes de começar

Prepare isto antes de abrir o assistente:

* A **documentação técnica do PSP** (endpoint de criação de cobrança, autenticação, formato da requisição/resposta, webhook se houver).
* As **API keys ou tokens** do PSP: primeiro as de **teste / sandbox**, depois as de **produção**.
* Comece criando o gateway em **Sandbox**, conecte-o com chaves de teste e [valide o checkout](/pt/guias/integracoes/pagamentos/personalizados/testar-gateway). Só então passe para **Produção** com as chaves reais.

<Note>
  É o mesmo modelo BYOK do catálogo: as chaves são suas. Aqui você também define *quais* chaves o assistente declara e *onde* elas são usadas (quase sempre nos cabeçalhos da requisição, por exemplo `Authorization: Bearer {{apiKey}}`).
</Note>

## Próximos passos

<Steps>
  <Step title="Criar o gateway">
    Percorra o assistente de 6 etapas para cadastrar seu PSP.

    <Card title="Criar um gateway personalizado" href="/pt/guias/integracoes/pagamentos/personalizados/criar-gateway" icon="wand-magic-sparkles">
      Configure credenciais, requisição, webhook e retorno.
    </Card>
  </Step>

  <Step title="Revisar variáveis">
    Consulte os placeholders que você pode injetar na solicitação ao PSP.

    <Card title="Variáveis e placeholders" href="/pt/guias/integracoes/pagamentos/personalizados/variaveis-e-placeholders" icon="brackets-curly">
      Referência de valor, cliente, pedido, retorno e mais.
    </Card>
  </Step>

  <Step title="Testar antes de publicar">
    Valide o fluxo completo contra o sandbox do PSP.

    <Card title="Testar o gateway" href="/pt/guias/integracoes/pagamentos/personalizados/testar-gateway" icon="vial">
      Gere um paylink de teste e revise o checklist de produção.
    </Card>
  </Step>

  <Step title="Usar no Brain Studio">
    Configure o nó Pagamentos para cobrar com seu gateway ativo.

    <Card title="Usar no Brain Studio" href="/pt/guias/integracoes/pagamentos/personalizados/usar-no-brain-studio" icon="diagram-project">
      Campos do nó, saídas e casos de uso.
    </Card>
  </Step>
</Steps>
