Saltar al contenido

Operación

Seguridad

Banky maneja credenciales bancarias y datos financieros. Esta página explica qué hacemos para protegerlos y qué te toca a ti en tu integración.

Principios

  • Solo lectura. Banky lee saldos y movimientos. No inicia pagos ni transferencias, y la API no tiene endpoints para mover dinero.
  • Consentimiento explícito. Cada conexión la autoriza el titular en el widget, y puede revocarse en cualquier momento con DELETE /v1/links/{id} o desde el panel.
  • Mínimo acceso. Live y test están aislados, y el acceso por MCP se autoriza conexión por conexión.

Credenciales bancarias

  • Se ingresan en el widget, que corre en banky.cl, y viajan por HTTPS directo a nuestro servidor. Tu aplicación nunca las recibe.
  • Se guardan cifradas en una bóveda de secretos (Supabase Vault), a la que solo accede el servidor mediante funciones restringidas. No se guardan en tablas comunes ni en el navegador.
  • Nunca se escriben en registros, nunca se devuelven por la API y nunca aparecen en mensajes de error.
  • Los códigos de segundo factor (Multipass, códigos de prueba) son de un solo uso: se envían al banco y no se guardan.
  • Abrimos una sola sesión a la vez con el banco por conexión y siempre la cerramos al terminar. Si el banco rechaza una clave, no reintentamos: así evitamos que la bloquee.
  • Al revocar una conexión borramos de inmediato sus credenciales y el dispositivo de confianza.

Llaves y acceso

  • Las llaves de API se muestran una sola vez. Guardamos solo su huella SHA-256.
  • Los datos de cada organización están aislados con políticas de seguridad a nivel de fila en la base de datos. El panel solo muestra lo que pertenece a las organizaciones de las que eres miembro.
  • Los webhooks se firman con HMAC-SHA256 y un secreto por endpoint, guardado en la misma bóveda.
  • No entregamos eventos a URLs internas o privadas (localhost, redes privadas, servicios de metadatos), para evitar que un webhook se use contra nuestra red.
  • Aplicamos límites de solicitudes en la API, el widget y el MCP.

Tu integración

  • Guarda la llave secret solo en tu servidor (ver buenas prácticas).
  • Verifica la firma de cada webhook y rechaza los eventos con más de 5 minutos de antigüedad (ver Verificar la firma).
  • Protege los datos bancarios que guardes con el mismo cuidado que cualquier dato personal sensible.
  • Explica a tus usuarios para qué usas sus datos y cómo revocar el acceso, y elimina la conexión cuando ya no la necesites.

Reportar un problema

Si encuentras una vulnerabilidad, escríbenos a hola@banky.cl con los detalles para reproducirla. No accedas a datos de terceros ni hagas pruebas que afecten el servicio. Respondemos todos los reportes.