AP PayOrbit

📖 Introduction PayOrbit is a high-performance payment routing and gateway aggregation engine designed for modern web businesses, SaaS products, and developers. It allows merchants to connect multiple payment gateway credentials to their projects, define traffic routing policies, enforce daily/monthly volume caps, and execute seamless smart routing to minimize transaction fees and avoid gateway downtimes. With custom adapters, transaction capping validation, real-time webhook propagation, reseller wallet commission ledgers, and developer API tooling, PayOrbit is a complete payment gateway management infrastructure. 🚀 Key Features 1. Smart Gateway Shuffling & Routing Enforce routing configurations at the project level to dynamically distribute transactions among enabled payment gateways: Round Robin: Distributes transaction traffic equally across gateways using an active index pointer. Random: Picks an active gateway randomly to load-balance or split transactions. Load Based: Prioritizes gateways based on lowest lifetime volume (lifetime_received) or minimal absolute usage. Failover (Priority-Based): Selects gateways strictly according to merchant-defined priority_order. 2. Transaction Volume Capping & Auto-Bypassing Configure strict transaction caps on gateways to stay within regulatory limits, avoid high gateway-specific fees, or distribute volume: Daily Cap, Monthly Cap, and Lifetime Cap limits. Real-time limit checking via the CapValidatorService. Automatic gateway bypassing once caps are breached, transitioning traffic to next-in-line gateways. 3. Multi-Tier Role System Administrator Dashboard: System configuration, global gateway activation/deactivation, merchant/user blocking, commission milestone rates, reseller setup, and withdrawal management. Reseller Portal: Merchant onboarding tracking, reseller gateway setup, commission balance monitoring, wallet ledger auditing, and withdrawal payouts. Merchant/User Dashboard: API key generation, multiple web/mobile projects configuration, active gateway mapping with custom caps and priorities, webhook delivery configurations, logs, and billing subscriptions. 4. Comprehensive Gateway Adapters Out-of-the-box adapters for popular payment processors including Stripe and Razorpay. Dynamic UPI QR Code Session Engine (built on chillerlan/php-qrcode) with customizable expiry times. Manual Bank & QR Payment confirmation flow with ledger tracking and verification steps. Clean adapter patterns allowing easy extension to other platforms (Cashfree, PayU, Paytm, Instamojo, PayPal). 5. Robust Developer Tooling Token-based API Authentication (laravel/sanctum and Custom API Key auth). Complete endpoints for payment initiation, verification, status lookup, and refund processing. Built-in webhook listener and dispatcher with automated retry queue logic (3 retries with exponential backoffs: 60s, 300s, 900s) and full audit logs.