LoyaltyCard — Telegram Mini App Loyalty Card with Stamps and Rewards (Source Code)
Seller: gevDev
Price: 19.90 USD
Available. The final price depends on the selected options and is checked before payment.
Product description
Paper punch cards get lost, and clients forget how many stamps they have left. LoyaltyCard turns the loyalty card into a part of Telegram: the client opens a Mini App from the bot and sees a gold client card with the stamp balance, progress toward the next reward, the rewards list and the visit history. Staff installs nothing — they add a stamp with one bot command by the client's short card code.
Built for any business with repeat visits: barbershops, beauty and nail studios, coffee shops, bakeries, car washes, kids clubs.
HOW IT WORKS
- The client opens the app from the bot (/start) and gets a personal card with a 6-character code.
- At the till the client shows the code; the staff sends /stamp CODE (or /stamp CODE 2 for two stamps). The balance updates instantly.
- Rewards are managed in the bot: /addreward Free haircut | 6 — title and cost in stamps (1–100).
- With enough stamps, the client taps "Get" next to a reward in the Mini App; the request goes to the admins' chat.
- The staff confirms with /give CODE (stamps are deducted, the reward lands in history) or declines with /deny CODE (nothing is deducted). One pending request per client, so nothing is redeemed twice.
WHAT YOU GET
- Loyalty Mini App: gold client card with stamp balance, progress dots and bar, copyable code, pending request block, next-reward tracker, rewards list, visit history, shop contacts
- Client bot commands: /start, /help, /card — personal card with code, balance and next reward
- Admin bot commands: /stamp, /give, /deny, /requests, /rewards, /addreward, /delreward, /profile, /lang ru|en, /stats, /settings, /admin
- Reward flow with explicit confirmation: stamps are deducted only on /give
- Full history: every stamp, every redeemed reward, every declined request
- Codes without lookalike characters (0/O, 1/I, 5/S, 8/B excluded) — easy to read aloud at the till
- Notifications in each user's language; the admin language is switched with /lang
- RU/EN interface, follows the Telegram theme, works on any phone width
- HMAC validation of initData, rate limits, 32 KB body limit, security headers
- JSON storage — no MySQL, Redis, or Docker; a single Node.js process serves the app, API and bot
- Demo mode to evaluate the UI locally without a bot token
- 25 automated tests (node:test)
- README with setup, API table and command reference
WHO IT IS FOR
- Barbershops, beauty and nail studios, coffee shops, bakeries, car washes, kids clubs
- Teams that want a working loyalty program today, without a per-client SaaS fee
- Developers who need a clean Mini App + grammY bot starter with a real reward-confirmation flow
REQUIREMENTS
- A Telegram bot from @BotFather (2 minutes)
- Node.js 20+ and any HTTPS host (Render Starter or a $3–5 VPS — the free Render tier sleeps, and a sleeping app shows errors to clients)
NOT INCLUDED
- Hosting, domain and bot token
- Your shop name, rewards and prices (set with bot commands or in data/db.json)
- Online payments, SMS or push notifications outside Telegram
- Multiple shops per installation
- Legal/tax setup for your business
FORMAT: ZIP with full source and docs. Updates and support for 6 months.
REFUNDS: digital product, no refunds after delivery. Ask questions before buying — I answer the same day.
Additional information
What you need:
- A Telegram bot from @BotFather (2 minutes)
- Node.js 20+ and any HTTPS host (Render Starter or a $3–5 VPS — the free Render tier sleeps, and a sleeping app shows errors to clients)
Not included:
- Hosting, domain and bot token
- Your shop name, rewards and prices — set with bot commands or in data/db.json
- Online payments, SMS or push notifications outside Telegram
- Multiple shops per installation
- Legal and tax setup