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 los datos requeridos para identificar la cuenta de destino. Informa `email` para una cuenta Mercado Pago o los datos bancarios obligatorios de una cuenta externa, incluidos `number` y `bank_id`. Para una transferencia vía Pix, define `transactions.type` como `pix` y envía los datos de la clave en `transactions.pix` en lugar de `account`.
invalid_account_type
El campo account_type se envió con un valor no compatible. Los valores aceptados son checking_account o savings.
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-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: d5979e57-42d5-4aa1-91d5-fad92ec353fe' \
-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"
}'