Skip to content

Customer Referral Settings

Overview

Customer Referral Settings control the customer-side referral programme — the one that lets your existing customers invite friends and earn rewards. This is separate from the Partner Program (B2B affiliate scheme); these settings only configure the consumer-facing flow.

Accessing Customer Referral Settings

Navigate to: Modules → System Settings → Customer Referral.

Customer Referral Settings page

Settings

Enable Customer Referral

  • Type: Toggle switch (On/Off)
  • Default: Off
  • Purpose: Master switch that turns on the referral programme. When off, the share-with-friends widget and reward logic are completely hidden — even if individual customers still hold valid referral codes from before.

Reward Per Successful Referral

  • Type: Number input (currency, base currency)
  • Purpose: Amount credited to the referrer's wallet when their referee completes the qualifying action.
  • Best practice: Pick a number that won't be eroded by your average margin. Pair this with a minimum-order threshold below.

Qualifying Action

  • Type: Single-select dropdown
  • Options:
  • First Order Placed — credits the referrer the moment the referee submits their first order.
  • First Order Delivered — waits for the order to reach Delivered status before crediting (recommended; protects against cancellations and refunds).
  • Purpose: Defines when the reward is paid out.

Minimum Referee Order Amount

  • Type: Number input (currency)
  • Default: 0 (no minimum)
  • Purpose: The referee's qualifying order must be at least this value for the reward to fire. Use this to prevent self-referral abuse with $1 orders.

Show Share Buttons

  • Type: Toggle switch (On/Off)
  • Purpose: When on, the customer's account page exposes social-share buttons (WhatsApp, Telegram, native share sheet) that prefill the referral URL. When off, customers can still copy the referral code manually but the visual share UI is hidden.

How It Works

  1. Each customer has a unique referral code generated automatically when their account is created.
  2. The customer shares the link https://yourstore.com/register?ref=CODE.
  3. A new visitor opens the link and registers — the system attaches the referrer to the new account.
  4. When the new customer's qualifying action fires (per the setting above), the configured reward is credited to the referrer's wallet in your store's base currency.
  5. The referrer can spend the wallet balance like any other store credit.

Best Practices

  • Set a minimum order amount to discourage self-referrals with throwaway accounts.
  • Prefer First Order Delivered as the qualifying action — it filters out cancellations.
  • Combine with Registration Settings → require email or mobile verification, so each referred account is harder to fake.
  • Watch the Customer Referrals dashboard periodically for unusual patterns (one IP, many invites).