Guide · Telegram Stars

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:

Telegram Stars glossary: XTR, Fragment, paysupport, the 21-day hold and 24 terms in all

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

TermMeaning
XTRThe Stars currency code in the Bot API
provider_tokenLeft empty for digital goods
pre_checkout_queryA request the bot answers before payment
successful_paymentThe message confirming a payment went through
telegram_payment_charge_idThe payment ID you keep for refunds
refundStarPaymentThe method for refunding Stars
/paysupportThe command for raising a payment problem
TxIdA blockchain transfer hash (for USDT top-ups)

For the full developer flow, see the XTR invoice guide.

Pairs people often mix up

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%.

Get started