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

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

json
Copiar
{
    "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 vinculada a una aplicación, utilizada en el backend para autenticar operaciones reales. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de producción. Nunca debe compartirse ni exponerse en el frontend., utilizando el id del contracargo.

curl
Copiar
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
Copiar
[
    {
        "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 descargarla o acceder a cada archivo 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 vinculada a una aplicación, utilizada en el backend para autenticar operaciones reales. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de producción. Nunca debe compartirse ni exponerse en el frontend., sustituyendo {type} por la categoría del documento y {uuid} por el identificador único del archivo.

curl
Copiar
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: