Recursos para IA
Obtener contracargo

Este endpoint permite consultar los detalles completos de un caso de contracargo identificado por su case_id. La consulta debe ser realizada por el vendedor propietario del caso. La respuesta incluye los pagos asociados, el monto disputado, la razón, la información de cobertura, el status de la documentación, los archivos enviados y las fechas relevantes. En caso de éxito, la solicitud devolverá una respuesta con status 200.

GET

https://api.mercadopago.com/v1/chargebacks/{id}
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

case_id numérico del caso de contracargo a consultar.
Response parameters
id
string
Identificador único del caso.
payments
array
IDs de los pagos asociados al caso. Puede incluir múltiples pagos cuando sean compras de carrito o paquete.
currency
string
Moneda en la que está el monto disputado.
amount
number
Monto total disputado.
Errors

400Error de solicitud.

invalid_path_param

Uno o más parámetros proporcionados en el path de la solicitud son inválidos. Compruébalos y proporciona valores válidos para volver a intentarlo.

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).

404Caso no encontrado.

chargeback_not_found

El case_id del contracargo no es numérico o no existe. Verifica el valor e inténtalo nuevamente.

500Error genérico.

internal_error

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

Request
curl -X GET \
    'https://api.mercadopago.com/v1/chargebacks/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
       -H 'X-Caller-Id: 123456789' \
    
Response
{
  "id": "123456789",
  "payments": [
    {}
  ],
  "currency": "COP",
  "amount": "50.00",
  "reason": "unauthorized",
  "reason_id": "6",
  "coverage_applied": true,
  "coverage_eligible": true,
  "documentation_required": true,
  "documentation_status": "pending",
  "documentation": [
    {
      "type": "collector",
      "url": "https://storage.mlstatic.com/op/123/456789/comprobante.pdf",
      "description": "Comprobante de envío",
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  ],
  "date_documentation_deadline": "2024-02-15T23:59:59.000-03:00",
  "date_created": "2024-02-01T10:30:00.000-03:00",
  "date_last_updated": "2024-02-03T14:00:00.000-03:00",
  "live_mode": true
}