Mercado Pago

Para usar el sistema de pago de Mercado Pago, complete la configuración siguiente en su panel de Mercado Pago Developers y luego ingrese los detalles en la configuración de integración.

Aplicación y token de acceso

1. Inicie sesión en Mercado Pago y abra la sección Developers (Desarrolladores / Tus integraciones).

2. Cree una aplicación (Tus integraciones → Crear aplicación) si aún no tiene una.

3. Copie su Token de acceso de producción o Token de acceso de prueba — este token se usará como el token principal de la API.

Para obtener información sobre los tipos de tokens y dónde encontrarlos, consulte: Credenciales.

Webhooks (notificaciones de pago)

1. En la configuración de integración, abra la Webhooks / notificaciones sección (consulte: Webhooks).

2. Configure la URL de notificación:

https://chatter.mavibot.ai/mercado_pago_callback/result

1. Suscríbase a Pagos eventos para poder recibir notificaciones sobre la creación y actualización del estado de los pagos.

2. Guarde el secreto de Webhook — debe ingresarse en la configuración de integración.

Conectando con Mavibot

En la sección Adquisición, seleccione Mercado Pago.

Luego ingrese:

• Token de acceso — el token que copió.

• secreto de Webhook — el secreto utilizado para verificar los webhooks.

Generación de enlace de pago

Función de calculadora: get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)

Parámetros	Descripción
! amount	Monto del pago. Este es un parámetro obligatorio.
description	Descripción del pago. Este es un parámetro opcional.
currency	Código de moneda ISO (p. ej., BRL, ARS, MXN, USD, EUR, CLP, COP, PEN, UYU) — opcional; el valor predeterminado es BRL.
customer_email	Correo electrónico del cliente — opcional.
product_name	Nombre alternativo del producto — opcional; si no se proporciona, se usa la descripción en su lugar.

La función devuelve un enlace de pago.

Este ejemplo muestra cómo pasar parámetros a la función y enviar el enlace de pago en un mensaje.

Pago mediante botón

Para enviar un botón de pago a través de Mercado Pago, seleccione un tipo de botón con compatibilidad de pago en el generador de botones y elija Mercado Pago como sistema de pago. Ingrese el monto, la descripción y la moneda si es necesario.

Callbacks en el diálogo después del pago

Pago exitoso

Después de que el cliente siga el enlace y complete un pago exitoso, se puede enviar un callback al diálogo en el siguiente formato:

<first_10_characters_of_Webhook_secret>_success <amount>

Ejemplo: gltubgnDle_success 100 — donde el prefijo son los primeros 10 caracteres de su secreto de Webhook, y 100 es el monto del pago.

Cómo agregar una reacción a un pago exitoso

Para enviar un mensaje a su cliente después de un pago exitoso (por ejemplo, “El pago se completó correctamente” o cualquier otro mensaje), debe configurar una reacción usando un bloque con un disparador y un callback.

Paso 1

Cree un bloque con una condición (bloque de inicio o bloque de disparador).

Este es el bloque de inicio con un callback en el campo Trigger

Este es el bloque Trigger con un callback en el campo Trigger

Paso 2

Especifique una parte del callback (si necesita reaccionar a todos los pagos, p. ej., cuando tiene varios productos diferentes), o el callback completo (si desea configurar una reacción solo para la venta de un producto específico).

Si necesita configurar una respuesta a cualquier pago en el proyecto, deje una parte del callback y seleccione el tipo de coincidencia "Coincidencia de palabras clave"

Paso 3

Escriba el mensaje de respuesta para un pago exitoso y guarde el bloque. Paso 3. Escriba el mensaje de reacción para un pago exitoso y guarde el bloque.

Pago fallido

Si el pago no es exitoso (rechazado, cancelado, etc., según el estado en la API), se puede enviar un callback en el siguiente formato:

<first_10_characters_of_Webhook_secret>_fail <amount>

Ejemplo: gltubgnDle_fail 100 — donde el prefijo son los primeros 10 caracteres de su secreto de Webhook, y 100 es el monto.

Cómo agregar una reacción a un pago fallido

Para enviar un mensaje a su cliente después de un pago fallido (por ejemplo, “El pago falló” o cualquier otro mensaje), debe configurar una reacción usando un bloque con un disparador y un callback.

Una reacción a un pago fallido se configura de la misma manera que una exitosa.

Paso 1

Cree un bloque con una condición (bloque de inicio o bloque de disparador).

Paso 2

Especifique una parte del callback (si necesita reaccionar a todos los pagos, p. ej., cuando tiene varios productos diferentes), o el callback completo (si desea configurar una reacción solo para la venta de un producto específico).

Paso 3

Escriba el mensaje de respuesta para un pago fallido y guarde el bloque.

Variables del cliente después de un pago exitoso

Variables	Descripción
mercado_pago_callback_data	Información del pago recibida del sistema de pago.
mercado_pago_payment_completed	"True" — el pago se ha procesado como exitoso.
mercado_pago_payment_id	ID de pago de Mercado Pago