Este endpoint permite crear una devolución total de todas las transacciones asociadas a una order para Código QR de Mercado Pago. Es decir, el reembolso será hecho sobre la order, por lo que todas sus transacciones, sean pagos, retiros de dinero, o ambas, serán devueltas. Adicionalmente, sólo podrán ser reembolsadas orders con "status=processed". En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.
invalid_order_owner
El valor enviado como Access Token no es el mismo con el que se creó la order. Verifica el valor enviado para ajustarlo e intenta nuevamente.
in_store_payment_refund_order
Se superó el tiempo límite permitido para hacer un reembolso de la order. Verifica estar dentro del plazo de días desde la creación de la order.
partial_refund_not_allowed_with_cashout
No se admiten reembolsos parciales para orders con retiros de dinero (cashout).
401Error.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la solicitud enviando el valor correcto.
404Error.
order_not_found
El valor enviado como Order ID no corresponde a una order creada, por lo que no puede ser encontrada. Por favor, verifícalo y vuelve a intentar realizar la solicitud enviando el valor correcto.
409Error.
idempotency_key_already_used
El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la petición enviando un nuevo valor.
invalid_order_status
Hubo un intento de reembolsar una order con un status que no lo permite. Verifica que el status sea "processed", de lo contrario no se podrá hacer la devolución.
order_already_refunded
Estás queriendo devolver una order que ya fue reembolsada. Verifica haber enviado el ID correcto.
movement_operations_pending
La order tiene movimientos pendientes, espera unos minutos.
500Error.
500
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-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-H 'X-Idempotency-Key: 574162c9-20cd-4ba9-bf4e-369662f14ac3' \
{
"id": "ORD0000ABCD222233334444555566",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "processing",
"reference_id": "12345678"
}
]
}
}