Affiliate commissions wrong

Who earns what: system flags, ?aff= / ?wm=, hold period, fraud rules, and pending vs approved vs paid.

Affiliate commissions wrong

Use this when affiliates say earnings are missing, stuck, or too low/high.

Who gets paid (money path)

Event Who earns Condition
Download/sale with uploader commission File owner (if approved affiliate) Affiliate system on; owner approved. ?aff= is tracking — it does not steal the uploader share
Direct Premium referral Referrer from ?aff= cookie aff.direct_premium_enabled + percent; affiliate approved
Webmaster Verified + approved site owner aff.webmaster_enabled; site approved; ?wm= or referer rules
Registration referral Referrer Separate toggle/percent when enabled

Master switch: aff.system_enabled (Affiliate system).

1. Program and user gates

1. Affiliate system on.

2. User has Approved affiliation (and Approved webmaster for webmaster payouts).

3. Sale appears on Payment transactions list with attribution you can open.

2. Attribution path

  • ?aff= / last-click cookie (xfa_aff) — cookie duration and preserve-on-revisit settings matter.
  • ?wm= / referer — site must be Verified + Approved. Webmaster sites and verification.
  • Promo links: Affiliate promo links (?aff=).

3. State machine (often “missing” is just Pending)

State Meaning
Pending Inside hold period (aff.pending_delay_days). Auto-approve worker runs periodically
Approved Counted toward withdrawable balance (unless locked in a payout)
Paid Already withdrawn
Reversed Refund / clawback
In payout Locked by an open withdrawal

Ledger: Affiliate commissions ledger. Cash out: Payout → requests. Transfer to site balance is not the same as a cash payout.

4. Fraud / percent surprises

  • Self-purchase / same-IP blocks (aff.fraud_block_self_purchase, aff.fraud_block_same_ip).
  • Daily commission cap (aff.fraud_max_commission_cents_per_day).
  • Per-plan JSON overrides vs global percents.
  • Site Rev % 0 usually means “use global default” — not “pay nothing” (confirm in Affiliation settings UI).

5. Member-facing confusion

  • Below minimum payout → withdraw blocked.
  • Dashboard locked without approval.
  • Pending ≠ unpaid forever — wait out Commission hold period (days).

Related