Referencia APIWithdrawals

Crear un retiro

Deprecated
> **Obsoleto:** usa el endpoint unificado [`POST /transfers`](/api-reference/transfers/crear-una-transferencia) con `destination: {type: bank_account, id: ...}`. Este endpoint sigue funcionando para integraciones existentes. Paga el balance de tu cuenta a una de tus cuentas bancarias externas. Requiere una llave con movimiento de dinero habilitado. El retiro es **asíncrono**: la respuesta es el estado inicial (`pending`/`in_review`/`approved`); suscríbete a los webhooks `withdrawal.*` o consulta el estado.

Authentication

X-SECRET-KEYstring
Tu clave secreta de API

Headers

Idempotency-KeystringOptional

Clave de idempotencia para reintentos seguros de operaciones críticas, especialmente las que mueven dinero o cambian estado operativo. Reintentar con la misma clave y el mismo cuerpo devuelve la respuesta original (header Idempotency-Replayed: true); reusarla con parámetros distintos devuelve 409.

Request

This endpoint expects an object.
bank_account_idstringRequired
ID de la cuenta bancaria destino
amount_in_centsintegerRequired
currencyenumOptional
Por defecto, la moneda de la cuenta bancaria
Allowed values:
is_instantbooleanOptional

Retiro instantáneo (sujeto a elegibilidad y comisión)

Response

Retiro creado (asíncrono)

idstring
statusenum
amount_in_centsinteger
currencystring
bank_namestring
notestring or null
Nota del retiro
created_atdatetime
bank_accountobject

Errors

400
Bad Request Error
403
Forbidden Error