Este endpoint permite cancelar una order creada para Mercado Pago Point y sus transacciones utilizando el ID de referencia obtenido en la respuesta a su creación. Se pueden cancelar orders con status=created y status=at_terminal. En caso de éxito, la solicitud de una order con status=created devolverá una respuesta con estado 200, mientras que la solicitud de una order con status=at_terminal devolverá una respuesta con estado 202, indicando que la solicitud fue aceptada, pero que la cancelación solo se hará efectiva después de recibir una notificación de cancelación.
POST
REQUERIDO
REQUERIDO CONDICIONAL
status=at_terminal, y su valor debe ser exactamente at_terminal. Para orders con status=created, el header se ignora. La cancelación de una order con `statREQUERIDO
REQUERIDO
400Error.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.
bad_request
El order_id proporcionado en el path de la petición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.
401Error.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la peticion enviando el valor correcto.
404Error.
order_not_found
Order no encontrada. Comprueba si enviaste el ID correcto.
409Error.
idempotency_key_already_used
El valor enviado como header de idempotencia ya fue utilizado. Por favor, vuelve a intentar realizar la petición enviando un nuevo valor.
cannot_cancel_order
El estado de la order no permite su cancelación. Solo se pueden cancelar vía API orders con status=created o status=at_terminal. Para cancelar una order con status=at_terminal, envía el header x-allow-cancelable-status: at_terminal y utiliza una terminal con una versión de software compatible. Para obtener más información sobre los modelos de terminal compatibles, consulta Cancelar una order. Si el header no se envía o es inválido, o si la terminal no es compatible, se devuelve este error.
order_already_canceled
La order ya fue cancelada.
500Error.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
500
Error interno. 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*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-H 'x-allow-cancelable-status: at_terminal' \
-H 'X-Idempotency-Key: 51e20922-5c23-47e2-b862-d120b61d5185' \
{
"id": "ORD0000ABCD222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"description": "Point Smart Mini",
"expiration_time": "PT2M",
"country_code": "MEX",
"processing_mode": "automatic",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
},
"status": "canceled",
"status_detail": "canceled",
"created_date": "2024-09-10T14:26:42.109320977Z",
"last_updated_date": "2024-09-10T14:26:42.109320977Z",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__SBX0000001",
"screen_time": "PT15S",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "canceled",
"status_detail": "canceled_by_api"
}
]
}
}