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.