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
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
invalid_payout_id
Dados inválidos foram enviados no body da requisição. O payout não foi encontrado. Tente enviar a solicitação novamente, validando todos os campos.
invalid_transaction_id
Dados inválidos foram enviados no body da requisição. A transação não foi encontrada. Tente enviar a solicitação novamente, validando todos os campos.
invalid_signature
Dados inválidos foram enviados no body da requisição. Verifique se a secret foi gerada corretamente e está registrada com o Mercado Pago. Verifique também se o body que está enviando é o que foi criptografado.
idempotency_key_required
Dados inválidos foram enviados no body da requisição. A chave de idempotência ("idempotency_key") está ausente. Tente enviar a solicitação novamente, validando todos os campos.
401Erro. Access Token não autorizado.
invalid_token
O Access Token enviado está incorreto. Revise o valor e tente enviar a requisição novamente com a informação correta.
403Proibido. Não tem permissões para acessar este recurso.
forbidden
Sem permissão para acessar o recurso.
404Erro. Payout não encontrado.
not_found
Payout não encontrado. Verifique se o ID enviado está correto.
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 "status=in_process" podem ser canceladas.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
502Erro de gateway. Falha na integração com um serviço externo.
bad_gateway
Ocorreu um erro na integração com um serviço externo. 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' \
-H 'X-Idempotency-Key: 0b7cbb89-eb7f-400c-ad5b-afdb26bc1eff' \
-H 'X-signature: true' \
-H 'X-enforce-signature: false' \
-H 'X-test-token: false' \
-d '{
"comments": "delete because the payment was canceled",
"deleted_by": "user_123"
}'