Recursos para IA
Buscar contestações

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

https://api.mercadopago.com/v1/chargebacks/search
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.
Query
payment_id
integer

OBRIGATÓRIO

ID do pagamento para o qual se deseja buscar casos de contestação, obtido de uma notificação configurada para o tópico chargebacks.
offset
integer
Número de resultados a pular para a paginação. O valor mínimo e padrão é 0.
limit
integer
Número de resultados por página. O valor mínimo é 1 e o valor padrão é 10.
Response parameters
paging
object
Metadados de paginação.
results
array
Lista de casos de contestação encontrados.
Erros

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.

Request
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' \
    
Response
{
  "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
    }
  ]
}