Cuentas Virtuales#
Una cuenta virtual es una cuenta del Core de Fidi X que está conectada directamente a una cuenta corriente bancaria. Esta conexión permite que transferencias bancarias reales impacten automáticamente el saldo en el Core, sin que el cliente de Fidi X tenga que registrar manualmente cada movimiento.Es la capacidad que hace posible que un producto financiero digital reciba dinero del sistema bancario tradicional de forma directa y trazable.
Cómo funciona#
Para que una cuenta virtual opere, se necesita que existan tres elementos:Una cuenta corriente del cliente en uno de los bancos sponsor con los que Fidi X tiene integración activa — actualmente Banco Consorcio y Banco Internacional.Una cuenta en el Core de Fidi X previamente creada, que actuará como la representación digital de esa cuenta corriente dentro del sistema.Un alias — un identificador único que se genera en el momento del linkeo y que conecta ambas cuentas. El alias es el dato que debe compartirse con quien vaya a realizar transferencias hacia esa cuenta virtual.
El flujo de una transferencia entrante#
Una vez que la cuenta virtual está configurada, el flujo de entrada de fondos opera de la siguiente manera:El originador realiza una transferencia bancaria desde su banco, usando el alias y el RUT del cliente como datos de destinatario. El banco sponsor recibe la transferencia y notifica a Fidi X. Fidi X registra automáticamente la transacción en el ledger — el saldo de la cuenta virtual se actualiza — y simultáneamente notifica al cliente del ingreso a través de un webhook.Desde la perspectiva del cliente de Fidi X, el flujo es transparente: no necesita intervenir en ningún paso del proceso. El dinero llega, el ledger se actualiza, y el webhook notifica.
Requisitos para linkear una cuenta#
Antes de poder linkear una cuenta, deben cumplirse las siguientes condiciones:Tener una organización activa con un ledger operativo en Fidi X.
Tener una cuenta corriente habilitada en uno de los bancos sponsor.
Haber creado previamente la cuenta en Fidi X que se desea linkear.
La relación entre cuentas#
Una cuenta de Fidi X puede estar linkeada a una y solo una cuenta corriente bancaria. Una cuenta corriente, en cambio, puede tener múltiples cuentas de Fidi X asociadas — cada una identificada por su propio alias único.Si se desea cambiar la cuenta corriente asociada a una cuenta de Fidi X, primero debe deslinkearse la existente.
El alias#
El alias es el identificador que hace posible que una transferencia bancaria llegue a la cuenta correcta dentro del ledger. Su formato depende del banco sponsor:Banco Consorcio — alias de 19 dígitos.
Banco Internacional — alias de 12 dígitos.
Sandbox#
Para facilitar el desarrollo e integración, Fidi X provee un endpoint de simulación que permite replicar el comportamiento de una transferencia bancaria entrante sin necesidad de realizar una operación bancaria real. Es útil para probar el flujo completo en ambiente de sandbox antes de pasar a producción.
(referencia técnica de la API)
Modificado en 2026-06-02 15:38:25
