Skip to main content

Partner Portal Guide

The Partner Portal is your command center for managing your Loyalteez loyalty program.

Getting Started

Create Your Account

  1. Visit partners.loyalteez.app
  2. Sign up with Google, GitHub, or email
  3. Complete your brand profile

Find Your Brand ID

Your Brand ID is essential for bot setup:

  1. Go to Settings → Account
  2. Copy the Brand ID (starts with 0x, 42 characters)

Key Sections

Dashboard

Your at-a-glance view of:

  • Total LTZ distributed
  • Active users
  • Recent activity
  • Quick stats

Events (Automation)

Configure what actions get rewarded:

Create Event:

  1. Click Create Event
  2. Set event name and type
  3. Configure reward amount
  4. Set cooldown and claim limits
  5. Choose detection method (Discord, Telegram, HTTP, etc.)
  6. Enable the event

Event Settings:

SettingDescription
Reward AmountLTZ given per event
CooldownHours between claims
Max Claims Per UserPer-user limit
Max Total ClaimsEvent-wide limit
Detection MethodHow events are triggered
EnabledActive or inactive

Integrations

Connect your platforms:

Discord:

  • Add bot to your server
  • View connected servers
  • Configure role rewards

Telegram:

  • View connected groups
  • Configure settings

Perks

Create rewards users can redeem:

Create Perk:

  1. Click Create Perk
  2. Set name, description, price
  3. Choose category
  4. Set supply limits
  5. Add fulfillment instructions

Perk Categories:

  • Access (channels, content)
  • Discount (codes, percentages)
  • Merch (physical goods)
  • Experience (events, calls)
  • Digital (NFTs, downloads)
  • Custom

Analytics

Track your program's performance:

  • LTZ distribution over time
  • Active users by period
  • Event breakdown
  • Top users
  • Perk redemptions

Settings

Account:

  • Brand ID (your wallet address)
  • Brand name and profile
  • Contact information

Security:

  • Security Key (for HMAC authentication)
  • Generate new keys
  • View key history

Domains:

  • Add authorized domains
  • For website integrations

Common Tasks

Add LTZ to Your Brand

  1. Go to Funds → Add Funds
  2. Choose payment method (Stripe or USDC)
  3. Complete purchase
  4. LTZ added to your brand wallet

Change Event Rewards

  1. Go to Events
  2. Find your event
  3. Click to edit
  4. Update reward amount
  5. Save

Create a New Perk

  1. Go to Perks → Create Perk
  2. Fill in details
  3. Set price and limits
  4. Add redemption instructions
  5. Save and enable

Generate Security Key

For developers using HMAC authentication:

  1. Go to Settings → Security
  2. Click Generate New Key
  3. Copy and store securely
  4. Use in your integration

Best Practices

Event Configuration

  • Start conservative — You can always increase rewards
  • Use cooldowns — Prevent gaming the system
  • Set limits — Control spending per event

Perk Strategy

  • Mix prices — Have options at all levels
  • Limited supply — Creates urgency
  • Clear descriptions — Users should know what they get

Security

  • Rotate keys — Generate new security keys periodically
  • Don't share — Keep security keys private
  • Monitor usage — Check analytics for anomalies

Support

Need help?