Overview
Each user can claim one referral code (idempotently — calling the endpoint twice returns the same code). The code is derived from your name plus a 4-character random suffix, e.g. RAHULAB12.
When someone else signs up and either applies your code at checkout or uses your referral link, a conversion is recorded on your code with a reward amount and status.
Getting your code
- Open Dashboard → Referrals.
- If you don't yet have a code, click Generate my code. The server generates one with up to one retry on collision; the returned code is yours forever.
- Codes are stored uppercased and uniquely indexed — once issued, no one else can have the same string.
Sharing the link
The Referrals page gives you a one-click copy for your link, which looks like:
https://www.tuition.in/register?ref=RAHULAB12
When the visitor signs up, the ref parameter is captured and attached to their new account. If they later subscribe or buy anything, your conversion is logged.
You can also share just the code by voice or chat — the student pastes it into the "Referral code" field on the register page.
How a conversion is recorded
- New user signs up with your code attached.
- On their first paid action (course enrolment, mock series purchase, subscription), the server creates a
ReferralConversionrow linked to yourReferralCode. rewardAmountis calculated per the platform's current program rules.rewardStatusstarts asPENDING.- After a 30-day cooling period (no refund triggered), the conversion flips to
APPROVEDand gets paid out in the next earnings cycle.
Rewards
Reward amount depends on what your referee bought:
- Course / batch / mock series purchase — a percentage of the first transaction (typically 10%).
- Subscription — a percentage of the first month / first year (typically 10%).
Rewards are credited to your Tuition.in wallet for cash-out via the usual payout flow — see Payments & payouts.
Tracking your earnings
The Referrals page shows:
- Total conversions ever.
- Pending reward amount (in cooling).
- Approved reward amount (paid or payable).
- The 10 most recent conversions with date, reward amount, and current status.
Conversions sit in PENDING until the cooling window passes and the referee hasn't refunded. After that they move to APPROVED and are eligible for payout.