Referral System

Referral System is a comprehensive referral program solution that enables your clients to refer others and earn rewards. This advanced module includes multi-platform tracking, customizable reward tiers, automated promo code generation, and detailed analytics to help you grow your customer base through referrals.

How It Works

Each client receives a unique referral code and referral link. When someone clicks the referral link, the system tracks the click, including the platform (WhatsApp, Telegram, Facebook, Instagram, etc.), IP address, and timestamp. If the referred person signs up and makes a purchase, the referrer earns invites/points based on the billing cycle of the purchase.

The system uses customizable reward tiers - for example, 5 invites might equal 1 month free service. When a client reaches a reward tier, they can claim their reward, and the system automatically generates a 100% discount promo code. The module includes advanced analytics showing clicks, signups, conversions, geographic data, and platform performance.

Key Features

• Unique Referral Codes: Each client gets a unique referral code and link
• One-Click Sharing: Clients can share referral links with one click
• Multi-Platform Tracking: Tracks clicks from WhatsApp, Telegram, Facebook, Instagram, and more
• Automatic Tracking: Auto-tracks clicks, signups, and conversions
• Customizable Reward Tiers: Set reward tiers (e.g., 5 invites = 1 month free)
• Automatic Promo Codes: Auto-generates 100% discount promo codes for rewards
• Email Notifications: Email alerts for link clicks and successful referrals
• Social Sharing Buttons: WhatsApp & Telegram sharing with pre-filled text
• Advanced Analytics: Dashboard with performance charts and insights
• Geographic Analytics: Track referrals by location
• Time-Based Analytics: See referral performance over time
• "How It Works" Popup: Educational popup for new users
• Admin Control Panel: Manage settings, claims, and view all activity
• Privacy Protection: Hides last names of top referrers in leaderboard
• Friendly URLs: Support for /ref/yourcode format
• Product Blocking: Block specific products from earning referral rewards
• Progress Tracking: Visual progress bars showing progress to next reward tier

How to Use

1. Install the module by uploading files to your WHMCS installation directory
2. Activate the module in Setup > Addon Modules > Referral System
3. Configure reward tiers in admin area:
   • Set invites required for each billing cycle (monthly, quarterly, annually, etc.)
   • Assign specific products to reward tiers (optional)
4. Configure general settings:
   • Set redeem type (generate ticket, auto-credit service, etc.)
   • Enable/disable "How It Works" popup
   • Configure email notification settings
   • Block specific products from earning rewards (optional)
5. Clients will automatically receive their referral code and can start sharing
6. Monitor referrals in the admin dashboard:
   • View all referral hits and clicks
   • See conversion rates and analytics
   • Manage reward claims
   • View top referrers leaderboard
7. When clients reach a reward tier, they can claim rewards which auto-generate promo codes
8. Review email tracking logs to see all sent notifications

This module provides a complete referral program solution with advanced tracking, analytics, and automation, helping you grow your customer base through word-of-mouth marketing.