Recursos para IA
Enviar documentación probatoria

Este endpoint permite enviar archivos de documentación probatoria relacionados con un caso de contracargo. Tipos de archivo soportados: image/jpeg, image/png y application/pdf. Antes de enviar la documentación, consulta GET /v1/chargebacks/{id} para confirmar que documentation_status=pending, ya que la documentación solo puede enviarse una vez por caso. En caso de éxito, la solicitud devolverá una respuesta con status 200.

POST

https://api.mercadopago.com/v1/chargebacks/{id}/documentation
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
X-Caller-Id
integer

REQUERIDO

ID del usuario autenticado (seller ID) y propietario del recurso solicitado.
Path
id
string

REQUERIDO

O case_id numérico del caso de contracargo al que se le enviará la documentación probatoria.
Response parameters
type
string
Responsable del envío de la documentación probatoria. El único valor permitido es collector, utilizado para archivos enviados por el vendedor.
collector: Único valor permitido. Identifica los archivos de documentación probatoria subidos por el vendedor.
url
string
URL para acceder o visualizar el archivo probatorio.
description
string
Texto descriptivo que identifica el tipo de evidencia del archivo probatorio. Por ejemplo: factura, comprobante de envío, captura de pantalla, etc.
uuid
string
Identificador único del archivo probatorio. Se utiliza como el parámetro uuid en el endpoint GET /v1/chargebacks/documentation/{type}/{uuid} para descargar o renderizar el archivo.
Errors

400Error de solicitud.

missing_required_params

El case_id del contracargo o el parámetro X-Caller-Id están ausentes. Vuelve a enviar la solicitud con la información necesaria.

missing_files

No se enviaron archivos probatorios en la solicitud. Vuelve a enviar la solicitud incluyendo los archivos requeridos.

empty_file

El archivo probatorio subido está vacío. Vuelve a enviar la solicitud con los archivos correctos.

documentation_already_submitted

El caso ya tiene documentación probatoria enviada (documentation_status no es pending). Envía una solicitud al endpoint de búsqueda (GET /v1/chargebacks/{id}) para verificar el archivo probatorio que ya fue enviado.

403Acceso denegado.

invalid_user_for_operation

El solicitante no tiene permisos para acceder al recurso solicitado (no es el propietario del caso o del archivo probatorio).

413Payload demasiado grande.

too_many_files

Se enviaron más de 10 archivos probatorios, excediendo el límite permitido.

file_size_exceeded

El tamaño total de los archivos probatorios supera los 10 MB, excediendo el límite permitido.

415Tipo de archivo no soportado.

unsupported_file_type

El formato del archivo probatorio es inválido. Solo se admiten archivos JPEG, PNG y PDF.

500Error genérico.

internal_error

Ocurrió un error genérico. Verifica la solicitud e inténtalo nuevamente.

Request
curl -X POST \
    'https://api.mercadopago.com/v1/chargebacks/{id}/documentation'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
       -H 'X-Caller-Id: 123456789' \
    
Response
[
  {
    "type": "collector",
    "url": "https://storage.mlstatic.com/op/123/456789/comprobante.pdf",
    "description": "Chargeback 1",
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
]