Este endpoint permite realizar la devolución total o parcial de los valores asociados a una order. Para realizar un reembolso total, no debes enviar el monto a reembolsar en el body de la solicitud. Para realizar un reembolso parcial, sí debes indicar el valor a ser reembolsado, junto con el identificador de la transacción que deseas devolver. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
invalid_idempotency_key_length
El X-Idempotency-Key debe tener entre 1 y 64 caracteres.
invalid_path_param
El order_id proporcionado en el path no es válido. Compruébalo y proporciona un order_id válido para volver a intentarlo.
refund_amount_exceeds
El monto del reembolso es mayor que el monto disponible en la transacción.
401Error. Access Token no autorizado.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.
404No encontrada.
order_not_found
Order no encontrada. Comprueba si enviaste el order_id correcto.
transaction_not_found
Transacción no encontrada. Comprueba si enviaste el transaction_id correcto.
409Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.
order_already_refunded
La order ya fue totalmente reembolsada.
cannot_refund_order
La order no puede ser reembolsada. Comprueba el status de la order e intenta nuevamente.
order_refund_already_in_process
Ya existe una solicitud de reembolso completo en proceso para esta order.
idempotency_key_already_used
El valor enviado como header de idempotencia (X-Idempotency-Key) ya fue utilizado. Por favor, vuelve a intentar realizar la solicitud enviando un nuevo valor.
operation_not_supported
La operación no es soportada para esta order. Comprueba el status y status_detail de la order e intenta nuevamente.
423Recurso bloqueado.
resource_locked
La clave de idempotencia (X-Idempotency-Key) está bloqueada por una solicitud en curso. Por favor, reintenta después de un breve tiempo.
500Error genérico.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/refund'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 6cbacdfa-6427-4544-992c-bcc9013dd39e' \
-d '{
"transactions": [
{
"id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"amount": "24.50"
}
]
}'{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"status": "refunded",
"status_detail": "refunded",
"transactions": {
"refunds": [
{
"id": "REF01KJZ0BPKX0BQ0KG1VPBMJDX9G",
"transaction_id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"reference_id": "",
"amount": "50.00",
"status": "processed"
}
]
}
}