Este endpoint cancela una order Wallet Connect que aún no fue capturada. Se utiliza normalmente cuando el vendedor decide no capturar el pago para orders creadas con capture_mode=manual y que están en status=action_required y status_detail=waiting_capture. La cancelación libera la autorización en el medio de pago del pagador sin mover ningún monto. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
REQUERIDO
automatic.400Error de solicitud.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
invalid_idempotency_key_length
El X-Idempotency-Key debe tener entre 1 y 64 caracteres.
invalid_path_param
El order_id proporcionado en el path no es válido. Compruébalo y proporciona un order_id válido para volver a intentarlo.
401Error. Access Token no autorizado.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.
invalid_credentials
No hay soporte para credenciales de prueba. Utiliza usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y tus credenciales de producción para el entorno de producción.
404Recurso no encontrado.
order_not_found
Order no encontrada. Comprueba si enviaste el order_id correcto.
409Alguna regla específica del sistema no permite realizar la acción.
cannot_cancel_order
La order no puede ser cancelada porque no está en un estado que permita la cancelación. Solo las orders en estado action_required pueden ser canceladas.
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 solicitud 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-1*********550113-12*********b4773884a*********e8df16347*********786' \
-H 'X-Idempotency-Key: d7836ffe-502a-42ce-9157-13910b31d237' \
{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"type": "online",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"total_amount": "50.00",
"total_paid_amount": "50.00",
"country_code": "PE",
"user_id": "1090806071",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic",
"currency": "PEN",
"created_date": "2026-02-20T18:27:08.639Z",
"last_updated_date": "2026-02-20T18:27:09.797Z",
"integration_data": {
"application_id": "6953384195632068",
"platform_id": "123abc"
},
"transactions": {
"payments": [
{
"id": "PAY01KSTHTYV2K2F86CPF6VF5SZ7R",
"amount": "0.50",
"reference_id": "e8eed39ee75a4371b64d98a074cf472f",
"status": "canceled",
"status_detail": "canceled_transaction",
"attempts": [
{
"id": "b66b7198286e416fb554be03430e4c46",
"status": "canceled",
"status_detail": "canceled_transaction"
}
],
"payment_method": {
"id": "wallet",
"type": "wallet",
"statement_descriptor": "Descriptor",
"installments": 1
},
"stored_credential": {
"payment_initiator": "merchant",
"reason": "recurring"
}
}
]
}
}