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

# Usar la pasarela en Brain Studio

> Configura el nodo Pagos en Brain Studio para cobrar con una pasarela personalizada dentro de un flujo conversacional.

Cuando tu pasarela personalizada está creada, conectada y **activa**, queda disponible en el selector del nodo **Pagos** dentro de Brain Studio.

## Configuración del nodo

| Campo                           | Descripción                                                                                                                                                |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pasarela de pago**            | Selector con tus pasarelas personalizadas activas. Se deshabilita si tu compañía no tiene credenciales de JelouPayments o si hay un error de autorización. |
| **Tiempo de espera (segundos)** | Cuánto espera el flujo antes de continuar por la rama **Tiempo de espera agotado**.                                                                        |
| **Datos del cliente**           | Mapea variables del flujo a los campos del cliente (referencia, nombres, email, teléfono, documento, dirección, país).                                     |
| **Monto**                       | Mapea variables del flujo a los campos del monto (montos gravados/no gravados, impuesto, moneda, descripción).                                             |
| **Guardar respuesta**           | Guarda, de forma opcional, la respuesta de la pasarela en una variable del flujo.                                                                          |

<Note>
  Este selector solo lista pasarelas personalizadas conectadas desde **Pagos**. No mezcla proveedores del catálogo ni otras credenciales de la compañía.
</Note>

## Salidas del nodo

El nodo Pagos expone seis salidas que debes conectar en tu flujo:

| Salida                   | Significado                                                                     |
| ------------------------ | ------------------------------------------------------------------------------- |
| Error general            | Cualquier error no manejado al ejecutar el nodo.                                |
| Mensaje enviado          | El paylink fue enviado al cliente.                                              |
| Pago exitoso             | El pago fue confirmado como exitoso (por webhook o por verificación de estado). |
| Pago pendiente           | El pago sigue pendiente de confirmación.                                        |
| Pago fallido             | El pago fue confirmado como fallido.                                            |
| Tiempo de espera agotado | Se cumplió el tiempo de espera configurado sin una resolución.                  |

<Tip>
  El mapeo `Éxito / Fallido / Ninguno` que definiste al configurar el webhook y la verificación de estado de tu pasarela determina únicamente las salidas **Pago exitoso**, **Pago pendiente** y **Pago fallido** — por eso es tan importante dejarlo bien configurado al [crear la pasarela](/guides/integraciones/pagos/personalizadas/crear-pasarela).
</Tip>

<Warning>
  No dejes sin manejar las ramas "Pago fallido" y "Tiempo de espera agotado" — sin ellas, el cliente puede quedar sin respuesta si el cobro no se completa.
</Warning>

## Casos de uso

<AccordionGroup>
  <Accordion title="PSP local no disponible en el catálogo de proveedores">
    Un negocio que opera con un PSP regional que no está en el catálogo de proveedores de Jelou: define su endpoint de checkout como pasarela personalizada y mapea las respuestas del webhook a las salidas del nodo Pagos, sin depender de que Jelou construya una integración dedicada.
  </Accordion>

  <Accordion title="Confirmación por consulta activa de estado">
    Un negocio cuyo PSP no ofrece webhooks confiables: habilita **Verificar estado con el PSP al retorno** al crear la pasarela, y el flujo usa la salida **Pago pendiente** mientras Jelou consulta el estado de la transacción.
  </Accordion>

  <Accordion title="Migración progresiva desde un proveedor del catálogo">
    Un negocio que ya usa un proveedor del catálogo pero necesita agregar un PSP adicional para otro país o método de pago: configura la pasarela personalizada en paralelo y selecciona una u otra en el nodo Pagos según el flujo o segmento de clientes.
  </Accordion>
</AccordionGroup>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Cómo funciona" href="/guides/integraciones/pagos/personalizadas/como-funciona" icon="diagram-project">
    Repasa la arquitectura y los requisitos de compatibilidad.
  </Card>

  <Card title="Catálogo de proveedores" href="/guides/integraciones/pagos/proveedores" icon="credit-card">
    Revisa si tu PSP ya tiene una integración lista para usar.
  </Card>
</CardGroup>