Gestionar contracargos

Inicia el proceso consultando la información del contracargo utilizando tu case_id o el payment_id devueltos en el cuerpo de la notificación configurada para el tópico de chargebacks. A partir de los detalles obtenidos, prepara la documentación probatoria que se enviará para dar continuidad al proceso de contracargo.

curl
curl -X GET \
  'https://api.mercadopago.com/v1/chargebacks/{id}' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>'

json
{
    "id": "234000062890459000",
    "payments": [
        86439942806
    ],
    "currency": "ARS",
    "amount": 1000.50,
    "reason": "unauthorized",
    "reason_id": "6",
    "coverage_applied": null,
    "coverage_eligible": true,
    "documentation_status": "not_supplied",
    "documentation": [],
    "date_documentation_deadline": null,
    "date_created": "2024-02-01T10:30:00.000-03:00",
    "date_last_updated": "2024-10-17T12:48:24.000-04:00",
    "live_mode": true
}

Consulta a continuación los posibles valores del campo documentation_status:

Siempre es necesario enviar documentación probatoria que respalde el contracargo y demuestre la validez de la venta. Estos documentos permiten que el equipo de Mercado Pago analice los hechos y medie la resolución junto a la marca de la tarjeta y el banco emisor.

Para enviar los archivos de evidencia que demuestren la validez de la venta, envía una solicitud al endpoint /v1/chargebacks/{id}/documentationPOST con tu Access Token de producciónClave privada de la aplicación creada en Mercado Pago, utilizada en el backend. Puedes acceder a ella en Tus integraciones > Datos de la integración > Producción > Credenciales de producción., utilizando el case_id del contracargo.

curl
curl -X POST \
  'https://api.mercadopago.com/v1/chargebacks/{id}/documentation' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>' \
  -H 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \
  -F 'file=@/path/to/file/file1.png' \
  -F 'file=@/path/to/file/file2.pdf'

Si los archivos se envían con éxito, la API devolverá un código HTTP 200 y el documentation_status del contracargo se cambiará a review_pending. La respuesta incluirá la lista de archivos subidos:

json
[
    {
        "type": "collector",
        "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "url": "https://storage.mlstatic.com/op/123/456789/file1.png",
        "description": "file1.png"
    },
    {
        "type": "collector",
        "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "url": "https://storage.mlstatic.com/op/123/456789/file2.pdf",
        "description": "file2.pdf"
    }
]

Tras el envío de la documentación probatoria, es posible descargar los archivos o acceder a cada uno individualmente mediante la URL disponible en el campo url del array documentation.

Para ver o descargar un archivo específico, envía una solicitud al endpoint /v1/chargebacks/documentation/{type}/{uuid}GET con tu Access Token de producciónClave privada de la aplicación creada en Mercado Pago, utilizada en el backend. Puedes acceder a ella en Tus integraciones > Datos de la integración > Producción > Credenciales de producción., sustituyendo {type} por la categoría del documento y {uuid} por el identificador único del archivo.

curl
curl -X GET \
  'https://api.mercadopago.com/v1/chargebacks/documentation/{type}/{uuid}' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>'

El archivo es retornado con su tipo MIME original (image/jpeg, image/png o application/pdf), lo que permite renderizarlo directamente en el navegador o guardarlo localmente.

Tras el envío de la documentación probatoria y una vez concluido el análisis por parte de la marca de la tarjeta y del banco emisor, se determina la resolución del contracargo y se notifica a las partes involucradas.

Espera la notificación Webhook referente a la resolución y consulta nuevamente el contracargo utilizando el endpoint /v1/chargebacks/{id}GET. Después de la resolución, el campo coverage_applied indicará el resultado: