Este endpoint cancela uma order de Wallet Connect que ainda não foi capturada. É normalmente utilizado quando o vendedor decide não capturar o pagamento para orders criadas com capture_mode=manual e que estão em status=action_required e status_detail=waiting_capture. O cancelamento libera a autorização no meio de pagamento do pagador sem movimentar nenhum valor. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
automatic.400Erro de requisição.
empty_required_header
O header X-Idempotency-Key é obrigatório e não foi enviado. Faça a requisição novamente incluindo-o.
invalid_idempotency_key_length
O X-Idempotency-Key deve ter entre 1 e 64 caracteres.
invalid_path_param
O order_id fornecido no path não é válido. Verifique e forneça um order_id válido para tentar novamente.
401Erro. Access Token não autorizado.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente enviar a requisição novamente com o valor correto.
invalid_credentials
Não há suporte para credenciais de teste. Utilize usuários de teste com credenciais de produção para o ambiente de teste (sandbox) e as suas credenciais de produção para o ambiente de produção.
404Recurso não encontrado.
order_not_found
Order não encontrada. Verifique se o order_id enviado está correto.
409Alguma regra específica do sistema não permite a realização da ação.
cannot_cancel_order
A order não pode ser cancelada porque não está em um status que permite o cancelamento. Apenas orders no status action_required podem ser canceladas.
order_already_canceled
A order já foi cancelada.
idempotency_key_already_used
O valor enviado como header de idempotência (X-Idempotency-Key) já foi utilizado. Por favor, tente a solicitação novamente enviando um novo valor.
500Erro genérico.
internal_error
Erro genérico. 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-1*********550113-12*********b4773884a*********e8df16347*********786' \
-H 'X-Idempotency-Key: 30838950-dd81-46c3-8bd0-fe0341ea257c' \
{
"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"
}
}
]
}
}