Multilevel Settings

Optional add-on to the referral programme. Pays out commissions up the chain of sponsors when a new customer places their first completed order.

Want the feature overview?

See Multilevel Referral for the ancestry walk + promo multiplier interaction.

Where

Wallet → Settings → Multilevel.

Multilevel Referral section — enable, levels (1-10), per-level commission percentages

Pre-req

Referral Program must be enabled first. Multilevel layers on top.

Step-by-step Setup

1. Enable

Master toggle. When OFF, only direct (single-level) rewards fire — multilevel walk skipped entirely.

2. Levels

How many levels deep to walk. Range 1-10.

Use caseLevels
Light tier system2 (direct + sponsor)
Standard MLM3-5
Deep network7-10

3. Per-level commissions

Percent at each level. Index 0 = level 1.

Example: [10, 5, 2] for 3 levels:

  • Level 1 (direct): 10 (informational — direct gets full base from single-level engine)
  • Level 2: 5% of base
  • Level 3: 2% of base

Level-1 in array is informational

The direct referrer is paid the full base reward by the single-level referral engine, not the level-1 percentage. Set the level-1 value to whatever you want shown on a "How rewards work" page or leave as a marker.

4. Save

Click Save changes.

How It Works (visual)

Invitee D invited by C. C invited by B. B invited by A.

A  (Level 3 sponsor)
  ↑
B  (Level 2 sponsor)
  ↑
C  (Level 1 sponsor — direct referrer)
  ↑
D  (the new customer placing first completed order)

When D's first order completes (assuming base referrer reward = 100, levels = 3, commissions = [10, 5, 2]):

LevelSponsorReward
1C (direct)100 (full base — paid by single-level engine)
2B100 × 5% = 5
3A100 × 2% = 2

Promo Multiplier Interaction

When a time-boxed promo is active, the multiplier wraps the base before multilevel resolves it.

So during a 2× promo with base 100:

LevelSponsorReward
1C200
2B200 × 5% = 10
3A200 × 2% = 4

Promo applies to every level.

Common Setups

Light 2-tier

FieldValue
Levels2
Commissions[10, 5]

Standard 3-tier

FieldValue
Levels3
Commissions[10, 5, 2]

Aggressive 5-tier

FieldValue
Levels5
Commissions[20, 10, 5, 3, 1]

Verify

  1. Build a 4-user chain A → B → C → D via referral cookie / signup
  2. Place D's first completed order
  3. Confirm in Wallet → Transactions:
    • C credited base reward (single-level engine)
    • B credited base × 5%
    • A credited base × 2%
  4. Re-trigger the order status — confirm no duplicate credits

Customer-Facing Display

The customer-side dashboard doesn't show a chain visualization (intentional — keeps it simple). The "Earned" total includes chain credits silently.

For an admin chain view, filter Wallet → Transactions by type = referral + reference contains level.

Compliance Note

Some jurisdictions regulate multi-level marketing schemes. Review local law before launching. Keep clear audit trail (the wallet ledger does this automatically).

Troubleshooting

ProblemFix
Multilevel not creditingEnabled? Friend's first order in completed? Ancestry chain populated when friend signed up?
Level-N percent not appliedIs N within "Levels" config? Has a value in the per-level array?
Promo multiplier missedOrder's completed timestamp inside start/end?
Ancestry emptySponsor was deleted before friend signed up