Skip to main content
Desde Pagos → Integraciones, el botón Agregar pasarela abre el wizard de alta. Al crear una pasarela nueva, los pasos son lineales: debes completar cada uno antes de avanzar. Cuando ya existe, puedes moverte libremente entre pasos para editarla.
Antes de llenar el wizard, usa el prompt de compatibilidad con tu LLM y la documentación de tu PSP. Sales con el mapeo listo para cada paso.

​
Wizard de alta

1

General

Define el Nombre, el Slug, la Descripción (opcional), la URL de ícono (opcional) y el Ambiente (Sandbox o Producción).
  • Nombre y Slug son obligatorios.
Paso General del wizard de pasarela personalizada, con los campos Nombre, Slug, Ambiente y Descripción

Paso 1 del wizard: datos generales de la pasarela

Empieza en Sandbox. El ambiente no se puede cambiar después: para producción crearás otra pasarela (o un alta aparte) con las llaves reales.
El Slug y el Ambiente no se pueden editar después de crear la pasarela.
2

Credenciales

Declara cada secreto o API key que tu PSP necesita. Por cada fila defines:
  • Key — nombre interno del placeholder (por ejemplo apiKey)
  • Label — texto visible en la interfaz
  • Tipo — Texto o Secreto
Debes declarar al menos una credencial. Usa Secreto para API keys y tokens: el valor queda enmascarado.
Paso Credenciales del wizard de pasarela personalizada, con una fila de credencial de tipo Secreto

Paso 2 del wizard: credenciales que tu PSP necesita

Aquí solo declaras qué llaves existen (como los campos de un BYOK). Los valores reales los pegas después, en Conectar.
Desde esta pantalla no puedes marcar una credencial como obligatoria. Si necesitas ese comportamiento, coordínalo con tu equipo técnico.
3

Petición (incluye Retorno)

Aquí defines cómo Jelou llama al PSP para crear un cobro y, de forma opcional, cómo manejar el retorno del cliente.Petición
  • Método (GET, POST, PUT o PATCH) y URL del endpoint de creación de cobro
  • Encabezados — por ejemplo Authorization: Bearer {{miCredencial}}
  • Body template — JSON de la solicitud con placeholders {{...}} (ver Variables y placeholders)
  • Path del link de pago y Path del transaction id — ruta en el JSON de respuesta donde viven el checkout URL y el id de transacción (por ejemplo data.checkout_url)
Paso Petición del wizard de pasarela personalizada, con el endpoint, los headers y el body template de ejemplo

Paso 3 del wizard: endpoint, headers y body template de la petición

La URL y el Body template son obligatorios. Cada {{...}} debe corresponder a una credencial declarada o a un placeholder reconocido.Retorno (opcional)
  • Parámetro de transaction id — query param que el PSP agrega al redirigir tras el checkout
  • Verificar estado con el PSP al retorno — consulta activa de estado (método, URL, encabezados, paths y mapeo a Éxito / Fallido / Ninguno)
Bloque de retorno del wizard, con los interruptores de retorno de navegador y verificación de estado con el PSP activados

Bloque de retorno: habilitar el retorno de navegador y la verificación de estado con el PSP

Tabla de mapeo de estados del PSP a Éxito o Fallido dentro del bloque de retorno

Mapeo de cada valor de estado del PSP a Éxito, Fallido o Ninguno

Al confirmar este paso se crea o actualiza la pasarela. El Slug y el Ambiente quedan fijados. Si la creación falla, el wizard bloquea el avance.
El selector puede mostrar DELETE, pero solo se aceptan GET, POST, PUT o PATCH. Elegir DELETE hace fallar el guardado.
4

Conectar

Disponible después de guardar el paso anterior. Aquí ingresas los valores reales de cada credencial declarada — los secretos de tu PSP, no sus nombres.
Paso Conectar del wizard de pasarela personalizada, con el campo Api key y el botón Actualizar llaves

Paso 4 del wizard: valores reales de las credenciales declaradas

En Sandbox, pega las llaves de prueba del PSP. En Producción, las llaves reales. Sin este paso, la pasarela no puede autenticarse contra el proveedor.
5

Webhook

Configura cómo interpretar las notificaciones entrantes del PSP:
  • Activa o desactiva el webhook con Habilitado. Si lo desactivas, el wizard salta a Finalizar.
  • Encabezado de firma (opcional) — header donde el PSP envía su firma HMAC
  • Path del nombre de evento y Path del transaction id — rutas dentro del payload
  • Tabla de eventos — mapea cada evento del PSP a Éxito, Fallido o Ninguno
Paso Webhook del wizard de pasarela personalizada, con el header de firma, los paths del payload y el formato JSON esperado

Paso 5 del wizard: configuración del webhook de confirmación

El campo Formato JSON esperado es solo una referencia visual: no se envía al backend.
6

Webhook secret

Solo aparece si el webhook está habilitado. Copia la URL de webhook que genera el wizard, configúrala en el panel de tu PSP y genera o rota el secreto HMAC.
  • Algoritmos disponibles: SHA256, SHA384 o SHA512
  • Un secreto personalizado debe tener al menos 16 caracteres
Paso Webhook secret del wizard de pasarela personalizada, con la URL del webhook, el secreto activo y el selector de algoritmo de firma

Paso 6 del wizard: URL de webhook y secreto de firma

Al terminar este paso se cierra el wizard.
Antes de usar la pasarela en producción, usa Probar desde la lista de Integraciones. Revisa Probar la pasarela.

​
Próximos pasos

Variables y placeholders

Placeholders disponibles para el body, encabezados y verificación de estado.

Probar la pasarela

Genera un paylink de prueba antes de pasar a producción.