Actualizar cuenta bancaria conectada

PATCH

https://app.recurrente.com/api/connected_accounts/:connected_account_id/bank_accounts/:id

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.

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.

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.

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

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

currencyenumOptional

Moneda de la cuenta bancaria

account_typeenum or nullOptional

Tipo de cuenta bancaria

is_preferredbooleanOptional

Indica si es la cuenta preferida para su moneda

ownership_typeenumOptional

Tipo de cuenta bancaria

Errors

400

Bad Request Error

404

Not Found Error

$	curl -X PATCH https://app.recurrente.com/api/connected_accounts/connected_account_id/bank_accounts/id \
>	-H "X-SECRET-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"is_preferred": true
>	}'

1	{
2	"id": "ba_lmgbvesmihkqzma3",
3	"bank_name": "Banco Industrial",
4	"holder_name": "Acme Restaurant, S.A.",
5	"created_at": "2024-01-15T09:30:00Z",
6	"status": "active",
7	"currency": "GTQ",
8	"account_type": "checking",
9	"is_preferred": true,
10	"ownership_type": "external"
11	}