How kongogaming/nexpay works
NexPay is an offline-first Android payment client. Users configure their bank and permissions, then initiate a transfer through QR-to-USSD or contact-to-UPI-123PAY; a locally observed bank SMS determines the authoritative outcome, which is shown and stored for later review. The graph preserves both payment rails, verification, encrypted persistence, onboarding, and settings. Some subsystem links are included only where the README documents them; unsampled implementation details are not inferred.
Main entry points: PaymentSessionManager.kt Payment sessions · MainActivity.kt Home and pay · SmsIngestionPipeline.kt SMS verification · TransactionRepository.kt Transaction repository
Components 24
Setup and preferences
- Guided setup
app/src/main/java/com/nexpay/app/SetupActivity.kt - Setup logic
app/src/main/java/com/nexpay/app/helpers/SetupHelper.kt - Settings
app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt - Preferences
app/src/main/java/com/nexpay/app/data/SettingsRepository.kt
Payment initiation
- Home and pay
app/src/main/java/com/nexpay/app/MainActivity.kt - QR scanning
app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt - QR parsing
app/src/main/java/com/nexpay/app/features/qr_scanner/domain/QRCodeParser.kt - Telephony dialing
app/src/main/java/com/nexpay/app/managers/CallManager.kt - Call overlay
app/src/main/java/com/nexpay/app/services/CallOverlayService.kt
Verification and state
- Payment sessions
app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt - Call state
app/src/main/java/com/nexpay/app/telephony/CallStateCoordinator.kt - SMS observation window
app/src/main/java/com/nexpay/app/payment/PaymentWindowObserver.kt - SMS receiver
app/src/main/java/com/nexpay/app/receivers/SimpleSMSReceiver.kt - SMS verification
app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt - Bank SMS parser
app/src/main/java/com/nexpay/app/payment/sms/SmsTransactionParser.kt - Payment result
app/src/main/java/com/nexpay/app/ui/activities/PaymentResultActivity.kt
Transactions and history
- Transaction repository
app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt - Encrypted database
app/src/main/java/com/nexpay/app/data/AppDatabase.kt - Database key
app/src/main/java/com/nexpay/app/data/DatabaseKeyManager.kt - Transaction record
app/src/main/java/com/nexpay/app/data/Transaction.kt - Transaction history
app/src/main/java/com/nexpay/app/ui/activities/TransactionHistoryActivity.kt
Other components
- User
- Telecom network
- Bank / NPCI
Connections 28
- User → Home and pay: opens
README.md - Home and pay → QR scanning: starts scan
app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt - QR scanning → QR parsing: parses code
app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt - QR scanning → Payment sessions: starts session
app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt - Home and pay → Telephony dialing: initiates contact rail
- Telephony dialing → Telecom network: dials USSD or IVR
README.md - Telephony dialing → Call overlay: starts overlay
app/src/main/java/com/nexpay/app/managers/CallManager.kt - Call overlay → Payment sessions: observes session
app/src/main/java/com/nexpay/app/services/CallOverlayService.kt - Payment sessions → Call state: collects call events
app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt - Payment sessions → Transaction repository: persists pending state
- Telecom network → Bank / NPCI: routes payment
README.md - Bank / NPCI → Telecom network: sends confirmation
README.md - Telecom network → SMS receiver: delivers SMS
README.md - SMS receiver → SMS verification: passes message
- SMS verification → Bank SMS parser: parses confirmation
- SMS verification → Payment sessions: confirms outcome
app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt - SMS verification → Transaction repository: updates records
app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt - Payment sessions → SMS observation window: manages observation
- SMS verification → Payment result: opens result
app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt - Transaction repository → Encrypted database: reads and writes
app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt - Encrypted database → Database key: unwraps encryption key
app/src/main/java/com/nexpay/app/data/AppDatabase.kt - Encrypted database → Transaction record: stores entities
app/src/main/java/com/nexpay/app/data/AppDatabase.kt - Home and pay → Settings: opens settings
app/src/main/java/com/nexpay/app/MainActivity.kt - Settings → Preferences: persists preferences
app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt - Home and pay → Transaction history: opens history
app/src/main/java/com/nexpay/app/MainActivity.kt - Transaction history → Transaction repository: loads transactions
- User → Guided setup: completes setup
README.md - Guided setup → Setup logic: delegates setup
app/src/main/java/com/nexpay/app/SetupActivity.kt