2-tier MLM overrides
Recruit recruiters. Get the math right.
Cobalz supports 2-tier MLM overrides — a configurable percentage of every sub-affiliate's commission flows to the affiliate that recruited them. Off by default, gated by your plan, off-by-default, and bounded by the legal line.
How it works
Two commission rows per attributed order.
When MLM is enabled and the leaf affiliate has a parent_affiliate_id:
- The leaf affiliate gets their normal commission per the cascade rules.
- Their parent gets a second commission row at
mlm_parent_override_rate× the leaf amount, withparent_commission_idlinking back to the leaf row. - Refunds cascade: voiding the leaf voids the parent override; clawback on the leaf creates a clawback on the parent at the same proportion.
// Merchant settings
{
mlm_enabled: true,
mlm_parent_override_rate: 0.25 // 25%
}
// Order: $100 sale, leaf affiliate earns $10
// commissions
// ┌──────────────────────────────────────────┐
// │ id=c1 affiliate=alice rate=0.10 amt=10.00│
// ├──────────────────────────────────────────┤
// │ id=c2 affiliate=bob rate=0.25 amt=2.50 │
// │ ↑ basis=subtotal │
// │ ↑ parent_commission_id=c1 │
// │ ↑ notes="2-tier override from order …" │
// └──────────────────────────────────────────┘Why this is gated
The 2-tier ceiling is a feature, not a limitation.
Multi-level marketing schemes with 3+ levels are regulated in many US states and most of the EU. Hitting that line accidentally is a fast track to lawsuits. Cobalz ships exactly the depth real affiliate programs need (one referrer-rewards layer) and stops there.
- Yes Configurable rate (0–100%) so you can find the right reward without us picking a number for you
- Yes Off by default — opt in explicitly
- Yes Plan-gated to Growth+ so your "free" tier program isn't accidentally compliant-flagged
- Yes Real refund clawback on parent rows — no orphaned overrides after refunds
- Yes Audit-logged + outbound webhook event (commission.created with parent_commission_id)
FAQ
MLM questions.
Why only 2 tiers, not 5?+
Because deep MLM (3+ tiers) is regulated as multi-level marketing and approaches pyramid-scheme territory legally. 2-tier "recruit recruiters" is the standard affiliate-industry implementation that stays in safe legal water.
Is MLM enabled by default?+
No — off by default. Enable in Settings → MLM with a single toggle, then set the override rate (0-100%).
Does refund clawback work for parent commissions?+
Yes. When the leaf commission is voided/clawed-back, the parent override row is voided/clawed-back proportionally.
How is the parent-child relationship set up?+
Three ways: (1) the affiliate signup form has an optional "referred by" field; (2) the bulk import CSV has a parent_email column; (3) the merchant can manually set parent_affiliate_id on the affiliate detail page.
Recruit affiliates who recruit affiliates.
2-tier MLM overrides included on the Growth plan. 14-day free trial.