A premium, highly-optimized Telegram Store Bot developed by Sync Org. Built with modern architecture, aesthetic interfaces, and robust security.
- Core Engine: Hydrogram (Asynchronous MTProto Client)
- Database: MongoDB (Motor Asyncio)
- State Management: In-Memory dictionary caching for lightning-fast UI state transitions.
- Environment Management: Completely dynamic. All secrets load safely via environment variables.
1. Aesthetic Minimalist Interface
Designed entirely around simple typography. We abandoned messy emojis in favor of crisp formatting using bold, mono, blockquote, and italic elements. The result is a clean, premium aesthetic.
2. Smart Stock System
- Atomic transactions to prevent race conditions during high-volume purchases.
- Supports both
accounts(Login Flow) andsessions(Session File Delivery). - Advanced bulk uploading via Text, TXT Files, and a live in-bot Dialpad for Manual Logins.
- Live session validation (Checks for dead or duplicate sessions automatically on upload).
3. Integrated Payment Gateways
- Manual UPI processing (Screenshots verified by admins).
- Crypto (USDT TRC20 and Binance Pay) integration.
- Full payment tracking history for users via their profile dashboard.
4. Advanced Admin Control Panel
- Built directly into the Telegram Chat. No external dashboards needed.
- Monitor active stock, pending payments, user statistics, and total sales.
- Broadcast messages natively (Standard and Pinned).
- Control maintenance mode and dynamic USDT rates on the fly.
- Manage active forced-subscription channels.
5. Robust User Controls
- Automated Referral Tracking.
- Coupon Redemption System.
- Session Management Console for buyers to remotely terminate compromised logins.
Ensure you have the following installed:
- Python 3.10+
- MongoDB Database (Local or Atlas)
The bot relies heavily on environment variables for security. You must configure these before booting the bot.
Required Variables:
API_ID: Your Telegram API ID.API_HASH: Your Telegram API Hash.BOT_TOKEN: The bot token obtained from BotFather.MONGO_URI: Your MongoDB connection string.ADMINS: Comma-separated list of admin user IDs (e.g.,12345,67890).
Optional Variables:
ADMIN_GROUP_ID: Chat ID where logs and payment proofs will be sent.STATIC_2FA_PASSWORD: The static 2FA password applied to accounts.LOG_CHANNEL: Channel ID for public purchase logs.USDT_RATE: Default conversion rate (e.g.,90.0).PAYMENT_UPI_ID: Your UPI ID for deposits.BINANCE_ID/TRC20_ADDRESS: Your Crypto wallet details.DEFAULT_FSUB_ID/DEFAULT_FSUB_LINK: Initial Force-Subscribe channel data.
- Clone this repository.
- Install the required dependencies:
pip install -r requirements.txt- Set your environment variables (via terminal export or a
.envloader of your choice if you wrap the run command). - Boot the server:
python main.pymain.py: The core initialization and startup sequence.config.py: Environment variable mappers and static configurations.database.py: All MongoDB schemas and queries.utils.py: Text formatting, pagination logic, and UI generators.plugins/: Pluggable architecture containing all modular bot functions:start.py: Initial onboarding, FSub, and Terms.admin.py: The master control panel.buy.py: The browsing and checkout system.stock.py: Admin uploading handlers and live session parsers.deposit.py: Payment collection and manual proof submission.redeem.py: The coupon management system.manager.py: Live OTP fetching and remote device termination logic.
Developed by: Sync Org
License:
This software is provided exclusively for personal study and non-commercial educational purposes.
Reselling, sublicensing, or distributing this codebase for monetary gain is strictly prohibited.
Please read the attached LICENSE file for full terms.