Skip to main content
Una vez conectada la integración, el nodo de Mercado Pago queda disponible en Canvas y te permite crear experiencias de cobro con WebView embebido dentro del flujo conversacional.
¿Primera vez implementando un cobro? Sigue primero el Tutorial: tu primer cobro.Si todavía no instalaste la integración, comienza por 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 Mercado Pago.
2

Agregar el nodo Mercado Pago

Agrega Mercado Pago 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 Mercado Pago 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. Completa las pestañas Datos del pago y Avanzado, y revisa las salidas disponibles en el nodo del Canvas.Si faltan campos obligatorios, el nodo muestra el aviso Configuración incompleta. Revisa los campos del nodo. y el badge de ambiente (Desarrollo o Producción).

Configurar el nodo

Nodo Mercado Pago en Canvas con la pestaña Datos del pago abierta en el panel lateral

Pestaña Datos del pago: personalización, montos y email comprador

boolean
predeterminado:"false"
Actívalo para definir los mensajes que acompañan tu botón de pago.Si está activo, habilita los campos Header, Body y Footer.
Ejemplo de mensaje con textos personalizados y botón de pago de Mercado Pago en WhatsApp

Ejemplo de mensaje con botón de pago personalizado en WhatsApp

string
Título del mensaje del botón de pago.Se muestra cuando Personalización está activa.
string
Texto principal del mensaje del botón de pago.Se muestra cuando Personalización está activa.
string
requerido
Texto descriptivo del cobro. Ejemplos: número de orden, producto, servicio o referencia interna.
number
requerido
Monto sobre el que aplica IVA u otro impuesto configurado. Solo números.
number
requerido
Monto exento de impuestos. Solo números. Si no aplica, usa 0.
string
requerido
Correo del comprador que usará el checkout.En Desarrollo, debe ser el email de un usuario de prueba de Mercado Pago del país correspondiente.En Producción, usa el email real del comprador capturado en el flujo.
Si la integración está en Desarrollo, copia uno de estos emails de prueba en Email comprador. Debe ser del mismo país que tus credenciales de prueba.

Salidas del nodo

Las salidas aparecen en el nodo de Mercado Pago en Canvas. Conéctalas según el resultado que quieras manejar en tu flujo.
Se activa cuando Mercado Pago confirma que la transacción fue aprobada.Recomendaciones:
  • confirmar la orden
  • emitir comprobante o notificación
  • actualizar estado de compra en tus sistemas
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 webhook o consulta posterior cuando corresponda
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):
Se activa cuando la transacción fue rechazada, declinada, denegada o no se completa.Recomendaciones:
  • permitir reintento controlado
  • ofrecer ruta de soporte o un camino alterno
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

Probar pagos en modo test

Si Mercado Pago está conectado con credenciales de prueba, el checkout debe completarse con un usuario de prueba de Mercado Pago.
En modo test, el pago es ficticio y no mueve dinero real. El ambiente Desarrollo en el nodo corresponde a credenciales de prueba de Mercado Pago.
1

Confirmar credenciales de prueba

Verifica que Mercado Pago esté instalado con un Access Token de Credenciales de prueba.
2

Configurar el nodo en ambiente de prueba

En la pestaña Avanzado, verifica que el ambiente corresponda a Desarrollo.
3

Usar un email de usuario de prueba

En Email comprador, usa un test user del mismo país que las credenciales conectadas.La lista completa por país está en el tutorial de primer cobro.
4

Probar desde WhatsApp

Dispara el flujo desde WhatsApp, abre el checkout WebView de Mercado Pago y completa el pago con las tarjetas de prueba por país del país correspondiente.
5

Validar la salida del flujo

Verifica por qué salida continúa el flujo:
  • Mensaje de pago enviado (solo envío del botón)
  • Pago exitoso
  • Pago pendiente
  • Pago fallido
  • Error

Pasar a producción

Si instalaste Mercado Pago con credenciales de prueba, puedes iniciar el paso a producción desde la pestaña Avanzado del nodo Mercado Pago en Canvas o desde la página de Mercado Pago en Marketplace. En ambos casos se abre el mismo modal para ingresar el Access Token productivo y confirmar la configuración. Antes de operar con pagos reales:
  • Asegúrate de tener un Access Token de Credenciales de producción en Mercado Pago.
  • Usa el flujo Pasar a producción descrito en Conectar en Brain Studio.
  • Confirma que Moneda y Porcentaje de IVA en el nodo coincidan con la configuración productiva.
  • Reemplaza en el nodo cualquier dato de prueba por datos reales del flujo.
  • En producción, usa el email real del comprador.
  • Ejecuta una prueba real de bajo monto antes de escalar.

Consideraciones importantes

Si instalaste Mercado Pago con credenciales de prueba, usa usuarios de prueba y emails de test. Si instalaste con credenciales de producción, usa datos reales del comprador.
En pruebas, Email comprador debe pertenecer a un usuario de prueba de Mercado Pago del país correspondiente.Si usas un email real en Desarrollo, el checkout puede fallar o no continuar por la salida esperada.
La Moneda y el Porcentaje de IVA del nodo deben coincidir con lo definido al instalar la integración y con el país de tus credenciales de Mercado Pago.
En escenarios pendientes o fallidos, informa con claridad al usuario antes de iniciar un nuevo intento de cobro. Mantén reintentos controlados.
Algunos medios de Mercado Pago pueden quedar pendientes antes de acreditarse. Tu flujo debe manejar Pago pendiente sin asumir que el cobro ya fue confirmado.
Para que el checkout se abra dentro de WhatsApp, la cuenta debe ser WhatsApp Business verificada. Si no lo está, el checkout se abrirá en el navegador externo. Revisa la advertencia en Conectar en Brain Studio.

Próximo paso

Cobertura y precios

Revisa disponibilidad por país, medios de pago y tarifas referenciales de Mercado Pago.