Este endpoint permite buscar todos los casos de contracargo asociados a un payment_id, retornado a partir de una notificación configurada para el tópico de chargebacks. El solicitante deberá ser el vendedor del pago consultado y la respuesta incluirá paginación y los detalles completos de cada caso encontrado, incluido el status de la documentación probatoria. En caso de éxito, la solicitud devolverá una respuesta con status 200.
GET
REQUERIDO
REQUERIDO
seller ID) y propietario del recurso solicitado.REQUERIDO
chargebacks.400Error de solicitud.
invalid_payment_id
El parámetro payment_id está ausente o es inválido. Consulta la notificación recibida para el tópico chargebacks para obtener el ID correcto.
403Acceso denegado.
unauthorized_payment_access
El solicitante no está autorizado para consultar el pago indicado. Solo la cuenta vendedora asociada al pago puede realizar esta consulta.
500Error genérico.
internal_error
Ocurrió un error genérico. Verifica la solicitud e inténtalo nuevamente.
curl -X GET \
'https://api.mercadopago.com/v1/chargebacks/search?payment_id=987654321&limit=10'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Caller-Id: 123456789' \
{
"paging": {
"offset": 0,
"limit": 10,
"total": 1
},
"results": [
{
"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
}
]
}