Para usar el sistema de pago Mercado Pago, complete la configuración a continuación en su panel de desarrolladores de Mercado Pago 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 de Desarrolladores (Developers / Suas integrações).
  2. Cree una aplicación (Your integrations → Create application) si aún no tiene una.
  3. Copie su Token de Acceso de Producción o Token de Acceso de Prueba — este token se utilizará como el token principal de la API.

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

Webhooks (notificaciones de pago)

  1. En la configuración de integración, abra la sección Webhooks / уведомления (consulte: Webhooks).
  2. Establezca la URL de notificación:

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

  1. Suscríbase a los eventos de Pagos para recibir notificaciones sobre la creación de pagos y actualizaciones de estado.
  2. Guarde el secreto del Webhook — debe ingresarse en la configuración de integración.

Conexión con Mavibot

En la sección de Adquirencia, seleccione Mercado Pago.

Luego ingrese:

  • Access Token — el token que copió.
  • Webhook secret — el secreto utilizado para verificar los webhooks.

Generación de enlace de pago

Función de la 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 (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 utiliza la descripción en su lugar.

La función devuelve un enlace de pago.

Pago mediante botón

Para enviar un botón de pago a través de Mercado Pago, seleccione un tipo de botón con soporte de pago en el constructor 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:

<primeros_10_caracteres_del_secreto_del_Webhook>_success <monto>

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, “Pago completado exitosamente” 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).

Paso 2

Especifique parte del callback (si necesita reaccionar a todos los pagos, por ejemplo, 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 exitoso y guarde el bloque.

Pago fallido

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

<primeros_10_caracteres_del_secreto_del_Webhook>_fail <monto>

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, “Pago fallido” o cualquier otro mensaje), debe configurar una reacción usando un bloque con un disparador y un callback.

Una reacción de 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 parte del callback (si necesita reaccionar a todos los pagos, por ejemplo, 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 de pago recibida del sistema de pago.
mercado_pago_payment_completed “True” — el pago ha sido procesado como exitoso.
mercado_pago_payment_id ID de pago de Mercado Pago