Source tracking
See which links and tags bring in new users, and tie every visit to a specific referrer.
Referral Program
A referral program for your Telegram bot — mini app out of the box
Track who referred whom, automatically accrue rewards and pay them out — without building your own backend. A ready-made referral infrastructure and mini app that connect in minutes.
Free plan · No card required · Launch in 5 minutes
5 min
To launch a referral program
2 modes
Observe only, or fully managed
Auto
Manual, webhook, or scheduled payouts
What it can do
A full referral program, no development required
Everything you need to launch and grow your bot's referral program — in one place.
Referrer & referral accounting
The system knows who invited whom and keeps a full history of referrer → referral relationships.
Automatic accruals
Flexible reward rules: a fixed amount, a percentage, or an external accrual triggered by any event from your bot.
Reward payouts
Manually, via webhook, or automatically on a schedule. Balances are tracked separately per currency.
Statistics & analytics
Funnel, top referrers, accrual trends, and referral data right in the report builder.
On top of your system
Can be connected even if you already have your own referral logic — no infrastructure changes needed.
Already have your own referral system? That's not a problem
Graspil's referral system can run on top of your own. In “Observe” mode you simply get analytics and tracking for visits on your existing links — without changing your bot or infrastructure.
Modes
Observe or Manage — you choose
Two modes for different needs: pure analytics on top of your own logic, or a full referral program on our side.
Observe
The system captures the codes arriving in the ?start= parameter of your links and ties visits to users. Your bot generates and controls the codes.
- Great if you already issue your own referral links
- Full visit analytics with no infrastructure changes
- Accruals work once you pass the referrer's Telegram ID or link a code owner via the API
Manage
The platform generates unique codes and links for every referrer. You get reward rules, balances, and payouts — through the UI or the API.
- Unique referral codes and links out of the box
- Accrual rules, balances, and payouts
- Perfect if you're building a referral program from scratch
Links & codes
Flexible referral link configuration
Set your own parameter name, pass an opaque code, or the referrer's Telegram ID directly — the system adapts to your link format.
- Custom parameter name (defaults to ref) to match your link format
- “Parameter = referrer's Telegram ID” mode, with no code-to-user mapping layer
- Link a code owner via the API — ahead of time (pre-assign) or retroactively (backfill)
Link format
Opaque code (default)
t.me/your_bot?start=ref-aK39xZ Referrer's Telegram ID directly
t.me/your_bot?start=128471992 Parameter name and mode are configurable in one click
Reward rule
10% on referral payment Active
Event
payment
Condition
≥ 1000 ₽
Reward
10%
Hold
14 days
Side effect
POST https://api.yourbot.com/reward
Accrual rules
Flexible rules are the heart of the referral program
Each rule defines: which event triggers it, how much to credit the referrer, and what else to do. Multiple rules apply by priority.
- Trigger — any event from your bot: payment, subscription, a funnel step
- Conditions on the event's value: minimum, maximum, or an exact match
- A hold period — protection against refunds before payout
- Side effects: a webhook call and updating the user's custom fields
- Rule priority when several rules match the same event
Fixed
A specific amount in the chosen currency for every event.
Percentage
A percentage of the event's amount — the currency comes from the event itself.
External
The platform notifies your server via webhook, and you calculate the amount.
Payouts
Pay out rewards however you like
Once a referrer has an approved balance, you can pay it out manually, via webhook, or automatically on a schedule.
Manual
Transfer the money however you like and mark the payout in the system. The platform keeps track.
Webhook
The platform sends a POST request to “credit X of currency Y to user Z”, and your server executes it.
Auto payouts
On a schedule (monthly or every N days) with a minimum threshold per currency.
Referrer balance
Available4 820 ₽
Reserved1 200 ₽
On hold650 ₽
Paid out12 300 ₽
Payout lifecycle
RequestedProcessingDone
Statistics
Full referral program analytics
Track how well the program performs and use referral data in the report builder alongside the rest of your bot's analytics.
- Referral program funnel from visit to target action
- Top referrers and accrual trends over time
- Balances and accrual statuses per currency
- Referral data available in the report builder
In-bot automation
Ready-made workflows right inside your bot
Using the automation tools, your bot's users can manage the referral program without ever leaving Telegram.
Program registration
The user joins the referral program and gets their personal link right in the chat with the bot.
Personal statistics
The referrer sees their balance, the number of people invited, and accrual history via a bot command.
Requesting a payout
A “Withdraw” button triggers a payout of the accumulated balance right from the bot.
Ready-made scenarios — no code required
Your Bot
bot
Welcome to the referral program! Tap /ref to get your link.
/ref
Your personal referral link:
t.me/your_bot?start=ref-aK39xZ📊 My stats💸 Request payout
Invite friends and get rewarded for every target action!
API
Full control via the API
Manage the referral program programmatically: issue links, link code owners, and trigger payouts right from your bot.
- Issue a referral link to a user on command
- Link code owners in bulk — pre-assign and backfill
- Trigger payouts on a button tap in the bot
Referral API
GET
referral/default/referrer-codeReturn (or create) a referral link for a user
POST
v1/referral/set-code-ownersLink owners to one or more codes
POST
v1/referral/payoutTrigger a payout of the referrer's available balance
Frequently asked questions
Launch your referral program today
Connect your bot, set up rules and payouts — and scale growth through your own users.
Connect the referral systemFree plan · No card required · Launch in 5 minutes