Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Rahat-Pagecode/gitbook-competitions/llms.txt

Use this file to discover all available pages before exploring further.

The Refer a Friend system is a built-in referral programme that integrates directly with the platform’s Wallet system. It lets you incentivise word-of-mouth growth by rewarding both the person sharing their referral link (the affiliate) and, optionally, the new customer they bring in. The backend configuration is intentionally straightforward, giving you control over reward types, order thresholds, and how each rule triggers.
Only newly registered accounts can be attached as a referral. Existing customers cannot be linked to an affiliate retrospectively.

​
Setting Up Referral Rules

Each rule you create lets you define:
  • Reward type — choose between a percentage of the order value or a fixed monetary amount
  • Order range — set minimum and maximum order totals that qualify for the reward
  • Affiliate reward — the credit earned by the person who shared the referral link
  • Customer reward — an optional reward given to the newly referred customer
  • Referral type — choose from New User, One Time, or Recurring (see below)

​
Referral Types

Triggers once for a newly registered customer who signed up via an affiliate link and is placing their very first order. The customer must not have spent anything previously. This rule executes only once per new customer and does not provide recurring rewards.
A continuous referral that fires every time a referred customer places an order — regardless of whether they use the referral link again. This type works with both existing and new referrals and is typically used with a percentage reward.You can optionally set a start date so the rule only applies to referrals registered from that date onward, allowing you to exclude older existing referrals if needed.Recurring rewards are not paid on orders settled with Wallet credit.
Can apply to newly registered customers who arrive via the affiliate link, or to existing referrals who must use the referral link at time of purchase. This reward can only be claimed once per rule. If you want to offer the same promotion again later, simply create a rule with a new name.

​
Avoiding Rule Conflicts

Only one rule executes per order. If two rules share overlapping Min/Max order totals, only the first matching rule will fire — the second will be skipped entirely.For example, if a New User rule and a One Time rule have identical order total ranges, only the first rule in the list will be rewarded. Place New User rules above One Time rules to ensure they take priority.If two New User rules overlap on order totals, only the first will ever reward — the second will never execute.
Rules are bypassed on orders paid entirely with Wallet credit. Ensure customers are aware that referral rewards are not earned on wallet-funded purchases.

​
Customising Rewards per Affiliate

You can override the default commission for a specific affiliate directly from the Edit User screen on your Users page. Only a percentage-based commission can be set on a per-user basis — fixed amount overrides are not supported at the individual level, helping prevent accidental over-rewarding of high-value affiliates.

​
Customer-Facing Referral Dashboard

Customers can view their own referral activity through their account area. The Referral Dashboard gives affiliates visibility of their programme performance directly from the frontend.

Build docs developers (and LLMs) love

Get started for freeTalk to us