Resources
System Architecture
PayWallet is built on a microservices architecture with clear separation of concerns, enabling scalability, maintainability, and flexibility.
Architecture Overview
PayWallet follows a microservices architecture pattern with an API Gateway as the single entry point.
Microservices Architecture
Loosely coupled services that can scale independently. Each service has a specific responsibility.
Multi-Tenant Support
Complete data isolation per tenant. Subdomain-based routing with database-per-tenant architecture.
API Gateway Pattern
Single entry point for all API requests. Centralized authentication, routing, and rate limiting.
Event-Driven Communication
Services communicate via events and REST APIs. Redis Pub/Sub for real-time event distribution.
Modular Monolith
FinOps service uses modular monolith pattern - clear module boundaries within a single deployable unit.
Fineract Integration
Deep integration with Apache PayWallet (Fineract) for core banking operations and ledger management.
Backend Services
All backend services are built with Spring Boot and communicate via REST APIs and events.
Gateway API
Port 8080Single entry point for all API requests. Handles authentication, routing, and rate limiting.
Core Service
Port 8081Core banking operations built on Apache PayWallet. Handles clients, loans, savings, and accounting.
Tenant Manager
Port 8082Multi-tenant management and provisioning. Handles tenant configuration and platform administration.
ROSCA Service
Port 8083ROSCA (Rotating Savings and Credit Association) operations. Group management and contribution tracking.
FinOps Service
Port 8084Financial operations modular monolith. Consolidates payments, billing, reconciliation, notifications, credit bureau, POS, and vouchers.
Frontend Applications
Three separate frontend applications, each optimized for specific use cases.
paywallet-ui
Port 3001Core banking application with Platform Admin, Core Banking, and Self-Service portals.
paywallet-web
Port 5174Unified marketing site — For Rounds and For Business.
paywallet-rosca-ui
Port 3003ROSCA admin and member portals.
Request Flow
How requests flow through the PayWallet platform.
Client Request
Frontend application sends request to Gateway API (Port 8080)
Authentication & Routing
Gateway validates authentication and routes to appropriate service
Service Processing
Backend service processes request and interacts with database
Response
Response flows back through Gateway to frontend application
Service Status
All backend services are operational and ready for use. Swagger/OpenAPI documentation is available on the Gateway service.
Gateway API
Port 8080Single entry point for all API requests. Handles authentication, routing, and rate limiting.
Core Service
Port 8081Core banking operations built on Apache PayWallet. Handles clients, loans, savings, and accounting.
Tenant Manager
Port 8082Multi-tenant management and provisioning. Handles tenant configuration and platform administration.
ROSCA Service
Port 8083ROSCA (Rotating Savings and Credit Association) operations. Group management and contribution tracking.
FinOps Service
Port 8084Financial operations modular monolith. Consolidates payments, billing, reconciliation, notifications, credit bureau, POS, and vouchers.
Multi-Tenant Architecture
PayWallet supports multiple organizations with complete data isolation.
Subdomain-Based Routing
- Platform Admin:
localhost:3000 - Tenant Access:
{tenant}.localhost:3000 - Default Tenant:
default.localhost:3000
Database Isolation
- One database per tenant (e.g.,
paywallet_default) - Tenant metadata in shared database (
paywallet_tenants) - Complete data isolation between tenants
Built-in platform capabilities
Core attributes that apply across lending, ROSCA, and FinOps services.
Package platform suites in weeks not months
Deploy a modern lending stack plus PayWallet-specific ROSCA and FinOps operations as modular suites for each tenant and market.
Launch Operations
Operate with one consistent platform experience
Product, operations, and engineering teams stay aligned through the same modern UI patterns and real-time operational surfaces.
Live Platform Status
Track gateway, ROSCA, and FinOps service readiness from a dedicated status page.
View status
FinOps Suite
Operate tenant billing, payment providers, and platform controls from FinOps-backed admin surfaces.
Explore FinOps
Platform Admin
Manage tenant operations across Core, ROSCA, and FinOps from the central admin control plane.
Open admin portal
System Architecture
Review service boundaries and how the platform scales across product modules.
See architecture
Learn More
Explore our API documentation and integration guides to start building with PayWallet.