Kairo TeleShop — Sell Digital Products Inside Telegram (Python Bot + Admin Panel)
Sell presets, e-books, templates and software licenses where your audience already is: inside Telegram. Kairo TeleShop is a complete store bot written in Python. Customers browse, add to cart, apply a coupon and pay without leaving the chat, and what they bought arrives the moment the payment clears. You run everything from a web panel.
Not a bot template with a few commands: payments, delivery, support, broadcasts, the database and the owner panel are wired together and covered by tests.
Live demo (owner panel)
https://kairo-teleshop-demo.vercel.app — password: demo. The sample store resets on its own; the bot is not part of the online demo.
In the bot
- Catalog by category with pagination, product pages with photo, description and variants (Personal / Commercial at different prices)
- Deep links: t.me/yourbot?start=p_12 opens a product straight from a channel post or an ad
- Cart with quantities, coupons (percent or fixed, minimum cart, max uses, expiry), checkout
- Payments with Telegram Stars (no provider needed) or any Telegram Payments provider such as Stripe
- Automatic delivery: files sent by the bot (uploaded once, then reused instantly), license keys from your stock or generated from a pattern, or links
- "My orders" with re-download of everything bought
- /support: customers write, you reply from Telegram or from the panel
- Referral links with a commission you choose
- Owner commands: /stats, /orders, /broadcast with confirmation, plus a message for every sale
In the panel
- Dashboard: revenue over 30 days, paid orders, average order, customers, top products, what needs attention
- Products with variants, photo upload, file upload, key stock and a live preview of how the product looks in Telegram
- Orders with search and filters, delivery details, resend delivery, refunds (Stars are returned through Telegram in one click)
- Customers with order history, referral earnings and blocking
- Coupons, broadcasts with history, support inbox, store settings, CSV exports
- Light and dark mode, works on the phone
Done right
- Payment updates are idempotent: a repeated update never delivers twice or counts a coupon twice
- The order is validated again at pre-checkout (amount, owner, status), and old invoices stop working
- Money stored as integers, one function computes every total
- One Python process runs bot and panel; SQLite by default, Postgres by changing one line
Tech stack
Python 3.11, aiogram 3, FastAPI, Jinja2, SQLAlchemy 2 (async) with SQLite or Postgres, Uvicorn. No Node, no build step.
Developer experience
- Demo mode: runs without a bot token, so you can explore the panel first
- "Load sample data" fills the panel with a sample store: 12 products in 4 categories, 20 customers, 30 orders
- 55 automated tests that drive the real bot handlers with a fake Telegram API, plus panel tests
- README covering BotFather, Stars and providers, VPS deployment with systemd and nginx, Docker, backups and translation
- Every bot sentence in one file, ready to translate
What you get
Full source code (.zip) and an illustrated PDF guide (11 pages) covering setup, creating your bot in BotFather, Telegram Stars or a payment provider, product delivery, running the store and deployment. Also README, LICENSE.md, CHANGELOG.md, Dockerfile, docker-compose.yml and a systemd unit. Free updates: re-download the latest version from your Payhip library.
License
Personal: one end product. Commercial: unlimited end products, including stores you set up for clients. You can't resell or redistribute the source code itself.
Support
Questions or a bug? Reply to your purchase email with your order number.
FAQ
Do I need a payment provider?
No. With Telegram Stars the bot sells right away; users buy Stars inside Telegram and you withdraw through Telegram. For card payments in USD, EUR and others, connect a provider such as Stripe in BotFather and paste its token.
Where does it run?
On any machine with Python 3.11: a small VPS, a home server, or Docker. The bot uses long polling, so it needs no public URL; only the panel should sit behind HTTPS.
Can I sell large files?
Telegram lets bots send files up to 50 MB. For anything bigger, use the link delivery type with your own download page or cloud link.
Can the bot speak my language?
Yes. All bot texts are in one file; copy it, translate the values and set LOCALE in .env. Untranslated lines fall back to English.
Is there a hosted demo?
Yes, of the owner panel: https://kairo-teleshop-demo.vercel.app (password: demo). It runs the sample "Pixelwares" store in demo mode, without a bot, and the data resets on its own. The listing images show the real bot conversation. After download, the panel also runs locally in demo mode.
Refund & support
Made and supported by Jefferson Valandro (GitHub, portfolio). If the product doesn't work as described and I can't fix the problem for you, reply to your purchase email within 14 days for a full refund.