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
- Inicie sesión en Mercado Pago y abra la sección de Desarrolladores (Developers / Suas integrações).
- Cree una aplicación (Your integrations → Create application) si aún no tiene una.
- 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)
- En la configuración de integración, abra la sección Webhooks / уведомления (consulte: Webhooks).
- Establezca la URL de notificación:
https://chatter.mavibot.ai/mercado_pago_callback/result
- Suscríbase a los eventos de Pagos para recibir notificaciones sobre la creación de pagos y actualizaciones de estado.
- 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)
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 |