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

# Testar um gateway antes de publicá-lo

> Use o checkout de teste para validar o fluxo completo antes de ativar seu gateway personalizado em produção.

Quando seu gateway tem credenciais conectadas (etapa **Conectar** do assistente), em **Pagamentos → Integrações** aparece a ação **Testar**. Ela abre o painel de checkout de teste para validar o ciclo completo antes da produção.

## Como testar

<Steps>
  <Step title="Preencha os dados de teste">
    Informe dados do pedido e do cliente: nome, telefone, id de referência, valores, imposto e moeda. Os campos opcionais só aparecem se o seu template de body ou seus cabeçalhos os usarem.

    <Frame caption="Painel de checkout de teste, com os dados de pedido e cliente">
      <img src="https://mintcdn.com/jelouai/5kQz7Vl-QmvhNoPW/assets/images/integraciones/pagos/personalizadas/probar-checkout.png?fit=max&auto=format&n=5kQz7Vl-QmvhNoPW&q=85&s=9684eb3e40477a3eda589f557d0fad73" alt="Painel Testar checkout de um gateway personalizado, com os campos de nome, telefone, valor e moeda de teste" width="696" height="990" data-path="assets/images/integraciones/pagos/personalizadas/probar-checkout.png" />
    </Frame>
  </Step>

  <Step title="Revise a pré-visualização">
    O painel mostra ao vivo como fica a solicitação com os placeholders já substituídos, antes de enviar qualquer coisa ao PSP.
  </Step>

  <Step title="Gere o pagamento de teste">
    Ao confirmar, o Jelou chama seu gateway e mostra o **paylink** resultante junto com a resposta do PSP, ou uma mensagem de erro se for rejeitado.
  </Step>
</Steps>

<Note>
  O painel de teste inclui um campo de URL de retorno. Não inclui cancelamento nem identificadores de canal ou usuário.
</Note>

Use este fluxo contra o **sandbox** ou modo de teste do PSP antes de ir para produção ou de usar o gateway em um fluxo de Brain ao vivo.

## Checklist antes de ir para produção

<Steps>
  <Step title="Credenciais do JelouPayments">
    Confirme que sua empresa tem as credenciais do JelouPayments configuradas.
  </Step>

  <Step title="Ambiente correto">
    Valide primeiro em **Sandbox** (ou no modo de teste do PSP) antes de criar o equivalente em **Produção**.
  </Step>

  <Step title="Credenciais do PSP">
    Cada segredo que seu PSP precisa está declarado, e os sensíveis estão tipados como **Segredo**.
  </Step>

  <Step title="Requisição verificada">
    A URL, o método, o body, o path do link de pagamento e o path do transaction id coincidem com a API real do PSP — verificado com **Testar**.
  </Step>

  <Step title="Placeholders válidos">
    Revise body, cabeçalhos e verificação de status com a [referência de placeholders](/pt/guias/integracoes/pagamentos/personalizados/variaveis-e-placeholders).
  </Step>

  <Step title="Retorno e status (se aplicável)">
    Se o PSP redireciona após o pagamento, o parâmetro de transaction id coincide com o que ele adiciona à URL. Se você usa consulta de status, o mapeamento para **Sucesso / Falha / Nenhum** está completo.
  </Step>

  <Step title="Webhook (se aplicável)">
    Cabeçalho de assinatura configurado se o PSP assina os webhooks, paths do payload corretos, e cada evento relevante mapeado para **Sucesso**, **Falha** ou **Nenhum**.
  </Step>

  <Step title="Segredo de webhook compartilhado">
    O segredo gerado ou rotacionado também está configurado no painel do PSP.
  </Step>

  <Step title="Checkout de teste completo">
    Você gerou um paylink real no sandbox, concluiu um pagamento de ponta a ponta e o status resultante é o esperado.
  </Step>

  <Step title="Produção">
    <Warning>
      Credenciais de produção podem criar uma cobrança real. Use o modo de teste do PSP quando existir. Se não existir, execute apenas uma transação autorizada de valor mínimo e defina o estorno ou reembolso antes de continuar.
    </Warning>

    Mude para **Produção**, repita o checkout de teste com credenciais produtivas e verifique novamente a assinatura do webhook de ponta a ponta.
  </Step>
</Steps>

## Ativação no Brain Studio

Um gateway recém-criado **não aparece imediatamente** no seletor do nó Pagamentos. O Jelou verifica a configuração em segundo plano e o marca como **ativo** quando está pronto. Você não pode forçar essa etapa pela interface.

<Note>
  Planeje uma margem de tempo entre terminar o assistente e poder usar o gateway dentro de um fluxo de Brain.
</Note>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Usar no Brain Studio" href="/pt/guias/integracoes/pagamentos/personalizados/usar-no-brain-studio" icon="diagram-project">
    Configure o nó Pagamentos assim que seu gateway estiver ativo.
  </Card>

  <Card title="Criar um gateway personalizado" href="/pt/guias/integracoes/pagamentos/personalizados/criar-gateway" icon="wand-magic-sparkles">
    Volte ao assistente se precisar ajustar alguma etapa.
  </Card>
</CardGroup>
