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

# Cómo funciona

> Cobra con cualquier PSP compatible desde Brain Studio, sin esperar una integración dedicada.

Si la pasarela que necesitas en tu proyecto **no está** entre las [integraciones de pago nativas](/guides/integraciones/pagos/proveedores) de Jelou, puedes configurarla tú mismo como **pasarela personalizada**.

Para eso necesitas la **documentación técnica de tu PSP** y sus **API keys o tokens** (igual que en BYOK, pero tú defines qué llaves pide tu proveedor). Con eso describes la integración una vez en **Pagos** y cobras desde el nodo **Pagos** en Brain Studio, usando la experiencia de [WebView embebido](/guides/integraciones/pagos/experiencias/checkout-webview).

## Resumen de la integración

<Tabs>
  <Tab title="Qué es">
    * Se configura desde **Pagos → Integraciones** con el botón **Agregar pasarela**
    * Queda disponible en el nodo **Pagos** de Brain Studio cuando está activa
    * No requiere código de backend por cada proveedor nuevo

    <Note>
      Configuras la pasarela en **Pagos**. Después la seleccionas en el nodo **Pagos** de Brain Studio para cobrar en el flujo.
    </Note>
  </Tab>

  <Tab title="Experiencia">
    * **WebView embebido:** Sí
    * **Nativa en chat:** No
    * **Confirmación externa:** No

    <Note>
      El usuario completa el pago dentro del checkout del PSP en WebView.
      La captura y procesamiento de datos sensibles ocurre en la infraestructura del proveedor.
    </Note>
  </Tab>

  <Tab title="Requisitos">
    Tu PSP debe poder:

    * Crear un cobro con **una sola llamada HTTP** (GET, POST, PUT o PATCH)
    * Exponer un endpoint en una **URL pública**
    * Responder en **JSON** con un **id de transacción** y una **URL de checkout (paylink)**
    * Autenticarse con **encabezados estáticos** (Bearer, API key, Basic, etc.)

    Si además avisa el resultado por **webhook** o permite **consultar el estado**, Jelou puede confirmar el pago automáticamente. Sin ninguno de los dos, igual puedes enviar el paylink, pero la confirmación queda limitada.

    <Warning>
      No soporta pagos recurrentes, cancelación de la orden desde Jelou, tokenización de tarjeta ni checkout embebido con SDK del PSP.
    </Warning>
  </Tab>
</Tabs>

## Asistente de compatibilidad

Antes de armar el wizard, usa este **prompt con tu LLM** (ChatGPT, Claude, Cursor u otro). Cópialo desde la docu, pégalo como instrucciones y **añade la documentación técnica de tu PSP** (URL, PDF o texto). El modelo te dice si es compatible y qué completar en cada paso del alta.

<Steps>
  <Step title="Copia el prompt">
    <Card title="Ver y copiar el prompt" icon="copy" href="/guides/integraciones/pagos/personalizadas/prompt-compatibilidad">
      Ábrelo en la docu y cópialo con el botón del bloque de código.
    </Card>
  </Step>

  <Step title="Pégalo en tu LLM">
    Úsalo como instrucciones del asistente (system prompt o primer mensaje).
  </Step>

  <Step title="Adjunta la documentación del PSP">
    Comparte la **URL**, el **PDF** o el **texto** de la API de tu proveedor. Sin eso, el asistente no puede evaluar compatibilidad.
  </Step>

  <Step title="Pide el veredicto">
    Solicita el veredicto y el mapeo campo a campo del wizard. Úsalo como base al [crear la pasarela](/guides/integraciones/pagos/personalizadas/crear-pasarela).
  </Step>
</Steps>

<Note>
  Si tu PSP no pasa el checklist (por ejemplo OAuth con refresh, SOAP/XML o un flujo multi-paso obligatorio), escribe a [marketplace@jelou.ai](mailto:marketplace@jelou.ai) para evaluar una integración dedicada u otras opciones.
</Note>

## Cuándo usarla

* Tu PSP **no está** en las [integraciones nativas](/guides/integraciones/pagos/proveedores) y no puedes (o no quieres) esperar una integración dedicada.
* Quieres cobrar en conversación con [WebView embebido](/guides/integraciones/pagos/experiencias/checkout-webview) usando el checkout de ese proveedor.
* Tu equipo técnico puede describir la API del PSP (creación de cobro + llaves) y tú la configuras en el wizard.

## Cómo funciona

<Frame caption="Desde Pagos → Integraciones, el botón &#x22;Agregar pasarela&#x22; abre el wizard de alta.">
  <img src="https://mintcdn.com/jelouai/5kQz7Vl-QmvhNoPW/assets/images/integraciones/pagos/personalizadas/agregar-pasarela.png?fit=max&auto=format&n=5kQz7Vl-QmvhNoPW&q=85&s=1ca15c648c91db50d51fe4cae01d22f3" alt="Pantalla de Integraciones en Pagos, con el botón Agregar pasarela resaltado en la esquina superior derecha" width="1766" height="887" data-path="assets/images/integraciones/pagos/personalizadas/agregar-pasarela.png" />
</Frame>

<Steps>
  <Step title="Describe la integración">
    Desde **Pagos**, un administrador completa el wizard: credenciales, petición, webhook y retorno.
  </Step>

  <Step title="Jelou guarda la configuración">
    La pasarela queda asociada a tu compañía y lista para probar o editar desde Integraciones.
  </Step>

  <Step title="Úsala en Brain Studio">
    Cuando la pasarela está **activa**, selecciónala en el nodo **Pagos** para cobrar dentro de la conversación.
  </Step>
</Steps>

## Antes de empezar

Prepara esto antes de abrir el wizard:

* La **documentación técnica del PSP** (endpoint de creación de cobro, autenticación, forma del request/response, webhook si aplica).
* Las **API keys o tokens** del PSP: primero las de **prueba / sandbox**, después las de **producción**.
* Empieza creando la pasarela en **Sandbox**, conéctala con llaves de prueba y [valida el checkout](/guides/integraciones/pagos/personalizadas/probar-pasarela). Solo entonces pasa a **Producción** con las llaves reales.

<Note>
  Es el mismo modelo BYOK que en el catálogo: las llaves son tuyas. Aquí además defines *qué* llaves declara el wizard y *dónde* se usan (casi siempre en los encabezados de la petición, por ejemplo `Authorization: Bearer {{apiKey}}`).
</Note>

## Próximos pasos

<Steps>
  <Step title="Crear la pasarela">
    Recorre el wizard de 6 pasos para dar de alta tu PSP.

    <Card title="Crear una pasarela personalizada" href="/guides/integraciones/pagos/personalizadas/crear-pasarela" icon="wand-magic-sparkles">
      Configura credenciales, petición, webhook y retorno.
    </Card>
  </Step>

  <Step title="Revisar variables">
    Consulta los placeholders que puedes inyectar en la solicitud al PSP.

    <Card title="Variables y placeholders" href="/guides/integraciones/pagos/personalizadas/variables-y-placeholders" icon="brackets-curly">
      Referencia de monto, cliente, orden, retorno y más.
    </Card>
  </Step>

  <Step title="Probar antes de publicar">
    Valida el flujo completo contra el sandbox del PSP.

    <Card title="Probar la pasarela" href="/guides/integraciones/pagos/personalizadas/probar-pasarela" icon="vial">
      Genera un paylink de prueba y revisa el checklist de producción.
    </Card>
  </Step>

  <Step title="Usar en Brain Studio">
    Configura el nodo Pagos para cobrar con tu pasarela activa.

    <Card title="Usar en Brain Studio" href="/guides/integraciones/pagos/personalizadas/usar-en-brain-studio" icon="diagram-project">
      Campos del nodo, salidas y casos de uso.
    </Card>
  </Step>
</Steps>
