# Referrals > How the Tokens referral program works: get your link, what the person you invite gets, what you earn and when it is paid, the rules and limits, and where to track your referrals in the dashboard. The referral program pays you in wallet credit when someone you invite buys a paid plan, and gives them a discount on that purchase. This page explains how to get your link, what each side gets, when the reward is granted, the rules that apply and where to follow your referrals. :::note[The numbers are set by Tokens and can change] Discount and commission rates, the hold period and the limits below are program settings. This page tells you where to read the current values in the dashboard instead of repeating them. Where it gives an example figure, it says so. ::: ## Get your referral link Open [/dashboard/referrals](/dashboard/referrals), titled "Developer Referrals & Rewards". You need an active **Weekly or Monthly** paid plan to have a referral code. Without one, the page shows "Active Paid Membership Required" and an **Upgrade Subscription** button. With a qualifying plan, the page shows "Your Personal Referral Link & Share Kit": - your link, in the form `/r/` on the Tokens site, with a **Copy Link** button; - your **Referral Code**, with **Copy Code Only**; - two ready-made share messages, **Copy Bangla Message** and **Copy English Message**; - a **Personal QR Code** for your link. The badge at the top of the card shows the commission rate on your code ("Cash Credit Rate"). The discount the person you invite gets is the one shown on your link's landing page, so open your own link to see exactly what they see. ## What the invited person gets When someone opens your link, Tokens remembers your code in their browser for 30 days. The first referral link they open wins; a later link does not replace it. The link's landing page shows the discount for your code and a button to sign up. If they sign up and later buy a plan, the discount is taken off the plan price at checkout. On the Billing page the **Referral Partner Attribution** field is filled in for them. Someone who did not arrive through a link can type a code into **Referral Code (Optional)** at checkout instead. Rules for the discount: - It applies to a plan purchase, not to a wallet top-up. - It does not stack with a coupon. If the person enters a coupon too, the bigger of the two discounts is used, and if the coupon wins, the referral does not count for you. - A code only works for a limited time after the person signs up (30 days by default). After that, checkout does not accept it. ## What you get When the person you invited pays, you earn a commission. It is a percentage of the amount they actually paid, after their discount. A purchase that costs nothing after discounts earns nothing. Example, with made-up rates of 10% discount and 10% commission: a plan that costs 20 is bought for 18, and you earn 1.80. The commission is paid into your wallet, in the currency of the payment, as a wallet credit. It is not a cash withdrawal. It appears in your wallet's transaction history as a bonus credit ("Referral commission matured"). You can earn more through two extras, both shown on the Referrals page when they apply: - **Milestone Volume Ladder & Bonus Rewards.** Tiers you reach after a number of distinct approved referrals, each with a wallet bonus and sometimes a higher commission rate. A progress bar shows how many more you need for the next tier. - **Flash Event** boosters. Time-limited promotions that add a bonus to each referral during the event. The banner shows what you get and when it ends. A commission rate, with any milestone boost, never goes above a program maximum (30% by default). ## When rewards are granted A new referral does not pay at once. It goes through these states, shown in the **Status** column of the conversions table: | Status | What it means | | --------------------- | ----------------------------------------------------------------------------------------------- | | **In 14 Day Escrow** | The person has paid. The commission is held for a hold period (14 days by default). | | **Approved & Credited** | The hold ended and the commission was added to your wallet ("Settled to Wallet"). | | **Under Review** | The referral looked unusual and is being checked ("Routine fraud check in progress"). | | **Revoked** | The commission was cancelled. | When the hold ends, Tokens checks two things before it pays: the payment must still be completed (not refunded or reversed), and you must still hold an active Weekly or Monthly paid plan. If either is no longer true, the referral is revoked and nothing is paid. A scheduled job does the payout, so the credit can arrive some time after the date shown in the **Escrow Maturation** column. That column shows the real date for each referral, even if some text on the page mentions a fixed number of days. ## Rules and limits These are the program rules in force today. Rates and limits are program settings and can change. - **Paid plan required.** Only subscribers on an active Weekly or Monthly paid plan get a code and earn commission, and they must stay on one until the hold ends. - **No self-referrals.** You cannot refer your own account or an account with your email address. - **Fraud checks.** Referrals that look related to you, for example the same network or device, or many sign-ups from one place in a day, are held for review instead of paid straight away. - **Daily limit.** There is a cap on how many referrals one referrer can get in 24 hours (20 by default). - **Time limit.** The invited person must buy within a set time after signing up (30 days by default). - **Payment must hold.** If the payment is refunded or reversed before the hold ends, the commission is cancelled. ## Track your referrals [/dashboard/referrals](/dashboard/referrals) shows: - four cards: **Referral Link Clicks** (unique visits on your link), **Attributed Sign-ups**, **Paying Customers** and **Total Earnings** (split into paid and pending); - **Program Rules & Automatic Escrow Maturation**, a short summary of the steps above; - **Referral Conversions & Ledger**, one row per referral with the date, the referee (shown as a short id, not a name), the commission, the status and the maturity date. Earned credit shows in your wallet at [/dashboard/wallet](/dashboard/wallet), in **Transaction history**. ## Related - [Plans, credits and wallet](/docs/plans-and-wallet) - [Dashboard tour](/docs/dashboard-tour) - [Support](/docs/support) --- Page: https://tokens.bd/docs/referrals