Overview
Tiers (also called membership levels) are a powerful way to gamify your loyalty program. As customers accumulate points, they progress through tiers, unlocking better benefits and earning multipliers.
Bronze
0 - 4,999 points
1x Points
- Earn 1 point per ₦100
- Birthday bonus
Silver
5,000 - 19,999 points
1.25x Points
- Earn 1.25 points per ₦100
- Birthday bonus + Free delivery
Gold
20,000+ points
1.5x Points
- Earn 1.5 points per ₦100
- VIP support
- Exclusive rewards
Creating Tiers
Define your tier structure with point thresholds and benefits.
Create Tiers
// Create Bronze tier (default)
await loyalpro.tiers.create({
program_id: program.id,
name: "Bronze",
min_points: 0,
max_points: 4999,
multiplier: 1.0,
benefits: ["birthday_bonus"],
is_default: true
});
// Create Silver tier
await loyalpro.tiers.create({
program_id: program.id,
name: "Silver",
min_points: 5000,
max_points: 19999,
multiplier: 1.25,
benefits: ["birthday_bonus", "free_delivery"]
});
// Create Gold tier
await loyalpro.tiers.create({
program_id: program.id,
name: "Gold",
min_points: 20000,
max_points: null, // No upper limit
multiplier: 1.5,
benefits: ["birthday_bonus", "free_delivery", "vip_support", "exclusive_rewards"]
});Automatic Tier Progression
LoyalPro automatically updates customer tiers based on their lifetime points.
How it works:
- When points are awarded, we check if the customer qualifies for a higher tier
- Tier upgrades trigger a customer.tier_changed webhook event
- You can send congratulations notifications when customers level up
- Optional: Set tier evaluation to use lifetime points, annual points, or current balance