Primeros pasos
Modo test y sandbox
Con una llave test conectas el Banco de Prueba, un banco simulado que responde como uno real pero con datos ficticios. No necesitas cuentas bancarias reales para construir y probar tu integración.
Banco de Prueba
- Su id es
sandboxy solo aparece en modo test. - Acepta titulares individuales y de empresa.
- No se conecta a ningún banco ni usa la red: responde al instante.
- Es determinista: el mismo RUT entrega siempre las mismas cuentas y movimientos, así que puedes escribir pruebas automatizadas sobre sus datos.
Credenciales de prueba
Usa el RUT 11.111.111-1 o cualquier RUT válido. La clave decide qué pasa:
| Clave | Resultado | Estado del link |
|---|---|---|
banky | La conexión se completa. | active |
2fa | El banco pide un código de segundo factor. El código correcto es 123456; cualquier otro se rechaza y puedes volver a intentarlo. | active |
error | El banco rechaza el RUT o la clave. El widget muestra el error y no se crea la conexión. | No se crea |
bloqueo | El banco pide una acción en su sitio antes de continuar. No se crea la conexión. | No se crea |
| Cualquier otra | Se trata como clave incorrecta. | No se crea |
Para un titular de empresa (holder_type: "business") el formulario pide además el RUT de la empresa. Usa cualquier RUT válido, por ejemplo 76.123.874-4.
Datos simulados
Cada conexión de prueba tiene dos cuentas en pesos chilenos:
| Titular | Cuentas | Movimientos típicos |
|---|---|---|
| Individual | Cuenta Corriente (checking_account) y Cuenta Vista (sight_account) | Remuneración el día 28, arriendo, cuentas de luz y agua, compras en comercios, transferencias entre personas y ahorro mensual. |
| Empresa | Cuenta Corriente (checking_account) y Línea de Crédito (line_of_credit) | Pagos de facturas de clientes, pagos a proveedores, remuneraciones, impuestos mensuales (F29) e intereses de la línea. |
La primera lectura trae los últimos 90 días. Los movimientos incluyen contraparte con nombre y RUT (ficticios, con dígito verificador válido) y número de operación cuando corresponde. Con el RUT 11.111.111-1, el titular individual se llama Camila Rojas Fuentes.
Para simular una actualización, pide una sincronización. Como los datos son deterministas, no se duplican movimientos:
curl -X POST "https://api.banky.cl/v1/links/link_9f2c41ab7e05d318/refresh" \
-H "Authorization: Bearer $BANKY_SECRET_KEY"Probar webhooks
- Registra un endpoint en el panel, en Webhooks, con el modo test activo. Los eventos de conexiones test solo llegan a endpoints test.
- Usa el botón Enviar prueba del panel para recibir un evento de ejemplo firmado.
- Conecta el Banco de Prueba para recibir
link.createdymovements.new, y usa el refresh para recibirlink.refreshed.
La URL del webhook debe ser HTTPS y pública. Para probar en tu computador, expón tu servidor local con un túnel HTTPS. Más detalles en Webhooks.