Skip to main content
Em Pagamentos → Integrações, o botão Adicionar gateway abre o assistente de cadastro. Ao criar um gateway novo, as etapas são lineares: você precisa concluir cada uma antes de avançar. Quando o gateway já existe, você pode se mover livremente entre as etapas para editá-lo.
Antes de preencher o assistente, use o prompt de compatibilidade com o seu LLM e a documentação do PSP. Você sai com o mapeamento pronto para cada etapa.

​
Assistente de cadastro

1

Geral

Defina o Nome, o Slug, a Descrição (opcional), a URL do ícone (opcional) e o Ambiente (Sandbox ou Produção).
  • Nome e Slug são obrigatórios.
Etapa Geral do assistente de gateway personalizado, com os campos Nome, Slug, Ambiente e Descrição

Etapa 1 do assistente: informações gerais do gateway

Comece em Sandbox. O ambiente não pode ser alterado depois: para produção você criará outro gateway (ou um cadastro aparte) com as chaves reais.
O Slug e o Ambiente não podem ser editados depois de criar o gateway.
2

Credenciais

Declare cada segredo ou API key que seu PSP precisa. Em cada linha você define:
  • Key — nome interno do placeholder (por exemplo apiKey)
  • Label — texto visível na interface
  • Tipo — Texto ou Segredo
Você deve declarar pelo menos uma credencial. Use Segredo para API keys e tokens: o valor fica mascarado.
Etapa Credenciais do assistente de gateway personalizado, com uma linha de credencial do tipo Segredo

Etapa 2 do assistente: credenciais que seu PSP precisa

Aqui você só declara quais chaves existem (como os campos de um BYOK). Os valores reais você cola depois, em Conectar.
Nesta tela você não pode marcar uma credencial como obrigatória. Se precisar desse comportamento, alinhe com sua equipe técnica.
3

Requisição (inclui Retorno)

Aqui você define como o Jelou chama o PSP para criar uma cobrança e, de forma opcional, como tratar o retorno do cliente.Requisição
  • Método (GET, POST, PUT ou PATCH) e URL do endpoint de criação de cobrança
  • Cabeçalhos — por exemplo Authorization: Bearer {{minhaCredencial}}
  • Body template — JSON da solicitação com placeholders {{...}} (veja Variáveis e placeholders)
  • Path do link de pagamento e Path do transaction id — caminho no JSON de resposta onde ficam a URL de checkout e o id de transação (por exemplo data.checkout_url)
Etapa Requisição do assistente de gateway personalizado, com o endpoint, os headers e o body template de exemplo

Etapa 3 do assistente: endpoint, headers e body template da requisição

A URL e o Body template são obrigatórios. Cada {{...}} deve corresponder a uma credencial declarada ou a um placeholder reconhecido.Retorno (opcional)
  • Parâmetro de transaction id — query param que o PSP adiciona ao redirecionar após o checkout
  • Verificar status com o PSP no retorno — consulta ativa de status (método, URL, cabeçalhos, paths e mapeamento para Sucesso / Falha / Nenhum)
Bloco de retorno do assistente, com os interruptores de retorno do navegador e verificação de status com o PSP ativados

Bloco de retorno: habilitar o retorno do navegador e a verificação de status com o PSP

Tabela de mapeamento de status do PSP para Sucesso ou Falha dentro do bloco de retorno

Mapeamento de cada valor de status do PSP para Sucesso, Falha ou Nenhum

Ao confirmar esta etapa, o gateway é criado ou atualizado. O Slug e o Ambiente ficam fixos. Se a criação falhar, o assistente bloqueia o avanço.
O seletor pode mostrar DELETE, mas só são aceitos GET, POST, PUT ou PATCH. Escolher DELETE faz o salvamento falhar.
4

Conectar

Disponível depois de salvar a etapa anterior. Aqui você informa os valores reais de cada credencial declarada — os segredos do seu PSP, não os nomes deles.
Etapa Conectar do assistente de gateway personalizado, com o campo Api key e o botão Atualizar chaves

Etapa 4 do assistente: valores reais das credenciais declaradas

Em Sandbox, cole as chaves de teste do PSP. Em Produção, as chaves reais. Sem esta etapa, o gateway não consegue se autenticar no provedor.
5

Webhook

Configure como interpretar as notificações recebidas do PSP:
  • Ative ou desative o webhook com Habilitado. Se desativar, o assistente pula para Finalizar.
  • Cabeçalho de assinatura (opcional) — header onde o PSP envia a assinatura HMAC
  • Path do nome do evento e Path do transaction id — caminhos dentro do payload
  • Tabela de eventos — mapeia cada evento do PSP para Sucesso, Falha ou Nenhum
Etapa Webhook do assistente de gateway personalizado, com o header de assinatura, os paths do payload e o formato JSON esperado

Etapa 5 do assistente: configuração do webhook de confirmação

O campo Formato JSON esperado é só uma referência visual: não é enviado ao backend.
6

Webhook secret

Só aparece se o webhook estiver habilitado. Copie a URL de webhook gerada pelo assistente, configure-a no painel do seu PSP e gere ou rotacione o segredo HMAC.
  • Algoritmos disponíveis: SHA256, SHA384 ou SHA512
  • Um segredo personalizado deve ter pelo menos 16 caracteres
Etapa Webhook secret do assistente de gateway personalizado, com a URL do webhook, o segredo ativo e o seletor de algoritmo de assinatura

Etapa 6 do assistente: URL de webhook e segredo de assinatura

Ao concluir esta etapa, o assistente é fechado.
Antes de usar o gateway em produção, use Testar na lista de Integrações. Veja Testar o gateway.

​
Próximos passos

Variáveis e placeholders

Placeholders disponíveis para o body, cabeçalhos e verificação de status.

Testar o gateway

Gere um paylink de teste antes de ir para produção.