Skip to main content
Se o gateway de pagamento que você precisa no seu projeto não está entre as integrações de pagamento nativas 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.

​
Resumo da integração

  • 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
Você configura o gateway em Pagamentos. Depois o seleciona no nó Pagamentos do Brain Studio para cobrar no fluxo.

​
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.
1

Copie o prompt

Ver e copiar o prompt

Abra na documentação e copie com o botão do bloco de código.
2

Cole no seu LLM

Use como instruções do assistente (system prompt ou primeira mensagem).
3

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

Peça o veredito

Solicite o veredito e o mapeamento campo a campo do assistente. Use como base ao criar o gateway.
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 [email protected] para avaliar uma integração dedicada ou outras opções.

​
Quando usar

  • Seu PSP não está nas integrações nativas e você não pode (ou não quer) esperar uma integração dedicada.
  • Você quer cobrar na conversa com WebView embutido 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

Tela de Integrações em Pagamentos, com o botão Adicionar gateway destacado no canto superior direito

Em Pagamentos → Integrações, o botão "Adicionar gateway" abre o assistente de cadastro.

1

Descreva a integração

Em Pagamentos, um administrador completa o assistente: credenciais, requisição, webhook e retorno.
2

O Jelou salva a configuração

O gateway fica associado à sua empresa e pronto para testar ou editar em Integrações.
3

Use no Brain Studio

Quando o gateway está ativo, selecione-o no nó Pagamentos para cobrar dentro da conversa.

​
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. Só então passe para Produção com as chaves reais.
É 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}}).

​
Próximos passos

1

Criar o gateway

Percorra o assistente de 6 etapas para cadastrar seu PSP.

Criar um gateway personalizado

Configure credenciais, requisição, webhook e retorno.
2

Revisar variáveis

Consulte os placeholders que você pode injetar na solicitação ao PSP.

Variáveis e placeholders

Referência de valor, cliente, pedido, retorno e mais.
3

Testar antes de publicar

Valide o fluxo completo contra o sandbox do PSP.

Testar o gateway

Gere um paylink de teste e revise o checklist de produção.
4

Usar no Brain Studio

Configure o nó Pagamentos para cobrar com seu gateway ativo.

Usar no Brain Studio

Campos do nó, saídas e casos de uso.