Skip to main content
Pagos en Brain Studio te permite iniciar, ejecutar y confirmar cobros dentro de una conversación (por ejemplo en WhatsApp), y continuar el flujo en función del resultado real de la transacción. La plataforma permite implementar distintas experiencias de pago, según el proveedor y el medio de pago utilizado:
  • WebView embebido en WhatsApp, donde el cliente completa el checkout dentro de la conversación.
  • Experiencia nativa en chat, cuando el medio de pago lo permite.
  • Flujos conversacionales para wallets o transferencias, cuando la confirmación ocurre fuera del checkout tradicional.
Jelou no custodia fondos. Cada usuario implementador utiliza su propia cuenta y credenciales del proveedor de pago correspondiente.

Cómo funciona

Un pago en Brain Studio siempre involucra tres roles claramente separados:
  • 🧠 Brain Studio → Construye la solicitud y expone el estado
  • 💳 Proveedor de pago → Ejecuta la transacción y liquida fondos
  • 🎯 Tu implementación → Decide la siguiente acción según el estado recibido

Responsabilidades de cada parte

  • Construye la solicitud (monto, moneda, metadata).
  • Dispara la operación hacia el proveedor.
  • Recibe el estado y lo expone como resultado.
  • No autoriza ni liquida pagos.

Estados que debes manejar

El proveedor siempre retornará un estado de transacción.
Tu implementación debe manejarlo explícitamente.
El pago fue confirmado correctamente.Tu flujo normalmente debería:
  • Continuar el proceso principal.
  • Confirmar al usuario.
  • Registrar el evento (si aplica).
La operación fue denegada o falló.Tu flujo debería:
  • Informar el error.
  • Permitir reintento o método alternativo.
  • Registrar el motivo si el proveedor lo expone.
El pago aún no tiene confirmación final
(común en efectivo o transferencias).
Tu flujo debería:
  • Definir una estrategia de seguimiento.
  • Consultar estado posteriormente (polling o webhook).
  • Evitar continuar como si estuviera aprobado.
Modela el nodo de pago como una transición determinística:
solicitud → ejecución externa → estado → siguiente acción.

Modelo de integración (BYOK)

Las integraciones de pago del Marketplace funcionan, en su mayoría, con BYOK (Bring Your Own Keys):
  • Conectas el proveedor con tus credenciales (API keys, Access Token u OAuth).
  • El pago se procesa y liquida en la cuenta del comercio dentro del proveedor.
  • Brain Studio orquesta el flujo y trabaja con el estado retornado.
BYOK = tú traes la cuenta y llaves del proveedor. Brain Studio no reemplaza al proveedor: lo integra.

Antes de implementar

Define el alcance de tu caso:
  • País(es) donde vas a operar.
  • Medios de pago requeridos (tarjetas, transferencias, efectivo, métodos locales).
  • Si el comercio ya usa un proveedor específico, parte por ese proveedor.

Flujo típico de implementación

1

Elegir proveedor y experiencia

Define país(es), medio(s) de pago y la experiencia (WebView / nativa / conversacional).
2

Obtener credenciales

Genera credenciales en el panel del proveedor (test y/o producción según tu caso).
3

Instalar desde Marketplace (BYOK)

Instala la integración e ingresa credenciales. El proveedor queda disponible como tool en Brain.
4

Usar en Brain y manejar estados

Implementa el pago en tu flujo y maneja explícitamente Aprobado / Rechazado / Pendiente (cuando aplique).
La práctica recomendada es tratar el pago como una “decisión por estado”: el proveedor devuelve un estado y tu flujo continúa en la rama correcta.

Próximos pasos