Referrals

Refer users to the bot, get a percentage of every payment they make. Higher commission tiers unlock as your qualified-referral count grows.

Your referral link

Send /referral in the bot. The reply shows:

📊 Your Referral Dashboard

Your Link:
https://t.me/reign?start=ref_AB3KMP7Q

🏆 Current Tier: Bronze (5%)
📈 Progress: 2/5 to Silver (7%) ▓▓▓░░░░░░░

👥 Total Referrals: 4
✅ Qualified: 2
💰 Total Earned: $12.50
💵 Pending Balance: $12.50

[🏆 Leaderboard]  [🔄 Refresh]

Share the link via any channel. When someone clicks it and starts a chat with the bot, they’re flagged as your referral. The link is permanent — you can use the same one indefinitely.

When a referral becomes “qualified”

Just clicking your link doesn’t earn you anything. The referred user has to track at least one wallet for the referral to be marked qualified. Until then they’re pending in your dashboard.

There’s also a backstop: if a referred user pays for a tier upgrade before they’ve added a wallet, the bot auto-qualifies them at that moment so the commission still applies.

Commission tiers

Your commission rate scales with your number of qualified referrals:

Tier	Min qualified referrals	Commission rate
Bronze	0	5%
Silver	5	7%
Gold	10	10%
Platinum	25	15%

You start at Bronze. Hit the qualified-referral threshold and you’re auto-promoted on the next commission event — no manual upgrade.

The new rate applies to future payments from your referrals, not retroactively.

How earnings work

Every time a referred user pays for a tier upgrade, the bot calculates payment_amount × your_commission_rate and credits the result to your pending balance. You earn on every payment they make — initial subscription, renewals, upgrades — for as long as the referral relationship exists.

There’s no cap on per-referral earnings or total earnings. There’s also no expiry on the referral relationship — a user you referred two years ago who upgrades today still earns you commission today at your current tier rate.

Vanity codes

Standard referral codes are 8-character random strings. Some users have a custom vanity code that replaces the random string with their own (e.g. t.me/reign?start=ref_VITALIK). If you have one set up, it appears in your /referral output.

Vanity codes are not self-service today. Both versions of the link work the same way and earn the same commissions.

Leaderboard

/leaderboard

Shows the top 10 referrers by qualified-referral count:

🏆 Top Referrers

🥇 @username1 — 47 referrals · Platinum
🥈 @username2 — 32 referrals · Platinum
🥉 @username3 — 28 referrals · Platinum
4. @username4 — 22 referrals · Gold
5. @username5 — 18 referrals · Gold
…

Names are shown as Telegram usernames if set, otherwise first names, otherwise “Anonymous.” Position 1–3 get medals; 4–10 get numerals.

Withdrawals

Earnings accumulate in your pending balance until you withdraw. Withdrawals are made to a wallet address you set in advance:

Set a withdrawal address. Open the dashboard with /web → Referrals → enter a wallet address (Base-compatible EVM address — 0x... format)
Reach the minimum threshold. Default minimum withdrawal is $100. The dashboard shows your current pending balance and whether you’ve crossed the threshold.
Request the withdrawal. Click Request Withdrawal in the dashboard. The amount is deducted from your pending balance and queued as pending.
Wait for processing. Withdrawals are paid in USDT on Base. You’ll see status updates as the request moves to processing → completed (with a transaction link to BaseScan).

If a withdrawal is rejected for any reason, the amount is refunded back to your pending balance.

Dashboard view

The Referrals page on the dashboard is the canonical hub:

Tab	What you’ll see
Overview	Stat cards (total referrals, total earned, pending, commission rate), tier progress, withdrawal address, withdraw button
Referrals	Table of every user you’ve referred — username (partially masked), status (qualified / pending), join date, qualification date
Earnings	Per-commission history — which referral generated which earning, payment they made, commission rate at the time, status
Withdrawals	Past withdrawal requests with amount, chain, status, transaction link

Edge cases

Situation	What happens
You try to use your own referral link	Blocked — self-referral isn’t allowed
Referred user is already a registered Reign user	Their existing account stays intact — they’re not retroactively flagged as your referral
Referred user joins free tier and never pays	Stays `pending` until they track a wallet (then `qualified`); no commission until they make a payment
Your account gets paused for inactivity	Earnings continue to accumulate; you can withdraw after sending any command to reactivate
Your account gets banned	Withdrawals are blocked while banned; pending balance is preserved
Referred user gets a refund	Commission for that payment is reversed (rare event, manual support flow)

What’s next

Idle & Paused Accounts What pauses alerts, and how to resume them.

Tier Comparison The full tier matrix that referred users will be choosing from.