Gerenciar contestações

Inicie o processo consultando as informações da contestação utilizando o id ou o payment_id fornecidos no corpo da notificação configurada. 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 de evidência que comprovem a validade da venda, envie uma requisição com seu Access Token de produçãoChave privada da aplicação criada no Mercado Pago e utilizada no backend. Você pode acessá-la em Suas integrações > Dados da integração > Produção > Credenciais de produção. ao endpoint /v1/chargebacks/{id}/documentationPOST, substituindo {id} pelo 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 baixar cada arquivo ou acessá-lo individualmente pela URL disponível no campo url do array documentation.

Para visualizar ou baixar um arquivo específico, envie uma solicitação com seu Access Token de produçãoChave privada da aplicação criada no Mercado Pago e utilizada no backend. Você pode acessá-la em Suas integrações > Dados da integração > Produção > Credenciais de produção. ao endpoint /v1/chargebacks/documentation/{type}/{uuid}GET, substituindo {type} pela categoria do documento e {uuid} pelo identificador 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 enviando uma solicitação ao endpoint /v1/chargebacks/{id}GET. Após a resolução, o campo coverage_applied indicará o resultado: