Perks & Redemption
Let users browse and purchase perks directly from Telegram.
How It Works
- Users earn LTZ through daily check-ins, GM/GN, etc.
- Users browse available perks with
/perks - Users purchase perks with
/claim <perk_id> - Redemption is tracked and fulfilled
User Commands
Browse Perks
/perks
Shows available perks with:
- Perk name and description
- Price in LTZ
- Availability (in stock vs. sold out)
- Perk ID for purchasing
Example Response:
🎁 Available Perks
1️⃣ VIP Access
💰 5,000 LTZ
📦 47/100 remaining
ID: vip_access
2️⃣ Free Shipping
💰 2,500 LTZ
📦 Unlimited
ID: free_shipping
Use /claim <perk_id> to purchase!
Purchase a Perk
/claim <perk_id>
Example:
/claim vip_access
Success Response:
✅ Perk Claimed!
You purchased: VIP Access
Cost: 5,000 LTZ
New Balance: 20,430 LTZ
Your claim has been recorded. Check your email for redemption instructions.
Perk Creation
Perks are created in Partner Portal:
Perks → Create Perk
Perk Fields
| Field | Description |
|---|---|
| Name | Display name |
| Description | What the perk provides |
| Price | Cost in LTZ |
| Category | Type (access, discount, merch, etc.) |
| Max Supply | Total available (0 = unlimited) |
| Max Per User | Claims per user (0 = unlimited) |
| Image URL | Optional image |
Categories
access- Access to channels, content, etc.discount- Discount codesmerch- Physical merchandiseexperience- Events, calls, sessionsdigital- Digital goods, NFTscustom- Custom perks
Shared Across Platforms
Perks are stored centrally and shared:
- Same perks appear on Discord and Telegram
- Same inventory tracking
- Same claim history
Users can browse perks on Telegram but redeem via:
- Telegram
- Discord
- perks.loyalteez.app web portal
Perk Redemption Flow
- User claims via
/claim <perk_id> - Balance checked - sufficient LTZ?
- Availability checked - in stock?
- LTZ deducted from user wallet
- Claim recorded in database
- Fulfillment triggered (email, webhook, etc.)
Best Practices
Pricing Strategy
| Perk Type | Suggested Price |
|---|---|
| Small bonus | 500-1,000 LTZ |
| Medium perk | 2,500-5,000 LTZ |
| Premium perk | 10,000-25,000 LTZ |
| Exclusive | 50,000+ LTZ |
Supply Management
- Limited supply creates urgency
- Unlimited works for discount codes
- Per-user limits prevent hoarding
Clear Descriptions
Users should understand exactly what they're getting:
- What the perk is
- How to redeem
- Any terms or conditions