Referral commission

Users share their referral link; when someone orders through it, they earn a cut.

How it is calculated

Commission = what the buyer paid − what the same order would cost at the referrer's own member tier.

For example:

• Referrer A is LV3 with a 20% discount
• Visitor B orders through A's link and pays 100
• The same order would cost A 80
• A therefore earns 100 − 80 = 20

So the higher the referrer's tier, the more they earn from referrals. This is another reason member tiers double as the reseller programme: changing someone's tier changes their referral earnings too.

The three-level commission ratios described in older documentation (level 1 = 0.2, level 2 = 0.4, level 3 = 0.3) no longer exist. The database may still contain promote_rebate_v1/v2/v3 rows, but no code in the current version reads them, and changing them has no effect whatsoever.

The referral link

Users find their link under User centre → Promotion centre:

https://your-domain/?from=USER_ID

A visitor who opens it has the referral recorded in their browser and carried into any order they place.

How the relationship is bound

Situation	Who is credited
Visitor clicks a referral link and orders without registering	The person in the link
Visitor clicks a referral link and then registers	The link owner is stored permanently on their account, and counts for every future order regardless of where they order from
A user registers on a sub-store	The sub-store owner
A logged-in user orders	Whoever is bound to their account — the browser record is ignored

In other words, once a user registers the relationship is fixed and cannot be stolen by another link later.

When no commission is paid

The system skips commission when the referrer is:

• the owner of the product (there is no margin to split on your own goods)
• the buyer themselves (so nobody can farm their own link)
• the owner of the current sub-store (that revenue comes through sub-store commission instead, so it is not double-counted)

Relationship to sub-store commission

When one order involves both a sub-store owner and a referrer, the system calculates the sub-store/supplier share first, then carves the referrer's share out of it. Nothing is paid twice, and the total never exceeds the margin available on that order.

On a sub-store, commission is worked out at that sub-store's own prices: the buyer pays the sub-store price (markup included), the referrer's tier price gets the same markup, and the difference is the commission. Opened on a sub-store, the Promotion centre also shows that sub-store's products, prices and projected earnings, matching what is actually paid out.

Where to see earnings

User centre → Promotion centre shows:

• The referral link and how many people have signed up through it
• Referred order count, total commission, and commission this month
• Recent referred orders
• A projected earnings table per product, calculated at the user's current tier

Paid commission appears in the ledger with the description "referral commission".

Turning promotion off

If you do not want referrals at all, turn off the Promotion switch under Admin panel → Site settings → Other. Once it is off:

• The user centre no longer shows the Promotion centre
• Referral links stop recording who sent the visitor, and new sign-ups are no longer bound to a referrer through a link
• New orders earn no referral commission

Existing referral relationships and commission already paid are not affected. Sub-store user ownership and sub-store commission do not depend on this switch either.

Some themes may still show a link to the Promotion centre. Opening it only shows a notice that promotion is turned off, then returns to the user centre.