Link Bank Account

Linkea una cuenta virtual existente en Core X con una cuenta corriente del banco sponsor,
habilitando movimientos de dinero real en esa cuenta virtual.

El proceso es sincrónico y genera un alias único para la cuenta virtual basado en el banco sponsor:

CONSORCIO: Genera alias de 19 dígitos (formato: 9000000000000000001+)

INTERNACIONAL: Genera alias de 12 dígitos (formato: 901000000001+)

El tax_id_virtual_account se infiere automáticamente:

Si la cuenta tiene owner_id (persona asociada), se usa el RUT de esa persona

Si no tiene owner_id, se usa el RUT de la organización

Validaciones

La cuenta virtual debe existir y estar en estado active

La cuenta bancaria debe existir en el sistema

Una cuenta virtual no puede estar linkeada dos veces

El banco sponsor debe ser CONSORCIO o INTERNACIONAL

Datos para pruebas

🏦 Cuentas Bancarias

Estas cuentas bancarias retornarán status ACTIVE o FAILED (HTTP 502) cuando se linkeen:

bank_sponsor	bank_account_number	tax_id_bank_account	Status	Uso Recomendado
CONSORCIO	`1234567890`	`17876267-9`	`ACTIVE`	Ejemplo básico de linkeo exitoso
CONSORCIO	`2345678901`	`18765432-1`	`ACTIVE`	Ejemplo básico de linkeo exitoso
CONSORCIO	`3456789012`	`76123456-7`	`FAILED`	Probar manejo de errores del banco sponsor
INTERNACIONAL	`9876543210`	`76123456-7`	`ACTIVE`	Ejemplo básico de linkeo exitoso
INTERNACIONAL	`8765432109`	`18765432-1`	`ACTIVE`	Ejemplo básico de linkeo exitoso
INTERNACIONAL	`7654321098`	`17876267-9`	`FAILED`	Probar manejo de errores del banco sponsor

Respuestas

201 Created: Linkeo exitoso (status ACTIVE o RESERVED)

400 Bad Request: Cuenta virtual no existe o cuenta bancaria no existe

409 Conflict: Cuenta no activa o ya linkeada al mismo banco

502 Bad Gateway: El banco sponsor rechazó el linkeo (status FAILED)

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/accounts/link-bank-account' \ --header 'X-Organization-ID;' \ --header 'idempotency-key;' \ --header 'traceparent;' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab", "bank_account_number": "1234567890", "bank_sponsor": "CONSORCIO", "tax_id_bank_account": "17876267-9" }'

{ "data": { "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab", "bank_account_number": "1234567890", "bank_sponsor": "CONSORCIO", "tax_id_bank_account": "17876267-9", "virtual_account_alias": "9000000000000000001", "status": "ACTIVE", "created_at": "2025-12-28T10:30:00Z" }, "metadata": { "trace_id": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01", "timestamp": "2025-12-28T10:30:00Z" } }

Validaciones#

Datos para pruebas#

🏦 Cuentas Bancarias#

Respuestas#

Solicitud

Respuestas

Validaciones

Datos para pruebas

🏦 Cuentas Bancarias

Respuestas