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
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
invalid_payout_id
Se enviaron datos inválidos en el body de la solicitud. No se encontró el payout. Vuelve a intentar enviar la solicitud, validando todos los campos.
invalid_transaction_id
Se enviaron datos inválidos en el body de la solicitud. No se encontró la transacción. Vuelve a intentar enviar la solicitud, validando todos los campos.
invalid_signature
Se enviaron datos inválidos en el body de la solicitud. Verifica si la secret fue generada correctamente y está registrada con Mercado Pago. Verifica también si el body que estás enviando es el que fue cifrado.
idempotency_key_required
Se enviaron datos inválidos en el body de la solicitud. La clave de idempotencia ("idempotency_key") está ausente. Vuelve a intentar enviar la solicitud, validando todos los campos.
401Error. Access Token no autorizado.
invalid_token
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.
403Prohibido. No tiene permisos para acceder a este recurso.
forbidden
Sin permiso para acceder al recurso.
404Error. Payout no encontrado.
not_found
Payout no encontrado. Comprueba si enviaste el ID correcto.
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 "status=in_process".
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
502Error de gateway. Fallo en la integración con un servicio externo.
bad_gateway
Ocurrió un error en la integración con un servicio externo. 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' \
-H 'X-Idempotency-Key: 38037f66-c6c8-40e1-a8a3-6da11c41a21d' \
-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"
}'