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

# Probar una pasarela antes de publicarla

> Usa el checkout de prueba para validar el flujo completo antes de activar tu pasarela personalizada en producción.

Cuando tu pasarela tiene credenciales conectadas (paso **Conectar** del wizard), en **Pagos → Integraciones** aparece la acción **Probar**. Abre el panel de checkout de prueba para validar el ciclo completo antes de producción.

## Cómo probar

<Steps>
  <Step title="Completa los datos de prueba">
    Ingresa datos de orden y cliente: nombre, teléfono, id de referencia, montos, impuesto y moneda. Los campos opcionales solo aparecen si tu plantilla de body o tus encabezados los usan.

    <Frame caption="Panel de checkout de prueba, con los datos de orden y 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="Panel Probar checkout de una pasarela personalizada, con los campos de nombre, teléfono, monto y moneda de prueba" width="696" height="990" data-path="assets/images/integraciones/pagos/personalizadas/probar-checkout.png" />
    </Frame>
  </Step>

  <Step title="Revisa la vista previa">
    El panel muestra en vivo cómo queda la solicitud con los placeholders ya reemplazados, antes de enviarla al PSP.
  </Step>

  <Step title="Genera el pago de prueba">
    Al confirmar, Jelou llama a tu pasarela y muestra el **paylink** resultante junto con la respuesta del PSP, o un mensaje de error si la rechaza.
  </Step>
</Steps>

<Note>
  El panel de prueba incluye un campo de URL de retorno. No incluye cancelación ni identificadores de canal o usuario.
</Note>

Usa este flujo contra el **sandbox** o modo de prueba del PSP antes de pasar a producción o de usarla en un flujo de Brain en vivo.

## Checklist antes de pasar a producción

<Steps>
  <Step title="Credenciales de JelouPayments">
    Confirma que tu compañía tiene las credenciales de JelouPayments configuradas.
  </Step>

  <Step title="Ambiente correcto">
    Valida primero en **Sandbox** (o en el modo de prueba del PSP) antes de crear el equivalente en **Producción**.
  </Step>

  <Step title="Credenciales del PSP">
    Cada secreto que tu PSP necesita está declarado, y los sensibles están tipados como **Secreto**.
  </Step>

  <Step title="Petición verificada">
    La URL, el método, el body, el path del link de pago y el path del transaction id coinciden con la API real del PSP — verificado con **Probar**.
  </Step>

  <Step title="Placeholders válidos">
    Revisa body, encabezados y verificación de estado contra la [referencia de placeholders](/guides/integraciones/pagos/personalizadas/variables-y-placeholders).
  </Step>

  <Step title="Retorno y estado (si aplica)">
    Si tu PSP redirige tras el pago, el parámetro de transaction id coincide con lo que agrega a la URL. Si usas consulta de estado, el mapeo a **Éxito / Fallido / Ninguno** está completo.
  </Step>

  <Step title="Webhook (si aplica)">
    Encabezado de firma configurado si el PSP firma sus webhooks, paths del payload correctos, y cada evento relevante mapeado a **Éxito**, **Fallido** o **Ninguno**.
  </Step>

  <Step title="Secreto de webhook compartido">
    El secreto generado o rotado también está configurado en el panel del PSP.
  </Step>

  <Step title="Checkout de prueba completo">
    Generaste un paylink real en sandbox, completaste un pago de punta a punta y el estado resultante es el esperado.
  </Step>

  <Step title="Producción">
    <Warning>
      Las credenciales productivas pueden crear un cobro real. Usa el modo de prueba del PSP cuando exista. Si no existe, ejecuta solo una transacción autorizada de importe mínimo y define su anulación o reembolso antes de continuar.
    </Warning>

    Cambia a **Producción**, repite el checkout de prueba con credenciales productivas y vuelve a verificar la firma del webhook de punta a punta.
  </Step>
</Steps>

## Activación en Brain Studio

Una pasarela recién creada **no aparece de inmediato** en el selector del nodo Pagos. Jelou verifica la configuración en segundo plano y la marca como **activa** cuando está lista. No puedes forzar ese paso desde la interfaz.

<Note>
  Planea un margen de tiempo entre terminar el wizard y poder usar la pasarela dentro de un flujo de Brain.
</Note>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Usar en Brain Studio" href="/guides/integraciones/pagos/personalizadas/usar-en-brain-studio" icon="diagram-project">
    Configura el nodo Pagos una vez que tu pasarela esté activa.
  </Card>

  <Card title="Crear una pasarela personalizada" href="/guides/integraciones/pagos/personalizadas/crear-pasarela" icon="wand-magic-sparkles">
    Vuelve al wizard si necesitas ajustar algún paso.
  </Card>
</CardGroup>
