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 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 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 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: habilitar o retorno do navegador e a verificação de status com o PSP

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