Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

How to manage chargebacks disputes - Chargeback management - Mercado Pago Developers

Intelligent search powered by OpenAI 

How to manage chargebacks disputes?

A dispute occurs when you want to argue the chargeback claim with supporting information that validate and ensure that the product was delivered in compliance.

All the information necessary to manage chargeback disputes made can be found here:

  1. Configure Webhooks or IPN notifications on your dashboard and enable the Chargebacks option.

  2. Check all the information related to a chargeback using the Get chargeback request

    1. Check if the chargeback can be covered and assure whether any documentation is required, via the coverage_eligible and documentation_required fields, respectively.
Attention
It is only necessary to continue with the next steps if:
  • The chargeback dispute is eligible for coverage
  • Documentation is required
  • The term has not expired
    1. Send the documents through the following API method:

    curl

    curl -X POST  \
    -F 'files[]=@/path/to/file/file1.png' \
    -F 'files[]=@/path/to/file/file2.pdf' \
    -H 'Authorization: Bearer <ACCESS_TOKEN>' \
    https://api.mercadopago.com/v1/chargebacks/ID/documentation
    Important
    Files can be .jpg, .png or .pdf and should not exceed 10mb overall.

    If the documentation is successfully uploaded to the site, the API will respond with status 200 OK and keep the value of documentation_status as pending. After reviewing the documentation, this same value is changed to valid or not supplied.

    1. Upon resolution, a new IPN notification will be sent so that you can verify the case. Check the dispute using the Get Chargeback method. The coverage_applied value could have taken on one of the possible values:
    ValueDescription
    trueShows that the decision was for the seller and the money is refunded.
    falseShows that the decision was against the seller and the money is discounted.