Crear un retiro para una cuenta conectada

Deprecated

POST

https://app.recurrente.com/api/connected_accounts/:connected_account_id/withdrawals

POST

/api/connected_accounts/:connected_account_id/withdrawals

$ curl -X POST https://app.recurrente.com/api/connected_accounts/connected_account_id/withdrawals \
>      -H "X-SECRET-KEY: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "bank_account_id": "string",
>   "amount_in_cents": 1
> }'

1 {
2   "id": "wi_ab12cd34",
3   "status": "pending",
4   "amount_in_cents": 50000,
5   "currency": "GTQ",
6   "bank_name": "Banco Industrial",
7   "note": "string",
8   "created_at": "2024-01-15T09:30:00Z",
9   "bank_account": {
10     "id": "ba_lmgbvesmihkqzma3",
11     "bank_name": "Banco Industrial",
12     "holder_name": "Acme Restaurant, S.A.",
13     "created_at": "2024-01-15T09:30:00Z",
14     "status": "active",
15     "currency": "GTQ",
16     "account_type": "checking",
17     "is_preferred": true,
18     "ownership_type": "external"
19   }
20 }

Obsoleto: usa el endpoint unificado POST /transfers con account_id y destination: {type: bank_account, id: ...}. Este endpoint sigue funcionando para integraciones existentes.

Crea un retiro (payout) para una cuenta conectada (hija), pagando a una de las cuentas bancarias de la hija. Requiere movimiento de dinero habilitado en la llave de la plataforma.

> **Obsoleto:** usa el endpoint unificado [`POST /transfers`](/api-reference/transfers/crear-una-transferencia) con `account_id` y `destination: {type: bank_account, id: ...}`. Este endpoint sigue funcionando para integraciones existentes. Crea un retiro (payout) para una cuenta conectada (hija), pagando a una de las cuentas bancarias de la hija. Requiere movimiento de dinero habilitado en la llave de la plataforma.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API

Path parameters

connected_account_idstringRequired

Request

This endpoint expects an object.

bank_account_idstringRequired

amount_in_centsintegerRequired

currencyenumOptional

Allowed values:

is_instantbooleanOptional

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

Authentication

Path parameters

Headers

Request

Response

Errors