For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Guías (Español)Guides (English)Referencia API
  • Referencia API
      • GETListar cuentas conectadas
      • POSTCrear una cuenta conectada
      • GETObtener cuenta conectada
      • PATCHActualizar cuenta conectada
      • GETListar cuentas bancarias conectadas
      • POSTCrear cuenta bancaria conectada
      • GETObtener cuenta bancaria conectada
      • DELArchivar cuenta bancaria conectada
      • PATCHActualizar cuenta bancaria conectada
LogoLogo
Referencia APIConnected Accounts

Crear cuenta bancaria conectada

POST
https://app.recurrente.com/api/connected_accounts/:connected_account_id/bank_accounts
POST
/api/connected_accounts/:connected_account_id/bank_accounts
$curl -X POST https://app.recurrente.com/api/connected_accounts/connected_account_id/bank_accounts \
>     -H "X-SECRET-KEY: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "holder_name": "Acme Restaurant, S.A.",
>  "number": "1234567890",
>  "bank_name": "Banco Industrial",
>  "currency": "GTQ"
>}'
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}

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.

Was this page helpful?
Previous

Obtener cuenta bancaria conectada

Next
Built with

Authentication

X-SECRET-KEYstring
Tu llave secreta de API

Path parameters

connected_account_idstringRequired
ID de la cuenta conectada

Request

This endpoint expects an object.
holder_namestringRequired
Nombre del titular de la cuenta
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
idstring

ID único de la cuenta bancaria

bank_namestring or null
Nombre del banco
holder_namestring
Nombre del titular
created_atdatetime

Fecha de creación

statusenum
Estado de la cuenta bancaria
Allowed values:
currencyenum
Moneda de la cuenta bancaria
Allowed values:
account_typeenum or null
Tipo de cuenta bancaria
Allowed values:
is_preferredboolean
Indica si es la cuenta preferida para su moneda
ownership_typeenum
Tipo de cuenta bancaria
Allowed values:

Errors

400
Bad Request Error
404
Not Found Error