GET /v1/institutions — consúltala para armar tu UI de selección de banco; cuando sumamos una institución nueva aparece ahí sin que cambies tu integración.
El
bank_id es el identificador que pasas al crear un link o emitir un widget_token. El id de institución (cl_<bank_id>) es el que devuelven los recursos de la API.Instituciones
Esta página lista las instituciones operando hoy.
GET /v1/institutions puede
devolver además alguna con status distinto de available (paused,
maintenance, coming_soon, disabled): ésas no aceptan conexiones nuevas, así
que filtra por status antes de ofrecerlas. Ver Estados de banco.Cada moneda es una cuenta distinta: una tarjeta o un producto bimoneda llega
como dos
account con el mismo nombre y distinto currency. No sumes saldos de
monedas distintas — Rail no convierte nada a pesos.refresh_type: "historical" en el refresh_intent se amplía la ventana donde el banco lo permite.
Comportamientos a tener en cuenta
BancoEstado tiene login asíncrono: puede tardar 60–90 segundos en detectar una clave incorrecta. Si tu usuario reporta que la conexión “se queda pegada”, espera al menos 90s antes de asumir error.
Productos de inversión. Hoy cuatro instituciones entregan el detalle de
sus productos de inversión en el bloque
investment del recurso account:
Banco de Chile (fondos mutuos y depósitos a plazo), BCI (depósitos a
plazo, fondos mutuos y acciones), Santander (fondos mutuos) y Banco BICE
(depósitos a plazo). El detalle y la cobertura campo por campo están en
Productos de inversión. Otras instituciones pueden
clasificar un producto como type: "investment" sin detalle: ahí investment
viene null.Sandbox
En test mode, todas las instituciones funcionan con las credenciales mágicas (RUT11.111.111-1 + clave rail-sandbox) y devuelven data fake determinista — sin tocar el banco real. El bank_id que elijas es cosmético en sandbox.
Banca empresa
Las cuentas de empresa no son unbank_id aparte: usas la misma institución y la distingues con holder_type: "business" al emitir el widget_token. Mismo modelo que Fintoc — ver Banca empresa.
Las seis piden los mismos tres campos: RUT de la empresa, RUT de la persona usuaria y su clave (el widget los rotula como los rotula cada portal).
La banca empresa es más chica y más nueva que la de personas: el volumen por
institución es bajo y el histórico disponible varía por banco. Si vas a armar un
producto sobre una de éstas, escríbenos antes para que te digamos en qué estado
está.
Consulta
GET /v1/institutions?holder_type=business para ver en todo momento qué instituciones soportan empresa y qué credenciales pide cada una (credential_fields).Consultar disponibilidad en runtime
GET /v1/institutions lista las instituciones soportadas, sus productos por holder_type y los campos de credenciales que pide cada una. Filtra con ?holder_type= y ?product=.
individual vs business, y qué campos pedir en cada una).