Loyalteez Documentation
Open-loop loyalty infrastructure for any platform.
What is Loyalteez?
Loyalteez is a loyalty network that brands plug into. You define what actions earn credits, and your customers earn those credits by participating — across Discord, Telegram, your website, your app, or anywhere you integrate. Credits are spendable on perks offered by any brand in the network.
Zero blockchain complexity — users don't need wallets or crypto knowledge. We handle everything.
Choose Your Path
I'm a Community Admin
You want to add loyalty rewards to your community or storefront.
Discord: Setup Guide → (5 minutes)
Telegram: Setup Guide → (5 minutes)
After setup, explore:
- Discord Admin Guides — Configure commands and events
- Telegram Admin Guides — Configure commands and events
I'm a Developer
You want to build a custom integration, add loyalty to your app, or understand the API.
The Loyalteez API accepts HTTP POST from any platform. Discord and Telegram bots are pre-built integrations, but you can send events from anywhere — web apps, mobile apps, games, e-commerce platforms, IoT devices.
- Platform Developers Guide — Build your own integration
- API Reference — Event handler, gas relayer, pregeneration
- MCP Server — AI-powered integration tools
Available Integrations
| Platform | Status | Best For |
|---|---|---|
| Discord | Production | Community servers, gaming, creator programs |
| Telegram | Production | Global communities, crypto groups, support channels |
| Custom HTTP | Production | Web apps, mobile apps, games, e-commerce, anything |
| Shopify | Available | E-commerce purchase & referral rewards |
| WordPress | Available | Content site engagement rewards |
All integrations share the same backend — credits earned on Discord can be spent on perks from a Shopify store, and vice versa.
Key Features
- Open-loop rewards — Credits work across every brand in the network
- Zero blockchain complexity — Users don't need wallets or crypto knowledge
- Gasless transactions — We cover all blockchain fees
- Configurable events — Reward any action you define
- Streaks & multipliers — Encourage consistent engagement
- Perks & redemption — Let users spend credits on real perks
- Analytics & KPIs — Track your program's performance
- Achievements — Gamified milestones beyond credits
- Cross-platform balances — One balance across all touchpoints
Platform Feature Matrix
Core features work across all platforms. Some features are platform-specific:
| Feature | Discord | Telegram | Custom HTTP |
|---|---|---|---|
| Daily check-ins | ✅ | ✅ | ✅ |
| Streak system | ✅ | ✅ | ✅ |
| Leaderboards | ✅ | ✅ | ✅ |
| Perks & redemption | ✅ | ✅ | ✅ |
| Achievements | ✅ | ✅ | ✅ |
| Admin configuration | ✅ | ✅ | Via API |
| Natural participation | ✅ | ✅ | Custom events |
| Role-based bonuses | ✅ | — | — |
| Voice tracking | ✅ | — | — |
| Purchase rewards | — | — | ✅ |
| Custom events | — | — | ✅ |
Architecture
Your Platform (Discord, Telegram, Web App, Shopify, Game, etc.)
↓
Loyalteez Integration (bot, SDK, or HTTP POST)
↓
Event Handler API (validates & processes)
↓
Shared Services (streaks, leaderboards, achievements, perks)
↓
Reward Distribution (wallet creation, LTZ transfer)
All powered by Cloudflare Workers for global, low-latency performance.
Getting Started Checklist
For Community Admins
- Create account at partners.loyalteez.app
- Generate Security Key in Partner Portal (Settings → Security)
- Add the bot to your Discord server or Telegram group
- Run
/setupcommand with your Brand ID and Security Key - Configure events and rewards
- Create perks for users to redeem
For Developers
- Review Platform Developers Guide
- Generate Security Key in Partner Portal
- Implement HMAC signature authentication
- Test with Event Handler API
- Deploy your integration
Support
- Documentation: You're here
- Partner Portal: partners.loyalteez.app
- Discord Community: discord.gg/loyalteez
- Email: [email protected]
Next Steps
Community Admins:
Developers: