This endpoint allows you to search for all chargeback cases associated with a payment_id, returned from a notification configured for the chargebacks topic. The requester must be the seller of the queried payment, and the response will include pagination and the full details of each case found, including the status of its supporting documentation. In case of success, the request will return a response with status 200.
GET
REQUIRED
REQUIRED
seller ID) and owner of the requested resource.REQUIRED
chargebacks topic.400Request error.
invalid_payment_id
The payment_id parameter is missing or invalid. Check the notification received for the chargebacks topic to obtain the correct ID.
403Access denied.
unauthorized_payment_access
The requester is not authorized to query the indicated payment. Only the seller account associated with the payment can perform this query.
500Generic error.
internal_error
A generic error occurred. Check the request and try again.
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*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'X-Caller-Id: 123456789' \
{
"paging": {
"offset": 0,
"limit": 10,
"total": 1
},
"results": [
{
"id": "123456789",
"payments": [
{}
],
"currency": "MXN",
"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
}
]
}