Agregar el nodo al Canvas
Abrir tu flujo en Canvas
Agregar el nodo Wompi
Conectar el nodo al punto de cobro
Abrir el panel de configuración

Nodo Wompi con el panel lateral de configuración abierto
Configurar el nodo
- Inputs
- Outputs
Datos del pago
Personalizar textos botón de pago
Personalizar textos botón de pago
Header
Header
Body
Body
Motivo de pago
Motivo de pago
Monto sujeto a impuestos
Monto sujeto a impuestos
Monto libre de impuestos
Monto libre de impuestos
0.Nombre completo comprador
Nombre completo comprador
Email comprador
Email comprador
Tipo de persona
Tipo de persona
Nombre del titular
Nombre del titular
Apellido del titular
Apellido del titular
Número de documento o nit
Número de documento o nit
Correo electrónico
Correo electrónico
Teléfono para nequi
Teléfono para nequi

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

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
Ambiente
Ambiente
Experiencia de pago
Experiencia de pago
- 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.

Campo Experiencia de pago en la pestaña Avanzado del nodo Wompi
Expiración del botón de pagos [minutos]
Expiración del botón de pagos [minutos]
Moneda
Moneda
COP.Porcentaje de IVA
Porcentaje de IVA
Metadata del pago
Metadata del pago
Guardar resultado como
Guardar resultado como
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.El agente pregunta el método de pago

El agente pregunta el método de pago
El agente completa los datos faltantes

El agente pide el teléfono asociado al pago con Nequi cuando falta en el flujo
El agente confirma los datos antes de continuar
- PSE: método de pago, titular, documento, email y banco.
- Nequi: método de pago, titular, documento, email y teléfono.

Resumen de confirmación para un pago con PSE

Resumen de confirmación para un pago con Nequi
El pagador completa el pago fuera de WhatsApp
- 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
Brain Studio continúa el flujo según el resultado
Probar pagos en Sandbox
Si Wompi está conectado con credenciales Sandbox, puedes probar el checkout con los datos de prueba publicados por Wompi.Confirmar credenciales Sandbox
pub_test_, prv_test_, test_events_ y test_integrity_.Configurar el nodo en ambiente de prueba
Completar datos del comprador
Probar 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.
Validar la salida del flujo
- Pago exitoso
- Pago pendiente
- Pago fallido
- Error

Checkout de Wompi en WhatsApp usando datos de prueba Sandbox
Datos de prueba en Sandbox
Tarjetas
Tarjetas
- Aprobada:
4242 4242 4242 4242 - Declinada:
4111 1111 1111 1111
ERROR.Nequi
Nequi
- Aprobada:
3991111111 - Declinada:
3992222222
ERROR.PSE
PSE
- Banco que aprueba: genera una transacción aprobada.
- Banco que rechaza: genera una transacción declinada.
Otros medios de pago
Otros medios de pago
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
El ambiente depende de la instalación
El ambiente depende de la instalación
La URL de Eventos debe estar configurada
La URL de Eventos debe estar configurada
Evita pagos duplicados
Evita pagos duplicados
Confirmación externa fuera de WhatsApp
Confirmación externa fuera de WhatsApp
Los datos de Sandbox no sirven en Producción
Los datos de Sandbox no sirven en Producción