POST
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_path_param
El Order ID proporcionado en el path de la requisición tiene un formato inválido. Este debe comenzar con el prefijo "ORD" y ser continuado por 26 caracteres. Compruébalo y proporciona un ID válido para volver a intentarlo.
invalid_order_owner
Debido a validaciones internas, no puedes procesar el reembolso de una order que no has creado.
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 360 días desde la creación de la order.
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.
order_already_refunded
Estás queriendo devolver una order que ya fue reembolsada. Verifica haber enviado el ID correcto.
cannot_refund_order,
El estado de la order no permite su reembolso. Solo pueden ser reembolsadas orders con status 'processed'.
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 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
-H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
{
"id": "ORD0000ABCD222233334444555566",
"status": "processed",
"status_detail": "accredited",
"transactions": {
"refunds": [
{
"id": "REF01J67CQQH5904WDBVZEM1234D",
"transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "50.00",
"status": "processing",
"reference_id": "12345678"
}
]
}
}