connectedAccounts

Actualizar cuenta bancaria conectada

Changed on Sep 19, 2026

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.

patch/connected_accounts/{connected_account_id}/bank_accounts/{id}

Request

Base URL
https://app.recurrente.com/api
Auth
API key in header X-SECRET-KEY
TypeScript
https://skmtc.dev/recurrente/apis/referencia-api/docs/connected_accounts/:connected_account_id/bank_accounts/:id/patch.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

connected_account_idstring required

ID de la cuenta conectada

idstring required

ID de la cuenta bancaria

Request body

is_preferredboolean required

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

Response

Cuenta bancaria actualizada

idstring

ID único de la cuenta bancaria

bank_namestring nullable

Nombre del banco

holder_namestring

Nombre del titular

created_atstring date-time

Fecha de creación

status'active' | 'archived'

Estado de la cuenta bancaria

currency'GTQ' | 'USD'

Moneda de la cuenta bancaria

account_type'checking' | 'savings'

Tipo de cuenta bancaria

is_preferredboolean

Indica si es la cuenta preferida para su moneda

ownership_type'external' | 'virtual'