SUP · Docs

Referral program

Share Sup Wallet. Every active Sup account can create a referral link. Referral rewards are not enabled yet.

Sign in and open /referral. Sup creates an account-owned code and a link of the form https://<sup-host>/?ref=YOURCODE. It follows the same SSO account across devices and does not depend on a connected wallet.

#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.
  • After the referred person has an active account, SSO records the first valid attribution against canonical account IDs. Self-referrals and unknown codes are refused, and an existing attribution cannot be overwritten.
  • Legacy wallet-keyed referral records are not guessed into SSO accounts.

#Commission

No commission, payout, or milestone is promised by the current product. If a commission programme is introduced, Billing will read the SSO-owned attribution through a reviewed service contract instead of rebuilding identity from wallets or email.

#Developer note

The browser reads same-origin GET /api/referral/me. The BFF derives the current account from the SSO-owned session and calls GET /account/referral; there is no owner query parameter. First-touch capture posts to /api/referral/claim, which forwards only the signed-in account's token and the public code. It is not an account-billing grant path.