> ## 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. # Criar um gateway personalizado > Configure passo a passo o assistente de 6 etapas para cadastrar um provedor de pagamento personalizado em Pagamentos. 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](/pt/guias/integracoes/pagamentos/personalizados/prompt-compatibilidade) com o seu LLM e a documentação do PSP. Você sai com o mapeamento pronto para cada etapa. ## Assistente de cadastro 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 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. 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 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. 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](/pt/guias/integracoes/pagamentos/personalizados/variaveis-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 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 Tabela de mapeamento de status do PSP para Sucesso ou Falha dentro do bloco de retorno 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. 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 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. 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 O campo **Formato JSON esperado** é só uma referência visual: não é enviado ao backend. 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 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](/pt/guias/integracoes/pagamentos/personalizados/testar-gateway). ## Próximos passos Placeholders disponíveis para o body, cabeçalhos e verificação de status. Gere um paylink de teste antes de ir para produção.