Referral Settings

Single-level referral programme. For chain commissions add Multilevel Settings.

Want the feature overview?

See Referral Program for the customer flow, code generation, cookie attribution, and dashboard layout.

Where

Wallet → Settings → Referral.

Referral section — enable, referrer reward type/amount, referee coupon, cookie window

The same Settings tab also contains the Invite Friends sub-section:

Invite Friends section — enable, daily limit, max per submit, subject/body templates

Step-by-step Setup

1. Enable

Master toggle. Zero overhead when OFF — no auth hooks fire.

2. Referrer reward type

Type	Result
`fixed`	Flat amount (e.g. `₹100`)
`percent`	Percent of invitee's first-order subtotal

fixed is simplest. percent rewards the referrer proportionally to how big the friend's first purchase is.

3. Referrer reward amount

Currency value (for fixed) or percent (for percent).

Strategy	Amount
Light	`50`
Normal	`100`
Aggressive	`250` or `10` percent

4. Referrer max cap

Optional. When type = percent, cap the maximum reward per referral.

5. Referee coupon type

Type	Customer experience
`fixed_cart`	Flat discount on the cart
`percent`	Percent off

6. Referee coupon amount

The discount value. Auto-generated WC coupon WELCOME-XXXXXX carries this.

Strategy	Amount
Soft	`50` (flat) or `5` percent
Standard	`100` (flat) or `10` percent
Aggressive	`250` (flat) or `20` percent

Attribution window. When a friend visits via the referral link, a 7-day (default) cookie is set. Friends who register within the window get attributed to the referrer.

Window	Use
`1`	Strict — only same-day signups credit
`7` (default)	Standard
`30`	Generous — long-cycle products

Toggle for the time-boxed multiplier.

When ON, three more fields:

Promo start
Promo end
Promo multiplier

Date-time fields. Window during which the multiplier applies.

The boost. Default 2 (= 2× rewards during the window). Multiplier applies to:

Referrer base reward
Multilevel chain rewards (if multilevel enabled)

11. Dashboard description

Rich text shown above the customer's referral panel. Brand it:

Earn ₹100 every time a friend places their first order. They get ₹50 off too.

12. How-it-works steps (3)

Three rich-text steps shown in the gradient card. Default:

1. Share your link
2. Friend signs up + places first order
3. You get ₹100, they get ₹50 off

Edit per your campaign.

13. Save

Click Save changes.

Verify

As customer A: visit /my-account/my_wallet/ → confirm referral panel + personal link
Copy link
Open private window → visit ?ref=A_CODE
Cookie set
Register as customer B
Place first order, complete it
Reload customer A's referral view → invites list shows B as signed_up with reward

Common Combos

Goal	Settings
Standard	Referrer ₹100 fixed, Referee ₹50 fixed_cart, Cookie 7d
Acquisition push	Referrer ₹250, Referee 20% percent, Cookie 14d
Launch promo	Above + Promo enable, multiplier 2, end date 30 days from now

Multilevel Add-On

Want chain commissions (sponsor of sponsor of friend)? See Multilevel Settings.

Invite-Friends Form

Want customers to invite via email instead of just sharing a link? See Invite Friends. Same engine, additional UI.

Troubleshooting

Problem	Fix
Code doesn't resolve	Regenerate via Users → [user] → Wallet card
Reward not credited	Order in `completed`? Friend visited via link? Already paid?
Cookie not set	Browser blocking 3rd-party cookies — share via direct link only
Coupon not in friend's email	Email mismatch; confirm friend's account email matches the cookie
Promo multiplier not active	Inside start/end window? Server timezone?