Primeros pasos
Documentación de Banky
Banky es una API de Open Finance para Chile. Con autorización del titular, conecta cuentas bancarias de empresas y personas, y entrega sus saldos y movimientos por API REST, webhooks y MCP. Es de solo lectura: Banky nunca mueve dinero.
Cómo funciona
01
Tu servidor crea un link token
Con tu llave secret pides un token de un solo uso que vence en 30 minutos.
02
Tu usuario conecta su banco
Abres el widget con ese token. La persona elige su banco e ingresa sus credenciales.
03
Recibes la conexión
El widget te entrega el link y te avisamos por webhook. Desde ese momento sincronizamos solos.
04
Lees cuentas y movimientos
Por API REST, por webhooks cuando llegan movimientos nuevos, o desde un agente de IA por MCP.
Las credenciales bancarias las recibe solo nuestro servidor, a través del widget. Tu aplicación nunca las ve ni las guarda, y nosotros las guardamos cifradas para poder sincronizar sin volver a pedirlas.
Conceptos
| Concepto | Qué es |
|---|---|
| Organización | Tu empresa dentro de Banky. Se crea al entrar por primera vez al panel con Google. Las llaves de API, las conexiones y los webhooks pertenecen a una organización. |
| Link token | Token de un solo uso (lt_…) que abre el widget para una persona. Lo crea tu servidor y vence a los 30 minutos. |
| Conexión (objeto link) | La autorización de un titular sobre un banco (link_…). Guarda el estado de la conexión, cuándo se sincronizó y si permite acceso por MCP. En la API se llama link. |
| Cuenta (account) | Una cuenta bancaria de una conexión (acc_…): cuenta corriente, cuenta vista, ahorro, tarjeta o línea de crédito, con su saldo disponible y contable. |
| Movimiento (movement) | Un abono o cargo de una cuenta (mov_…), en pesos enteros, con fecha contable, glosa del banco, contraparte (nombre y RUT) y número de operación cuando el banco los informa. |
| Institución | Un banco soportado, con su estado (disponible o próximamente) y los tipos de titular que acepta. |
Modo live y modo test
Cada organización tiene dos mundos separados. Las llaves indican a cuál pertenecen por su prefijo, y una llave de un modo nunca ve datos del otro.
- Test (
banky_sk_test_…): conecta solo el Banco de Prueba, un banco simulado con datos ficticios y deterministas. Úsalo para desarrollar y para tus pruebas automatizadas. - Live (
banky_sk_live_…): conecta bancos reales con credenciales reales.
Siguientes pasos
Inicio rápido
Conecta una cuenta de prueba y lee sus movimientos en cinco pasos.
Widget de conexión
Instala connect.js y recibe la conexión en tu aplicación.
Referencia de API
Todos los endpoints, con ejemplos en curl, Node.js y Python.
MCP
Da acceso de solo lectura a Claude, ChatGPT y otros agentes.
¿Prefieres generar un cliente? Descarga la especificación OpenAPI 3.1 de la API v1.