Telegram Stars glossary: XTR, Fragment, paysupport, the 21-day hold and 24 terms in all
Telegram Stars terms in plain language: 24 concepts grouped into buying, spending, earning and technical, from XTR to TxId, each linked to a detailed guide.
Published:

Reading about Stars, you run into words like XTR, paysupport, hold and upgrade. This Telegram Stars glossary sorts them into four groups: buying, spending, earning and technical terms. Each comes with a link to a detailed guide.
1. Buying
- Telegram Stars: the payment unit for digital goods and services inside Telegram. To see yours, check your Stars balance.
- In-app purchase: buying Stars through the App Store or Google Play.
- @PremiumBot: Telegram's official bot, which sells Stars in the direct Android version, Web and Desktop.
- Fragment: a platform on TON that accepts Gram (and, for some purchases, stablecoins) for Stars, Premium, usernames and ads.
- PayStars: a service for buying Stars and Premium with USDT. See ways to buy Stars.
- Final sale: under Telegram's terms, Stars purchases aren't refunded.
2. Spending
- Star reaction: a "paid" reaction to a post, made with Stars. See Star reactions.
- Star subscription: a monthly Stars payment for a channel or bot. See paid channel subscriptions.
- Paid media: a photo or video unlocked with Stars. See paid media.
- Paid message: a fee someone sets for messaging them. See paid messages.
- Gift: an animated gift sent for Stars. An upgrade turns it into a collectible: see upgrading a gift.
- Crafting: combining several collectible gifts into a rarer version. See crafting.
3. Earning
- Reward: exchanging Stars earned by a creator or developer through Fragment.
- 21-day hold: the waiting period before earned Stars can be claimed. See the 21-day hold.
- Affiliate program: a commission for referring people to a bot. See affiliate programs.
- Telegram Ads: spending earned Stars on advertising. See Ads with Stars.
- Suggested post: a subscriber pitches a post to a channel along with a payment. See suggested posts.
4. Technical terms
| Term | Meaning |
|---|---|
| XTR | The Stars currency code in the Bot API |
| provider_token | Left empty for digital goods |
| pre_checkout_query | A request the bot answers before payment |
| successful_payment | The message confirming a payment went through |
| telegram_payment_charge_id | The payment ID you keep for refunds |
| refundStarPayment | The method for refunding Stars |
| /paysupport | The command for raising a payment problem |
| TxId | A blockchain transfer hash (for USDT top-ups) |
For the full developer flow, see the XTR invoice guide.
Pairs people often mix up
- Stars ≠ Gram: what's the difference.
- Buyer price ≠ creator reward: how Stars pricing works.
Got the terms down? Try them out: buy Telegram Stars from 50 on PayStars, paid in USDT.
FAQ
What is XTR?
It's the currency code for Telegram Stars in the Bot API. Invoices for digital goods use currency = XTR.
Are Stars and Gram the same thing?
No. Stars are a unit inside Telegram, while Gram is the TON blockchain's coin.
Can I turn Stars into money?
Not as a regular buyer. Creators and developers who earn Stars can claim rewards through Fragment.
Sources
Buy Stars and Premium with USD (USDT)
Via API key: 0% (plain Fragment price). Via the website: 5%.
More news
Writing a refund policy for your Telegram Stars bot: template and examplesWhat a refund policy for a Telegram Stars bot should cover: eligibility, time window, /paysupport and refundStarPayment, plus sample wording you can adapt.Read →
What happens to your Telegram Stars if you lose access to your accountStars belong to your Telegram account, not your phone. Learn what happens to them when you lose access, how to get back in, and how to protect your balance.Read →
Keeping records of Telegram Stars revenue as a creator or businessHow to keep clean records of Telegram Stars revenue: what to log, tracking Fragment withdrawals, separating personal and business, and what to ask an accountant.Read →