Recursos para IA

Como gerenciar disputas de contestação?

Uma disputa ocorre quando você deseja argumentar o pedido de contestação com informações e documentos que validam a transação e garantem que o produto foi entregue em conformidade.

Abaixo você encontra as informações necessárias para o gerenciamento das disputas das contestações feitas.

  1. Configure as notificações Webhooks ou IPN no painel e ative a opção Chargebacks.

  2. Consulte todas as informações de uma contestação utilizando a solicitação Obter estorno. Acesse as informações completas pela Referência de API da solução Mercado Pago que você estiver integrando.

    1. Identifique se a contestação é elegível a cobertura por meio do campo coverage_eligible. Independentemente do valor retornado em documentation_required, sempre envie documentação comprobatória que sustente a contestação e demonstre a validade da venda.
Para casos elegíveis à cobertura, prossiga enquanto o prazo para envio estiver vigente. O envio da documentação comprobatória é sempre necessário e não depende do campo documentation_required.
  1. Encaminhe os documentos que comprovem que a venda é válida através do método a seguir:
curl
curl -X POST  \
-F 'files[]=@/path/to/file/file1.png' \
-F 'files[]=@/path/to/file/file2.pdf' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'X-Caller-Id: <YOUR_SELLER_ID>' \
https://api.mercadopago.com/v1/chargebacks/ID/documentation
Nota
Os arquivos poderão ser .jpg, .png ou .pdf e, no total, não poderão superar 10mb.

Se a documentação for carregada no site com sucesso, a API responderá com status 200 OK e manterá o valor de documentation_status como pending. Após a análise da documentação, este mesmo valor será alterado para valid ou not supplied.

  1. Aguarde a notificação IPN ou Webhook referente à resolução. Cheque novamente a contestação usando o endpoint Obter estorno. Acesse as informações completas pela Referência de API da solução Mercado Pago que você estiver integrando. O valor de coverage_applied pode ter assumido um dos possíveis valores:
ValorDescrição
trueIndica que a decisão foi a favor do vendedor e o dinheiro será devolvido.
falseIndica que a decisão foi contra o vendedor e o dinheiro será descontado.