Saltar al contenido

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 sandbox y 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:

ClaveResultadoEstado del link
bankyLa conexión se completa.active
2faEl banco pide un código de segundo factor. El código correcto es 123456; cualquier otro se rechaza y puedes volver a intentarlo.active
errorEl banco rechaza el RUT o la clave. El widget muestra el error y no se crea la conexión.No se crea
bloqueoEl banco pide una acción en su sitio antes de continuar. No se crea la conexión.No se crea
Cualquier otraSe 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:

TitularCuentasMovimientos típicos
IndividualCuenta 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.
EmpresaCuenta 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.created y movements.new, y usa el refresh para recibir link.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.