Tahweel
Tahweel es una herramienta open source que convierte un teléfono Android en un gateway de pagos para billeteras móviles (Vodafone Cash, e& Money). El teléfono envía SMS de confirmación al servidor, este verifica la autenticidad del operador y envía un webhook firmado.
Ficha actualizada 23 sept 2026, 1:25 · upstream 23 sept 2026, 1:18 · release v0.2.0
Qué es Tahweel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Tahweel permite transformar un teléfono Android con SIM de una billetera móvil en un punto de pago seguro. Cuando el usuario realiza un pago, el SMS que recibe del operador se envía al servidor Tahweel, este verifica la autenticidad mediante tokens y envía un webhook firmado a tu backend. Todo ocurre localmente sin necesidad de cloud, cuentas o telemetría externa.
La arquitectura es simple: el teléfono actúa como proxy entre el operador y tu sistema. El servidor mantiene una base de datos de intentos de pago y registra las confirmaciones. Esto elimina la dependencia de APIs del operador y reduce los costos operativos.
El proyecto incluye un gestor de dispositivos, un dashboard para visualizar transacciones, un parser de SMS y documentación completa en español.
- Conectar una billetera móvil (Vodafone Cash, e& Money) a tu sistema de pagos sin necesidad de API del operador
- Automatizar la confirmación de pagos mediante SMS sin intervención humana
- Crear un punto de pago local que no dependa de servicios externos ni de internet continuo
- Monitorear y auditar cada transacción realizada por el usuario
- Implementar sistemas de pago en zonas con mala conectividad o sin acceso a APIs externas
- Funciona completamente localmente: no requiere cloud, cuentas ni telemetría externa. Tu data nunca sale del servidor.
- API RESTful con Swagger UI y Postman collection lista para producción
- Soporta múltiples wallets mediante un solo archivo de parser
- Verificación de firmas en los webhooks para evitar fraudes
- Compatible con Android 6.0+ y funciona sobre USB o WiFi
- Diseñado para ser escalable: puedes agregar más dispositivos sin modificar el código
- Funciona mejor con SMS de confirmación que no requieren verificación de OTP (como Vodafone Cash), ya que el teléfono actúa como proxy y no necesita autenticar cada mensaje
- No soporta métodos de pago que requieran autenticación por PIN o biometría del usuario en tiempo real
- El servidor debe estar siempre activo; si se apaga, las transacciones pendientes pueden perderse
- La velocidad de procesamiento depende de la capacidad del teléfono y del servidor
- No incluye funcionalidades avanzadas como pagos con tarjeta, transferencias entre cuentas o cobros recurrentes
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.
Para desplegar Tahweel en producción, utiliza Docker con PostgreSQL. Configura variables de entorno para el token de ingestión, la clave API y la contraseña del administrador. Usa un reverse proxy (Nginx) como load balancer entre el servidor Tahweel y tu backend. Implementa backups diarios de la base de datos. Para actualizar, usa Docker Compose o despliega desde Git. Si Google Play Protect bloquea la instalación, instala el APK vía ADB en lugar de Android Studio.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.