# FinKilo (finkilo.com)

> FinKilo es una plataforma de infraestructura financiera y emisión de tarjetas prepagadas virtuales sobre la red global Visa denominadas en Pesos Digitales (MMXN, paridad 1:1 MXN), con fondeo instantáneo mediante stablecoins (USDT, USDC, MMXN) en redes TRON (TRC-20), Ethereum (ERC-20), BNB Smart Chain (BEP-20) y Polygon, así como transferencias interbancarias SPEI (CLABE dedicada de 18 dígitos). Opera bajo un esquema de custodia soberana con frase semilla de 12 palabras y matriz de seguridad dinámica para personas físicas, además de ofrecer una suite B2B empresarial con API REST y OAuth 2.0 para dispersión corporativa en México.

## Productos y Niveles de Tarjeta (Panteón Maya)

- **Chaac (Acceso Esencial)**: Tarjeta virtual Visa en MMXN optimizada para compras online, suscripciones digitales y pagos cotidianos. Emisión inmediata en 60 segundos, fondeo mínimo desde $25 USD ($500 MMXN), soporte 3D Secure (3DS), CVV dinámico de 4 minutos y bloqueo/desbloqueo instantáneo (Hold/Unhold).
- **Kukulcán (Edición Soberana)**: Tarjeta virtual Visa diseñada para uso diario, comercio electrónico internacional, viajes y servicios cloud. Fondeo desde $50 USD ($1,000 MMXN), comisión de recarga reducida y CVV dinámico rotativo.
- **Itzamná (Arquitecto Supremo)**: Tarjeta virtual Visa de alta capacidad para media buyers (Meta Ads, Google Ads, TikTok Ads), freelancers y operaciones empresariales. Fondeo desde $100 USD ($2,000 MMXN), cuenta CLABE SPEI dedicada, dirección USDT dedicada y límites mensuales de hasta $5,000,000 MMXN.
- **Pakal (Grado Imperial)**: Nivel superior del protocolo FinKilo con compatibilidad para Apple Pay y Google Pay (pagos contactless NFC), comisión preferencial de recarga, CLABE interbancaria dedicada y límites de hasta $15,000,000 MMXN mensuales.

## Soluciones Empresariales (FinKilo B2B & API)

- **Emisión y Dispersión Corporativa (`/empresas`)**: Plataforma exclusiva para Personas Morales en México (onboarding KYB). Permite emitir tarjetas corporativas Visa para viáticos, bonos, nómina e incentivos con fondeo vía SPEI o tesorería cripto.
- **API REST v1 & OAuth 2.0 (`/docs`)**:
  - Emisión programática de tarjetas virtuales (`POST /api/v1/b2b/cards/issue`).
  - Recarga instantánea desde balance maestro empresarial (`POST /api/v1/b2b/cards/:id/reload`).
  - Consulta de saldo en tiempo real y movimientos conciliados (`GET /api/v1/cards/:id/balance`, `GET /api/v1/cards/:id/transactions`).
  - Control de estado Hold/Unhold (`POST /api/v1/cards/:id/toggle-hold`) y generación de CVV dinámico (`POST /api/v1/cards/:id/cvv/generate`).
  - Webhooks firmados con HMAC-SHA256 para notificaciones en tiempo real de fondeos SPEI, compras POS y recargas cripto.
  - Componente embebible seguro (`/embed/card`) con aislamiento y verificación por matriz de coordenadas.

## Arquitectura de Seguridad

- **Custodia Soberana**: Autenticación criptográfica mediante frase semilla mnemónica BIP-39 de 12 palabras (PBKDF2 / HMAC-SHA256) y matriz de coordenadas dinámica para revelar numeración PAN y CVV.
- **CVV Dinámico (dCVV)**: Código de seguridad de 3 dígitos generado directamente con el procesador emisor con vigencia temporal de 240 segundos (4 minutos) para prevenir fraude en comercio electrónico.
- **Paridad Estable 1:1**: Denominación nativa en MMXN (Moneta Digital), eliminando volatilidad cambiaria frente al Peso Mexicano (MXN).

## Enlaces Principales y Documentación

- [Sitio Principal y Catálogo de Tarjetas](https://finkilo.com/): Emisión instantánea, simulador de recarga cripto a MMXN y comparativa técnica.
- [FinKilo para Empresas (B2B)](https://finkilo.com/empresas): Onboarding KYB para personas morales, dispersión masiva y tarjetas corporativas.
- [Documentación API v1 & SDK](https://finkilo.com/docs): Referencia técnica de endpoints REST, flujo OAuth 2.0, webhooks y widget embebible.
- [Aviso de Privacidad](https://finkilo.com/privacidad): Políticas de tratamiento de datos, minimización de información y derechos ARCO.
- [Términos y Condiciones](https://finkilo.com/terminos): Marco contractual, uso aceptable, límites operativos y políticas de cumplimiento.
- [Seguridad y Reporte de Vulnerabilidades](https://finkilo.com/.well-known/security.txt): Canal oficial RFC 9116 para investigadores de seguridad.