> ## 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. # Uso y configuración > Agrega el nodo de Wompi a tu flujo en Canvas, elige la experiencia de pago (WebView o confirmación externa) y prueba pagos en Sandbox. 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. > [!TIP] > > Si todavía no instalaste la integración, sigue primero [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/wompi/conectar-en-brain-studio.md). *** ## 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](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-nodo-sidebar-configuracion.png?fit=max\&auto=format\&n=R4qL5d7Hj6fxJl87\&q=85\&s=53258340c4f654623a645769ef006345) Nodo Wompi con el panel lateral de configuración abierto *** ## Configurar el nodo > [tab] Inputs > > ### Datos del pago > > > [accordion] Personalizar textos botón de pago > > > > **Personalizar textos botón de pago** `boolean` (default: 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. > > > [accordion] Header > > > > **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. > > > [accordion] Body > > > > **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. > > > [accordion] Footer > > > > **Footer** `string` > > > > Texto de cierre 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. > > > [accordion] Motivo de pago > > > > **Motivo de pago** `string` *required* > > > > Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna. > > > [accordion] Monto sujeto a impuestos > > > > **Monto sujeto a impuestos** `number` *required* > > > > Monto sobre el que aplica IVA. > > > [accordion] Monto libre de impuestos > > > > **Monto libre de impuestos** `number` *required* > > > > Monto exento de impuestos. Si no aplica, usa `0`. > > > [accordion] Nombre completo comprador > > > > **Nombre completo comprador** `string` *required* > > > > Nombre completo del comprador. Idealmente debe venir desde una variable capturada previamente en el flujo. > > > > Aplica cuando la **Experiencia de pago** es **Pago WebView**. > > > [accordion] Email comprador > > > > **Email comprador** `string` *required* > > > > 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**. > > > [accordion] Tipo de persona > > > > **Tipo de persona** `string` *required* > > > > Define si el titular del pago es persona **Natural** o **Jurídica**. > > > > Es obligatorio cuando la **Experiencia de pago** es **Pago Confirmación Externa**. > > > [accordion] Nombre del titular > > > > **Nombre del titular** `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. > > > [accordion] Apellido del titular > > > > **Apellido del titular** `string` > > > > Apellido de la persona titular del pago. > > > > Aplica cuando la **Experiencia de pago** es **Pago Confirmación Externa**. > > > [accordion] Número de documento o nit > > > > **Número de documento o nit** `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**. > > > [accordion] Correo electrónico > > > > **Correo electrónico** `string` > > > > Correo electrónico del titular del pago. > > > > Aplica cuando la **Experiencia de pago** es **Pago Confirmación Externa**. > > > [accordion] Teléfono para nequi > > > > **Teléfono para nequi** `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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-nodo-input-telefono-nequi.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=da19bbe5956480ad99d743092493fb18) > > > > 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-nodo-datos-pago-confirmacion-externa.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=ef7038e10551149a0e2c9e39946fa6d5) > > 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 > > > [accordion] Ambiente > > > > 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. > > > > > [!WARNING] > > > > > > 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. > > > [accordion] Experiencia de pago > > > > **Experiencia de pago** `string` *required* > > > > 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-nodo-avanzado-experiencia-pago.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=2d6400f14a36d9c307b9eb12d490426b) > > > > Campo Experiencia de pago en la pestaña Avanzado del nodo Wompi > > > [accordion] Expiración del botón de pagos \[minutos] > > > > **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. > > > [accordion] Moneda > > > > **Moneda** `string` *required* > > > > Define la moneda del cobro. > > > > Para Wompi Colombia, normalmente usarás `COP`. > > > [accordion] Porcentaje de IVA > > > > **Porcentaje de IVA** `number` > > > > Define el porcentaje de IVA aplicado a la operación de cobro. > > > [accordion] Metadata del pago > > > > **Metadata del pago** `string` > > > > Campo opcional para guardar referencia interna como ID de orden, correlativo, user ID o booking ID. > > > [accordion] Guardar resultado como > > > > **Guardar resultado como** `string` > > > > Define el nombre de la variable donde Brain Studio guardará el JSON completo de respuesta del nodo. > > > > > [!TIP] > > > > > > Útil para trazabilidad, validaciones posteriores o decisiones del flujo. > [tab] Outputs > > > [accordion] Pago exitoso > > > > Se activa cuando Wompi confirma que la transacción fue aprobada. > > > > Recomendaciones: > > > > * confirmar la orden > > * emitir comprobante o actualizar estado en sistemas externos > > > [accordion] Pago pendiente > > > > Se activa cuando la transacción queda en proceso o requiere confirmación posterior. > > > > Recomendaciones: > > > > * informar al usuario con claridad > > * evitar crear un segundo cobro mientras se resuelve el estado > > * esperar actualización por evento cuando corresponda > > > [accordion] Mensaje de pago enviado > > > > Se activa cuando el mensaje con el botón de pago se envía correctamente en la conversación. > > > > Esta salida **no** confirma el pago. Solo indica que el mensaje con el botón de pago fue enviado correctamente en la conversación. > > > > Puedes conectar esta salida a un **AI Agent de soporte post-envío del mensaje de pago** para asistir al usuario mientras decide abrir el checkout o si tiene dudas antes de pagar. > > > > **Recomendaciones:** > > > > * resolver dudas sobre cómo abrir el botón de pago > > * ayudar si el WebView no carga o el usuario no entiende el paso > > * evitar crear un nuevo cobro sin contexto > > * no confirmar pagos desde esta salida > > > > **Ejemplo de prompt (referencial):** > > > > ```txt theme={null} > > Actúa como “Soporte de Pago”, un asistente breve para ayudar al usuario después de recibir un mensaje con botón de pago dentro de WhatsApp. > > > > Contexto: > > El usuario acaba de recibir un mensaje con botón de pago para abrir un checkout en WebView. Tu rol es responder dudas simples antes de que el usuario complete el pago. > > > > ──────────────────── > > INTERRUPCIÓN INMEDIATA > > ──────────────────── > > Si el último mensaje o evento recibido contiene señales de resultado de pago, NO respondas. > > > > Señales de resultado de pago: > > - pago exitoso, pago aprobado, pago completado > > - pago pendiente > > - pago fallido, rechazado, declinado o denegado > > - error de pago > > - confirmación automática del proveedor > > - recibo, comprobante, número de operación, transaction ID, payment ID > > - mensajes con estructura de comprobante, montos, método de pago o estado final > > > > Cuando detectes cualquiera de estas señales, detén tu ejecución inmediatamente. El resultado del pago debe ser manejado por las salidas oficiales del nodo de pago, no por este agente. > > > > ──────────────────── > > COMPORTAMIENTO > > ──────────────────── > > - Si el usuario no hizo una pregunta o no reportó un problema, no respondas. > > - Si el usuario tiene una duda, responde de forma breve, clara y útil. > > - No confirmes pagos. > > - No inventes estados de pago. > > - No recalcules montos. > > - No prometas reversos, aprobaciones, reembolsos ni tiempos de acreditación. > > - No generes nuevos links ni nuevos cobros. > > - Si el usuario necesita ayuda humana, indícale que será derivado según el flujo de soporte definido por el comercio. > > > > ──────────────────── > > QUÉ PUEDES RESPONDER > > ──────────────────── > > Puedes ayudar con: > > - cómo abrir el botón de pago > > - qué hacer si el WebView no carga > > - qué hacer si el usuario cerró el checkout > > - dudas básicas sobre completar el formulario de pago > > - orientación general si el pago aparece pendiente o rechazado, sin confirmar el estado > > > > ──────────────────── > > RESPUESTAS SUGERIDAS > > ──────────────────── > > Si el usuario pregunta cómo pagar: > > “Abre el botón de pago y sigue las instrucciones del checkout. Cuando termines, vuelve a esta conversación.” > > > > Si el WebView no carga: > > “Intenta abrir el botón nuevamente y revisa tu conexión. Si el problema continúa, puedes intentar más tarde o pedir ayuda por este mismo chat.” > > > > Si el usuario dice que el pago fue rechazado: > > “Puedes revisar los datos ingresados e intentarlo nuevamente. Si el problema continúa, usa otro método de pago o solicita ayuda por este canal.” > > > > Si el usuario dice que ya pagó: > > No confirmes el pago. No respondas si el mensaje parece ser un resultado automático o comprobante. Si es solo una frase del usuario, responde: > > “Gracias. Esperemos la confirmación del pago para continuar.” > > > > ──────────────────── > > CIERRE > > ──────────────────── > > Si el usuario dice que ya no necesita ayuda, responde breve: > > “Perfecto. Si necesitas algo más, aquí estaré.” > > ``` > > > [accordion] Pago fallido > > > > Se activa cuando la transacción fue rechazada, declinada, denegada o no se completa. > > > > Recomendaciones: > > > > * permitir reintento controlado > > * ofrecer soporte o un camino alternativo > > > [accordion] Error > > > > Se activa ante errores técnicos, errores del proveedor o fallas de comunicación durante la creación o el procesamiento del pago. > > > > Recomendaciones: > > > > * registrar el error > > * mostrar mensaje de contingencia > > * reintentar de forma controlada y escalar si persiste *** ## 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-confirmacion-externa-seleccion-metodo.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=1dd1810d0a1570ceee370f2a8f5063c2) 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-confirmacion-externa-solicitud-telefono-nequi.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=59769c4c70ca51f22995af06e31cec67) 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-confirmacion-externa-resumen-pse.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=1387ab8477cfaa88cb980376c43a7822) 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](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/wompi-confirmacion-externa-resumen-nequi.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=bb66c0bf51af08be1dfa0990a102db61) 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. > [!NOTE] > > 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. > [!NOTE] > > 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](https://mintcdn.com/jelouai/R4qL5d7Hj6fxJl87/assets/images/integraciones/pagos/wompi-webview-whatsapp-sandbox.gif?s=a4b578345b793984fe113b4cee8a0ca1) Checkout de Wompi en WhatsApp usando datos de prueba Sandbox *** ## Datos de prueba en Sandbox > [!NOTE] > > Los datos de prueba aplican solo cuando la integración está instalada con credenciales Sandbox y el nodo se ejecuta en ambiente de prueba. > [accordion] Tarjetas > > 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`. > [accordion] Nequi > > Para probar pagos con Nequi: > > * **Aprobada:** `3991111111` > * **Declinada:** `3992222222` > > Cualquier otro número puede generar una transacción con estado `ERROR`. > [accordion] PSE > > 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. > [accordion] Otros medios de pago > > 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](https://docs.wompi.co/docs/colombia/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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/wompi/conectar-en-brain-studio.md). * 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 > [accordion] El ambiente depende de la instalación > > Si instalaste Wompi con credenciales Sandbox, prueba con datos de prueba. Si instalaste con credenciales de Producción, usa datos reales. > [accordion] La URL de Eventos debe estar configurada > > 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. > [accordion] Evita pagos duplicados > > En escenarios pendientes o fallidos, informa con claridad antes de iniciar otro intento de cobro. Mantén reintentos controlados. > [accordion] Confirmación externa fuera de WhatsApp > > 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. > [accordion] Los datos de Sandbox no sirven en Producción > > Tarjetas, teléfonos y bancos de prueba solo aplican en Sandbox. En producción el usuario debe usar datos reales. *** ## Próximo paso > [card] [Cobertura y precios](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/wompi/cobertura-y-precios.md) > > Revisa disponibilidad, moneda, medios de pago y consideraciones comerciales de Wompi. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.