XiriGo Admin DocsXiriPoints Loyalty Program
Manage the XiriPoints loyalty system including fund tracking, tiers, challenges, badges, and customer loyalty accounts.
XiriPoints Loyalty Program
The Loyalty module manages the XiriPoints loyalty program, which rewards customers for purchases and engagement on the XiriGo marketplace. The system uses a hybrid cost-sharing model where both the platform and vendors contribute to loyalty rewards, with FIFO-based point expiry.
Loyalty Dashboard
The loyalty landing page provides a high-level overview of the program's health:
| Metric | Description |
|---|---|
| Total Points Outstanding | Total XiriPoints currently held by all customers |
| Points Issued (MTD) | Points earned by customers this month |
| Points Redeemed (MTD) | Points spent by customers this month |
| Points Expired (MTD) | Points that expired due to FIFO expiry rules |
| Fund Balance | Current balance of the loyalty fund (platform + vendor contributions) |
| Active Members | Number of customers with a non-zero points balance |
| Redemption Rate | Percentage of issued points that are eventually redeemed |
Fund Tracking
The loyalty fund tracks financial contributions and liabilities:
Platform Contributions
Portion of loyalty costs funded by the platform. Configurable as a percentage of each point's value.
Vendor Contributions
Portion of loyalty costs funded by vendors whose products were purchased. Deducted from vendor payouts.
Redemption Liability
Total EUR value of outstanding unredeemed points, representing the platform's future obligation.
Tiers
Loyalty tiers reward customers for sustained engagement and spending. Customers progress through tiers as they accumulate qualifying points.
Tier Configuration
| Tier | Default Requirement | Earning Multiplier | Benefits |
|---|---|---|---|
| Bronze | 0 points (default tier) | 1x | Basic earning rate, birthday bonus |
| Silver | 5,000 lifetime points | 1.25x | Enhanced earning, early sale access |
| Gold | 20,000 lifetime points | 1.5x | Priority support, exclusive offers, free shipping threshold reduction |
| Platinum | 50,000 lifetime points | 2x | All Gold benefits + personal account manager, highest earning rate |
Managing Tiers
View all configured tiers with their requirements, multipliers, and member counts.
Click a tier to modify:
- Points threshold — Lifetime points needed to reach this tier
- Earning multiplier — Multiplier applied to base point earnings
- Maintenance requirement — Points needed per year to maintain the tier (optional)
- Benefits description — List of benefits displayed to customers
Changes take effect immediately. Customer tiers are recalculated automatically.
Tier downgrades (when a customer fails to meet maintenance requirements) can be configured to happen quarterly or annually. A grace period is applied before downgrade.
Challenges
Challenges are gamified tasks that reward customers with bonus points for specific actions.
Challenge Types
| Type | Description | Example |
|---|---|---|
| Order Count | Complete a target number of orders | "Place 5 orders this month" — 500 bonus points |
| Spending | Spend a target amount | "Spend EUR 200 this month" — 300 bonus points |
| Reviews | Submit product reviews | "Write 3 reviews" — 150 bonus points |
| Streaks | Maintain consecutive purchasing weeks/months | "Order every week for 4 weeks" — 1,000 bonus points |
| Referrals | Refer new customers who complete a purchase | "Refer a friend" — 750 points per successful referral |
| Categories | Purchase from target categories | "Shop from 3 different categories" — 200 bonus points |
Managing Challenges
Click Create Challenge. Select the challenge type, set the target value, bonus points reward, and validity period.
Define who can participate:
- All customers
- Specific loyalty tiers
- New customers only
- Customers who have not purchased in 30+ days
- Max completions per customer — How many times a customer can complete this challenge
- Total completions — Platform-wide limit (e.g., "first 100 customers to complete")
Activate the challenge. It appears in the customer's loyalty dashboard in the mobile app.
Badges
Badges are collectible achievements that recognize customer milestones and engagement.
Badge Triggers
| Trigger | Description | Example |
|---|---|---|
| First Order | Awarded when a customer places their first order | "Welcome Shopper" badge |
| Order Milestone | Awarded at specific order counts | "10 Orders", "50 Orders", "100 Orders" |
| Spending Milestone | Awarded at spending thresholds | "EUR 500 Club", "EUR 2,000 Club" |
| Tier Upgrade | Awarded when reaching a new loyalty tier | "Silver Member", "Gold Member" |
| Review Milestone | Awarded for submitting reviews | "First Review", "10 Reviews" |
| Referral | Awarded for successful referrals | "Brand Ambassador" |
| Challenge Completion | Awarded for completing specific challenges | "Challenge Champion" |
| Seasonal | Awarded during specific events or seasons | "Holiday Shopper 2026" |
Managing Badges
- Create badges with a name, description, icon/image, and trigger condition
- Set whether the badge awards bonus points when earned
- View badge distribution (how many customers have each badge)
- Retire badges (no longer earnable but existing holders keep them)
Seasonal and limited-time badges create urgency and encourage engagement. Rotate them regularly to keep the loyalty program fresh.
Customer Loyalty Accounts
View and manage individual customer loyalty accounts from the loyalty module:
Account Detail
| Section | Content |
|---|---|
| Balance | Current points balance, lifetime points earned, lifetime points redeemed |
| Tier | Current tier, progress to next tier (points needed), tier history |
| Transactions | Full points transaction history (earned, redeemed, expired, bonus, adjustment) |
| Batches | Points organized by FIFO batches with individual expiry dates |
| Challenges | Active and completed challenges with progress |
| Badges | All earned badges with award dates |
Admin Actions
| Action | Description |
|---|---|
| Award points | Manually add points to a customer's account (e.g., goodwill gesture, error correction) |
| Deduct points | Remove points from a customer's account (requires a documented reason) |
| Adjust tier | Manually override a customer's tier (temporary or permanent) |
| View batches | Inspect FIFO point batches and their expiry dates |
| Export history | Download the customer's full loyalty transaction history |
Manual point adjustments are recorded in the audit log with the admin's identity and stated reason. Use them sparingly and document the justification.