Guía de Instalación
Configura tu integración de Mercado Pago en tu plataforma en minutos.
Requisito Indispensable
Para realizar esta configuración y asegurar que las sub-cuentas se sincronicen correctamente, es estrictamente necesario que seas un usuario logueado en la agencia con rol de Administrador. Si realizas la instalación sin los permisos adecuados, la conexión de las sub-cuentas fallará.
Creación de la App en Mercado Pago
Debes crear una "Aplicación" dentro del panel para desarrolladores de Mercado Pago para poder obtener el Client ID y Client Secret requeridos. Sigue estos pasos exactos:
Ingresa un nombre descriptivo para identificarla (Ej: Pagos CRM).
Selecciona la opción "Pagos online" como el tipo de producto a integrar.
Cuando te pregunte "¿Cómo hiciste la tienda?", debes seleccionar explícitamente la opción "Checkout Bricks".
Haz clic en Crear aplicación o Confirmar para finalizar. Luego copia tus credenciales desde la pestaña Credenciales de Producción.
Una vez creada la app, ve a Configuraciones avanzadas en el menú lateral. En el campo de "Redirección de URL", pega exactamente esta dirección:
https://mpghl.com/api/auth/mercadopago/callbackEste paso es fundamental para que la conexión de las sub-cuentas funcione correctamente.
Configuración de Webhooks
Para que el CRM se entere automáticamente cuando un pago es aprobado o rechazado, es estrictamente necesario configurar las alertas webhooks dentro de tu aplicación recién creada en Mercado Pago.
1. URL de Producción y Prueba
En el menú lateral de tu aplicación de Mercado Pago, ve a Notificaciones > Webhooks y pega esta URL exacta:
https://mpghl.com/api/webhooks/mercadopago2. Selección de Eventos
Selecciona las siguientes casillas para recibir alertas:
Finalmente haz clic en Guardar.
Credenciales de Test
Si deseas probar los pagos antes de salir a producción de forma segura, puedes configurar credenciales de prueba.Esta configuración debe realizarse a nivel de Agencia. Al completarlas y guardarlas, todas las subcuentas que conecten Mercado Pago tomarán automáticamente esta credencial para operar en modo Sandbox de pruebas.
¿Cómo habilito esto?
Dentro de la plataforma, ingresa a la configuración de tu Agencia y despliega la opción de Credenciales de test configuradas (como se muestra en la imagen de la interfaz de administración). Allí deberás proporcionar el TEST PUBLIC KEY y TEST ACCESS TOKEN que te otorga Mercado Pago y guardar los cambios.
¿Preferís verlo en acción?
Seguí este tutorial paso a paso para completar la configuración.