Las notificaciones Webhooks (también conocidas como devoluciones de llamada web) son un método simple que permite a una aplicación o sistema proporcionar información en tiempo real siempre que ocurre un evento. Es una forma pasiva de recibir datos entre dos sistemas mediante una solicitud HTTP POST.

Una vez configuradas, estas notificaciones serán enviadas siempre que se cree un contracargo o se modifique su estado. A partir de la información recibida, será posible gestionar el contracargo.

A continuación, presentamos un paso a paso para realizar la configuración.

1. Accede a Tus integraciones y selecciona la aplicación para la cual deseas activar las notificaciones de contracargos.

2. En el menú a la izquierda, selecciona Webhooks > Configurar notificaciones.

3. En "URL de producción", configura la URL HTTPS productiva que se utilizará para recibir las notificaciones.

4. En los eventos recomendados, además del evento Order (Mercado Pago) ya configurado anteriormente para recibir los estados de la transacción, selecciona también el evento Chargebacks para recibir las notificaciones de seguimiento de las etapas del contracargo. Estas notificaciones se enviarán en formato JSON mediante un HTTPS POST a la URL especificada anteriormente.

5. Por último, haz clic en Guardar configuraciones. Esto generará una clave secreta exclusiva para la aplicación, que permitirá validar la autenticidad de las notificaciones recibidas, garantizando que hayan sido enviadas por Mercado Pago. Para más detalles, consulta la documentación de notificaciones Webhooks.

Las notificaciones enviadas por Mercado Pago para el tópico chargebacks serán similares al siguiente ejemplo:

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": "PAY01JRTXT3GC8CJGW394QZZ349N6",
          "case_id": "234000062890459000",
          "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"
}

Estas notificaciones proporcionan información completa sobre el proceso iniciado por el cliente, siendo fundamentales para gestionar el contracargo.