Telegram Stars API for Automated Sales
Short Answer
Telegram Stars are the in-app currency of the Telegram platform, used to pay for digital goods sold within Telegram bots and channels, unlock Telegram Premium features, send reactions, and tip content creators. Resellers can sell Telegram Stars via API by accepting a buyer's Telegram user ID and crediting Stars directly to their account. With over 900 million Telegram users globally, Stars are a rapidly growing top-up product with strong demand from active Telegram users.
Definition: Telegram Stars resale via API means purchasing Telegram Stars at wholesale from a B2B supplier and delivering them directly to a buyer's Telegram account by user ID — no redeemable code, delivery is account-to-account.
Key takeaway: Telegram Stars are uniquely positioned because the reseller's sales channel is often the same platform where buyers use the product. A Telegram bot that sells Stars is itself a Telegram product — the buyer can purchase Stars within Telegram and use them immediately in Telegram. This creates a frictionless purchase loop that other digital goods cannot replicate.
Who This Guide Is For
- Telegram bot operators adding Stars as a top-up product
- Resellers targeting Telegram's active user base
- Online stores adding Telegram Stars as a digital goods SKU
- Developers building automated sales pipelines for Telegram Stars
How Telegram Stars Work
Telegram Stars (⭐) are used within the Telegram ecosystem for:
| Use Case | Stars Required |
|---|---|
| Purchase digital goods in bots | Set by bot owner |
| Telegram Premium subscription | 1,000 Stars/month (illustrative) |
| Unlock profile emoji | Varies |
| Send stars to content creators | Any amount (tip) |
| Pay for services in mini apps | Set by service |
| Gift to another user | Any amount |
Stars are purchased with real money via the Telegram app (at Telegram's standard rate) or via third-party resellers at potentially lower prices — which is the reseller opportunity.
Top-Up Flow via API
Unlike gift cards, Telegram Stars top-ups require the buyer's Telegram user ID:
Step 1: Buyer provides their Telegram user ID
(Found in Telegram: Settings → tap username area → numeric ID shown,
or via @userinfobot)
Step 2: Validate the user ID
POST /validate-user
{ "platform": "telegram", "user_id": "123456789" }
→ { "valid": true, "username": "@username" }
Step 3: Show username to buyer for confirmation
"Topping up @username — confirm?"
Step 4: Accept payment; place order
POST /topup
{ "platform": "telegram", "user_id": "123456789", "stars": 500 }
→ { "order_id": "ORD-005", "status": "processing" }
Step 5: Stars credited to account; confirm to buyer
Star Package Reference (Illustrative)
Stars are sold in bundles. Package sizes and pricing depend on your supplier. The following is illustrative.
| Package | Stars | Approx. Retail Price |
|---|---|---|
| Starter | 50 | ~$1.00 |
| Small | 100 | ~$2.00 |
| Medium | 250 | ~$4.50 |
| Standard | 500 | ~$8.50 |
| Large | 1,000 | ~$16.00 |
| Mega | 2,500 | ~$37.00 |
| Ultra | 5,000 | ~$70.00 |
At Telegram's in-app rate (illustrative reference), Stars are sold at approximately $0.016–0.02 per Star. Resellers can offer competitive rates, making third-party top-up attractive to frequent users.
Margin Structure (Illustrative)
Illustrative example only. Actual margins depend on supplier pricing.
500 Stars — Telegram bot with TON/crypto payment:
| Variable | Amount |
|---|---|
| Customer pays (retail) | $9.00 |
| Wholesale cost | $8.25 |
| Gross margin | $0.75 |
| Payment fee (crypto, 0.5%) | $0.05 |
| Net profit | $0.70 |
| Net margin | 7.8% |
500 Stars — online store, card payment:
| Variable | Amount |
|---|---|
| Customer pays (retail) | $9.00 |
| Wholesale cost | $8.25 |
| Payment fee (2.5%) | $0.23 |
| Net profit | $0.52 |
| Net margin | 5.8% |
Telegram bots accepting TON (Telegram's native cryptocurrency) or crypto payments have materially lower payment processing costs, which significantly improves margin on smaller-denomination products.
Selling Stars Through a Telegram Bot
The natural channel for Telegram Stars is a Telegram bot. The complete flow:
User sends /buy to @StarResellBot
Bot: "How many Stars? 100 | 250 | 500 | 1000"
User: 500
Bot: "Enter your Telegram user ID"
User: 123456789
Bot: "Topping up @username — is this correct?"
User: Yes
Bot: "Choose payment: [TON] [Card] [Crypto]"
User: TON
Bot sends TON invoice; user pays
Bot calls API → order placed → Stars credited
Bot: "✅ 500 Stars sent to @username. Order #ORD-005"
This flow is fully automatable. With a supplier API and Telegram bot framework (Python: aiogram/python-telegram-bot; Node.js: telegraf), this bot can be built in under a week.
Payment Methods for Telegram Stars Bots
| Payment Method | Integration | Fee | Best For |
|---|---|---|---|
| TON (Toncoin) | Native Telegram integration | ~0.1–0.5% | Crypto-native audience |
| Telegram Payments (Stripe) | Built-in | 2.5%+ | Non-crypto buyers |
| Card (external gateway) | API integration | 2–3% | International buyers |
| Crypto (USDT, BTC via gateway) | API integration | 0.5–1% | Privacy-first buyers |
Key Differences from Other Top-Up Products
| Dimension | Telegram Stars | PUBG UC | ML Diamonds |
|---|---|---|---|
| Platform | Telegram | Mobile game | Mobile game |
| Account identifier | Telegram user ID | Game ID + server | Game ID + zone |
| Sales channel fit | Telegram bot (native) | Any channel | Any channel |
| Payment fit | TON / crypto | Local payment | Local payment |
| Audience | Telegram heavy users | Mobile gamers | Mobile gamers (SEA) |
Checklist
- Confirm supplier offers Telegram Stars top-up API
- Implement Telegram user ID collection in buy flow
- Validate user ID before accepting payment (display username for confirmation)
- Accept payment (TON recommended for Telegram bot context)
- Place order via API and poll for completion
- Confirm delivery to buyer with order reference
- Handle error states: invalid user ID, order failure
- Set Terms: Stars delivery is to confirmed account; non-reversible after delivery
- Test full flow in sandbox/test environment before going live