Aiogram 3.4 · Python 3.10+ · Railway ready

Ship an e‑commerce
Telegram bot tonight.

A production template with catalog, cart, FSM checkout, admin alerts, and Google Sheets logging — clone, edit one JSON file, deploy. No framework to learn.

Launch price through Nov 30 · 7‑day no‑questions refund · Free updates for 12 months

Python 3.10+ aiogram 3.4 Railway · Render · VPS Google Sheets optional MIT-style dev license 7-day refund
The real cost of "free"

Free templates burn a week.
This one saves it.

WHAT YOU USUALLY GET (FREE)
  • ✗ Aiogram 2.x — breaks on Python 3.11+
  • ✗ 500-line monolithic bot.py
  • ✗ No admin notifications
  • ✗ No deploy config
  • ✗ No docs, no tests
  • ✗ Broken Google Sheets integration
WHAT YOU GET HERE ($9 launch)
  • ✓ Aiogram 3.4 — latest async API
  • ✓ Modular handlers, clean separation
  • ✓ Instant admin alerts on every order
  • ✓ Railway one-click deploy included
  • ✓ 12‑min setup video + full README
  • ✓ Google Sheets logger that actually works
Everything included

Not a toy. Not a demo.
A bot you'd ship to a paying client.

🛍

Catalog + inline buttons

One JSON file is your entire store. Edit, redeploy, done.

🛒

Cart with quantity picker

Per-user cart, +/− quantity on every product, clear in one tap.

✅

FSM checkout flow

Name → phone → address → confirm. State survives disconnects.

🔔

Admin notifications

Every order lands in your admin chat with full details.

📊

Google Sheets logger

Optional, service-account auth, one row per order, works out of box.

🚀

Railway one-click

Procfile, railway.json, env template — connect GitHub and go live.

What's in the zip

Exactly what you're getting.

No mystery. No "advanced version coming soon." Every file, listed.

Source tree
telegram-order-bot/
├── bot.py              # entrypoint, dispatcher wiring
├── config.py           # env loader, settings dataclass
├── products.json       # your entire catalog
├── handlers/
│   ├── start.py        # /start, menu
│   ├── catalog.py      # categories, product view
│   ├── cart.py         # add, remove, qty, clear
│   ├── checkout.py     # FSM: name→phone→addr
│   └── admin.py        # /orders, /stats
├── services/
│   ├── cart_store.py   # per-user cart state
│   ├── notifier.py     # admin chat alerts
│   └── sheets.py       # optional Google Sheets
├── .env.example
├── requirements.txt
├── Procfile
├── railway.json
├── README.md           # 12-min setup guide
└── LICENSE
By the numbers
Python files 11
Lines of code ~780
Setup time 15 min
Deploy time 3 min
Dependencies 4
Setup video 12:04
Honest fit check

Who this is for.
Who it isn't.

Buy this if you
  • ✓ Have a small shop / café / service and want orders in Telegram
  • ✓ Freelance and want a clean base to charge $150–$500 per custom bot
  • ✓ Can edit a JSON file and run pip install
  • ✓ Hate spending a weekend wiring up state machines from scratch
  • ✓ Want to learn aiogram 3 from a codebase that's actually modular
Skip it if you
  • ✗ Need native Stripe/Telegram payments in v1.0 (that's v1.1, Q1 2027)
  • ✗ Want a no-code builder — this is code you edit, not a UI
  • ✗ Need marketplace features (multi-vendor, commissions, escrow)
  • ✗ Expect a bot that writes product copy for you
  • ✗ Don't have a Telegram bot token and won't make one
See it running

From /start to paid order
in six taps.

Tap below to message a real bot running this exact code.

Open @quickorder_myshop_bot in Telegram →
B
@quickorder_myshop_bot
online now
Try it
/start
Welcome to Trump Order Shop 👋
Tap 🛍 Catalog to browse.
🛍 Catalog
Categories
☕ Coffee (3)
🥐 Pastry (2)
🥪 Sandwich (2)
✅ Confirm
✅ Order ORD-00042 placed.
Admin notified. ETA 1h.
Code you'd be proud to ship

Modular. Documented.
Actually readable.

// Edit this file. Redeploy. That's your whole store.
{
  "categories": [
    { "id": "coffee", "title": "☕ Coffee" },
    { "id": "pastry", "title": "🥐 Pastry" }
  ],
  "products": [
    {
      "id": "p_latte",
      "category": "coffee",
      "title": "Oat Latte",
      "price_cents": 450,
      "desc": "Double shot, oat milk, light foam."
    }
  ]
}
class Checkout(StatesGroup):
    name = State()
    phone = State()
    address = State()
    confirm = State()


@router.callback_query(F.data == "checkout")
async def start_checkout(cb: CallbackQuery, state: FSMContext) -> None:
    lines, total = cart_total(cb.from_user.id)
    if not lines:
        await cb.answer("Cart is empty", show_alert=True)
        return
    await state.set_state(Checkout.name)
    await cb.message.answer("What's your full name?")
async def notify_admin(bot: Bot, order: Order) -> None:
    text = (
        f"🔔 New order {order.ref}\n"
        f"👤 {order.name}  📞 {order.phone}\n"
        f"📍 {order.address}\n\n"
        + render_lines(order.lines)
        + f"\nTotal: ${order.total/100:.2f}"
    )
    for admin_id in settings.admin_ids:
        try:
            await bot.send_message(admin_id, text, parse_mode="HTML")
        except TelegramForbiddenError:
            log.warning("admin %s blocked the bot", admin_id)
The math

$9 vs the alternatives.

Build it yourself Hire a dev This template
Cost $0 $300–$1,500 $9
Time to live 1–2 weekends 1–3 weeks ~20 minutes
Catalog/cart/checkout You write it They write it Included
Deploy config DIY Depends Railway + Procfile
Reselling rights Your code Usually no Dev tier ($29)
Future updates You maintain it Billed hourly 12 months free
Launch price · through Nov 30

Pay once. Reuse forever.

Price goes to $29 / $79 on Dec 1. Grab it now to lock in the launch tier.

Personal
Save 69%
$9
$29
one-time
  • ✓ Full source code
  • ✓ Unlimited personal projects
  • ✓ 12 months of updates
  • ✓ Setup video + README
  • ✓ 7-day refund
Get it — $9
BEST VALUE
Developer
$29
$79
one-time
  • ✓ Everything in Personal
  • ✓ Resell rights for client work
  • ✓ Deliver bots on Fiverr/Upwork
  • ✓ Priority email support
  • ✓ Private Discord invite
Get it — $29

Developer tier pays for itself after one $150 Fiverr order.

⏱
7-day refund
No questions, Gumroad-handled. If it doesn't work, you get your money back.
🔄
12 months of updates
Every version through Nov 2027 — bugfixes, Stripe, i18n — free for buyers.
📬
Real support
Email reply within 24h on weekdays. Priority queue for Developer tier.
📣
Launch week — no fake reviews

This just launched. Instead of inventing testimonials, here's the deal: first 10 buyers get a direct line to me — reply to your Gumroad receipt with "launch 10" and I'll help you get it live personally, same day.

FAQ

Short answers.

Do I need hosting? +

Railway's free tier is enough for small bots. If you outgrow it, Render is $7/mo or use any VPS. Deploy configs are included.

Can I resell bots I build from this? +

With the Developer license, yes — build unlimited client bots on top of it. With Personal, use it for your own projects only.

Does it do payments? +

v1.0 handles order collection (name, phone, address) and admin alerts. Stripe + Telegram native payments ship in v1.1 (Q1 2027), free for buyers.

What Python experience do I need? +

Enough to edit a JSON file, run pip install, and read a README. If you've shipped one Python script, you'll ship this in 20 minutes.

How does the license work? +

Personal = unlimited bots for yourself or one business you own. Developer = everything above plus the right to deliver client bots built on top of it. Neither tier lets you resell the raw template as-is.

Refunds? +

7-day no-questions through Gumroad. If it doesn't work, you get your money back.

Which Python / aiogram version? +

Python 3.10+ (tested on 3.10, 3.11, 3.12). Aiogram 3.4.x. Dependencies pinned in requirements.txt.

Ship tonight.

One clone, one JSON, one deploy. The whole thing fits in an evening — and the next client's bot fits in an hour.

Get the template — $9 launch →

Price goes to $29 on Dec 1.

Deep dives

Technical write-ups on what's inside, why it's built this way, and the gotchas that cost me days. Read before you clone.

ARCHITECTURE
How I packaged 6 Fiverr gigs into one aiogram 3 template
The 70% that was always identical — FSM checkout, non-blocking admin alerts, modular routers.
DEPLOY
Deploying a Telegram bot to Railway in 2026 — the 3 traps nobody mentions
Python 3.13 pydantic-core breakage, long-polling conflict, ephemeral filesystem eating orders.
COMPARE
aiogram 3 vs python-telegram-bot in 2026 — honest take
Router registration, FSM, middleware, types, docs, and when I'd pick each in production.
Launch price
$29$9 — through Nov 30
Get it →