Recursos para IA
Obter contestação

Este endpoint permite consultar os detalhes completos de um caso de contestação identificado pelo case_id. A consulta deve ser realizada pelo vendedor proprietário do caso. A resposta inclui os pagamentos associados, o valor contestado, o motivo, as informações de cobertura, o status da documentação, os arquivos enviados e as datas relevantes. Em caso de sucesso, a requisição retornará uma resposta com status 200.

GET

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
X-Caller-Id
integer

OBRIGATÓRIO

ID do usuário autenticado (seller ID) e proprietário do recurso solicitado.
Path
id
string

OBRIGATÓRIO

case_id numérico do caso de contestação a consultar.
Response parameters
id
string
Identificador único do caso.
payments
array
IDs dos pagamentos associados ao caso. Pode incluir múltiplos pagamentos quando forem compras de um carrinho ou um pacote.
currency
string
Moeda em que está o valor disputado.
amount
number
Valor total disputado.
Erros

400Erro de requisição.

invalid_path_param

Um ou mais parâmetros fornecidos no path da solicitação são inválidos. Verifique-os e forneça valores válidos para tentar novamente.

403Acesso negado.

invalid_user_for_operation

O solicitante não tem permissão para acessar o recurso solicitado (não é o proprietário do caso ou do arquivo comprobatório).

404Caso não encontrado.

chargeback_not_found

O case_id da contestação não é numérico ou não existe. Verifique o valor e tente novamente.

500Erro genérico.

internal_error

Ocorreu um erro genérico. Verifique a solicitação e tente novamente.

Request
curl -X GET \
    'https://api.mercadopago.com/v1/chargebacks/{id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
       -H 'X-Caller-Id: 123456789' \
    
Response
{
  "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
}