Referral Program

The referral module lets customers share a personal code with friends. When a referred friend places their first order, the referrer earns a reward (store credit, discount, or custom reward).

How it works

Customer generates their referral code

Logged-in customers go to their Account → Referral page. A unique code is auto-generated for them (e.g. AMARA-8X2K). They can share this link or code.

Friend applies the code

The referred friend enters the code at checkout in the "Referral code" field, or clicks the referral link which pre-fills the code.

Friend places their first order

The referral is recorded when the referred customer completes their first paid order. Trial or abandoned carts don't count.

Referrer receives their reward

After the order is placed and paid, the referral is marked as "Rewarded". The referrer receives a notification (email or SMS on Mwanzo).

Referral stats (for customers)

Customers can see their referral stats from Account → Referral:

Their unique code and shareable link
Number of referrals sent
Number of successful conversions (friends who ordered)
Total rewards earned

🖼️

Screenshot: Customer referral page showing code, stats, and reward history

Admin: Referral analytics

As an admin, go to Referrals (or access via the custom admin page) to view:

Total referrals placed vs. converted
Top referrers by volume and conversion rate
Weekly/monthly referral trend
Average order value of referred customers

The analytics are available at GET /admin/referrals/analytics?period=30d.

Reward configuration

Referral rewards are configured at the backend level. Current default reward: store credit added to the referrer's account upon the referred order being placed.

To change the reward type, amount, or conditions, contact your platform administrator — this requires a configuration change.

💡Tip

The best-performing referral programs offer a double-sided reward: something for the referrer AND something for the new customer (e.g. referrer gets KSh 200 credit, new customer gets KSh 100 off their first order).

Preventing abuse

The system prevents:

Self-referrals (using your own code)
Multiple rewards per referred customer
Rewarding referrals where the order was later refunded

Promotions & Discounts

Discount codes for referred customers

Analytics

View referral performance in the dashboard