Cancela uma order criada para Mercado Pago Point e suas transações utilizando o ID de referência obtido na resposta à sua criação. Apenas uma order com status "created" pode ser cancelada. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro.
empty_required_header
O header "X-Idempotency-Key" é requerido e não foi enviado. Faça a requisição novamente incluindo-o.
bad_request
O order_id fornecido no path da requisição não está correto. Verifique e forneça um ID válido para tentar novamente.
401Erro.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
404Erro.
order_not_found
Order não encontrada. Verifique se o ID enviado está correto.
409Erro.
idempotency_key_already_used
O valor enviado como header de idempotência já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
cannot_cancel_order
Há um conflito ao tentar cancelar a order devido ao seu estado atual. Lembre-se de que os pedidos só podem ser cancelados via API quando "status=created". Se você estiver tentando cancelar uma order com o estado "status=at_terminal", deverá fazê-lo a partir do terminal.
500Erro.
idempotency_validation_failed
Falha na validação. Tente enviar a solicitação novamente.
500
Erro interno. Tente enviar a solicitação novamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders/{order_id}/cancel'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********932064-12*********edf6d3c99*********2236c703f*********668' \
-H 'X-Idempotency-Key: d1e89db0-84fa-4de3-bf92-6ebc8bcaa56a' \
{
"id": "ORD0000ABCD222233334444555566",
"user_id": "5238400195",
"type": "point",
"external_reference": "ext_ref_1234",
"description": "Point Smart Mini",
"expiration_time": "PT16M",
"country_code": "CL",
"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__N950NCB801293324",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "25",
"status": "canceled",
"status_detail": "canceled_by_api"
}
]
},
"taxes": [
{
"payer_condition": "payment_taxable_iva"
}
]
}