Saltar al contenido principal

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.

Una vez conectada la integración, el nodo de Wompi queda disponible en Canvas y te permite crear experiencias de cobro con WebView embebido dentro del flujo conversacional.
Si todavía no instalaste la integración, sigue primero Conectar en Brain Studio.

Agregar el nodo al Canvas

1

Abrir tu flujo en Canvas

Abre en Brain Studio el flujo donde quieres incorporar el cobro con Wompi.
2

Agregar el nodo Wompi

Agrega Wompi desde la barra de herramientas de Canvas, en el nodo Pagos, o desde los proveedores de pago disponibles una vez instalada la integración.El punto exacto puede variar según si iniciaste la instalación desde Marketplace, Jelou Agent, el nodo de pagos en Canvas o un template.
3

Conectar el nodo al punto de cobro

Conecta el nodo de Wompi después de que el flujo ya tenga el monto, los datos del comprador y la confirmación de compra.
4

Abrir el panel de configuración

Selecciona el nodo para abrir el panel lateral derecho y completar los inputs y revisar las salidas disponibles.
Nodo Wompi en Canvas con el panel lateral de configuración abierto

Configurar el nodo

Datos del pago

Personalizar textos botón de pago
boolean
predeterminado:"false"
Permite definir el mensaje que acompaña el botón de pago en la conversación.Si se activa, habilita Header, Body y Footer cuando estén disponibles en tu versión del nodo.
Header
string
Título del mensaje del botón de pago.Se muestra cuando Personalizar textos botón de pago está activo y el campo está disponible en tu versión del nodo.
Body
string
Texto principal del mensaje del botón de pago.Se muestra cuando Personalizar textos botón de pago está activo y el campo está disponible en tu versión del nodo.
Motivo de pago
string
requerido
Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna.
Monto sujeto a impuestos
number
requerido
Monto sobre el que aplica IVA.
Monto libre de impuestos
number
requerido
Monto exento de impuestos. Si no aplica, usa 0.
Nombre completo comprador
string
requerido
Nombre completo del comprador. Idealmente debe venir desde una variable capturada previamente en el flujo.
Email comprador
string
requerido
Correo del comprador que usará el checkout.En Sandbox puede ser un correo de prueba o controlado. En producción debe ser el email real del comprador.

Avanzado

El bloque Ambiente muestra si Wompi opera en Desarrollo o Producción.Si la integración está en Desarrollo, desde ahí puedes iniciar el flujo para Pasar a producción.Si la integración está en Producción, el bloque refleja que Wompi ya opera con credenciales productivas.
El ambiente depende de las credenciales instaladas. No pases a producción sin preparar credenciales productivas y configurar la URL de Eventos correspondiente en Wompi.
Experiencia de pago
string
predeterminado:"WebView"
Indica que el checkout de Wompi se abre como WebView embebido dentro de la experiencia conversacional.
Expiración del botón de pagos [minutos]
number
Define cuánto tiempo permanece vigente el botón de pago después de enviarlo.Los valores disponibles dependen de la configuración visible en Brain Studio.
Moneda
string
requerido
Define la moneda del cobro.Para Wompi Colombia, normalmente usarás COP.
Porcentaje de IVA
number
Define el porcentaje de IVA aplicado a la operación de cobro.
Metadata del pago
string
Campo opcional para guardar referencia interna como ID de orden, correlativo, user ID o booking ID.
Guardar resultado como
string
Define el nombre de la variable donde Brain Studio guardará el JSON completo de respuesta del nodo.
Útil para trazabilidad, validaciones posteriores o decisiones del flujo.

Probar pagos en Sandbox

Si Wompi está conectado con credenciales Sandbox, puedes probar el checkout con los datos de prueba publicados por Wompi.
En Sandbox, el pago es ficticio y no mueve dinero real.
1

Confirmar credenciales Sandbox

Verifica que Wompi esté instalado con credenciales que tengan prefijos pub_test_, prv_test_, test_events_ y test_integrity_.
2

Configurar el nodo en ambiente de prueba

En la pestaña Avanzado, verifica que el ambiente corresponda a desarrollo/prueba.
3

Completar datos del comprador

Usa un email y nombre de prueba o controlado en los campos Email comprador y Nombre completo comprador.
4

Probar desde WhatsApp

Dispara el flujo desde WhatsApp, abre el checkout WebView de Wompi y selecciona un medio de pago de prueba.
5

Validar la salida del flujo

Verifica por qué salida continúa el flujo:
  • Pago exitoso
  • Pago pendiente
  • Pago fallido
  • Error
Animación del checkout WebView de Wompi abierto desde WhatsApp para completar un pago de prueba en Sandbox

Datos de prueba en Sandbox

Los datos de prueba aplican solo cuando la integración está instalada con credenciales Sandbox y el nodo se ejecuta en ambiente de prueba.
Para probar pagos con tarjeta en Sandbox:
  • Aprobada: 4242 4242 4242 4242
  • Declinada: 4111 1111 1111 1111
Usa cualquier fecha de expiración futura y un CVC de 3 dígitos.Si usas otra tarjeta, el estado final puede ser ERROR.
Para probar pagos con Nequi:
  • Aprobada: 3991111111
  • Declinada: 3992222222
Cualquier otro número puede generar una transacción con estado ERROR.
En el checkout de Wompi, usa los bancos de prueba disponibles:
  • Banco que aprueba: genera una transacción aprobada.
  • Banco que rechaza: genera una transacción declinada.
Wompi también publica datos de prueba para medios como Botón Bancolombia, Bancolombia QR, Puntos Colombia, DaviPlata, BNPL Bancolombia y otros métodos disponibles según la cuenta.Consulta la documentación oficial de Wompi sobre datos de prueba en Sandbox para revisar el detalle actualizado.

Pasar a producción

Si instalaste Wompi con credenciales de desarrollo/Sandbox, puedes iniciar el paso a producción desde la pestaña Avanzado del nodo Wompi en Canvas o desde la página de Wompi en Marketplace. En ambos casos se abre el mismo modal para ingresar credenciales productivas y confirmar la configuración correspondiente. Antes de operar con pagos reales:
  • Asegúrate de tener credenciales de Producción completas: llave pública, llave privada, secreto de eventos y secreto de integridad. También confirma que la URL de Eventos esté correctamente configurada en Wompi.
  • Usa el flujo Pasar a producción descrito en Conectar en Brain Studio.
  • Reemplaza en el nodo cualquier dato de prueba por datos reales del flujo.
  • En producción, usa el email y nombre real del comprador.
  • Ejecuta una prueba real de bajo monto antes de escalar.

Consideraciones importantes

Si instalaste Wompi con credenciales Sandbox, prueba con datos de prueba. Si instalaste con credenciales de Producción, usa datos reales.
El estado final del pago depende de los eventos que Wompi envía a Jelou. Si la URL de Eventos no está configurada en el ambiente correcto, el flujo puede no avanzar por la salida esperada.
En escenarios pendientes o fallidos, informa con claridad antes de iniciar otro intento de cobro. Mantén reintentos controlados.
Tarjetas, teléfonos y bancos de prueba solo aplican en Sandbox. En producción el usuario debe usar datos reales.

Próximo paso

Cobertura y precios

Revisa disponibilidad, moneda, medios de pago y consideraciones comerciales de Wompi.