Skip to navigation
Referencia APIConnected Accounts

Actualizar cuenta bancaria conectada

Cambia la cuenta bancaria predeterminada de retiros enviando is_preferred: true en la cuenta bancaria que debe quedar como principal.

Las cuentas bancarias son inmutables: para cambiar cualquier otro campo (titular, número, banco, moneda, tipo), archiva la cuenta bancaria existente y crea una nueva. Recurrente responde 400 si se intenta actualizar cualquier campo distinto de is_preferred.

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
idstringRequired
ID de la cuenta bancaria

Request

This endpoint expects an object.
is_preferredbooleanRequired

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

Response

Cuenta bancaria actualizada
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