Skip to main content
Status: Planned Phase: Phase 2 | Tier: Free + Pro

​
Overview

Word-of-mouth is the dominant acquisition channel for cannabis apps. Dispensary visits are social — people go with friends, share recommendations, and trust personal endorsements over advertising. The Referral System channels this natural behavior into a structured program that rewards users for bringing friends to High IQ and gives those friends a warm, personalized onboarding experience. Every High IQ user gets a unique referral code. That code is embedded in share cards, accessible from their profile, and shareable as a QR code or deep link. When a new user signs up through a referral and confirms they are real (by uploading at least one dispensary order), both the referrer and the new user earn rewards. As referrers accumulate successful referrals, they unlock increasingly prestigious tiers — from profile frame upgrades to beta feature access to advisory board membership. The system is designed to be generous without being exploitable. Referral confirmation requires a real order upload (not just account creation), which eliminates fake signups. Rewards are primarily cosmetic and status-based rather than monetary, which keeps the program sustainable and avoids the perverse incentives that plague cash-reward referral programs. The goal is not to pay people to spam their contacts — it is to reward the organic behavior of sharing something genuinely useful with friends who will benefit from it.

​
How It Works

1

Get Your Code

Every user automatically receives a unique referral code upon account creation (e.g., HIGHIQ-J7K2). Pro users can request a vanity code (e.g., HIGHIQ-JOHN). The code is visible on the user’s profile and in the “Invite Friends” screen.
2

Share It

Users share their code through multiple channels: embedded in share cards (automatic), from the “Invite Friends” screen (copy link, QR code, or share sheet), or by telling friends the code verbally.
3

Friend Downloads

The new user downloads High IQ from the App Store. If they used a deep link (highiq.app/r/HIGHIQ-J7K2), attribution is automatic. If they downloaded directly, they enter the referral code during onboarding.
4

Friend Activates

The referral is not confirmed at signup. It is confirmed only when the new user uploads at least one dispensary order. This proves they are a real user with genuine intent, not a fake account created to game rewards.
5

Both Get Rewarded

Upon confirmation, the referrer earns IQ Points and progresses toward their next referral tier. The new user receives a “Recruited” badge, 50 IQ Points, and their referrer’s top strain recommendation as a personalized welcome gift.

​
Referral Tiers

Referral tiers are cumulative — reaching a higher tier includes all rewards from lower tiers. The progression is designed so that every tier feels meaningfully different and worth pursuing.

​
What the Referred Friend Gets

The referred user’s experience is not just “sign up and get nothing.” They receive a personalized welcome:
  • “Recruited” badge — Shows in their badge collection immediately, with their referrer’s name
  • 50 IQ Points — Starting balance to explore the IQ Store
  • Referrer’s top strain recommendation — “Your friend John’s favorite strain is Wedding Cake. Here’s the full report.” This creates an instant conversation between the two users and demonstrates report depth from the first session

​
Deep Linking

​
User Value

The referral system turns every High IQ user into a growth channel — not through spammy incentives, but by rewarding the natural behavior of sharing something useful with friends who smoke together.

​
Technical Approach

​
Data Model (Convex)

​
Anti-Abuse Protections

The referral system is designed to resist gaming from day one:

​
Key API Mutations

​
Tier Impact

​
Dependencies

  • Badge system with rarity levels — built and live
  • User profiles in Convex — built and live
  • Share Cards (Phase 1) — referral code embedding in share visuals
  • Deep linking infrastructure (Universal Links + App Store redirect)
  • Convex tables for referral tracking (referral_codes, referrals, referral_rewards)
  • QR code generation (react-native-qrcode-svg)
  • “Invite Friends” screen UI
  • Referral code entry field in onboarding flow
  • Web redirect page at highiq.app/r/{CODE}
  • IQ Points system (Phase 4) — for point rewards (badges work independently)
  • Admin panel for vanity code approval and abuse review

​
Open Questions

  1. Vanity code conflicts — What happens when two Pro users request the same vanity code? First-come-first-served, or auction with IQ Points?
  2. Referral expiration — Should pending referrals expire if the referred user never uploads an order? 30 days seems reasonable.
  3. Re-referral — If a user deletes their account and re-creates it, can they be referred again? Probably not (Apple ID tracking prevents this), but the policy should be explicit.
  4. Cross-tier rewards — When a user reaches a new tier, do they retroactively get all lower-tier rewards they have not claimed, or only the new tier’s rewards? Retroactive is simpler and more generous.
  5. Referral transparency — Should referrers see who they referred (by name), or only see a count? Showing names builds social connection but raises privacy questions.