Este endpoint permite cancelar uma transação agendada utilizando o ID de referência obtido na resposta à sua criação. O cancelamento destina-se a permitir a interrupção de operações de pagamento incorretas ou indesejadas antes da conclusão financeira, sendo irreversível visando preservar a integridade operacional e garantir o rastreamento completo para auditoria. Apenas transações que ainda não foram processadas ("pending" e "in_process") podem ser canceladas. Em caso de sucesso, a requisição retornará uma resposta com o status 204.
PUT
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
bad_request
Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.
401Não autorizado. Credenciais inválidas ou ausentes.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
403Proibido. Não tem permissões para acessar este recurso.
forbidden
Sem permissão para acessar o recurso.
404Não encontrado. O recurso solicitado não existe.
not_found
O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.
412Pré-condição não atendida. O status da transação não permite cancelamento.
Precondition Failed
O status da transação não permite o seu cancelamento. Apenas transações com "status" 'pending' ou 'in_process' podem ser canceladas.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
curl -X PUT \
'https://api.mercadopago.com/v1/payouts/{payout_id}/transactions/{transaction_id}/cancel'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
-d '{
"comments": "delete because the payment was canceled",
"deleted_by": "user_123"
}'