Cancela una order y sus transacciones utilizando el ID de referencia obtenido en la respuesta a su creación. Sólo puede ser cancelada una order en "status=action_required" o "status=created". En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
REQUERIDO
400Error de solicitud.
invalid_path_param
El "order_id" proporcionado en el path de la requisición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.
invalid_idempotency_key_length
El valor enviado en el header "X-Idempotency-Key" excedió el tamaño máximo permitido. El header acepta valores entre 1 y 64 caracteres.
401Error. Access Token no autorizado.
401
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Use usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y sus credenciales de producción para el entorno de producción.
404Error. Order no encontrada.
order_not_found
Order no encontrada. Comprueba si enviaste el ID correcto.
409Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.
cannot_cancel_order
El estado en el que se encuentra la order no permite su cancelación. Solo pueden ser canceladas orders con "status=action_required" o "status=created".
order_already_canceled
La order ya fue cancelada.
idempotency_key_already_used
El valor enviado como header de idempotencia ("X-Idempotency-Key") ya fue utilizado. Por favor, vuelve a intentar realizar la requisición enviando un nuevo valor.
500Error genérico.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/cancel'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 6b8efeb0-e231-4036-9046-ba72677bfcad' \
{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"integration_data": {
"application_id": "1234",
"integrator_id": "dev_123",
"platform_id": "1234567890",
"sponsor": {
"id": "446566691"
}
},
"user_id": "12345",
"created_date": "2024-08-26T13:06:51.045317772Z",
"last_updated_date": "2024-08-26T13:06:51.045317772Z",
"country_code": "CO",
"type": "online",
"status": "canceled",
"status_detail": "canceled_transaction",
"capture_mode": "automatic",
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "canceled",
"status_detail": "canceled_transaction",
"expiration_time": "P3Y6M4DT12H30M5S",
"payment_method": {
"id": "master",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store",
"financial_institution": "1051"
}
}
]
},
"description": "Smartphone",
"items": [
{
"title": "Smartphone",
"unit_price": "24.50",
"quantity": 4,
"description": "Smartphone",
"external_code": "1234",
"picture_url": "https://http2.mlstatic.com/resources/frontend/statics/growth-sellers-landings/device-mlb-point-i_medium2x.png",
"category_id": "MLB1055",
"type": "MLB1055",
"warranty": "true",
"event_date": "2014-06-28T16:53:03.176-04:00"
}
]
}