Notificaciones
Las notificaciones son mensajes enviados por el servidor de Mercado Pago a partir de eventos realizados en tu aplicaciĆ³n. Para que estas notificaciones sean enviadas, debes activar distintos tĆ³picos de notificaciĆ³n, sea por medio de Tus integraciones o al crear un pago, que te informarĆ”n sobre los diferentes eventos ocurridos.
La activaciĆ³n de estos tĆ³picos dependerĆ” de la soluciĆ³n de Mercado Pago que hayas integrado y de las necesidades de negocio. Conoce cuĆ”les son, tomando como referencia la tabla a continuaciĆ³n:
Eventos | Nombre en Tus integraciones | TĆ³pico | Productos asociados |
CreaciĆ³n y actualizaciĆ³n de pagos | Pagos | payment | Checkout API Checkout Pro Checkout Bricks Suscripciones Wallet Connect |
Pago recurrente de una suscripciĆ³n (creaciĆ³n y actualizaciĆ³n) | Planes y suscripciones | subscription_authorized_payment | Suscripciones |
VinculaciĆ³n de una suscripciĆ³n (creaciĆ³n y actualizaciĆ³n) | Planes y suscripciones | subscription_preapproval | Suscripciones |
VinculaciĆ³n de un plan de suscripciĆ³n (creaciĆ³n y actualizaciĆ³n) | Planes y suscripciones | subscription_preapproval_plan | Suscripciones |
VinculaciĆ³n y desvinculaciĆ³n de cuentas conectadas a travĆ©s de OAuth. | VinculaciĆ³n de aplicaciones | mp-connect | Todos los productos que hayan implementado OAuth |
Transacciones de Wallet Connect | Wallet Connect | wallet_connect | Wallet Connect |
Alertas de fraude luego del procesamiento de un pedido | Alertas de fraude | stop_delivery_op_wh / delivery_cancellation | Checkout API Checkout PRO |
CreaciĆ³n de reclamos y reembolsos | Reclamos | topic_claims_integration_wh | Checkout API Checkout Pro Checkout Bricks Suscripciones CĆ³digo QR Wallet Connect |
RecuperaciĆ³n y actualizaciĆ³n informaciĆ³n de tarjetas dentro de Mercado Pago. | Card Updater | topic_card_id_wh | Checkout Pro Checkout API Checkout Bricks |
CreaciĆ³n, actualizaciĆ³n o cierre de Ć³rdenes comerciales | Ćrdenes comerciales | topic_merchant_order_wh / merchant_order | Checkout Pro CĆ³digo QR |
Apertura de contracargos, cambios de status y modificaciones referentes a las liberaciones de dinero. | Contracargos | topic_chargebacks_wh / chargebacks | Checkout Pro Checkout API Checkout Bricks |
Una vez configuradas, las notificaciones permiten programar el backend de las tiendas para, por ejemplo, actualizar el estado de pedidos cuando un pago es creado, enviar un e-mail de confirmaciĆ³n cuando un pedido es actualizado en Mercado Pago, actualizar el registro de un cliente cuando realice una vinculaciĆ³n de un plan de suscripciĆ³n, entre otras acciones recurrentes de los eventos detallados en la tabla anterior.
Existen dos tipos de notificaciones para su configuraciĆ³n, como se muestra en la tabla a continuaciĆ³n.
Tipo | DescripciĆ³n |
Webhooks | Recomendadas. Utilizan HTTP REST para notificar instantĆ”neamente las actualizaciones y ofrecen mayor seguridad en la integraciĆ³n mediante la clave secreta, un mĆ©todo de validaciĆ³n para garantizar que las notificaciones recibidas fueron enviadas por Mercado Pago. Para aprender a configurar y simular el envĆo de estas notificaciones, accede a la documentaciĆ³n de Webhooks. |
IPN | Permite que la aplicaciĆ³n reciba notificaciones de Mercado Pago sobre el estado de un pago, contracargo o merchant order por medio de una llamada HTTP POST. La notificaciĆ³n puede tardar unos minutos en enviarse, y no permite realizar la validaciĆ³n de origen mediante el header x-Signature .Importante: Las notificaciones IPN serĆ”n descontinuadas pronto. Por esto, recomendamos la utilizaciĆ³n de las notificaciones Webhooks. |