Welcome to Telegram Subscription Manager
A fully automated Telegram bot system that streamlines channel subscriptions with Paystack payment integration. Users pay, verify their payment, and instantly receive access to your private Telegram channel. Expired subscriptions are automatically removed.Quick Start
Get your bot running in under 10 minutes
Installation Guide
Complete setup with prerequisites and configuration
Deployment Guide
Deploy your bot to production with Vercel
API Reference
Explore webhook endpoints and integrations
Key Features
Multiple Subscription Plans
Offer flexible pricing options to your users:- Basic Plan: ₦5,000 for 7 days of VIP access
- Bi-Weekly Plan: ₦10,000 for 14 days of VIP access
- Monthly Plan: ₦15,000 for 30 days of VIP access
- Premium Plan: ₦22,000 for 14 days with Auto Copier Bot access
Plans are fully configurable in
src/lib/config.ts. Customize pricing, duration, and features to match your business needs.Automated Workflows
Payment Verification
Users pay via Paystack and submit their transaction reference. The bot automatically verifies payment authenticity and amount.
Instant Access
Once verified, the bot generates a one-time invite link and grants immediate channel access.
Auto-Removal
A scheduled cron job runs hourly to check for expired subscriptions and automatically removes users from the channel.
Premium Auto Copier Feature
For Premium subscribers, the bot includes an advanced MT5 trading copier:- Automatic Trade Copying: Trades from your master account are instantly replicated to users’ MT5 accounts
- 24/7 Operation: Works continuously even when users’ phones are offline
- Configurable Settings: Users can adjust lot sizes, max positions, and risk parameters
- MetaCopier Integration: Built on reliable MetaCopier infrastructure
Tech Stack
Built with modern, production-ready technologies:| Component | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Database | MongoDB with Prisma ORM |
| Payment Processing | Paystack API |
| Bot Communication | Telegram Bot API (HTTP) |
| Deployment | Vercel with Cron Jobs |
| Type Safety | TypeScript |
Security Features
Built with security as a priority:Reference Uniqueness
Prevents double redemption of payment references
Rate Limiting
Blocks users after 4 failed verification attempts for 1 hour
Webhook Verification
Validates Paystack webhook signatures
Protected Endpoints
Cron jobs secured with bearer token authentication
User Flow
Here’s how a typical user journey works:Bot Commands
Users interact with the bot using these commands:| Command | Description |
|---|---|
/start | Welcome message with plan details and payment instructions |
/pay | Collect email and generate payment links for all plans |
/verify_basic <ref> | Verify Basic plan payment (₦5,000, 7 days) |
/verify_biweekly <ref> | Verify Bi-Weekly plan payment (₦10,000, 14 days) |
/verify_monthly <ref> | Verify Monthly plan payment (₦15,000, 30 days) |
/verify_premium <ref> | Verify Premium plan payment (₦22,000, 14 days + copier) |
/verify_promo <ref> | Verify promo code payment (₦3,000, 7 days) |
/status | Check current subscription status and expiry date |
/mt5setup | Setup MT5 account for Auto Copier (Premium only) |
/settings | Configure copier settings (Premium only) |
/mystats | View copier status and statistics (Premium only) |
/help | Display help message with instructions |
Admin-only commands include
/broadcast, /broadcast_active, /broadcast_premium, /broadcast_promo, /botstats, and /checkuser.Why Use This Bot?
Save Time with Automation
Save Time with Automation
Eliminate manual verification and channel management. The bot handles everything from payment verification to access control automatically.
Reduce Payment Fraud
Reduce Payment Fraud
With Paystack integration and reference uniqueness checks, you can be confident that every subscription is legitimate and paid for.
Scale Your Business
Scale Your Business
Handle hundreds of subscribers without additional workload. The system scales automatically with your growth.
Monetize Your Expertise
Monetize Your Expertise
Turn your Telegram channel into a recurring revenue stream with flexible subscription plans.
Premium Features for Power Users
Premium Features for Power Users
Next Steps
Quick Start
Deploy your bot in minutes
Installation
Complete setup instructions
Configuration
Customize plans and settings