nkap
Gateway de dinero móvil abierto con libro mayor doble entrada real. Gestiona integraciones con operadores como MTN MoMo, resolviendo timeouts sin fallas y asegurando idempotencia mediante reconciliación automática.
Ficha actualizada 22 sept 2026, 15:05 · upstream 22 sept 2026, 13:48 · release v2.0.0
Qué es nkap
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Nkap es un gateway de dinero móvil diseñado para actuar como capa intermedia entre aplicaciones y operadores de pago (ej. MTN MoMo), proporcionando una contabilidad verificable y un estado de máquina de pagos robusto. Su arquitectura se basa en un libro mayor doble entrada real, inmutable y con suma cero, donde cada transacción se registra mediante entradas reversibles en lugar de actualizaciones directas, garantizando la trazabilidad completa.
- Integración segura con operadores de dinero móvil (ej. MTN MoMo) sin reinventar lógica contable.
- Manejo de timeouts de red: los pagos no se marcan como fallidos automáticamente, sino que entran en estado UNKNOWN para ser resueltos por un reconciliador.
- Simulación de operadores mediante un módulo scriptable para pruebas de integración y casos de error antes del despliegue.
- Auditoría financiera con libro mayor append-only estricto, donde el saldo es la suma de las entradas, no una variable almacenada.
- Despliegue autocontenido en contenedores (Docker Compose) sin dependencias de SaaS externos.
- Libro mayor doble entrada real con reglas estrictas: append-only, suma cero y enteros para evitar errores de punto flotante.
- Timeout no es failure: los pagos en estado UNKNOWN se resuelven vía reconciliador interno o escalación humana, nunca asumiendo fallo automático.
- Idempotencia garantizada a nivel de operador mediante claves persistentes antes del envío, evitando cobros duplicados.
- Simulador de operador incluido para pruebas sin necesidad de credenciales reales hasta el momento del despliegue.
- Arquitectura modular con núcleo puro (core) independiente de frameworks web o bases de datos para facilitar auditoría y contribución.
- Nunca ha manejado dinero real; todas las pruebas se han realizado en sandbox de operadores (ej. MTN, M-Pesa).
- No incluye motor KYC/AML ni custodia de fondos; el dinero permanece con el operador.
- Requiere configuración manual de credenciales del operador y no ofrece marketplace integrado.
- Dependencia de infraestructura externa: PostgreSQL para base de datos y Kafka para eventos (según análisis técnico).
- No es una institución de pago licenciada; actúa como middleware, no como entidad financiera.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Docker Compose. Para producción, usar imágenes públicas en ghcr.io/deval123/nkap-gateway y nkap-simulator (linux/amd64 y arm64). Build desde fuente con docker compose up --build -d si se desea modificar código. Requisitos mínimos: 4 núcleos CPU, 4GB RAM, 20GB disco. No requiere JDK si se usa imagen pre-buildada. Verificar credenciales del operador antes de apuntar a producción.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.