Skip to main content
Una vez conectada la integración, el nodo de Conekta queda disponible en Canvas y te permite crear experiencias de cobro con WebView embebido 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.
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

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
predeterminado:"WebView"
Indica que el checkout de Conekta se abre como WebView embebido dentro de la experiencia conversacional.
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


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

Probar desde WhatsApp

Dispara el flujo desde WhatsApp, abre el checkout WebView de Conekta y selecciona un medio de pago de prueba.
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.
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.