Saltar al contenido principal
Una vez conectada la integración, el nodo de Wompi queda disponible en Canvas y te permite crear experiencias de cobro con WebView embebido o confirmación externa 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

Nodo Wompi con el panel lateral de configuración abierto


Configurar el nodo

Datos del 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.
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.
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.
string
requerido
Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna.
number
requerido
Monto sobre el que aplica IVA.
number
requerido
Monto exento de impuestos. Si no aplica, usa 0.
string
requerido
Nombre completo del comprador. Idealmente debe venir desde una variable capturada previamente en el flujo.Aplica cuando la Experiencia de pago es Pago WebView.
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.Aplica cuando la Experiencia de pago es Pago WebView.
string
requerido
Define si el titular del pago es persona Natural o Jurídica.Es obligatorio cuando la Experiencia de pago es Pago Confirmación Externa.
string
Nombre de la persona titular del pago.Aplica cuando la Experiencia de pago es Pago Confirmación Externa. Si el flujo no lo envía, el agente conversacional se lo pide directamente al pagador.
string
Apellido de la persona titular del pago.Aplica cuando la Experiencia de pago es Pago Confirmación Externa.
string
Número de cédula si el titular es persona natural, o NIT si es empresa.Aplica cuando la Experiencia de pago es Pago Confirmación Externa.
string
Correo electrónico del titular del pago.Aplica cuando la Experiencia de pago es Pago Confirmación Externa.
string
Teléfono del pagador registrado en Nequi.Aplica solo cuando el pagador elige Nequi dentro de Pago Confirmación Externa. Si no lo envías desde el flujo, el agente lo solicita directamente en la conversación antes de generar el pago.
Campo Teléfono para nequi en el nodo Wompi, con el placeholder Teléfono del pagador en nequi

Campo Teléfono para nequi, visible cuando el pago se hace con Nequi

Panel lateral del nodo Wompi en la pestaña Datos del pago mostrando Tipo de persona, Nombre del titular, Apellido del titular, Número de documento o nit y Correo electrónico

Datos del pago con la Experiencia de pago Confirmación Externa: Tipo de persona, Nombre del titular, Apellido del titular, Número de documento o nit y Correo electrónico

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.
string
requerido
Define cómo el pagador completa la transacción. Opciones disponibles:
  • Pago WebView — abre el checkout de Wompi como WebView embebido dentro de la conversación.
  • Pago Confirmación Externa — un agente conversacional guía al pagador para completar el pago con Nequi o PSE, fuera de WhatsApp.
Nodo Wompi en la pestaña Avanzado mostrando el campo Experiencia de pago con las opciones Pago WebView y Pago Confirmación Externa

Campo Experiencia de pago en la pestaña Avanzado del nodo Wompi

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.
string
requerido
Define la moneda del cobro.Para Wompi Colombia, normalmente usarás COP.
number
Define el porcentaje de IVA aplicado a la operación de cobro.
string
Campo opcional para guardar referencia interna como ID de orden, correlativo, user ID o booking ID.
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.

Cómo funciona la confirmación externa

Cuando seleccionas Pago Confirmación Externa en Experiencia de pago, el nodo activa internamente un agente conversacional que guía al pagador antes de generar el cobro.
1

El agente pregunta el método de pago

El agente le pregunta al pagador con qué método quiere pagar: PSE o Nequi.
Conversación de WhatsApp donde el agente de Wompi pregunta si el pago se hará con PSE o Nequi

El agente pregunta el método de pago

2

El agente completa los datos faltantes

Si el flujo no envía Nombre del titular, Apellido del titular, Número de documento o nit o Correo electrónico, el agente los pide en la conversación. Con PSE, también pide el tipo de documento y el banco.Si el método elegido es Nequi y no se envió Teléfono para nequi, el agente lo solicita puntualmente antes de continuar.
Conversación de WhatsApp donde el agente de Wompi pide el número de teléfono para completar un pago con Nequi

El agente pide el teléfono asociado al pago con Nequi cuando falta en el flujo

3

El agente confirma los datos antes de continuar

El agente muestra un resumen con los datos registrados y pide responder Confirmar para continuar, o indicar qué dato corregir. El resumen varía según el método elegido:
  • PSE: método de pago, titular, documento, email y banco.
  • Nequi: método de pago, titular, documento, email y teléfono.
Conversación de WhatsApp con el resumen de datos para un pago con PSE y la instrucción de responder Confirmar

Resumen de confirmación para un pago con PSE

Conversación de WhatsApp con el resumen de datos para un pago con Nequi y la instrucción de responder Confirmar

Resumen de confirmación para un pago con Nequi

4

El pagador completa el pago fuera de WhatsApp

Según el método elegido:
  • PSE: el agente entrega un botón Proceder al pago que abre un formulario seguro para autorizar la transferencia desde el banco elegido.
  • Nequi: el agente envía la solicitud de pago a la app Nequi del pagador, quien debe abrirla y aprobar el pago.

Confirmación externa con Wompi

5

Brain Studio continúa el flujo según el resultado

Wompi notifica el estado del pago mediante eventos y el nodo continúa por la salida correspondiente (Pago exitoso, Pago pendiente, Pago fallido o Error), igual que en la experiencia WebView.
Con Pago Confirmación Externa, el pago se completa fuera de WhatsApp (en el formulario de PSE o en la app Nequi). El nodo no abre WebView dentro del chat.

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 y confirma la Experiencia de pago que quieres probar (Pago WebView o Pago Confirmación Externa).
3

Completar datos del comprador

Con Pago WebView, usa un email y nombre de prueba o controlado en los campos Email comprador y Nombre completo comprador.Con Pago Confirmación Externa, elige el Tipo de persona y completa (o deja que el agente pida) Nombre del titular, Apellido del titular, Número de documento o nit, Correo electrónico y, si usas Nequi, Teléfono para nequi.
4

Probar desde WhatsApp

Dispara el flujo desde WhatsApp.
  • Con Pago WebView, abre el checkout de Wompi y selecciona un medio de pago de prueba.
  • Con Pago Confirmación Externa, elige PSE o Nequi cuando el agente lo pregunte y sigue el flujo hasta confirmar.
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

Checkout de Wompi en WhatsApp usando datos de prueba 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.
Con Pago Confirmación Externa, el pago no ocurre dentro de WhatsApp. Tu flujo debe manejar Pago pendiente y las salidas finales sin asumir confirmación inmediata, igual que con otros proveedores de confirmación externa.
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.