Telegram Shop Bot Kit: Stars + Crypto Checkout (Cloudflare Workers Source Code)

Run a complete shop inside Telegram: catalog, cart and checkout with Telegram Stars or crypto, instant digital delivery and order alerts to your phone. You own the code and host it free on Cloudflare Workers. No server, no monthly fees.

WHAT IT DOES

• Catalog with stock and sold-out labels, cart with + / – / clear

• Checkout with ⭐ Telegram Stars (native XTR invoices, pre-checkout amount and stock validation)

• Optional crypto checkout: the buyer sends USDT/USDC to your wallets and submits the TX hash; you approve or reject with one tap

• Automatic delivery after payment (download link, license key, instructions) plus a "New paid order" alert in your admin chat

• Admin commands from your phone: /add, /edit, /stock, /hide, /products, /orders_all, /ship, /refund (Stars refunds), /stats, /reply

• Buyer commands: /catalog, /cart, /orders, /support, /paysupport, /terms

WHAT YOU GET

• Full TypeScript source for Cloudflare Workers + D1 (free tier), using Telegram webhooks, so nothing has to stay online

• wrangler.toml, D1 migration, config file for shop name, texts, wallets and starter products

• Step-by-step README: BotFather token → wrangler secrets → D1 migration → one-click setWebhook (/setup page)

• Test suite (Vitest, real local D1 + mocked Telegram API, 11 tests), webhook secret check, duplicate-payment protection

• Commercial license: use it for your own shops and client projects (no resale of the kit)

REQUIREMENTS

Free Cloudflare account, Node.js 22+, basic terminal use (copy-paste commands). Setup takes about 15 minutes.

Want it installed and branded for you? Done-for-you setup: https://gosuoo.com/custom

Instant download (ZIP). Telegram Stars payouts and fees follow Telegram's rules. Crypto payments are confirmed manually by you.