# kongogaming/nexpay architecture

> Architecture diagram of the GitHub repository kongogaming/nexpay, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kongogaming/nexpay
- Repository: https://github.com/kongogaming/nexpay

## Overview

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: [`app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt`](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt) (Payment sessions), [`app/src/main/java/com/nexpay/app/MainActivity.kt`](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/MainActivity.kt) (Home and pay), [`app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt`](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt) (SMS verification), [`app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt`](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt) (Transaction repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup and preferences"]
  node_setup_ui["Guided setup<br/>[SetupActivity.kt]"]
  node_setup_logic["Setup logic<br/>[SetupHelper.kt]"]
  node_settings["Settings"]
  node_settings_store["Preferences"]
end

subgraph group_payment["Payment initiation"]
  node_home["Home and pay<br/>[MainActivity.kt]"]
  node_qr["QR scanning"]
  node_qr_parser["QR parsing<br/>[QRCodeParser.kt]"]
  node_call_manager["Telephony dialing<br/>[CallManager.kt]"]
  node_call_overlay["Call overlay"]
end

subgraph group_verification["Verification and state"]
  node_session["Payment sessions"]
  node_call_state["Call state"]
  node_window["SMS observation window"]
  node_sms_receiver["SMS receiver"]
  node_sms_pipeline["SMS verification"]
  node_sms_parser["Bank SMS parser"]
  node_result["Payment result"]
end

subgraph group_data["Transactions and history"]
  node_repository["Transaction repository"]
  node_database[("Encrypted database<br/>[AppDatabase.kt]")]
  node_key_manager["Database key"]
  node_transaction["Transaction record<br/>[Transaction.kt]"]
  node_history["Transaction history"]
end

node_user(("User"))
node_carrier(("Telecom network"))
node_bank(("Bank / NPCI"))

node_user -->|"opens"| node_home
node_home -->|"starts scan"| node_qr
node_qr -->|"parses code"| node_qr_parser
node_qr -->|"starts session"| node_session
node_home -.->|"initiates contact rail"| node_call_manager
node_call_manager -->|"dials USSD or IVR"| node_carrier
node_call_manager -->|"starts overlay"| node_call_overlay
node_call_overlay -->|"observes session"| node_session
node_session -->|"collects call events"| node_call_state
node_session -.->|"persists pending state"| node_repository
node_carrier -->|"routes payment"| node_bank
node_bank -->|"sends confirmation"| node_carrier
node_carrier -->|"delivers SMS"| node_sms_receiver
node_sms_receiver -.->|"passes message"| node_sms_pipeline
node_sms_pipeline -.->|"parses confirmation"| node_sms_parser
node_sms_pipeline -->|"confirms outcome"| node_session
node_sms_pipeline -->|"updates records"| node_repository
node_session -.->|"manages observation"| node_window
node_sms_pipeline -->|"opens result"| node_result
node_repository -->|"reads and writes"| node_database
node_database -->|"unwraps encryption key"| node_key_manager
node_database -->|"stores entities"| node_transaction
node_home -->|"opens settings"| node_settings
node_settings -->|"persists preferences"| node_settings_store
node_home -->|"opens history"| node_history
node_history -.->|"loads transactions"| node_repository
node_user -->|"completes setup"| node_setup_ui
node_setup_ui -->|"delegates setup"| node_setup_logic

click node_home "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/MainActivity.kt"
click node_setup_ui "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/SetupActivity.kt"
click node_setup_logic "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/helpers/SetupHelper.kt"
click node_settings "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt"
click node_settings_store "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/SettingsRepository.kt"
click node_qr "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt"
click node_qr_parser "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/features/qr_scanner/domain/QRCodeParser.kt"
click node_call_manager "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/managers/CallManager.kt"
click node_call_overlay "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/services/CallOverlayService.kt"
click node_session "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt"
click node_call_state "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/telephony/CallStateCoordinator.kt"
click node_window "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/PaymentWindowObserver.kt"
click node_sms_receiver "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/receivers/SimpleSMSReceiver.kt"
click node_sms_pipeline "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt"
click node_sms_parser "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/sms/SmsTransactionParser.kt"
click node_result "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/PaymentResultActivity.kt"
click node_repository "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt"
click node_database "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/AppDatabase.kt"
click node_key_manager "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/DatabaseKeyManager.kt"
click node_transaction "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/Transaction.kt"
click node_history "https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/TransactionHistoryActivity.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_setup_ui,node_setup_logic,node_settings,node_settings_store,node_user toneBlue
class node_home,node_qr,node_qr_parser,node_call_manager,node_call_overlay toneAmber
class node_session,node_call_state,node_window,node_sms_receiver,node_sms_pipeline,node_sms_parser,node_result toneMint
class node_repository,node_database,node_key_manager,node_transaction,node_history toneRose
class node_carrier,node_bank toneIndigo
```

## Components

### Setup and preferences

- [Guided setup](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/SetupActivity.kt): `app/src/main/java/com/nexpay/app/SetupActivity.kt`
- [Setup logic](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/helpers/SetupHelper.kt): `app/src/main/java/com/nexpay/app/helpers/SetupHelper.kt`
- [Settings](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt): `app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt`
- [Preferences](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/SettingsRepository.kt): `app/src/main/java/com/nexpay/app/data/SettingsRepository.kt`

### Payment initiation

- [Home and pay](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/MainActivity.kt): `app/src/main/java/com/nexpay/app/MainActivity.kt`
- [QR scanning](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt): `app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt`
- [QR parsing](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/features/qr_scanner/domain/QRCodeParser.kt): `app/src/main/java/com/nexpay/app/features/qr_scanner/domain/QRCodeParser.kt`
- [Telephony dialing](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/managers/CallManager.kt): `app/src/main/java/com/nexpay/app/managers/CallManager.kt`
- [Call overlay](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/services/CallOverlayService.kt): `app/src/main/java/com/nexpay/app/services/CallOverlayService.kt`

### Verification and state

- [Payment sessions](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt): `app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt`
- [Call state](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/telephony/CallStateCoordinator.kt): `app/src/main/java/com/nexpay/app/telephony/CallStateCoordinator.kt`
- [SMS observation window](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/PaymentWindowObserver.kt): `app/src/main/java/com/nexpay/app/payment/PaymentWindowObserver.kt`
- [SMS receiver](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/receivers/SimpleSMSReceiver.kt): `app/src/main/java/com/nexpay/app/receivers/SimpleSMSReceiver.kt`
- [SMS verification](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt): `app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt`
- [Bank SMS parser](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/payment/sms/SmsTransactionParser.kt): `app/src/main/java/com/nexpay/app/payment/sms/SmsTransactionParser.kt`
- [Payment result](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/PaymentResultActivity.kt): `app/src/main/java/com/nexpay/app/ui/activities/PaymentResultActivity.kt`

### Transactions and history

- [Transaction repository](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt): `app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt`
- [Encrypted database](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/AppDatabase.kt): `app/src/main/java/com/nexpay/app/data/AppDatabase.kt`
- [Database key](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/DatabaseKeyManager.kt): `app/src/main/java/com/nexpay/app/data/DatabaseKeyManager.kt`
- [Transaction record](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/data/Transaction.kt): `app/src/main/java/com/nexpay/app/data/Transaction.kt`
- [Transaction history](https://github.com/kongogaming/nexpay/blob/main/app/src/main/java/com/nexpay/app/ui/activities/TransactionHistoryActivity.kt): `app/src/main/java/com/nexpay/app/ui/activities/TransactionHistoryActivity.kt`

### Other components

- **User**
- **Telecom network**
- **Bank / NPCI**

## Connections

- User → Home and pay: opens (evidence: `README.md`)
- Home and pay → QR scanning: starts scan (evidence: `app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt`)
- QR scanning → QR parsing: parses code (evidence: `app/src/main/java/com/nexpay/app/features/qr_scanner/presentation/QRScannerActivity.kt`)
- QR scanning → Payment sessions: starts session (evidence: `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 (evidence: `README.md`)
- Telephony dialing → Call overlay: starts overlay (evidence: `app/src/main/java/com/nexpay/app/managers/CallManager.kt`)
- Call overlay → Payment sessions: observes session (evidence: `app/src/main/java/com/nexpay/app/services/CallOverlayService.kt`)
- Payment sessions → Call state: collects call events (evidence: `app/src/main/java/com/nexpay/app/payment/PaymentSessionManager.kt`)
- Payment sessions → Transaction repository: persists pending state
- Telecom network → Bank / NPCI: routes payment (evidence: `README.md`)
- Bank / NPCI → Telecom network: sends confirmation (evidence: `README.md`)
- Telecom network → SMS receiver: delivers SMS (evidence: `README.md`)
- SMS receiver → SMS verification: passes message
- SMS verification → Bank SMS parser: parses confirmation
- SMS verification → Payment sessions: confirms outcome (evidence: `app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt`)
- SMS verification → Transaction repository: updates records (evidence: `app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt`)
- Payment sessions → SMS observation window: manages observation
- SMS verification → Payment result: opens result (evidence: `app/src/main/java/com/nexpay/app/receivers/SmsIngestionPipeline.kt`)
- Transaction repository → Encrypted database: reads and writes (evidence: `app/src/main/java/com/nexpay/app/repository/TransactionRepository.kt`)
- Encrypted database → Database key: unwraps encryption key (evidence: `app/src/main/java/com/nexpay/app/data/AppDatabase.kt`)
- Encrypted database → Transaction record: stores entities (evidence: `app/src/main/java/com/nexpay/app/data/AppDatabase.kt`)
- Home and pay → Settings: opens settings (evidence: `app/src/main/java/com/nexpay/app/MainActivity.kt`)
- Settings → Preferences: persists preferences (evidence: `app/src/main/java/com/nexpay/app/ui/activities/SettingsActivity.kt`)
- Home and pay → Transaction history: opens history (evidence: `app/src/main/java/com/nexpay/app/MainActivity.kt`)
- Transaction history → Transaction repository: loads transactions
- User → Guided setup: completes setup (evidence: `README.md`)
- Guided setup → Setup logic: delegates setup (evidence: `app/src/main/java/com/nexpay/app/SetupActivity.kt`)
