Idempotency - Payment flow - Mercado Pago Developers
Which documentation are you looking for?

Do not know how to start integrating? 

Check the first steps


Connection problems or service outages can interrupt communication when sending or receiving data to create an Advanced Payment.

To ensure the correct creation of an Advanced Payment, you can make a new attempt to send the data, however, it is possible that it has already been created and due to the interruption you have not received the correct response. Therefore, these retries will create a new Advanced Payment.

To avoid duplication, it is mandatory to send a unique key in the Header X-Idempotency-Key that identifies the creation of a single Advanced Payment. This way, when a new attempt is made, the same key can be sent to indicate that it is the same process.

If the Advanced Payment has already been created, your information is returned without creating a new payment.

Check below the diagram that illustrates how the Idempotency Key works in the process of creating an Advanced Payment.


Send request

curl -X POST \
    -H 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
    -H 'Authorization: Bearer ACCESS_TOKEN'
    -H 'accept: application/json' \
    -H 'content-type: application/json' \
    '' \
    -d '{
           "description":"Payment Description",
           "type_token": "wallet-token"


When running the request you may receive different types of responses originating from specific reasons. See the Responses section for more information.