Información adicional sobre notificaciones
En esta documentación encontrarĆ”s información adicional sobre notificaciones, ya sean consideraciones especiales dependiendo de la solución que hayas integrado, aspectos especĆficos de ciertos tópicos, o ejemplos de notificaciones particulares para que puedas consultar.
Card Updater
Card Updater es una función para integraciones de productos con pagos recurrentes, que actualiza datos de tarjetas, ya sea vencidas o con datos incorrectos, y actualiza esta información dentro de Mercado Pago.
Este proceso se desencadena a partir de un pago rechazado, donde la verificación hecha por el Card Updater podrÔ o bien generar un nuevo card_id
para un cliente (en casos de error en la inserción de datos o cambio de tarjeta), o bien mantener el card_id
previamente generado, pero actualizando la base de datos con información correcta de la tarjeta.
En cualquiera de los casos, se enviarÔ una notificación Webhooks como la que se muestra a continuación:
json
{ "action": "card.updated", "api_version": "v1", "application_id": 8339021212080291, "data": { "customer_id": "12345678-aluyasdhfyt", "new_card_id": 50000102202, "old_card_id": 50000006036 }, "date_created": "2024-01-11T15:23:53-03:00", "id": "a47fc06844bf4e418a03aeab1479c496", "live_mode": true, "type": "automatic-payments", "user_id": 1197520450, "version": 1 }
Campo | Descripción |
action | card.updated es el Ćŗnico valor posible e indica cuando la tarjeta de un cliente fue actualizada. |
application_id | Identificador de la aplicación sobre la que se estÔ notificando. |
data | Este campo es donde estĆ”n los detalles de la actualización, como el customer_id (identificador del cliente), el nuevo card_id , y el antiguo.En caso de que no se cree un nuevo card_id , se reenvĆa el original. |
date_created | Fecha de creación de la notificación. |
id | Identificador exclusivo del evento, evita mensajes duplicados. |
live_mode | Indica si la URL informada es vƔlida |
type | Este valor siempre serĆ” automatic-payments |
user_id | Identificador del usuario para el que se envĆa la notificación. |
Integraciones Point
Este tópico permite recibir notificaciones sobre la actualización de los status en las intenciones de pago creadas para integraciones Point. Al activarlo, debes tener en cuenta:
- āIntención de pagoā y āpagoā no son lo mismo. Al activar este tópico, recibirĆ”s actualizaciones sobre las llamadas creadas para iniciar un pago. Para recibir notificaciones sobre el pago en sĆ mismo, debes activar el tópico
payments
mediante Tus integraciones. - No es posible configurar este tópico al momento de crear un pago. Su configuración debe ser hecha por medio de Tus integraciones.
- Puedes consultar las notificaciones correspondientes a los distintos estados de las intenciones de pago accediendo a la documentación especĆfica de Mercado Pago Point.
Suscripciones
Para activar las notificaciones de tu integración con Suscripciones, debes tener en cuenta:
- Si has integrado Suscripciones con planes asociados, debes activar el tópico
subscription_preapproval_plan
para recibir alertas sobre la creación o actualización de un Plan. - Si has integrado Suscripciones sin planes asociados, debes activar el tópico
subscription_preapproval
para recibir alertas sobre la creación o actualización de una suscripción de pago pendiente, o bien el tópicosubscription_authorized_payment
para actualizaciones sobre suscripciones con pago autorizado. - En todos los casos, deberÔs activar también el tópico
payments
, que te permitirĆ” recibir notificaciones sobre los pagos asociados a esas suscripciones cuando sean efectuados.
Checkout Pro
Si realizaste una integración con Checkout Pro y deseas recibir notificaciones, debes tener en cuenta:
- La activación del tópico
merchant_orders
te permitirÔ recibir alertas sobre creación y actualizaciones de pedidos. - AdemÔs, la activación del tópico
payments
serĆ” Ćŗtil para mantener al dĆa tu base de datos, ya que te notificarĆ” sobre las actualizaciones de los pagos correspondientes a esos pedidos generados.
Alertas de fraude
En caso de detectarse un alerta de fraude, y si tienes activado el tópico stop_delivery_op_wh
, recibirÔs una notificación como la siguiente:
json
{ "action": "Created", "api_version": "v1", "data": { "description": "desc", "merchant_order": 249940988000, "payment_id": 58980959081, "site_id": "MLA" }, "date_created": "2022-07-23T23:03:5704:00", "id": "58980959081", "live_mode": true, "type": "stop_delivery_op_wh", "user_id": 224403329, "version": 1 }
En ella, se incluyen los detalles del pedido que generó el alerta, bajo el parÔmetro merchant_order
, y el payment_id
asociado al pago. Con esos datos, deberÔs efectuar la cancelación del pedido sin entregarlo, realizando un llamado a la API de cancelaciones.
Ten en cuenta que este tipo de notificaciones no funcionan con la lógica de reintento habitual. Si, al recibirla, no envĆas un HTTP STATUS 200 (OK)
o 201 (CREATED)
, habrÔs perdido la notificación y no volverÔs a recibirla.
Reclamos
En los casos en los que se hayan activado las notificaciones para el tópico topic_claims_integration_wh
, se enviarÔ una notificación Webhooks cuando se inicie un reclamo o contracargo, tal como se muestra a continuación:
json
{ "action": "Created", "api_version": "v1", "data": { "description": "desc", "merchant_order": 249940988000, "payment_id": 58980959081, "site_id": "MLA" }, "date_created": "2022-07-23T23:03:5704:00", "id": "58980959081", "live_mode": true, "type": "stop_delivery_op_wh", "user_id": 224403329, "version": 1 }
Campo | Descripción |
action | Evento notificado, que indica si es la creación de un recurso o su actualización. |
api_version | Valor que indica la versión de la API que envĆa la notificación. |
data.id | Identificador exclusivo del reclamo o contracargo. |
data.resource | Tipo de notificación recibida. En este caso, indica notificaciones relacionadas a reclamos. |
date_created | Fecha de creación de la notificación. |
id | Identificador de la notificación recibida. |
live_mode | Indica si la URL informada es vƔlida. |
type | Tipo de notificación recibida, de acuerdo al tópico seleccionado previamente. En este caso, serÔ siempre claim . |
user_id | Identificador del usuario para el que se envĆa la notificación. |
Contracargos
En los casos en los que se hayan activado las notificaciones para el tópico topic_chargebacks_wh
, se enviarÔ una notificación Webhooks cuando se inicie un contracargo o cambie su estado, tal como se muestra a continuación:
json
{ "actions":["changed_case_status"], "api_version":"v1", "application_id":9007201037432480, "data":{ "checkout":"PRO", "date_updated":"0001-01-01T00:00:00Z", "id":217000061307271000, "payment_id":81034165129, "product_id":"BC32A57TRPP001U8NHHG", "site_id":"MLA", "transaction_intent_id":"" }, "date_created":"2024-07-02T22:03:24-04:00", "id":114544942708, "live_mode":true, "type":"topic_chargebacks_wh", "user_id":425424311, "version":1720427447 }
Medios de pago offline
En caso de haber integrado medios de pago offline y configurado tus notificaciones con el tópico payments
, todos los cambios de estado de un pago te serƔn notificados.
Esto es vƔlido tambiƩn para el caso de pagos expirados: su estado pasarƔ de pending
a cancelled
, y el alerta correspondiente serĆ” enviado a tu sistema.
Código QR
Si realizaste una integración con Código QR y deseas recibir notificaciones, debes tener en cuenta:
- No es posible configurar notificaciones webhooks por medio de Tus integraciones. Debes hacerlo al momento de crear un pago.
- Por este motivo, tampoco es posible validar el origen de las notificaciones a partir del header
x-Signature
. Para conocer vĆas alternativas para verificar el origen de estas notificaciones, puedes contactar a Soporte de Mercado Pago. - La activación del tópico
merchant_orders
te permitirĆ” recibir alertas sobre creación y actualizaciones de pedidos. Si bien el tópico envĆa unstatus=opened
, serÔ la notificación constatus=closed
aquella que certificarĆ” con seguridad que la orden generada fue pagada.
Link de pago
No es posible configurar notificaciones para Links de pago generados a travƩs del Panel de Mercado Pago.