Shahid Malla

WHMCS Affiliate System: Build a Referral Program That Works

WHMCS ships an affiliate system most operators ignore. Set up right, it brings customers your marketing can't reach at predictable CAC. The setup, the recruitment, the fraud prevention.

S Shahid Malla
· Jan 16, 2026 · 5 min read · 82 views
shahidmalla.com/blog/whmcs-affiliate-system-build-a-referral-program-that-works
WHMCS Affiliate System: Build a Referral Program That Works
On this page (11 sections)

WHMCS ships an affiliate system that's good enough to start with — and most hosting brands either ignore it or overconfigure it. Done right, an affiliate program brings in customers your marketing can't reach, at a CAC you can predict. Done wrong, it's a settings page nobody uses.

This is the practical setup for an affiliate program that actually generates referrals.

Step 1 — Enable the basics

WHMCS Admin → Setup → Affiliates → Affiliate System Settings:

  • Enable Affiliate System: yes.
  • Bonus Deposit: $5-10. Gives new affiliates initial balance so the dashboard isn't empty.
  • Affiliate Pay Type: Percentage. Easier to manage at scale than flat amounts.
  • Pay Out Period: One-time only (commission on first invoice) vs. Recurring (commission on every renewal). Recurring is better for retention; one-time is better for cash flow.
  • Default Affiliate Commission %: 10-20% is industry standard. Higher to attract serious affiliates.
  • Affiliate Cookie Length: 90 days. Customers research hosting for weeks before buying.
  • Affiliate Payout Method: Withdrawal request (manual approval), PayPal, or bank transfer.
  • Minimum Payout Amount: $50-100. Filters out spam affiliates.

Step 2 — Per-product commission overrides

The default % applies to everything. For specific products, override:

Setup → Products/Services → Products → edit → Other tab → Affiliate Commission:

  • Higher commissions on margin-heavy products (annual hosting plans, VPS).
  • Lower or zero on thin-margin items (domains, SSL).

This protects you from affiliates funneling traffic only to your unprofitable products.

Step 3 — Affiliate dashboard customization

The default WHMCS affiliate dashboard works but is sparse. Affiliates want:

  • Real-time stats (clicks, signups, commissions earned).
  • Their unique referral link prominently displayed with copy button.
  • Marketing assets — banners, swipe copy, comparison tables.
  • Performance dashboard showing top-converting links.

Customize /templates/{your-theme}/affiliates.tpl and add a "Marketing Assets" section pointing to a folder of pre-built banners they can use.

Step 4 — Recruiting affiliates

Three channels that work:

  1. Existing customers. Best converting affiliates. Email blast with "earn $X per referral" — they already trust you.
  2. Hosting review sites + bloggers. Reach out individually. Most accept higher commissions in exchange for content.
  3. YouTube creators in your niche. Tutorials about hosting / WordPress / VPS audiences are gold.

What I'd skip: generic affiliate networks (CJ, ShareASale). The fees + low-quality traffic don't pay back for small hosting brands.

Step 5 — Affiliate fraud prevention

Affiliates will try to self-refer for free hosting. Block:

  • Self-referrals — WHMCS detects same email/IP/payment method between affiliate and referred client. Set Setup → Affiliates → Block Self-Signups.
  • Suspiciously fast signups (account created → upgrade → cancel just before payout). Set a hold period — commissions only become payable after 30 days of customer activity.
  • High refund rates from a single affiliate. Disable the affiliate after refund rate >20%.

Step 6 — Track referrals from your marketing site

If your marketing site is separate from WHMCS, you need cross-domain referral cookie support. Solution:

  1. Affiliate link format: https://yourwhmcs.com/?aff=AFFILIATE_ID.
  2. When that link is hit, WHMCS sets a cookie scoped to your billing domain.
  3. From the marketing site, link to WHMCS keeping the ?aff= param. WHMCS sees it, links the visit to the affiliate.

For traffic landing on the marketing site first (not WHMCS directly), use a JS bridge — capture the affiliate code in localStorage, append to every WHMCS-bound link.

Step 7 — Payout workflow

Affiliates request payout when balance > minimum. Workflow:

  1. Affiliate clicks "Withdraw" in their dashboard.
  2. WHMCS creates a withdrawal request, sets affiliate balance to 0 (locked).
  3. You receive notification.
  4. You pay out (PayPal, bank transfer, Wise, whatever).
  5. Mark the withdrawal as Paid in WHMCS.

Automate the payout if possible (Wise has an API; PayPal Mass Pay works). Manual payouts work for small affiliate programs.

How to verify the system works

  1. Sign up as an affiliate (from your customer-facing area).
  2. Get your affiliate link.
  3. Visit your hosting order form using the affiliate link.
  4. Place an order as a new test customer.
  5. Confirm the affiliate's stats show: 1 click, 1 signup, commission accrued.
  6. Test the cookie length — clear and revisit after 91 days simulated; commission should not credit.

Common pitfalls

"Affiliate signs up, refers themselves, gets commission." Self-detect off. Enable, and add IP / payment-method matching.

"Affiliate program is empty after 6 months." Nobody recruited. Affiliate programs don't market themselves; you do.

"Commissions paid out before customers actually keep service." Set a hold period — commission becomes payable 30 days after the customer's first paid invoice.

"Affiliates can see other customers' info." Check permissions — the affiliate dashboard should expose only the affiliate's own referral data, not customer-level details.

My take — affiliate program math

Most hosting brands either:

  • Don't run an affiliate program (leaving distribution on the table).
  • Run one at 5-10% and wonder why nobody pushes their links.

The right model: 25-30% recurring commission for serious partners (the ones with audiences). Yes, you give up a chunk of margin. You gain a customer that costs you 0 in ad spend, who likely sticks around longer (referred customers churn less). Math usually wins.

Going further


I configure WHMCS affiliate programs for hosting brands — setup, recruiting strategy, fraud prevention, payout automation. Tell me your goals and I'll send a quote in 24 hours.

Share this article

S

Written by

Shahid Malla

WHMCS expert, full-stack developer, technical lead at Fada.cloud. 10+ years building hosting platforms, custom modules, and automation that ships.

Trusted platforms

Prefer to hire through a platform?

Not sure about working directly? Hire me through Fiverr or Upwork instead - same me, same work, with the platform's buyer protection and escrow.

Got a project like this?

Tell me what you need - I'll send a real quote within 24 hours.