How It Works
When an affiliate refers someone to the platform (the new user registers through the affiliate’s invite link), that affiliate is recorded as the sponsor of the new user. If that new user then buys a membership plan, the sponsoring affiliate earns a referral commission — automatically, without any manual step.
This commission type is called Refer Registration Commission and is part of the MLM referral system. The amount is calculated based on the MLM level settings configured under Marketing → MLM.
When the Commission Fires and When It Doesn’t
The commission is triggered each time a referred user completes a membership purchase through the standard checkout flow. Whether it fires on renewals depends on how the renewal is processed:
| Purchase type | Commission fires? |
|---|---|
| First purchase through checkout | ✅ Yes — commission is created and credited to the referring affiliate. |
| Automatic renewal handled by the payment gateway (e.g. Stripe recurring charge, PayPal subscription webhook) | ❌ No — the gateway webhook processes the charge directly without going through the checkout flow, so no commission is created. |
| User manually re-purchases the same plan again through the checkout page | ✅ Yes — because the full checkout flow runs again, a new commission entry is created for the referring affiliate. |
How the Commission Amount Is Calculated
The commission amount is based on the MLM Referral Level settings configured by the Admin under Marketing → MLM. Three calculation types are supported:
| Type | How it works |
|---|---|
| Percentage of plan price | A percentage of the total membership purchase amount is awarded to each level. |
| Fixed amount | A fixed currency amount is awarded per level regardless of the plan price. |
| Custom percentage | A custom base amount is defined, and each MLM level receives a percentage of that base amount. |
If MLM is configured with multiple levels (e.g. Level 1, Level 2, Level 3), the commission flows up the referral chain — the direct sponsor (Level 1) gets the most, and higher levels each get their configured share.
How to Enable Commission on a Membership Plan
- Log in to the admin panel.
- In the top navigation, click Membership (under Marketing).
- Click Membership Plans.
- Open the plan you want to configure (or create a new one via Create Plan).
- In the Commission Settings section of the plan form, find the Commission Sale Status dropdown.
- Set it to Enable to activate affiliate commission for purchases of this plan. Set to Disable to prevent any commission from being awarded.
- Save the plan.
Where Affiliates See the Commission
When a membership purchase is approved and activated, the commission is added to the referring affiliate’s wallet automatically with the type Refer Registration Commission. The affiliate can see it in their wallet transaction history. They can request a payout once their wallet balance reaches the minimum withdrawal threshold set by the Admin.
Summary
| Scenario | Affiliate earns commission? |
|---|---|
| Referred user buys a membership plan for the first time (plan has Commission Sale Status = Enable) | ✅ Yes |
| Referred user’s subscription renews automatically via payment gateway webhook | ❌ No — gateway webhook does not run the checkout commission flow |
| Referred user manually re-purchases the same plan through checkout again | ✅ Yes — a new commission entry is created for the referring affiliate |
| Plan has Commission Sale Status = Disable | ❌ No |
| MLM referral system is disabled | ❌ No |
| User registered without using an affiliate invite link (no sponsor) | ❌ No |