SUP · Docs

Referral program

Share a link, earn a cut. Any connected wallet gets a referral code — no subscription required. When someone you referred pays, you earn commission.

Open /referral with your wallet connected. Sup creates your code automatically and gives you a share link of the form https://<sup-host>/?ref=YOURCODE. The dashboard shows how many people you've referred, what you've earned, what's been paid out, and what's still pending.

#How attribution works

  • When someone lands on the site through your ?ref= link, Sup remembers it for 30 days. First touch wins — an existing referral isn't overwritten.
  • The retired direct Wallet-payment flow no longer creates referral credit.
  • Self-referrals and unknown or missing codes are not credited. Referral support for hosted account checkout requires a separately reviewed attribution design.

#Commission

Historical direct-payment commissions remain visible. New hosted account checkout does not promise commission until its attribution and payout contract is implemented. Pending is what was earned minus what was already paid out.

#Milestones

ReferralsMilestonePerk
1First referralYou're officially an affiliate
3Getting startedBonus perks — coming soon
10Power referrerHigher reward tier — coming soon
25Super affiliateVIP perks — coming soon
50LegendCustom rewards — coming soon

#Developer note

The dashboard reads GET /api/referral/me?owner=0x… for the historical Wallet-scoped referral profile. It returns the code, counts, historical earnedUsd / paidOutUsd / pendingUsd, and milestones. It is not an account-billing grant path. See Plans for current checkout.