Saltar al contenido principal
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.
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 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

Nodo Conekta en Canvas con el panel lateral abierto en Datos del pago


Configurar el nodo

Datos del pago

boolean
predeterminado:"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.
string
Título del mensaje del botón de pago.Se muestra cuando Personalización está activa. Aparece en la vista previa del mensaje.
string
Texto principal del mensaje del botón de pago.Se muestra cuando Personalización está activa. Aparece en la vista previa del mensaje.
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.
string
requerido
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}}.
number
requerido
Monto sobre el que aplica IVA. Solo números.Puedes mapearlo desde variables del flujo.
number
requerido
Monto exento de impuestos. Si no aplica, usa 0. Solo números.Puedes mapearlo desde variables del flujo.
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.
string
Apellido de la persona titular del pago.Aplica cuando la Experiencia de pago es Pago Confirmación Externa.
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.
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

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

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

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

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.
El ambiente depende de las credenciales instaladas. No pases a producción sin preparar credenciales productivas.
string
requerido
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

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

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 Conekta México, normalmente usarás MXN.
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 de memoria donde Brain Studio almacenará la respuesta del nodo.La respuesta quedará disponible en nodos posteriores del flujo, por ejemplo {{$memory.paymentResponse}}.
Ú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

Pestaña Avanzado del nodo Conekta


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)

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

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.
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.
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.
  • 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

Si instalaste Conekta con credenciales de prueba, prueba con datos de prueba. Si instalaste con credenciales de producción, usa datos reales.
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 y medios de prueba solo aplican en ambiente de prueba. 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 Conekta.