Este endpoint permite cancelar una transacción agendada utilizando el ID de referencia obtenido en la respuesta a su creación. El cancelamento está destinado a permitir la interrupción de operaciones de pago incorrectas o no deseadas antes de la conclusión financiera, siendo irreversible para preservar la integridad operacional y garantizar el seguimiento completo para auditoría. Solo pueden ser canceladas transacciones que aún no han sido procesadas ("pending" e "in_process"). En caso de éxito, la solicitud devolverá una respuesta con el estado 204.
PUT
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
bad_request
Se enviaron datos inválidos en el body de la solicitud. Vuelve a intentar enviar la solicitud, validando todos los campos.
401No autorizado. Credenciales inválidas o faltantes.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
404No encontrado. El recurso solicitado no existe.
not_found
El recurso solicitado no fue encontrado o el valor enviado para identificarlo es inexistente. Valida la información enviada en los parámetros y vuelve a intentarlo.
412Precondición no cumplida. El estado de la transacción no permite la cancelación.
Precondition Failed
El estado en el que se encuentra la transacción no permite su cancelación. Solo pueden ser canceladas transacciones con "status" 'pending' o 'in_process'.
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
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"
}'