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.
invalid_installments_cost_config
El vendedor tiene una restricción que impide el uso de cuotas sin o con intereses. Verifica que el vendedor haya completado la configuración de cuotas en su cuenta de Mercado Pago.
invalid_default_installments
El número de cuotas solicitado no está entre las opciones habilitadas por el vendedor. Envía un valor de default_installments dentro de las opciones disponibles configuradas para ese vendedor en la cuenta de Mercado Pago.
missing_installments_cost
El número de cuotas (default_installments) es mayor que 1 y no se indicó quién será el responsable financiero del costo de estas cuotas (installments_cost). Rehaz la operación agregando installments_cost con valor seller o buyer.
invalid_installments_cost_single
Definir que los costos de las cuotas son del comprador (installments_cost=buyer) es inválido cuando default_installments=1 porque una sola cuota no tiene costo financiero. Rehaz la operación usando installments_cost=seller u omite ambos campos.
invalid_payment_method_for_installments
Los campos default_installments e installments_cost solo pueden enviarse cuando el medio de pago definido sea tarjeta de crédito. Rehaz la operación agregando default_type=credit_card al payload o elimina los campos de cuotas si el pago es con tarjeta de débito.
minimum_amount_not_met
El monto de la transacción es menor al mínimo requerido para el plan de cuotas solicitado. Aumenta el monto o reduce el número de cuotas.
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-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'x-allow-cancelable-status: at_terminal' \
-H 'X-Idempotency-Key: 966d14d5-116d-4325-b98b-b91c42650873' \
{
"id": "ORD0000ABCD222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"description": "Point Smart Mini",
"expiration_time": "PT2M",
"country_code": "BR",
"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",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card",
"default_installments": 6,
"installments_cost": "seller"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "canceled",
"status_detail": "canceled_by_api"
}
]
}
}