Saltar al contenido

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

  1. 01

    Tu servidor crea un link token

    Con tu llave secret pides un token de un solo uso que vence en 30 minutos.

  2. 02

    Tu usuario conecta su banco

    Abres el widget con ese token. La persona elige su banco e ingresa sus credenciales.

  3. 03

    Recibes la conexión

    El widget te entrega el link y te avisamos por webhook. Desde ese momento sincronizamos solos.

  4. 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

ConceptoQué es
OrganizaciónTu 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 tokenToken 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ónUn 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

¿Prefieres generar un cliente? Descarga la especificación OpenAPI 3.1 de la API v1.