Referrals Management

Manage and monitor the user referral program.

Route

/admin/referrals

Overview

The Referrals page provides a centralized dashboard for monitoring referral program performance, reviewing individual referrals, and managing referral statuses.

How the Referral Program Works

1. Existing users share their unique referral code or link
2. New users enter the referral code during registration
3. When the new user makes a qualifying purchase, the referrer earns a wallet credit reward
4. Rewards are automatically added to the referrer's wallet balance

Dashboard Statistics

• Total Referrals - All-time referral count
• Qualified Referrals - Referrals that met the purchase threshold
• Pending Referrals - Referrals awaiting qualification
• Conversion Rate - Percentage of referrals that qualified
• Total Rewards Paid - Sum of all wallet credits awarded

Referrals Table

Each referral displays:

• Referrer - User who shared their code
• Referee - New user who registered
• Status - Current referral status
• Registration Date - When referee registered
• Registration IP - IP address at registration (for fraud detection)
• Qualifying Amount - Referee's total purchases toward qualification
• Actions - View details, update status

Referral Status

Referrals progress through these statuses:

• Pending - Referee registered, awaiting qualifying purchase
• Qualified - Referee met purchase threshold, reward issued
• Rejected - Referral rejected (e.g., fraud, duplicate account)

Filtering & Search

Filter Options

• Status - Filter by Pending, Qualified, or Rejected
• Flagged for Fraud - Show only referrals flagged as potentially fraudulent
• Date Range - Filter by registration date

Search

Search referrals by:

• Referrer name or email
• Referee name or email

Referral Details

Click a referral to view full details:

Referrer Information

• Name and email
• Total referrals made
• Successful referrals count
• Referral code

Referee Information

• Name and email
• Registration date
• Registration IP address
• Total purchases made
• Qualification progress

Status History

• Status changes with timestamps
• Admin notes on status updates

Actions

Update Referral Status

1. Click on a referral
2. Click "Update Status"
3. Select new status (Qualified/Rejected)
4. Add notes explaining the change
5. Save changes

Fraud Detection

The referrals table highlights potential fraud indicators:

• Same IP registrations - Multiple referrals from same IP
• Rapid registrations - Many referrals in short time period
• Suspicious patterns - Unusual activity flagged by system

To flag a referral for fraud:

1. Click on the referral
2. Toggle "Flag for Fraud"
3. Add investigation notes
4. Save changes

Flagged referrals can be filtered and reviewed separately.

User Experience

For Referrers

Users access their referral dashboard at /account/referrals where they can:

• View their unique referral code
• Copy shareable referral link
• Track referral statistics
• See list of their referrals and status

For New Users

During registration, new users can:

• Enter a referral code in the optional field
• See the referrer's name when code is validated
• Receive confirmation their referral was recorded

Configuration

Referral program settings are managed in Site Settings:

• Enable/disable the referral program
• Set qualifying purchase amount
• Set reward amount
• Set maximum referrals per user
• Configure fraud warning message

Best Practices

• Review pending referrals regularly
• Investigate flagged referrals promptly
• Keep fraud warning message up to date
• Monitor conversion rate for program health
• Export data periodically for analysis
• Adjust qualifying/reward amounts based on performance

Tips

• Use the IP address information to identify potential self-referrals
• Set appropriate max referrals to prevent abuse
• Clear fraud warning message deters bad actors
• Regular monitoring helps maintain program integrity
• Consider promotional periods with enhanced rewards