Intelligent search powered by OpenAI
POST
REQUIRED
REQUIRED
REQUIRED
400Request error.
empty_required_header
The 'X-Idempotency-Key' header is required and was not sent. Make the requisition again including it.
invalid_path_param
The order_id provided in the request path is not correct. Please confirm it and provide a valid ID to try again.
refund_amount_exceeds
The requested refund amount is greater than the available amount.
404Not found.
Error. Order not found.
Error. Transaction not found.
409Some specific system rule does not allow the action to be performed due to defined restrictions.
Some specific system rule does not allow the action to be performed due to defined restrictions.
Error. Order already refunded.
The order cannot be refunded. Please check the order status and try again.
500Generic error.
idempotency_validation_failed
Validation fail. Please try submitting the request again.
internal_error
Generic error. Please try submitting the request again.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
-H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
-d '{
"transactions": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.90"
}
]
}'{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"status": "processed",
"status_detail": "refunded",
"transactions": {
"refunds": [
{
"id": "REF01J49MMW3SSBK5PSV3DFR32959",
"transaction_id": "PAY01JEVQM06WDW16MAQ8B5SC0MSC",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"amount": "24.90",
"status": "processed"
}
]
}
}