Partner Journey Flow

Complete journey from registered user to active MLM partner earning commissions through the 7 income types.

Overview

The partner journey encompasses:

1. Instant partner activation (automatic when accessing partner platform)
2. Referral link management
3. Promotion to Rank 1 ($1,100 personal purchase)
4. Earning through 7 income types
5. Rank progression (21 ranks, non-expiring)
6. Leadership pool qualification (Rank 5+)
7. Requesting and receiving payouts

Partner Activation Methods

Partners can be activated in two ways:

1. Via Partner Platform (Recommended) - User logs into partner.region.iwm.com → automatic instant activation
2. Via Profile - User clicks "Become Partner" in profile on invest or shop platform → redirects to partner platform → activation

Note: Partner activation is instant and free. No approval required.

---

Main Flow Diagram

---

Step Details

1. Partner Activation (Instant)

Activation Properties:

Property	Value
Cost	$0 (Free)
Approval	Instant (automatic)
KYC Required	No
Initial Rank	Consultant 0
Referral Link	Generated automatically
Personal Sales Commission	3%
Entrance Fee Commission	10.5%

Activation Trigger:

Partner status is automatically activated when:

• User accesses partner.region.iwm.com for the first time
• User clicks "Become Partner" in profile and is redirected to partner platform

Endpoint: POST /partners/activate

Request Body:

{
  "acceptTerms": true,
  "acceptPrivacyPolicy": true,
  "marketingConsent": false
}

Note: Terms acceptance is typically handled via a modal on first access to partner platform.

Partner Record Created:

{
  "id": "uuid",
  "userId": "user-uuid",
  "sponsorId": "sponsor-partner-uuid or null",
  "referralCode": "ABC123XY",
  "status": "ACTIVE",
  "currentRankId": "rank-0-uuid",
  "highestRankId": "rank-0-uuid",
  "directReferralsCount": 0,
  "totalNetworkSize": 0,
  "treeDepth": 0,
  "totalStructureTurnoverUsd": 0,
  "personalTurnoverUsd": 0,
  "isActivated": false,
  "joinedAt": "2024-01-15T10:30:00Z",
  "activatedAt": null
}

Closure Table Entries (Unlimited Depth):

-- Self-reference (always created)
INSERT INTO mlm.partner_tree_paths (ancestor_id, descendant_id, depth)
VALUES (new_partner_id, new_partner_id, 0);

-- Upline entries (if has sponsor) - ENTIRE chain
INSERT INTO mlm.partner_tree_paths (ancestor_id, descendant_id, depth)
SELECT ancestor_id, new_partner_id, depth + 1
FROM mlm.partner_tree_paths
WHERE descendant_id = sponsor_id;

---

2. Referral Link Generation

Endpoint: POST /partners/me/links

Request:

{
  "name": "Instagram Bio",
  "targetUrl": "/products/featured",
  "utmSource": "instagram",
  "utmMedium": "bio",
  "utmCampaign": "winter_2024"
}

Generated Link:

https://platform.com/products/featured?ref=ABC123XY&utm_source=instagram&utm_medium=bio&utm_campaign=winter_2024

Link Limits:

Rule	Constraint
Links per partner	Max 50 active links
Name	Max 100 characters
Custom code	4-20 alphanumeric, unique

---

3. Rank 0 Capabilities

At Rank 0, partners can:

Capability	Available
Referral link generation	Yes
Register unlimited clients	Yes
Personal Sales commission	3%
Entrance Fee commission	10.5%
Team Sales (differential)	No
Passive income	No
Leadership pools	No

---

4. Activation to Rank 1

Requirement: $1,100 personal purchase (Si14 shares OR investment product)

Activation Flow:

Rank 1 Unlocks:

• All 7 income types
• Team Sales (differential commissions)
• Passive income from client profits
• Network profits from downline
• Eligibility for higher ranks

---

5. The 7 Income Types

Dashboard Endpoint: GET /partners/me/dashboard

Response:

{
  "summary": {
    "totalClicks": 1250,
    "totalRegistrations": 85,
    "totalConversions": 42,
    "conversionRate": 3.36
  },
  "earnings": {
    "pendingBalanceUsd": 1500.0,
    "availableBalanceUsd": 4500.0,
    "totalEarnedUsd": 12000.0,
    "totalWithdrawnUsd": 6000.0,
    "currency": "USD",
    "byIncomeType": {
      "personalSales": 3000.0,
      "teamSales": 2500.0,
      "repeatSales": 1000.0,
      "portfolioReturns": 800.0,
      "clientProfits": 1200.0,
      "networkProfits": 900.0,
      "leadershipPool": 2600.0
    }
  },
  "rank": {
    "current": "Consultant 5",
    "currentRate": 14,
    "nextRank": "Consultant 5 PRO",
    "nextRankTurnover": 700000,
    "currentTurnover": 450000,
    "progressPercent": 64
  },
  "leadershipPool": {
    "eligible": true,
    "pool": "POOL_5",
    "qualificationVolume": 5000,
    "currentVolume": 6200,
    "qualified": true,
    "lastDistribution": {
      "amount": 200.0,
      "date": "2024-01-14"
    }
  }
}

Income Type Triggers:

Type	Name	Trigger	Rate
1	Personal Sales	Direct sale	3%-20% based on rank
2	Team Sales	Downline sale	Differential
3	Repeat Sales	Client repurchase	Same as Type 1
4	Portfolio Returns	Own investment profit	Strategy-based
5	Client Profits	Direct client earns profit	5%-20% based on rank
6	Network Profits	Downline client earns profit	Differential
7	Leadership Pool	Weekly/Monthly distribution	Equal share

---

6. Rank Progression (21 Ranks)

Rank Hierarchy:

Rank	Turnover (USD)	Personal Sales Rate	Passive Income Rate
0	0	3%	0%
1	1,100 (personal)	5%	5%
2	10,000	8%	8%
3	50,000	10%	10%
4	100,000	12%	12%
4_PRO	200,000	13%	13%
5	400,000	14%	14%
5_PRO	700,000	15%	15%
6	1,000,000	16%	16%
6_PRO	1,500,000	16.5%	16.5%
7+	...	Up to 20%	Up to 20%

Progression Rules:

• Automatic advancement upon meeting turnover threshold
• Non-expiring (ranks never decrease)
• No monthly maintenance required
• Commission rates apply immediately

Endpoint: GET /partners/me/rank-progress

Response:

{
  "currentRank": {
    "code": "5",
    "name": "Consultant 5",
    "personalSalesRate": 14,
    "passiveIncomeRate": 14,
    "leadershipPoolEligible": true
  },
  "nextRank": {
    "code": "5_PRO",
    "name": "Consultant 5 PRO",
    "turnoverRequired": 700000,
    "personalSalesRate": 15,
    "passiveIncomeRate": 15
  },
  "progress": {
    "currentTurnover": 450000,
    "requiredTurnover": 700000,
    "percentComplete": 64.3
  }
}

---

7. Leadership Pool Qualification (Rank 5+)

Pool Configuration:

Pool	Ranks	% of Turnover	Frequency	Qualification
POOL_5	5, 5_PRO	1%	Weekly	$5,000 / $10,000 weekly volume
POOL_6	6, 6_PRO	0.5%	Weekly	$20,000 / $30,000 weekly volume
POOL_7	7, 7_PRO	0.5%	Weekly	$45,000 / $60,000 weekly volume
POOL_8	8, 8_PRO	0.5%	Weekly	$90,000 / $120,000 weekly volume
POOL_9	9, 9_PRO	1%	Monthly	Rank achievement only
POOL_10	10, 10_PRO	1%	Monthly	Rank achievement only
POOL_11	11, 11_PRO	1%	Monthly	Rank achievement only

Note: Pools 9-11 do not require separate volume qualification. Partners who achieve these ranks automatically participate in monthly distribution.

50% Branch Rule (Pools 5-8 only): No single branch can contribute more than 50% of qualification volume.

Example:
- Required: $10,000
- Branch A: $80,000 → counts as $5,000 (50% cap)
- Branch B: $15,000 → counts as $5,000+
- Result: Qualified (diverse structure)

Endpoint: GET /partners/me/pool-status

Response:

{
  "eligible": true,
  "pool": {
    "code": "POOL_5",
    "name": "Pool 5",
    "percentageOfTurnover": 1.0,
    "frequency": "WEEKLY"
  },
  "qualification": {
    "required": 5000,
    "branchVolumes": {
      "branch-a-id": 8000,
      "branch-b-id": 3500
    },
    "cappedTotal": 7500,
    "qualified": true
  },
  "nextDistribution": "2024-01-21T23:00:00Z"
}

---

8. Payout Request

Endpoint: POST /partners/me/payouts

Request:

{
  "amountUsd": 500.0,
  "payoutMethodId": "method-uuid"
}

Validation Rules:

Rule	Value
Minimum payout	$100 USD
Available balance	Must be >= requested amount
KYC status	Must be APPROVED
Pending payouts	Max 1 pending request at a time
Partner status	Must be ACTIVE

Payout Status Flow:

PENDING -> APPROVED -> PROCESSING -> COMPLETED
    |          |            |
    v          v            v
CANCELLED  REJECTED     FAILED

---

9. Payout Processing

Processing Timeline:

Method	Review Time	Processing Time	Total
Bank Card	1-24 hours	Instant	1-24 hours
Bank Transfer	1-24 hours	1-3 business days	2-4 days
Crypto	1-24 hours	Instant	1-24 hours
E-wallet	1-24 hours	Instant	1-24 hours

Payout Methods:

Method	Required Fields
BANK_CARD	cardNumber, cardHolderName, expiryMonth, expiryYear
BANK_TRANSFER	bankName, accountNumber, swiftCode
CRYPTO	walletAddress, network (BTC, ETH, USDT-TRC20)
EWALLET	provider, accountId

---

Error Scenarios

Enrollment Errors

Scenario	HTTP Code	Error Code	Message
Already a partner	409	ALREADY_PARTNER	"You are already enrolled as a partner"
Terms not accepted	400	TERMS_REQUIRED	"You must accept the terms and conditions"

Payout Errors

Scenario	HTTP Code	Error Code	Message
Insufficient balance	422	INSUFFICIENT_BALANCE	"Available balance is less than requested amount"
Below minimum	400	BELOW_MINIMUM	"Minimum payout amount is $100 USD"
Pending payout exists	409	PAYOUT_ALREADY_PENDING	"You have a pending payout request"
No payout method	400	NO_PAYOUT_METHOD	"Add a payout method first"
KYC required	403	KYC_REQUIRED	"Complete KYC verification for payouts"

Link Generation Errors

Scenario	HTTP Code	Error Code	Message
Duplicate custom code	409	CODE_EXISTS	"This referral code is already taken"
Invalid target URL	400	INVALID_TARGET	"Target URL must be a valid platform path"
Link limit reached	400	LINK_LIMIT	"Maximum number of referral links reached"

---

Key Differences from Old System

Aspect	Old System	New System
Entry Cost	Varies	Free (Rank 0)
Activation	Immediate	$1,100 purchase for Rank 1
Commission Model	Unilevel (10 levels)	Differential (unlimited)
Income Types	3	7
Currency	RUB	USD
Rank Maintenance	Monthly	None (non-expiring)
Leadership Pools	None	7 pools (Rank 5+)

---

Related Documents

• User Onboarding
• Referral Attribution Flow
• Commission Lifecycle
• MLM Schema
• Commission Engine
• Commission Rules
• Rank Rules