Claudexia Referral Program: Earn 5% on Every Friend's Top-Up

We launched a referral program: a personal link, 5% of every top-up your invitees make credited automatically to your balance. No coupons, no expiry.

The Claudexia referral program is live. It is the single most requested feature from our long-term users over the last few months — especially from teams who have already brought their colleagues and friends to Claudexia by hand. Now sharing Claude API access through Claudexia pays you back, too.

How it works

In Dashboard → Referrals you will find:

a personal short link in the form claudexia.tech/?ref=K7M2XQ,
a QR code for sharing offline or in chat apps,
a KPI block: total earned, earned in the last 30 days, signups via your link, and how many of those are active.

When a new user clicks your link we transparently store your referral code in a 400-day cookie and immediately strip ?ref=... from the address bar, so the link is safe to publish on Twitter, in a blog post, or to attach to a GitHub project README.

After signup the user is permanently attributed to you. On every subsequent top-up of their balance you receive 5% of the top-up amount — automatically, in USD, straight onto your Claudexia balance. No coupons, no support tickets, no "wait until end of month".

What it means in dollars

A few realistic scenarios:

A solo developer friend tops up $50/month → you earn $2.50/month passively.
A 3-person team tops up $300/month combined → $15/month.
Someone runs a one-off business top-up of $1000 for an Opus 4.7 project → $50 in one go.

The minimum top-up that triggers a bonus is $5. That keeps tiny test transactions from cluttering your bonus history.

Under the hood

We built referrals to be a real billing primitive, not a marketing afterthought:

Cookie + localStorage attribution — survives tab closes, device switches inside the same browser session, and OAuth-provider hops during signup.
Idempotent crediting — even if a payment webhook fires twice, exactly one bonus row is written. We rely on a UNIQUE INDEX on source_payment_id plus a deterministic ref:auto:<payment_id> key.
Anti-abuse heuristics — a velocity cap of 5 first-time top-ups per 24h per referrer, a same_ip flag for suspicious signups. Suspicious bonuses go into admin moderation instead of being credited silently.
Transparent history — the dashboard shows every credit with timestamp, base top-up amount, rate, and status (pending, credited, failed, reversed).
Bonuses survive outages — if Wellflow is temporarily unreachable at credit time, the row stays in failed and is recoverable via an admin Approve once the service comes back. Money is never lost.

How to grab your link

Sign in to dashboard.
Open Referrals in the side menu.
Copy the link or download the QR code.
Share it where it fits: a personal blog, a team chat, your GitHub profile, Twitter.

We can lift your referral rate individually for ambassadors and creators with strong audiences — drop us a note at support if your channel reliably brings more than ten active users per month.

What's next

This is the first iteration. On the roadmap:

multi-tier rates (a higher percentage at higher monthly volume),
a leaderboard for top referrers with extra rewards,
a partner API for those who want to embed referral links programmatically.

If you have a request, tell us in our Telegram channel or by email. For now: open the dashboard, copy your link, and invite the people who also need reliable Claude API access — from anywhere.