Este endpoint permite buscar todos os casos de contestação associados a um payment_id, retornado a partir de uma notificação configurada para o tópico de chargebacks. O solicitante deverá ser o vendedor do pagamento consultado e a resposta incluirá uma paginação e os detalhes completos de cada caso encontrado, incluindo o status da documentação comprobatória. Em caso de sucesso, a requisição retornará uma resposta com status 200.
GET
OBRIGATÓRIO
OBRIGATÓRIO
seller ID) e proprietário do recurso solicitado.OBRIGATÓRIO
chargebacks.400Erro de requisição.
invalid_payment_id
O parâmetro payment_id está ausente ou é inválido. Consulte a notificação recebida para o tópico chargebacks para obter o ID correto.
403Acesso negado.
unauthorized_payment_access
O solicitante não está autorizado a consultar o pagamento indicado. Somente a conta vendedora associada ao pagamento pode realizar esta consulta.
500Erro genérico.
internal_error
Ocorreu um erro genérico. Verifique a solicitação e tente novamente.
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-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Caller-Id: 123456789' \
{
"paging": {
"offset": 0,
"limit": 10,
"total": 1
},
"results": [
{
"id": "123456789",
"payments": [
{}
],
"currency": "BRL",
"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
}
]
}