🛰️ ShopVPN — Smart V2Ray Configuration Sales Bot

• 🔑 Unique configuration inventory per user with automatic provisioning
• 🔗 Direct product-to-panel assignment
• 🔄 Free-form renewal by traffic/time amount
• 👤 Unified My Account for purchased, gifted and test services
• 🧪 Multiple configurable test plans
• 🔢 Multi-quantity purchases with automatic total calculation
• 💱 Automatic USD/USDT exchange-rate lookup with fallback rates
• 💰 Internal wallet with top-up requests and admin approval
• 🗂️ Product/category management with pricing and stock controls
• 🚫 User blocking and mandatory channel membership
• 📊 Live subscription information and expiration/traffic reminders
• ⚠️ Low-stock alerts for administrators
• 📱 Configuration delivery as text + QR code
• 🎫 Support tickets and live support chat
• 🎨 Customizable main-menu layout, labels and colors
• 🏷️ Store branding controls
• 🏢 Independent reseller bots with isolated databases
• 🌐 Polling or Webhook mode
• 💾 Persistent FSM state on SQLite
• ⏳ Temporary/sensitive-message cleanup
• 📣 Channel advertising and deep-link utilities

• 🏢 Linked reseller mode inside the main bot
• 🤖 Independent reseller bots
• 👥 Referral links with multiple reward models
• 💸 Percentage commissions and fixed wallet rewards
• 🎁 Free configuration rewards after referral thresholds
• 🏷️ Discount codes with limits, expiration and product/category scope
• 🎡 Lucky wheel with configurable rewards and cooldown
• 🪜 Reseller tiers, fees, expiration, reminders and credit limits
• 📦 Product-based reseller supply
• 💰 Wallet and cashback features

• 👑 Owner, Admin, Mid-level Admin and Support roles
• 📢 Broadcast messaging
• 📈 Sales statistics with date filters
• 📝 Full administrator audit logs
• 🗄️ Automatic daily backups to Telegram
• ♻️ Immediate backup and full database restore
• 📅 Jalali/Persian calendar support
• 👥 Users, products, categories, gateways, panels and reseller management
• 🎫 Support, reports and system settings

• 🛡️ User anti-spam/rate limiting
• 🎟️ Advanced discount-code limits
• 🔒 Sensitive payment/card message cleanup

• 🩺 VPN panel health monitoring and recovery alerts
• 📊 Daily sales reports
• 📣 Topic-based report groups
• 🎁 Bulk traffic/time gifts
• 🧹 Automatic cleanup of expired services
• 🔌 Token-scoped Integration API

• ⏸️ On-hold services that start expiration on first connection
• 📦 Per-panel capacity limits
• 📍 Service location/panel migration
• 💰 Bulk product price editing with undo
• 💸 Renewal/wallet cashback
• 🎁 Wallet top-up gift codes
• 🪙 Coins and scheduled lottery
• 🎫 Department-based support tickets and outage reports

The AI layer answers repetitive customer questions before escalating to human support.

• 🔌 Selectable providers: Gemini, Groq or OpenRouter
• 📚 Administrator-managed FAQ knowledge
• 🔎 Real user-specific answers for services, expiration, wallet and orders
• 🛒 Real purchase cards with current prices and payment buttons
• 🔒 No direct financial/write operations by the AI
• 🙋 Automatic escalation for financial complaints or explicit human-support requests
• ⚡ If no API provider is configured, requests can go directly to human support

All gateways are independent and can be enabled or disabled separately.

The miniapp/ directory contains a full Telegram Mini App with both a customer storefront and web administration.

• ⚡ FastAPI backend with secure Telegram initData verification
• 🎨 Responsive storefront
• 🛒 Products, cart, wallet, lucky wheel, referrals and test configurations
• 🔔 Expiration and traffic alerts
• 📲 Add subscriptions to popular VPN apps using deep links
• 🎫 Support tickets and live support chat
• 🌐 Persian/English switch with automatic RTL/LTR direction

• 📊 Dashboard and order exports
• 🗂️ Categories, products, panels and configuration management
• 🏢 Reseller management
• 🏷️ Discounts, lucky wheel, referrals and reminders
• 👥 User search, blocking and targeted broadcasts
• 💰 Wallet lookup and balance adjustments
• 🎨 Branding and theme customization
• 🧩 Telegram main-menu layout management
• 🎫 Ticket/support management
• 📝 System and admin logs
• 🗄️ Backup and database restore

The admin_panel/ package provides a standalone web administration panel independent of Telegram.

• 🔐 Username/password login with independent sessions
• 👥 Separate web-admin roles and permissions
• 📊 Sales, orders, wallet and system dashboards
• 🎨 Multiple visual themes
• 📱 PWA installation on mobile
• 🌍 Global server map and health checks
• 💱 Exchange-rate management
• ✅ Order, wallet and payment approval
• 🏢 Reseller management and analytics
• 🎫 Support tickets and conversations
• 📢 Broadcast messaging
• 🗄️ Backup and restore
• 🔔 Web Push notifications
• 📱 Android app token management
• 📝 Web-admin audit logs
• 🌐 Persian/English UI with automatic RTL/LTR

Automatic: use the relevant manage.sh option for the web panel.

Manual:

python -m admin_panel.create_admin <username> <password>
uvicorn admin_panel.server:app --host 127.0.0.1 --port 8002

The backend provides infrastructure for a native Android management application.

• 🔑 Secure long-lived administrator token (PAT)
• 🧩 Server-Driven UI
• 🔔 Firebase Cloud Messaging (FCM) push notifications
• 📋 Orders, tickets, users, products, discounts, VPN panels and web admins
• 🌍 Server map through WebView
• 🎨 Light/dark interface
• 🔕 Per-section notification controls

1. Installs system prerequisites
2. Clones or updates the project
3. Creates the Python virtual environment
4. Installs required packages
5. Installs/updates the local translation runtime and language models automatically
6. Creates/configures .env
7. Creates the systemd service
8. Starts the bot and keeps it running after server reboots

sudo systemctl status v2raybot
sudo journalctl -u v2raybot -f
sudo systemctl restart v2raybot
sudo systemctl stop v2raybot

The same one-line installer can be run again for future updates. Translation runtime and language models are installed/updated automatically; no manual translation setup is required.

git clone https://github.com/mehdirafatpanah/Shopvpn.git
cd Shopvpn

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

cp .env.example .env
nano .env

At minimum:

BOT_TOKEN=your_bot_token
OWNER_ID=your_numeric_telegram_id

python main.py

For production, use the automatic installer/systemd approach or another process manager.

The exact variables depend on enabled features. Common configuration areas include:

Keep production secrets outside the repository.

manage.sh is the main installation and maintenance helper.

Depending on the project version, it can handle:

• 🚀 Installation and dependency setup
• ⚙️ Environment/configuration
• ▶️ Start/stop/restart
• 📲 Mini App and web panel setup
• 🗄️ Backup/restore
• 🔌 VPN panel setup
• 📋 Logs and diagnostics
• 🔗 Integration API setup
• 🌐 Persian/English management menu

Run:

chmod +x manage.sh
./manage.sh

The script itself is the authoritative source for the current menu options.

• Python 3.10+
• aiogram 3.x
• FastAPI
• SQLite
• HTML/CSS/JavaScript
• Telegram Mini Apps / WebApp authentication
• Firebase Cloud Messaging
• HTTP/API integrations for VPN panels, payments and AI providers

• 🩺 VPN panel health monitoring
• 📊 Advanced sales and activity analytics
• 📣 Topic-based reporting
• 🎁 Bulk gifts
• 🧹 Expired-service cleanup
• 🔌 Token-scoped Integration API
• ⏸️ On-hold services
• 📦 Panel capacity limits
• 📍 Service migration
• 💰 Bulk price editing with undo
• 💸 Cashback
• 🎁 Wallet gift codes
• 🪙 Coins and lottery
• ⭐ Order/service ratings
• 💸 Wallet transfers
• 🧾 Wallet transaction ledger
• 📦 Configurable delivery modes and QR backgrounds
• 🔗 Multi-domain subscription links
• 🧩 Custom configuration-builder products
• 🛠️ 3X-UI utilities
• 🗄️ Multi-bot backup/restore
• 📨 Secondary backup destinations
• 🏭 Owner-only factory reset
• ⏰ Scheduled broadcasts
• 🔘 Automatic Mini App menu-button synchronization
• 🔗 Advertising/deep-link tracking
• 🟢 Admin-presence routing
• 🔔 Pending-invoice push notifications
• 🖼️ Mini App banner/catalog management
• 🔀 Multi-level referral commissions and fraud suspension
• 💳 Reseller postpaid credit
• 📉 Reseller-tier quantity discounts
• 🌐 Resellers without their own Telegram bot through the web API

Bug reports, feature suggestions, documentation improvements and pull requests are welcome.

Before opening a pull request:

1. Keep secrets and production credentials out of the repository.
2. Preserve database compatibility where possible.
3. Run relevant Python/JavaScript checks.
4. Keep Persian and English user-facing text synchronized through the i18n layer.

This project is released under the MIT License.

Created by Mehdi Rafatpanah

• Telegram: @celenor
• GitHub: @mehdirafatpanah