Cancelar ação por ID

Este endpoint permite cancelar uma ação criada para Mercado Pago Point e suas transações utilizando o ID de referência obtido na resposta à sua criação. Apenas uma ação com status "created" pode ser cancelada. Em caso de sucesso, a requisição retornará uma resposta com o status 200.

POST

https://api.mercadopago.com/terminals/v1/actions/{action_id}/cancel
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
X-Idempotency-Key
string

OBRIGATÓRIO

Esta função permite repetir solicitações de forma segura, sem o risco de realizar a mesma ação mais de uma vez por engano. Isso é útil para evitar erros, como a criação de dois pagamentos idênticos. Para garantir que cad...Ver mais
Path
action_id
string

OBRIGATÓRIO

ID da ação a ser cancelada. Esse valor é retornado na resposta à requisição Criar ação de terminal.
Response parameters
This request has no response
Erros

400Erro.

empty_required_header

O header 'X-Idempotency-Key' é requerido e não foi enviado. Faça a requisição novamente incluindo-o.

invalid_path_param

O action_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 fornecido como Access Token está incorreto. Por favor, verifique e envie a solicitaçã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.

Request
curl -X POST \
    'https://api.mercadopago.com/terminals/v1/actions/{action_id}/cancel'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
       -H 'X-Idempotency-Key: 2e07cfe3-65b6-4702-9a76-87cddd229e79' \
    
Response
// Esta requisição não tem resposta.