Para poder recibir notificaciones sobre las suscripciones y pagos recurrentes, además de crear los planes desde nuestra aplicación, es necesario realizar la configuración del webhook en la aplicación de Mercado Pago. Este paso es necesario ya que de momento, Mercado Pago no nos permite configurarlo al momento de crear el plan.
Pre-requisitos:
- Crear aplicación de Mercado Pago
- Crear conexión con la aplicación de Mercado Pago en la sección de Conexiones
Puedes leer cómo realizar esta conexión en la Guía sobre cómo conectar Mercado Pago
Configuración del Webhook
Una vez creada la conexión con Mercado Pago, vamos a poder verla listada en la sección de conexiones. Para configurar el webhook, es necesario copiar la dirección url que se incluye en la conexión bajo el nombre de “Webhook URL for Mercado Pago”. La misma se muestra en la siguiente imagen dentro del recuadro rojo:
A continuación, deberás acceder al panel de desarrollador de Mercado Pago a través del siguiente enlace: https://www.mercadopago.com/developers
Una vez ingresado, debes abrir las configuraciones de la aplicación creada y buscar la sección de “Webhooks” como se muestra en la imagen a continuación:
Dentro de esta sección, deberás agrega los eventos de “Pagos” y “Planes y Suscripciones”, y luego presionar en “Guardar Configuración”.
La dirección a copiar tendrá el siguiente formato:
https://api.notificationsformercadopago.com/mercadopago-webhook?connection_id=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
Asegúrate de que la dirección y los eventos estén configurados en la pestaña “Modo Productivo” para recibir notificaciones de pagos reales.
Probar la conexión (opcional)
Puedes probar la conexión usando la herramienta “Simular Notificación” que se encuentra en la misma sección de configuración del Webhook de Mercado Pago.
En esta herramienta, puedes seleccionar la URL de producción recién completada, un tipo de evento y un identificador.
Rellena los detalles como se muestra en la imagen anterior y haz clic en “Enviar Prueba”. Esto enviará una notificación de prueba usando el identificador proporcionado. En el ejemplo, se utiliza un identificador inexistente “123456”, por lo que no se creará ninguna notificación en el sistema, pero servirá para probar la conexión. Si está configurada correctamente, deberías ver un mensaje como el siguiente:
