Source code for a Telegram store builder bot, including various payment gateways.

Telegram Store Builder Bot Source – A Complete Telegram Commerce Solution

Telegram Store Builder Bot Source is a complete solution for building and managing a store inside Telegram.
It supports
physical products, digital products, downloadable files, software licenses, subscription services, time-based products, and products with multiple variants.

This is not just a simple Telegram bot source.
It combines
Telegram Bot, Telegram Mini App, Web Admin Panel, Product & Order Management, Customer Management, Payments, Wallets, Multilingual Support, Multi-Currency Pricing, Market-Based Pricing, Referral, Reward, and Affiliate features
inside a single integrated system.

The architecture is designed to support anything from a small Telegram shop to a more advanced multi-market and multi-currency commerce platform.

⭐ Main Features

• Professional Telegram Store Bot
• Telegram Mini App Store
• Complete Web Admin Panel
• Easy Web-Based Setup Wizard
• Physical Product Support
• Digital Product Support
• Sell Files, Software, Source Code, and Licenses
• Subscription and Time-Based Products
• Service Provisioning for Automated Activation
• Variable Products and Variants
• Customer and Order Management
• Inventory and Warehouse Management
• Multi-Warehouse Support
• Extensible Multilingual System
• Multi-Country and Market Management
• Multi-Currency Support
• Market-Specific Product Pricing
• FX Rate Management
• Tax Engine
• Smart Gateway Routing
• Multi-Currency Wallet
• Coupon and Discount Engine
• Referral System
• Reward Engine
• Affiliate System
• Digital Delivery
• Invoice System
• Support and Returns
• SMS Integrations
• Queue and Worker System
• Health Center
• Backup and Restore
• Update Manager
• Role and Permission Management
• Audit Log
• TOTP Two-Factor Authentication

🛍️ Sell Different Types of Products and Services

Telegram Store Builder Bot Source is not limited to one type of product.
Different commerce models can be managed from a single system.

📦 Physical Products

Manage physical products with pricing, stock, SKU, images, categories, variants, weight, and shipping information.

The inventory system also includes warehouse management, stock reservation, inventory transfers, adjustments, and low-stock monitoring.

💾 Digital Products

Sell files, software, source code, themes, plugins, educational content, licenses, and other digital products.

After the order is completed, the Digital Delivery system can manage the delivery process to the customer.

⏳ Subscription and Time-Based Services

Create plans based on
subscription duration, capacity, usage limits, device count, user count, or other required parameters.

Subscription lifecycle features such as renewals, Grace Periods, Early Renewal, and lifecycle management are also included.

⚙️ Service Provisioning

For businesses that need to automatically create, issue, or activate a service after purchase,
the source includes a Service Provisioning architecture.

This can be connected to compatible internal or external systems using APIs or Secure Bridges.

🔄 Product Variants

Products can have different options such as
subscription duration, volume, capacity, plan, color, number of users, or other attributes.

Each variant can have its own price, SKU, stock, and status.

📱 Telegram Mini App Store

In addition to the Telegram bot interface, the product includes a Telegram Mini App
that provides customers with a modern graphical shopping experience directly inside Telegram.

• Browse products
• Browse categories
• Open product pages
• Select product variants
• Add products to cart
• Manage the shopping cart
• Complete checkout
• View previous orders
• Access purchased digital products and services

The Telegram Bot and Mini App share the same products, customers, orders, Market, and Currency data.

🖥️ Professional Web Admin Panel

Store management does not have to be handled only through Telegram commands.
A dedicated web-based administration panel is included with the source.

• Dashboard
• Products & Variants
• Categories
• Orders
• Customers
• Inventory & Warehouses
• Payment Integrations
• Market & Currency Management
• Mini App Management
• Discounts
• Referral & Reward
• Affiliate Management
• Subscriptions
• Invoices
• Support
• Returns
• Health Center
• Logs & Audit
• Admins & Roles

🌍 Multilingual and Translation-Ready

The source is designed with a multilingual architecture.
Interface translations are separated from the core business logic.

The initial release includes:

• Persian
• English

Additional languages can be added through the language file structure.

Products, categories, and variants can also have localized content.

🌐 Multi-Country and Market Management

Language, Country, Market, and Currency are handled as independent concepts.

This allows different pricing, currencies, payment methods, and taxation rules to be configured for different markets.

For example, a customer may use a Persian interface while shopping in another market and paying using that market’s currency.

💱 Multi-Currency and Market Pricing

Different prices can be assigned to the same product or variant depending on Market and Currency.

This means that the same product does not need to have one global price.

The FX Rate Engine can also manage exchange rates, markup, and rate expiration.

🧮 Tax Engine

Tax rules can be configured based on:

• Market
• Country
• Currency
• Product Type

The system supports both tax-inclusive and tax-exclusive pricing models.

💳 Payment System and Smart Gateway Routing

The payment architecture is designed to support different payment providers.

Using Gateway Routing, administrators can control which payment gateway is available based on:

• Market
• Country
• Currency
• Product Type
• Minimum Amount
• Maximum Amount

💳 Supported Payment Provider Architecture

The integration system includes support structures for multiple payment providers.

Some Available Provider Integrations:

• Zarinpal
• Zibal
• IDPay
• NextPay
• Vandar
• AqayePardakht
• Pay.ir
• Sepal
• IranDargah

Secure Bridge

For providers that require a dedicated connection, the system includes a
Secure Bridge architecture.

This allows the store to connect to compatible international providers, payment processors, banking systems, or custom APIs.

A valid account and the required API credentials, Merchant ID, Terminal ID, or other provider-specific credentials are required to use any payment provider.

🛡️ Payment Callback Idempotency

Payment callbacks are protected with an idempotency mechanism.

If a provider sends the same callback multiple times, the system is designed to prevent duplicate processing of the same payment event.

💰 Multi-Currency Wallet

The wallet system includes separate ledgers for different currencies.

Credit and debit operations are recorded, and balances in different currencies are not silently merged or converted.

🎟️ Coupon and Discount Engine

Create discount rules and coupon campaigns for different sales scenarios.

Discount logic can be scoped to different products, categories, markets, currencies, usage limits, and validity periods.

👥 Referral and Reward Engine

The Referral system can be used to track invited users and reward successful referrals.

The Reward Engine can issue:

• Points
• Wallet Credits
• Coupons
• Campaign Rewards

Event-based idempotency is also used to help prevent duplicate rewards.

🤝 Affiliate System

Affiliate management is separate from the standard Referral system.

Referral is intended for user invitations and rewards, while Affiliate is designed for sales commissions and partner programs.

• Affiliate Accounts
• Referral Attribution
• Commissions
• Approval Delays
• Payout Requests
• Settlement
• Rejection
• Commission Reversal

📦 Inventory and Multi-Warehouse

The inventory system includes:

• Warehouses
• Stock Management
• Stock Reservations
• Inventory Movements
• Transfers
• Adjustments
• Low Stock Monitoring
• Multi-Warehouse Management

📦 Shipping

Shipping-related functionality can be configured for physical products.

Shipping methods, delivery zones, and checkout-related shipping information can be managed according to the store’s requirements.

🔄 Subscription Management

The subscription system supports:

• Creating subscriptions from orders
• Start and expiration dates
• Renewals
• Early Renewal
• Grace Period
• Lifecycle Notifications
• Expiration Processing

⚙️ Service Provisioning

For services that must be created or activated after purchase, the system includes Provisioning Jobs.

This can be used to connect the store to internal or external systems through compatible APIs or bridges.

Provisioning jobs are designed with status tracking and retry support so temporary provider errors do not automatically destroy the order workflow.

⬇️ Digital Delivery

Digital Assets and Deliveries are managed separately from the main product record.

The system can use limited download tokens to provide safer access to purchased digital content.

🧾 Invoice System

Invoices can be generated for orders.

Configurable seller information includes:

• Seller Name
• Address
• Phone Number
• Tax ID
• Invoice Prefix

💬 Support and Returns

A support system is included for managing customer tickets, messages, and media messages.

Return requests use their own workflow and statuses, while a Refund Ledger is available for recording refund lifecycle information.

📨 SMS Integration

The integration architecture can connect to multiple SMS providers.

• Kavenegar
• SMS.ir
• IPPanel
• FarazSMS
• Ghasedak
• MeliPayamak
• Custom HTTP Bridge

⚡ Queue, Cron, and Workers

Background operations such as Broadcast, SMS, and selected commerce tasks use queues and workers.

Example Cron configurations for shared hosting and example systemd services for VPS environments are included with the product.

🩺 Health Center

Health Center helps administrators inspect the status of major operational components.

It can be used to diagnose issues related to Telegram API connectivity, Webhooks, Queues, Workers, and other system components.

🔐 Admin Security

• Admin Accounts
• Role & Permission Management
• TOTP Two-Factor Authentication
• Login Rate Limiting
• Audit Log
• Webhook Secret
• Protected Integration Credentials

Different administrators can be assigned only the permissions they need.

👨‍💼 Roles and Permissions

Not every administrator needs access to every area of the system.

Permissions can be managed for products, orders, customers, integrations, finance, inventory, affiliate, support, health tools, and other administrative sections.

📋 Audit Log

Sensitive administrative actions can be recorded in the Audit Log so important changes remain traceable.

💾 Backup and Restore

The system includes backup and restore infrastructure for safer maintenance and recovery.

For production use, keeping an additional off-server backup is strongly recommended.

🔄 Update Manager

An Update Manager is included for future releases.

The update architecture can manage:

• Release Manifest
• Minimum PHP Version
• Compatibility Checks
• Checksums
• Pre-Update Backups
• Future Database Migrations
• Rollback

Version 1.0.0 is the first public release and installs the complete initial database baseline.

📥 Import and Export

Import and Export tools are available for bulk catalog management.

This can simplify product administration for stores with larger product catalogs.

🚀 Web-Based Setup Wizard

Initial installation is handled through a web-based Setup Wizard.

The installer collects and configures important information such as:

• Database Settings
• Telegram Bot Token
• Admin ID
• Store Name
• APP URL
• Channel Settings

📚 Complete Persian and English Documentation

The product includes two complete HTML manuals:

• GUIDE_FA.html — Complete Persian Documentation
• GUIDE_EN.html — Complete English Documentation

The manuals cover installation, product configuration, payment gateways, markets, currencies,
taxes, FX rates, Mini App configuration, Cron Jobs, Workers, security, backup, updates, and troubleshooting.

🖥️ Suitable for Different Hosting Environments

• cPanel
• DirectAdmin
• Linux VPS
• Servers using systemd

📋 Technical Requirements

• PHP 8.1 or newer
• MySQL / MariaDB
• Valid HTTPS
• Telegram Bot Token
• PDO MySQL
• cURL
• JSON
• OpenSSL
• mbstring
• fileinfo
• Cron Job or Worker Support
• Server Access to Telegram API

🎯 Who Is This Product For?

• Telegram Store Owners
• Digital Product Sellers
• Source Code and File Sellers
• Software and License Sellers
• Subscription Service Providers
• Time-Based Service Businesses
• Physical Product Stores
• Multilingual Businesses
• Multi-Currency and Multi-Market Stores
• Developers and Agencies Building Telegram Stores for Clients

📦 Version Information

Version: 1.0.0
Product Type: Telegram Store Builder Bot Source
Release: First Public Release

⚠️ Important Notes Before Purchase

• The buyer must create their own Telegram Bot using BotFather.
• The Bot Token is unique to each store and is not included with the source code.
• Payment gateway accounts and API credentials are not included.
• Each payment provider requires a valid account and its own required credentials.
• Some external providers may require a Secure Bridge or provider-specific configuration.
• Automated provisioning of external services requires a compatible API or Bridge from the service provider.
• SMS usage requires an account and API credentials from the selected SMS provider.
• The server must be able to communicate with Telegram and any external services used by the store.
• Taxation, payment, and commerce rules for each market must be configured by the store administrator according to applicable regulations.

✨ More Than a Simple Telegram Store Bot

Telegram Store Builder Bot Source is designed for projects where a basic Telegram bot is no longer enough.

By combining

Telegram Bot, Mini App, Web Admin Panel, Physical and Digital Products,
Subscription Services, Market Pricing, Multi-Currency, Tax, FX,
Gateway Routing, Wallet, Referral, Reward, Affiliate, Inventory,
Digital Delivery, Service Provisioning, Backup, and Update Manager
,
the system provides a unified foundation for managing commerce inside Telegram.

Instead of using separate systems for products, customers, orders, payments,
discounts, affiliate programs, and service management, a large part of the sales workflow can be managed from one integrated platform.