This endpoint allows to cancel an order that has not yet been paid using the ID obtained in the response to its creation. Only orders in "created" or "action_required" status can be canceled. Cancellation releases any reserved balance when applicable. In case of success, the request will return a response with status 200.
POST
REQUIRED
REQUIRED
REQUIRED
REQUIRED
400Request error.
empty_required_header
The "X-Idempotency-Key" header is required and was not sent. Make the request again including it.
401Error. Access Token not authorized.
401
The value sent as Access Token is incorrect. Please check and try again with the correct value.
invalid_credentials
There is no support for test credentials. Use test users with production credentials for the sandbox environment and your production credentials for the production environment.
404Error. Order not found.
order_not_found
Order not found. Please check if you provided the correct order ID.
409Conflict.
order_already_canceled
Cannot cancel order. Only orders with status "created" or "action_required" can be canceled. Check the message returned in the error details to find out what the problem was and try again.
500Generic error.
internal_error
Generic error. Please try submitting the request again.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/cancel'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer ' \
-H 'X-Idempotency-Key: a22e21fd-5d74-401b-b481-554ad3221856' \
{
"id": "ORD01J49MMW3SSBK5PSV3DFR32959",
"processing_mode": "manual",
"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": "PE",
"type": "online",
"status": "canceled",
"status_detail": "canceled_transaction",
"capture_mode": "automatic_async",
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
"status": "canceled",
"status_detail": "canceled_transaction",
"payment_method": {
"id": "master",
"type": "credit_card",
"token": "12345",
"installments": 1,
"statement_descriptor": "My Store"
}
}
]
},
"client_token": "eyJhbGciOiJSUzI1NiIs...",
"description": "Smartphone",
"items": [
{
"external_code": "ITEM-001",
"title": "Product 001",
"description": "Product description",
"category_id": "travels",
"picture_url": "https://example.com/img.jpg",
"quantity": 1,
"unit_price": "1000.00",
"type": "travel",
"warranty": true,
"event_date": "2014-06-28T16:53:03.176-04:00"
}
]
}