Refund full amount
To refund the full amount of a payment it is necessary to send an empty body in the request. To do so, send a POST to the endpoint /v1/advanced_payments/{advanced_payment_id}/refunds and execute the request or, if you prefer, use curl below.
curl -X POST \
'https://api.mercadopago.com/v1/advanced_payments/ADVANCED_PAYMENT_ID/refunds' \
-H 'X-Idempotency-Key: IDEMPOTENCY-KEY' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'accept: application/json' \
-H 'content-type: application/json'
Responses
When executing the request for a full refund, different responses may be returned. Below you will find the details of each one of them, as well as the possible causes.
Successful response
[
{
"id": 1242469925,
"payment_id": 51617407254,
"amount": 25,
"source": {
"id": 783789745,
"name": "Test Test",
"type": "collector"
},
"date_created": "2022-11-18T08:48:06.768-04:00",
"status": "approved"
}
]
Failed response: Bad request
This is a common response when one of the request parameters is incorrect or not found. For example, this error will occur if an incorrectly formatted ID is sent at the time of the request.
Status code: 400
{
"status": "400",
"error": "bad_request",
"message": "Invalid splitter id.",
"cause": [
{
"code":"400048",
"message": "Invalid splitter id",
"data": null
}
]
}
Failed response: Not found
This is a common response that is returned when no Advanced Payment created with the ID given in the request parameters is found.
Status code: 404
{
"status": "404",
"error": "not_found",
"message": "Advanced payment not found.",
"cause": [
{
"code":"404002",
"message": "Advanced payment not found",
"data": null
}
]
}
Failed response: Internal error code
It is the response that indicates that a server error occurred while processing the request. This means that the client's request could not be completed due to an internal problem on the server.
Status code: 500
{
"status": "500",
"error": "internal_server_error",
"message": "Invalid splitter id.",
"cause": [
{
"code":"500000",
"message": "Internal server error",
"data": null
}
]
}
Status code: 200