Webhooks notifications, also known as web callbacks, are an effective method that allows Mercado Pago servers to send information in real time when a specific event related to your integration occurs. Instead of your system constantly querying for updates, Webhooks allow the passive and automatic transmission of data between Mercado Pago and your integration through an HTTPS POST request, optimizing communication and reducing server load.

Below, we present a step-by-step guide to receive payment notifications in your Payouts integrations. Once configured, Webhook notifications will be sent whenever there is any update on the reported topic, including the creation of a transaction or status changes during processing.

Through the notification_url field, you can set up Webhook notifications when making the call to create a transaction. Simply fill it with the URL where you want to receive the updates.

curl
Copiar
--data '{
  ...
  "seller_configuration": {
    "notification_info": {
      "notification_url": "http://example.com/notification"
    }
  }
  ...
}'

See below for examples illustrating the messages returned when an event occurs.

• Message when creating a transaction:

json
Copiar
{
  "created_date": "2026-01-29T15:20:25.470+00:00",
  "external_reference": "test_mp-bank",
  "id": "736669",
  "last_updated_date": "2026-01-29T15:20:25.470+00:00",
  "payout": {
    "external_reference": "global_111",
    "id": "26722",
    "notification_url": "https://webhook.site/a12e4590-1fb4-4a71-8326-5a3bbc9b4bcb"
  },
  "status": "created"
}

• Message when updating a transaction:

json
Copiar
{
  "created_date": "2026-01-29T15:20:25.470+00:00",
  "external_reference": "test_mp-bank",
  "id": "736669",
  "last_updated_date": "2026-01-29T15:20:25.470+00:00",
  "payout": {
    "external_reference": "global_111",
    "id": "26722",
    "notification_url": "https://webhook.site/a12e4590-1fb4-4a71-8326-5a3bbc9b4bcb"
  },
  "status": "processed",
  "status_detail": "approved"
}

The payout.id attribute corresponds to the ID of the payout you are being notified about, the id parameter is the identifier of the notification, and the status indicates whether the transaction was created or updated.

When you receive a notification on your platform, Mercado Pago expects a response to validate that the reception was correct. To do this, you must return an HTTP STATUS 200 (OK) or 201 (CREATED).

The waiting time for this confirmation will be 22 seconds. If this response is not sent, the system will understand that the notification was not received and will make a new attempt to send it every 15 minutes until it receives the response. After the third attempt, the deadline will be extended, but the deliveries will continue to happen.

After responding to the notification, confirming its receipt, you can get all the information about the notified resource by sending a GET to the endpoint /v1/transaction-intents/{id}API.

With this information, you’ll be able to make the necessary updates.