Skip to navigation
Referencia APIConnected Accounts

Crear cuenta bancaria conectada

Crea una cuenta bancaria externa para una cuenta conectada. Recurrente la usa como destino de retiros según la configuración de la cuenta hija.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

connected_account_idstringRequired
ID de la cuenta conectada

Request

This endpoint expects an object.
holder_namestringRequired

Nombre del titular que se conserva si no se puede confirmar; un nombre válido confirmado por el banco lo reemplaza.

numberstringRequired

Número de cuenta bancaria

bank_namestringRequired

Nombre del banco. La comparación es case-insensitive. Si el nombre no coincide con un banco soportado, Recurrente responde 400 con la lista de bancos válidos. Consulta GET /api/banks para obtener la lista actualizada.

currencyenumRequired
Moneda de la cuenta bancaria
Allowed values:
account_typeenumOptional
Tipo de cuenta bancaria
Allowed values:
is_preferredbooleanOptional

Enviar true para dejar esta cuenta bancaria como predeterminada para retiros en su moneda

Response

Cuenta bancaria creada
idstringOptional

ID único de la cuenta bancaria

bank_namestring or nullOptional
Nombre del banco
holder_namestringOptional
Nombre del titular
created_atdatetimeOptional

Fecha de creación

statusenumOptional
Estado de la cuenta bancaria
Allowed values:
currencyenumOptional
Moneda de la cuenta bancaria
Allowed values:
account_typeenum or nullOptional
Tipo de cuenta bancaria
Allowed values:
is_preferredbooleanOptional
Indica si es la cuenta preferida para su moneda
ownership_typeenumOptional
Tipo de cuenta bancaria
Allowed values:

Errors

400
Bad Request Error
404
Not Found Error