Gerenciar contestações

Inicie o processo consultando as informações da contestação utilizando o seu case_id ou o payment_id retornados no body da notificação configurada para o tópico de chargebacks. A partir dos detalhes obtidos, prepare a documentação comprobatória que será enviada para dar continuidade ao processo de contestação.

curl
curl -X GET \
  'https://api.mercadopago.com/v1/chargebacks/{id}' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>'

json
{
    "id": "234000062890459000",
    "payments": [
        86439942806
    ],
    "currency": "ARS",
    "amount": 1000.50,
    "reason": "unauthorized",
    "reason_id": "6",
    "coverage_applied": null,
    "coverage_eligible": true,
    "documentation_status": "not_supplied",
    "documentation": [],
    "date_documentation_deadline": null,
    "date_created": "2024-02-01T10:30:00.000-03:00",
    "date_last_updated": "2024-10-17T12:48:24.000-04:00",
    "live_mode": true
}

Confira abaixo os possíveis valores do campo documentation_status:

É sempre necessário enviar documentação comprobatória que sustente a contestação e demonstre a validade da venda. Esses documentos permitem que a equipe do Mercado Pago analise os fatos e faça a mediação da resolução junto à bandeira do cartão e ao banco emissor.

Para enviar os arquivos comprobatórios que comprovem a validade da venda, envie uma solicitação ao endpoint /v1/chargebacks/{id}/documentationPOST com seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração., utilizando o case_id da contestação.

curl
curl -X POST \
  'https://api.mercadopago.com/v1/chargebacks/{id}/documentation' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>' \
  -H 'X-Idempotency-Key: <SOME_UNIQUE_VALUE>' \
  -F 'file=@/path/to/file/file1.png' \
  -F 'file=@/path/to/file/file2.pdf'

Se os arquivos forem enviados com sucesso, a API retornará um código HTTP 200 e o documentation_status da contestação será alterado para review_pending. A resposta incluirá a lista dos arquivos enviados:

json
[
    {
        "type": "collector",
        "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "url": "https://storage.mlstatic.com/op/123/456789/file1.png",
        "description": "file1.png"
    },
    {
        "type": "collector",
        "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "url": "https://storage.mlstatic.com/op/123/456789/file2.pdf",
        "description": "file2.pdf"
    }
]

Após o envio da documentação comprobatória, é possível baixá-los ou acessar cada arquivo individualmente pela URL disponível no campo url do array documentation.

Para visualizar ou baixar um arquivo específico, envie uma solicitação ao endpoint /v1/chargebacks/documentation/{type}/{uuid}GET com seu Access TokenChave privada da aplicação criada no Mercado Pago e que é utilizada no backend. Você pode acessá-la através de Suas integrações > Dados da integração., substituindo {type} pela categoria do documento e {uuid} pelo identificador único do arquivo.

curl
curl -X GET \
  'https://api.mercadopago.com/v1/chargebacks/documentation/{type}/{uuid}' \
  -H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
  -H 'X-Caller-Id: <YOUR_SELLER_ID>'

O arquivo é retornado com seu tipo MIME original (image/jpeg, image/png ou application/pdf), permitindo que seja renderizado diretamente no navegador ou salvo localmente.

Após o envio da documentação comprobatória e uma vez concluída a análise por parte da bandeira do cartão e do banco emissor, a resolução da contestação é determinada e as partes envolvidas são notificadas.

Aguarde a notificação Webhook referente à resolução e consulte novamente a contestação usando o endpoint /v1/chargebacks/{id}GET. Após a resolução, o campo coverage_applied indicará o resultado: