> ## 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 Conekta a tu flujo en Canvas, elige la experiencia de pago (WebView o confirmación externa) y prueba pagos en ambiente de prueba. Una vez conectada la integración, el nodo de **Conekta** 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/conekta/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 Conekta. **2. Agregar el nodo Conekta** Agrega **Conekta** 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 Conekta después de que el flujo ya tenga el monto 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 Conekta en Canvas con salidas del pago y panel lateral en la pestaña Datos del pago con Personalización desactivada](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-nodo-sidebar-configuracion.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=f297b76ce62cf53c5664f4918513802b) Nodo Conekta en Canvas con el panel lateral abierto en Datos del pago *** ## Configurar el nodo > [tab] Inputs > > ### Datos del pago > > > [accordion] Personalización > > > > **Personalización** `boolean` (default: false) > > > > Actívalo para definir los mensajes que acompañan el botón de pago en la conversación. > > > > Si está desactivado, Brain Studio usa los textos predeterminados del mensaje de cobro. > > > [accordion] Encabezado > > > > **Encabezado** `string` > > > > Título del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. Aparece en la vista previa del mensaje. > > > [accordion] Contenido > > > > **Contenido** `string` > > > > Texto principal del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. Aparece en la vista previa del mensaje. > > > [accordion] Pie de página > > > > **Pie de página** `string` > > > > Texto de cierre del mensaje del botón de pago. > > > > Se muestra cuando **Personalización** está activa. Aparece en la vista previa del mensaje. > > > [accordion] Motivo de pago > > > > **Motivo de pago** `string` *required* > > > > Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna. > > > > Puedes mapearlo desde variables del flujo, por ejemplo `{{$memory.paymentBreakdown.summary}}`. > > > [accordion] Monto sujeto a impuestos > > > > **Monto sujeto a impuestos** `number` *required* > > > > Monto sobre el que aplica IVA. Solo números. > > > > Puedes mapearlo desde variables del flujo. > > > [accordion] Monto libre de impuestos > > > > **Monto libre de impuestos** `number` *required* > > > > Monto exento de impuestos. Si no aplica, usa `0`. Solo números. > > > > Puedes mapearlo desde variables del flujo. > > > [accordion] Nombre del titular > > > > **Nombre del titular** `string` > > > > Nombre de la persona o razón social de la empresa 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` > > > > El campo aparece en el nodo porque se comparte con Wompi, pero **Conekta no lo usa**: puedes dejarlo vacío. El agente tampoco se lo pide al pagador. > > > [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**. > > ![Panel lateral del nodo Conekta en la pestaña Datos del pago con Personalización activa, campos Encabezado, Contenido, Pie de página, vista previa del mensaje y montos del cobro](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-nodo-datos-del-pago.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=84d6caefc182d0da0c3220313ec31a81) > > Datos del pago con personalización del botón activa > > ![Panel lateral del nodo Conekta en la pestaña Datos del pago mostrando los campos 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/conekta-nodo-datos-pago-confirmacion-externa.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=db4cc16b73420ff783adc215c5b3d241) > > Datos del pago con la Experiencia de pago Confirmación Externa: campos Nombre del titular, Apellido del titular, Número de documento o nit y Correo electrónico > > > [!NOTE] > > > > Con **Personalización** desactivada, el panel muestra directamente los campos del cobro. El nodo en Canvas expone las salidas **Pago exitoso**, **Pago pendiente**, **Mensaje de pago enviado**, **Pago fallido** y **Error**. > > ### Avanzado > > > [accordion] Ambiente > > > > El bloque **Ambiente** muestra si Conekta 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 Conekta ya opera con credenciales productivas. > > > > > [!WARNING] > > > > > > El ambiente depende de las credenciales instaladas. No pases a producción sin preparar credenciales productivas. > > > [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 Conekta como WebView embebido dentro de la conversación. > > * **Pago Confirmación Externa** — un agente conversacional guía al pagador para completar el pago mediante **aprobación desde la app BBVA Wallet** o **código SPEI**, fuera de WhatsApp. > > > > ![Nodo Conekta 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/conekta-nodo-avanzado-experiencia-pago.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=38759431566fa544c8d60ac8c23093ac) > > > > Campo Experiencia de pago en la pestaña Avanzado del nodo Conekta > > > [accordion] Expiración del botón de pago > > > > **Expiración del botón de pago** `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 Conekta México, normalmente usarás `MXN`. > > > [accordion] Porcentaje de IVA > > > > **Porcentaje de IVA** `number` > > > > Define el porcentaje de IVA aplicado a la operación de cobro. > > > [accordion] Metadatos del pago > > > > **Metadatos del pago** `string` > > > > Campo opcional para guardar referencia interna como ID de orden, correlativo, user ID o booking ID. > > > [accordion] Guardar respuesta > > > > **Guardar respuesta** `string` > > > > Define el nombre de la variable de memoria donde Brain Studio almacenará la respuesta del nodo. > > > > La respuesta quedará disponible en nodos posteriores del flujo, por ejemplo `{{$memory.paymentResponse}}`. > > > > > [!TIP] > > > > > > Útil para trazabilidad, validaciones posteriores o decisiones del flujo. > > ![Panel lateral del nodo Conekta mostrando la pestaña Avanzado con expiración del botón, moneda MXN, IVA, metadatos y guardar respuesta](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/conekta-nodo-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=16ec102e31f28444899a076583a17241) > > Pestaña Avanzado del nodo Conekta > [tab] Outputs > > > [accordion] Pago exitoso > > > > Se activa cuando Conekta 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} > > INTERRUPCIÓN INMEDIATA: > > - Si el último mensaje del usuario contiene la estructura de un recibo de pago (incluye elementos como "Pago aprobado", "N° de operación", "Pagamento aprovado", "Operação", el símbolo ✅ seguido de datos de transacción, separadores ━━━, o patrones como "Monto:", "Valor:", "Medio de pago:", "Método:"), NO respondas absolutamente nada. Ejecuta end_function de inmediato con status "payment_completed". > > > > > > Eres "Soporte de Pago", un asistente de ayuda para completar pagos de prueba dentro de WhatsApp. Contexto: el usuario acaba de recibir un botón (CTA) para realizar un pago de prueba junto con los datos de una tarjeta ficticia. Tu rol NO es vender ni recalcular montos: solo ayudar a completar el pago o resolver problemas del botón. > > > > > > COMPORTAMIENTO CLAVE > > > > - Este agente puede ejecutarse sin que el usuario haya escrito nada. > > - Si NO hay una pregunta o problema explícito del usuario en el último mensaje, envía SOLO este mensaje proactivo (una sola vez) y luego quédate en modo reactivo:"Si tienes cualquier duda con tu pago, escríbeme por aquí y te ayudo." > > - Si el usuario SÍ escribe (pregunta/problema), responde directo, breve y claro. > > - No reinicies el proceso. No recalcules montos. No generes nuevos enlaces. No inventes información. > > - Máximo 1 emoji por mensaje. > > > > QUÉ SOPORTAS > > - Cómo pagar desde el botón. > > - No abre el botón / error al cargar. > > - Dudas sobre los datos de la tarjeta de prueba. > > - Pago pendiente o rechazado. > > - Problemas con el formulario de pago. > > > > Si el usuario reporta un problema: > > 1) Pide una descripción corta. > > 2) Si ayuda, pide captura de pantalla (puede enviar imágenes). > > 3) Sugiere intentar de nuevo o indica que puede escalar la consulta. > > > > CONTEXTO DEL DEMO > > - Los datos de tarjeta que el usuario recibió son ficticios y seguros, no generan cargos reales. > > - El formulario de pago se abre desde el botón CTA que ya recibió. > > - Este es un entorno de prueba para demostrar cómo funcionan los pagos en Brain Studio. > > > > CIERRE / FIN DE LA TAREA > > Si el usuario dice que ya pagó y no necesita más ayuda (ej. "listo", "gracias", "ya pagué", "era eso", "todo bien"), responde corto y cierra: > > Español: "Perfecto. Si necesitas algo más, aquí estaré." > > Portugués: "Perfeito. Se precisar de algo mais, estarei por aqui." > > Luego ejecuta end_function con status "completed". > > > > ## TERMINACIÓN > > > > Ejecuta end_function en estos casos: > > - WHEN: El mensaje contiene estructura de recibo de pago (✅, ━━━, "Pago aprobado", "Pagamento aprovado", "N° de operación", "Operação") → status: "payment_completed", message: "" (vacío, no respondas nada) > > - WHEN: El usuario indica que terminó o no necesita más ayuda → status: "completed", message: "" > > > > ## Reglas Operativas > > > > - Siempre ejecuta end_function con este formato: > > { > > "output_schema": "{\"status\": \"payment_completed|completed\", \"message\": \"...\"}" > > } > > - Para payment_completed: message DEBE ser string vacío "". No generes ningún texto de respuesta antes de ejecutar end_function. > > ``` > > > [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 solicita los datos del pagador** Si el flujo no envía **Nombre del titular**, **Apellido del titular** o **Correo electrónico**, el agente se los pide directamente en la conversación, junto con el **tipo de pago**: aprobación desde la app **BBVA Wallet** (el agente la muestra como "redirección externa a BBVA") o **código único SPEI**. El pagador puede responder todos los datos juntos, por partes, o incluso con una nota de voz. ![Conversación de WhatsApp donde el agente de Conekta solicita nombre, apellido, correo electrónico y tipo de pago (redirección BBVA o código SPEI)](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/conekta-confirmacion-externa-solicitud-datos.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=c9c27cb0cfaef439a1c75c63f9164987) El agente solicita los datos faltantes para generar el pago con Conekta **2. 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. ![Conversación de WhatsApp con el resumen de datos del pagador y la instrucción de responder Confirmar para continuar](https://mintcdn.com/jelouai/1_JmEPMrIr40GNhs/assets/images/integraciones/pagos/conekta-confirmacion-externa-resumen-confirmacion.png?fit=max\&auto=format\&n=1_JmEPMrIr40GNhs\&q=85\&s=e80c300db3c138b3c93c9141e63fc98c) Resumen de confirmación antes de generar el pago **3. El pagador completa el pago fuera de WhatsApp** Según el **tipo de pago** elegido: * **Aprobación desde BBVA Wallet:** el pagador aprueba el pago desde la app **BBVA Wallet**. * **Código único SPEI:** el agente entrega un código para pegar en la plataforma bancaria del pagador y completar la transferencia. Confirmación externa con Conekta: aprobación desde BBVA Wallet **4. Brain Studio continúa el flujo según el resultado** Conekta notifica el estado del pago mediante webhook 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 la app BBVA Wallet o en la plataforma bancaria del pagador). El nodo no abre WebView ni captura tarjeta dentro del chat. *** ## Probar pagos en ambiente de prueba Si Conekta está conectado con credenciales de **prueba**, puedes probar el checkout con los datos de prueba publicados por Conekta. > [!NOTE] > > En ambiente de prueba, el pago es ficticio y no mueve dinero real. **1. Confirmar credenciales de prueba** Verifica que Conekta esté instalado con credenciales del ambiente de prueba. **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. Probar desde WhatsApp** Dispara el flujo desde WhatsApp. * Con **Pago WebView**, abre el checkout de Conekta y selecciona un medio de pago de prueba. * Con **Pago Confirmación Externa**, completa los datos que te pida el agente y sigue el flujo de **aprobación desde BBVA Wallet** o **código SPEI**. **4. Validar la salida del flujo** Verifica por qué salida continúa el flujo: * **Pago exitoso** * **Pago pendiente** * **Pago fallido** * **Error** *** ## Pasar a producción Si instalaste Conekta con credenciales de **desarrollo/prueba**, puedes iniciar el paso a producción desde la pestaña **Avanzado** del nodo Conekta en **Canvas** o desde la página de **Conekta** 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 y llave privada. * Usa el flujo **Pasar a producción** descrito en [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/conekta/conectar-en-brain-studio.md). * Reemplaza en el nodo cualquier dato de prueba por datos reales del flujo. * Ejecuta una prueba real de bajo monto antes de escalar. *** ## Consideraciones importantes > [accordion] El ambiente depende de la instalación > > Si instalaste Conekta con credenciales de prueba, prueba con datos de prueba. Si instalaste con credenciales de producción, usa datos reales. > [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 prueba no sirven en producción > > Tarjetas y medios de prueba solo aplican en ambiente de prueba. En producción el usuario debe usar datos reales. *** ## Próximo paso > [card] [Cobertura y precios](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/conekta/cobertura-y-precios.md) > > Revisa disponibilidad, moneda, medios de pago y consideraciones comerciales de Conekta. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.