After receiving the notification
When you receive a notification on your platform, Mercado Pago waits for a response to validate that you received it correctly. For that, you must return an HTTP STATUS 200 (OK)
or 201 (CREATED)
. If this response is not sent, it will be understood that you have not received the notification and a further attempt to send it will be made until you submit the response.
In the table below you can find the main events, deadlines and waiting time for receiving new notification attempts.
Event | Deadline after the first dispatch | Confirmation waiting time |
Shipping | - | 22 seconds |
First try | 15 minutes | 5 seconds |
Second attempt | 30 minutes | 5 seconds |
Third attempt | 6 hours | 5 seconds |
Fourth attempt | 48 hours | 5 seconds |
Fifth attempt | 96 hours | 5 seconds |
After returning the notification, you will get the full information of the notified resource by going to the corresponding API endpoint:
Type | URL | Documentation |
payment | https://api.mercadopago.com/v1/payments/[ID] | check documentation |
chargebacks | https://api.mercadopago.com/v1/chargebacks/[ID] | check documentation |
merchant_orders | https://api.mercadopago.com/merchant_orders/[ID] | check documentation |
Also, specifically in fraud alerts, the order must not be delivered and the cancellation needs to be done through the cancellations API.
In the notification, you will receive a JSON
with the following information containing the payment id to cancel.
"description": ".....",
"merchant_order": 4945357007,
"payment_id": 23064274473
With this information, you will be able to carry out the necessary updates to your platform, such as updating an approved payment or a closed order.