Platform Architecture
A microservices architecture designed for financial-grade reliability, with clear separation of concerns and non-custodial fund flows.
Non-Custodial by Design
PayWolt never holds customer funds. All money movements are executed directly by licensed payment providers. This architecture provides regulatory clarity and eliminates counterparty risk.
Core Principles
Orchestration-Only Model
PayWolt orchestrates payment flows without holding customer funds. All transactions are processed directly by licensed payment providers.
Provider-Based Flows
Intelligent routing across multiple providers (Stripe, Wise, Flutterwave, Adyen) with automatic failover and optimization.
Database Per Service
Each microservice owns its data. No shared databases. Clean boundaries enable independent scaling and deployment.
Cloud-Native Design
Built for containerized environments with health checks, graceful shutdowns, and horizontal scaling.
Service Overview
Gateway
API routing, rate limiting, authentication
Wallet
Multi-currency accounts, balances, transactions
Ledger
Double-entry accounting, audit trails
Orchestrator
Provider selection, flow coordination
Auth
Identity, sessions, permissions
KYC
Identity verification, compliance checks
Canary Deployment Philosophy
Every production release follows a phased rollout strategy.
Limited Exposure
New code serves a small subset of traffic before full rollout.
Real-Time Metrics
Continuous monitoring of success rates and latency during rollout.
Automatic Rollback
Degradation triggers immediate reversion to stable version.