Este endpoint permite cancelar una transacción programada elegible mediante el payout_id y el transaction_id devueltos al crear el payout. Solo se pueden cancelar transacciones que aún no se hayan procesado y tengan status=pending o status=in_process, y la cancelación es irreversible. La solicitud de cancelación debe enviarse con al menos 12 horas de antelación respecto de la fecha y hora de ejecución programadas. En caso de éxito, la solicitud devuelve el estado 204.
PUT
REQUERIDO
REQUERIDO
REQUERIDO CONDICIONAL
REQUERIDO CONDICIONAL
boolean que indica si el integrador enviará o no la firma. Debe ser false en ambiente de pruebas y true en ambiente productivo, que es cuando es obligatorio enviar la firma.REQUERIDO
id de la respuesta a POST /v1/payouts.REQUERIDO
transactions[].id de la respuesta a POST /v1/payouts.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.
invalid_account
El objeto `account` se envió sin el correo electrónico requerido para identificar la cuenta Mercado Pago de destino. Informa el correo electrónico de la cuenta destinataria en `email`.
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 solicitud 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-4*********782856-12*********f202ca494*********f0baa4bb3*********648' \
-H 'X-Idempotency-Key: 73446d4d-6199-4acd-8f53-1e218f435d94' \
-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"
}'