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 Integraciones y selecciona la aplicación integrada con Checkout API para la que deseas activar las notificaciones.

2. En el menú lateral, selecciona Configuración de Webhooks.

3. En el switch Prueba / Producción de la parte superior, selecciona Prueba e ingresa la URL HTTPS para recibir notificaciones de prueba. Si quieres configurar notificaciones de producción, selecciona Producción e ingresa la URL HTTPS de producción.

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 configurada para cada entorno.

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

Para consultar las notificaciones de contracargos, abre la aplicación y, en Inicio, selecciona la pestaña Webhooks. Utiliza el switch Prueba / Producción para consultar las notificaciones del entorno seleccionado.

Allí puedes filtrar los envíos, consultar su fecha, estado de entrega, acción, evento e ID del recurso, revisar las métricas de entrega y tiempo de respuesta, abrir el detalle para ver el cuerpo de la notificación y reenviarla cuando sea necesario. En Prueba, los datos se actualizan en tiempo real.

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

json
{
  "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": "50.00",
    "total_paid_amount": "200.00",
    "transactions": {
      "payments": [
        {
          "id": "PAY01JRTXT3GC8CJGW394QZZ349N6",
          "amount": "50.00",
          "paid_amount": "47.28",
          "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": "50.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.