MoyShop

Telegram Mini App Store — jualan digital product dengan QRIS, auto-delivery, full admin dashboard.

Problem: Jualan digital product ribet — invoice manual, konfirmasi pembayaran lambat, delivery gak otomatis. MoyShop solves this: checkout → QRIS → auto-delivery dalam hitungan detik.

---

✨ Features

• 🛍️ Mini App Store — full shopping experience inside Telegram
• 💳 QRIS Payment — via KlikQRIS, auto-detect pembayaran
• 📦 Auto Delivery — konten digital langsung dikirim setelah bayar
• 📊 Admin Dashboard — tracking order real-time, statistik, broadcast
• 🔔 Webhook Notifications — admin + buyer notification instant
• 👥 User Tracking — data pembeli, riwayat order, broadcast massal

---

🚀 Quick Start

Prasyarat

• Python 3.11+
• Akun KlikQRIS (API key + merchant ID)
• Bot Telegram via @BotFather

Environment Variables

Variable	Required	Description
KLIKQRIS_API_KEY	✅	API key dari KlikQRIS
KLIKQRIS_MERCHANT_ID	✅	Merchant ID KlikQRIS
BOT_TOKEN	✅	Token bot Telegram
ADMIN_TELEGRAM_ID	✅	ID admin Telegram
VERCEL_URL	❌	URL deploy (auto-detect)

Local Development

pip install -r requirements.txt
python main.py
# → http://localhost:8080

Deploy Vercel

vercel deploy

---

🏗️ Architecture

Telegram Bot ←→ VPS (bot.py)
     ↕
Vercel (main.py)
  ├── FastAPI (REST + Webhook)
  ├── SQLite (/tmp — ephemeral)
  ├── KlikQRIS API (payment)
  └── Mini App (HTML/JS inline)

---

📖 API Endpoints

Endpoint	Method	Description
/api/products	GET	List produk
/api/orders/create	POST	Buat order + generate QRIS
/webhook/klikqris	POST	Callback pembayaran
/api/admin/orders	GET	Semua order + stats
/api/admin/users	GET	Tracking user
/api/admin/broadcast	POST	Broadcast ke semua user
/miniapp	GET	Mini App storefront
/admin	GET	Admin dashboard

---

🗺️ Roadmap

• Persistent DB (Turso / Neon)
• Multi-payment gateway
• Email delivery option
• Product analytics

---

📄 License

MIT © 2026