Webhooks notifications (also known as web callbacks) are a simple method that allows an application or system to provide real-time information whenever an event occurs. It is a passive way of receiving data between two systems through an HTTP POST request.

Once configured, these notifications will be sent whenever a chargeback is created or its status is modified. From the received information, it will be possible to manage the chargeback.

Below, we present a step-by-step guide to perform the configuration.

1. Access Your integrations and select the application integrated with Checkout API for which you want to enable notifications.

2. In the left menu, select Webhooks > Configure Notifications.

3. In "Production URL", configure the productive HTTPS URL that will be used to receive notifications.

4. In the recommended events, besides the Order (Mercado Pago) event already configured previously to receive the transaction statuses, also select the Chargebacks event to receive notifications tracking the stages of the chargeback. These notifications will be sent in JSON format via HTTPS POST to the URL specified earlier.

5. Finally, click Save Settings. This will generate a unique secret key for the application, which will allow you to validate the authenticity of the received notifications, ensuring that they have been sent by Mercado Pago. For more details, refer to the Webhook Notifications Documentation.

The notifications sent by Mercado Pago for the chargebacks topic will be similar to the following example:

json
Copiar
{
  "action": "order.charged_back",
  "api_version": "v1",
  "application_id": "874202490252970",
  "data": {
    "external_reference": "ext_ref_1234",
    "id": "ORD01JRTXT3GC8CJGW394QWYQ9VP3",
    "status": "charged_back",
    "status_detail": "settled",
    "total_amount": "200.00",
    "total_paid_amount": "200.00",
    "transactions": {
      "payments": [
        {
          "id": "PAY01JRTXT3GC8CJGW394QZZ349N6",
          "amount": "200.00",
          "paid_amount": "200.00",
          "payment_method": {
            "id": "master",
            "installments": 1,
            "type": "credit_card"
          },
          "status": "charged_back",
          "status_detail": "settled",
          "reference": {
            "id": "ref-0"
          }
        }
      ],
      "chargebacks": [
        {
          "id": "CBK12JRTXT3GC8CJGW394QZZ349M7",
          "transaction_id": "PAY01JT4211RXR4678HH8304SDKW4",
          "case_id": "123456789",
          "status": "settled",
          "amount": "200.00",
          "references": [
             {
               "id": "01JSZZW4Q2JZJZC1R1W08KRVEP"
             }
           ]
        }
      ],
    },
    "type": "online",
    "version": 1
  },
  "date_created": "2025-04-14T19:53:23.114998555Z",
  "live_mode": false,
  "type": "order",
  "user_id": "2021490138"
}

These notifications provide complete information about the process initiated by the customer, being essential to manage the chargeback.