💳 SmartCardJo — Telecom POS & Wallet Ecosystem

⚙️ Overview

SmartCardJo is a large-scale Laravel-based financial platform that powers telecom recharge, balance management, and card sales across Jordan.
It connects multiple user tiers — Admins, Sellers, Sub-Sellers, and Customers — through a real-time wallet and transaction API that syncs with Android applications.

The system processes millions of transactions daily, maintaining full accuracy across wallets, balances, and profit distributions with zero downtime.

🧱 Tech Stack

• Backend: Laravel (RESTful API architecture)
• Frontend: Vue.js (Admin panel & reporting dashboard)
• Mobile: Android (2 separate apps: Seller & Sub-Seller)
• Database: MySQL (optimized for financial precision)
• Caching: Redis (real-time balance and transaction speed)
• API Communication: Token-based authentication, JSON response, layered request validation
• Server Management: Nginx on VPS with auto-backup and log rotation
• Monitoring: Custom transaction logger + daily balance snapshot verification

🔐 Core Features

✅ Wallet & Balance System:
Multi-level credit structure with instant profit distribution to seller, sub-seller, and admin tiers.

✅ Transaction Engine:
Handles hundreds of concurrent API calls per second with queue management, rollback protection, and detailed logging.

✅ Profit & Commission System:
Dynamic rates per seller and product, auto-calculated at transaction time, tracked in a dedicated profits table.

✅ Stock Management:
Tracks virtual cards, SIMs, and telecom products with expiry, out-of-stock flags, and variant pricing.

✅ Payment Gateways:
Integrated UWallet API for Jordanian payments + internal reconciliation logic for unmatched records.

✅ Admin Dashboard:
Real-time KPIs: total sales, active users, wallet balances, stock value, and cash-in/out analytics.

✅ Security & Recovery:
Automatic backups, transaction signature verification, and daily snapshot comparison via Artisan commands.

📱 Mobile Integration

Two Android applications connected through Laravel APIs:

• Seller App: real-time order execution, wallet sync, history logs
• Sub-Seller App: limited-access layer for retail resellers with secure authentication and dynamic pricing

All synced through /api/v1/ endpoints with token validation and permission checks.

📊 Impact

• Over 1,000+ active merchants
• Millions of API transactions per day
• 99.99% uptime
• Fully automated daily financial snapshot to detect discrepancies
• Currently expanding with new payment gateways and reconciliation layers

🧠 My Role

• Architected the entire system from ground zero
• Designed wallet logic, commission flow, and recovery tools
• Developed Android communication layer (Laravel APIs)
• Implemented real-time monitoring, logging, and balance validation
• Managed database optimization, migrations, and live production scaling