> ## 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 Mercado Pago a tu flujo en Canvas, configura sus campos y prueba pagos en modo test.

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.

> [!TIP]
>
> ¿Primera vez implementando un cobro? Sigue primero el [Tutorial: tu primer cobro](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/implementando-tu-primer-cobro.md).
>
> Si todavía no instalaste la integración, comienza por [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/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 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

> [tab] Datos del pago
>
> ![Nodo Mercado Pago en Canvas con la pestaña Datos del pago abierta en el panel lateral](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/mercado-pago-nodo-datos-del-pago.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=0822dbc19dc6a7cde416f531d7e35f1d)
>
> Pestaña Datos del pago: personalización, montos y email comprador
>
> > [accordion] Personalización
> >
> > **Personalización** `boolean` (default: 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](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/mercado-pago-boton-ejemplo.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=f6db5219e43173be92f979306c06505b)
> >
> > Ejemplo de mensaje con botón de pago personalizado en WhatsApp
>
> > [accordion] Header
> >
> > **Header** `string`
> >
> > Título del mensaje del botón de pago.
> >
> > Se muestra cuando **Personalización** está activa.
>
> > [accordion] Body
> >
> > **Body** `string`
> >
> > Texto principal del mensaje del botón de pago.
> >
> > Se muestra cuando **Personalización** está activa.
>
> > [accordion] Footer
> >
> > **Footer** `string`
> >
> > Texto de cierre del mensaje del botón de pago.
> >
> > Se muestra cuando **Personalización** está activa.
>
> > [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 u otro impuesto configurado. Solo números.
>
> > [accordion] Monto libre de impuestos
> >
> > **Monto libre de impuestos** `number` *required*
> >
> > Monto exento de impuestos. Solo números. Si no aplica, usa `0`.
>
> > [accordion] Email comprador
> >
> > **Email comprador** `string` *required*
> >
> > 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.
> >
> > > [!NOTE]
> > >
> > > 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.
> >
> > > [accordion] 🇨🇱 Chile
> > >
> > > ```txt theme={null}
> > > test_user_230383680042455079@testuser.com
> > > ```
> >
> > > [accordion] 🇵🇪 Perú
> > >
> > > ```txt theme={null}
> > > test_user_6344464757279593247@testuser.com
> > > ```
> >
> > > [accordion] 🇨🇴 Colombia
> > >
> > > ```txt theme={null}
> > > test_user_7600640374023229585@testuser.com
> > > ```
> >
> > > [accordion] 🇲🇽 México
> > >
> > > ```txt theme={null}
> > > test_user_538195043292703001@testuser.com
> > > ```
> >
> > > [accordion] 🇧🇷 Brasil
> > >
> > > ```txt theme={null}
> > > test_user_6254528388464257378@testuser.com
> > > ```
> >
> > > [accordion] 🇦🇷 Argentina
> > >
> > > ```txt theme={null}
> > > test_user_1511189314898568640@testuser.com
> > > ```
> >
> > > [accordion] 🇺🇾 Uruguay
> > >
> > > ```txt theme={null}
> > > test_user_1178397850300963040@testuser.com
> > > ```

> [tab] Avanzado
>
> ![Nodo Mercado Pago con la pestaña Avanzado abierta mostrando ambiente, moneda, IVA y guardar respuesta](https://mintcdn.com/jelouai/3D3ye1Wdwh66cTgk/assets/images/integraciones/pagos/mercado-pago-nodo-avanzado.png?fit=max\&auto=format\&n=3D3ye1Wdwh66cTgk\&q=85\&s=3af0bb75a3f715bd06f9ec5ba9361d32)
>
> Pestaña Avanzado: ambiente, expiración, moneda, IVA y guardar respuesta
>
> > [accordion] Ambiente
> >
> > Muestra si Mercado Pago opera en **Desarrollo** o **Producción**.
> >
> > En **Desarrollo**, verás el mensaje *Tu integración está en modo de desarrollo. Pásala a producción cuando estés listo.* y podrás iniciar el flujo para **Pasar a producción**.
> >
> > En **Producción**, el selector refleja que la integración ya opera con credenciales productivas.
> >
> > > [!NOTE]
> > >
> > > El ambiente **Desarrollo** corresponde a una instalación con **credenciales de prueba** de Mercado Pago. **Producción** corresponde a **credenciales de producción**.
> >
> > > [!WARNING]
> > >
> > > No pases a producción sin tener un Access Token de **Credenciales de producción** listo en Mercado Pago.
>
> > [accordion] Expiración del botón de pago
> >
> > **Expiración del botón de pago** `string`
> >
> > Define cuánto tiempo permanece vigente el botón de pago después de enviarlo.
> >
> > Selecciona una opción del listado disponible en Brain Studio.
>
> > [accordion] Moneda
> >
> > **Moneda** `string` *required*
> >
> > Define la moneda del cobro (por ejemplo, `CLP`).
> >
> > Debe coincidir con el país de las credenciales conectadas y con la **Moneda de cobro** definida al instalar la integración en [Conectar en Brain Studio](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/conectar-en-brain-studio.md).
>
> > [accordion] Porcentaje de IVA
> >
> > **Porcentaje de IVA** `number`
> >
> > Define el porcentaje de IVA aplicado a la operación de cobro.
> >
> > Debe ser coherente con el **IVA aplicado** configurado al instalar la integración.
>
> > [accordion] Metadatos del pago
> >
> > **Metadatos del pago** `string`
> >
> > Campo opcional para guardar referencia interna como ID de orden, correlativo o user ID.
>
> > [accordion] Guardar respuesta
> >
> > **Guardar respuesta** `string`
> >
> > Almacena la opción seleccionada en una variable de memoria.
> >
> > Escribe el nombre de la variable después del prefijo `{{$memory.}}`. Máximo **50 caracteres**.
> >
> > La respuesta se almacenará en memoria y estará disponible en nodos posteriores.
> >
> > > [!TIP]
> > >
> > > Útil para trazabilidad, validaciones posteriores o decisiones del flujo.

***

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

> [accordion] Pago exitoso
>
> 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

> [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 webhook o consulta posterior 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 puede esperar soporte o continuar por el canal definido por el flujo.
>
> ────────────────────
> 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 ruta de soporte o un camino alterno

> [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

***

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

> [!NOTE]
>
> 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/implementando-tu-primer-cobro.md#emails-de-prueba-por-país-modo-test--dev).

**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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/implementando-tu-primer-cobro.md#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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/conectar-en-brain-studio.md).
* 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

> [accordion] El ambiente depende de la instalación
>
> 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.

> [accordion] El email comprador es crítico en Desarrollo
>
> 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.

> [accordion] Moneda e IVA deben ser coherentes
>
> 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.

> [accordion] Evita pagos duplicados
>
> En escenarios pendientes o fallidos, informa con claridad al usuario antes de iniciar un nuevo intento de cobro. Mantén reintentos controlados.

> [accordion] Medios de pago y estados pendientes
>
> 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.

> [accordion] WebView embebido en WhatsApp
>
> 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](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/conectar-en-brain-studio.md).

***

## Próximo paso

> [card] [Cobertura y precios](https://docs.jelou.ai/guides/integraciones/pagos/proveedores/mercado-pago/cobertura-y-precios.md)
>
> Revisa disponibilidad por país, medios de pago y tarifas referenciales de Mercado Pago.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.