Referencia APIConnected Accounts

Actualizar cuenta conectada

Actualiza los datos comerciales, los datos fiscales y la configuración de retiros de una cuenta conectada. Para usar retiros instantáneos, la cuenta hija debe cumplir los requisitos de elegibilidad de Recurrente.

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. 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

idstringRequired
ID de la cuenta conectada

Request

This endpoint expects an object.
namestringOptional
Nombre comercial de la cuenta hija
withdrawals_scheduleenumOptional
Frecuencia para retiros de la cuenta hija

Response

Cuenta conectada actualizada
idstringOptional

ID único de la cuenta conectada

statusstringOptional
Estado de la cuenta
namestringOptional
Nombre comercial de la cuenta
account_typeenumOptional
Tipo de cuenta de negocio
created_atdatetimeOptional

Fecha de creación

creator_namestringOptional
Nombre del usuario creador
creator_emailstringOptionalformat: "email"
Email del usuario creador
tax_idstring or nullOptional
ID fiscal de la cuenta
tax_namestring or nullOptional
Nombre fiscal de la cuenta
withdrawals_scheduleenum or nullOptional
Frecuencia configurada para retiros
onboarding_completedbooleanOptional

Indica si la cuenta completó onboarding

Errors

400
Bad Request Error
404
Not Found Error