LIVE PORTAL • Telegram v11.8 API Synchronized • Free Animated Stickers

shield_person ADMIN LOGGED IN + Write Guide

Home › Guides & Tips › tips › Guide #10974

How Developers Create Telegram Affiliate Programs: Custom Commission Rates, Duration Settings & Viral Growth Loops

trending_up VIDEO GUIDE Developer Hub • Growth Engineering

How Developers Create Telegram Affiliate Programs: Custom Commission Rates, Duration Settings & Viral Growth Loops

Scale your Telegram Bot or Mini App with automated, transparent viral distribution. Learn how developers launch native Affiliate Programs, configure custom revenue-sharing percentages and cookie durations, and recruit thousands of channel promoters with zero tracking infrastructure overhead.

rocket_launch

Organic Viral Scale

Incentivize top Telegram channel admins and influencers to market your product in exchange for automated commission splits.

tune

Custom Parameter Control

Set tailored commission rates (5% to 50%) and specify duration windows ranging from 30 days to lifetime attribution.

auto_graph

Zero Ledger Maintenance

Telegram automatically calculates, splits, and deposits Star commissions into affiliates' balances with zero server overhead.

checklist Step-by-Step: Launching Your First Affiliate Campaign

1

Accessing the Bot Affiliate Management Tab

Open the profile page of your Bot or Mini App where you have administrator permissions. Tap Edit, then select Affiliate Program to access the campaign configuration interface.

2

Defining Commission Percentages and Duration

Choose the commission percentage that affiliates will receive from qualifying in-app Star purchases (e.g. 20%). Next, configure the attribution duration: select whether affiliates earn commissions on purchases made within 1 month, 3 months, 6 months, 1 year, or lifetime attribution.

3

Publishing to the Global Directory

Toggle the program status to Active. Your bot will automatically appear in Telegram's native directory under Settings > My Stars > Affiliate Programs, exposing your app to millions of potential promoters instantly.

code MTProto Layer 174: Bot Affiliate Management Schema

Under the MTProto Layer 174 schema, developers can also configure and query affiliate programs programmatically via the bots.setBotAffiliateProgram API method:

MTProto Layer 174 • Affiliate Program Configuration Telegram Bot Core API

// Configure or update an affiliate program for a bot
bots.setBotAffiliateProgram#46f041d8
    flags:#
    bot:InputUser
    commission_permille:int    // 200 = 20.0% commission rate
    duration_months:flags.0?int // 0 = Lifetime, 1 = 30 days
    = Updates;

// Query Active Affiliate Performance Ledger
bots.getBotAffiliates#a0a38210
    flags:#
    bot:InputUser
    offset_id:int
    limit:100
    = bots.BotAffiliates;

help Frequently Asked Questions

contact_support Can developers adjust commission rates after affiliates have joined?

Yes. Developers can update commission terms or end a program at any time. Any changes apply only to future referrals, while previously referred users remain attributed under the original terms agreed upon at registration.

contact_support Does Telegram take an extra fee on affiliate payouts?

No separate fee is charged on affiliate splits. Telegram's standard platform fee on Stars applies to the total invoice amount, and the remaining balance is split automatically between the developer and affiliate according to the configured percentage.

auto_stories More in "tips" Learning Track

arrow_back Back to all tips guides | View All 4 Categories →