Telegram Stars and Toncoin are not two names for the same thing. They are two different things and are used for different jobs.
Telegram Stars are Telegram's in-app payment units. A person can use them to pay inside a Telegram bot or mini app. Toncoin, often called TON, is the familiar name for the cryptocurrency used on The Open Network blockchain. The TON project now calls its native currency Gram (GRAM), but many people still search for Toncoin or TON.
The simple rule is this: for digital goods and services sold inside a Telegram bot or mini app, Telegram requires Stars. Physical goods and services follow different rules: Telegram allows other currencies and payment providers for those sales. A TON-chain payment is not a replacement for a Stars checkout for digital goods or services inside Telegram. Telegram’s payment documentation is clear about this rule.
| If you need to... | Use... | Why |
|---|---|---|
| Take payment for a digital good or service inside a Telegram bot or mini app | Telegram Stars | Telegram requires Stars for this type of in-app checkout. |
| Send a transaction on the TON blockchain or pay a blockchain fee | Gram, previously called Toncoin | This is the TON network currency, not Telegram's in-app checkout unit. |
| Sell a membership from a website outside the Telegram app | A payment method supported on that membership page | The buyer is paying on the web page, not through a Telegram bot checkout. |
| Accept a direct wallet-to-wallet crypto payment | A crypto payment flow | This needs its own payment confirmation and access process. |
Telegram Stars: payment units inside the app
Stars are not cryptocurrency. They are virtual items used inside Telegram. Buyers can get Stars from Telegram and spend them in eligible bot or mini-app payments.
For a digital product or service sold inside Telegram, the buyer sees a Telegram payment screen and pays in Stars. They do not send crypto from a wallet. The payment uses the XTR currency code in Telegram's system.
This can be useful for a creator because the buyer stays in Telegram and does not need to enter card details at that point. But it also means that a Stars price is its own price. Do not present it as a Gram price or tell buyers that they need a TON wallet to pay it.
Toncoin, TON, and Gram: the blockchain side
The Open Network, or TON, is a blockchain. Its native cryptocurrency is used for actions on that network, such as paying transaction fees or using a TON app. The current TON documentation calls the coin Gram (GRAM). Older articles, wallets, and searches often call it Toncoin or TON.
For this article, the name is less important than the boundary: a blockchain currency lives in a wallet and is used for blockchain transactions. Telegram Stars live in Telegram's in-app payment system. One does not turn into the other just because both appear in Telegram conversations.
If you are choosing a wallet or learning how to use one, read our Telegram wallet guide instead. This article is about choosing a payment route, not about choosing a wallet.
Choose by where the customer pays
Start with the place where the customer will complete payment.
Inside a Telegram bot or mini app
For digital goods and services sold inside a Telegram bot or mini app, use Stars. Telegram says these payments must use Stars, not cryptocurrency or another payment provider. That rule applies to the in-app checkout itself.
Private membership access can be more nuanced. Check Telegram's current requirements for your own offer and do not assume that an old setup will always remain compliant.
On a membership page outside Telegram
A website checkout is a different route. The customer opens a membership page in a browser and uses one of the payment methods supported there. This can be the clearer choice when you need to show card, PayPal, or crypto payment options outside the Telegram app.
The payment method is not only a technical detail. It changes what the customer sees, where they pay, and what support question they may have later. Keep the bot message and membership-page description clear about where the payment will happen.
In a TON wallet or blockchain app
Use the TON-chain currency only when the action itself is on the blockchain: for example, a wallet transfer or a transaction in a TON application. That is not the same as a subscription checkout that automatically gives someone private access after payment.
If you accept a direct crypto transfer, you still need to confirm the payment and give the customer access. For a practical route, see how to accept crypto payments in Telegram. It explains automated gateway payments and the access-code route for a manual payment.
How this works with InviteMember
You do not need to build a payment bot from scratch to use Stars for a membership offer. In an InviteMember project, enable Telegram Stars in Payment options, then set a Stars price for the relevant subscription plan. The membership bot can then offer that plan inside Telegram.
You can also turn on Only Stars In Bot. This hides other payment options in the membership bot while they stay available on the membership page outside Telegram. That gives a simple split: Stars in the bot, and other supported methods on the web page.
Before sharing the plan, test it with another Telegram account. Check that the Stars price is clear, the buyer receives the correct private access after a successful payment, and the membership page shows the methods you expect. InviteMember handles the membership flow, but it does not decide whether your particular offer meets Telegram's current payment policy.
Buying with Stars is different from receiving earnings
A buyer spends Stars. A creator may later receive Stars as bot revenue. These are related but they are not the same step as a buyer's checkout.
Do not tell a customer to convert Stars to Gram to buy a plan. Do not promise a creator that every Stars balance is ready to withdraw immediately. Availability and withdrawal conditions can apply to creator earnings.
When you are ready to understand that separate process, use the Telegram Stars to TON withdrawal guide. It covers that journey without turning this comparison into a conversion tutorial.
Common mistakes to avoid
- Calling Stars cryptocurrency. They are Telegram's in-app payment units.
- Calling a Stars checkout a TON payment. The buyer is paying in Stars, not from a TON wallet.
- Offering a TON-chain payment in place of Stars for a bot or mini-app sale of digital goods or services inside Telegram.
- Treating a wallet transfer as an automatic membership checkout when there is no payment-confirmation and access flow.
- Assuming that a past policy choice will apply forever. Check Telegram's current rules before changing how you sell.
FAQ
Are Telegram Stars and Toncoin the same?
No. Stars are Telegram's in-app payment units. Toncoin is the familiar older name for the TON blockchain currency, now called Gram in current TON documentation.
Can I accept TON instead of Stars in a Telegram bot?
Not for a bot or mini-app sale of digital goods or services inside Telegram. Telegram requires Stars for that in-app payment flow. A wallet payment is a separate process.
Can I use Stars and other payment methods for the same membership?
Yes. With InviteMember, you can offer Stars in the membership bot and use other supported payment methods on the membership page outside Telegram. Check the current rules for your offer before deciding which methods stay visible in the bot.
Do customers need a TON wallet to pay with Stars?
No. A Stars payment happens in Telegram. It is not a request to send crypto from a wallet.
The practical choice
Use Stars when the purchase happens in an applicable Telegram bot or mini-app payment flow. Use the TON-chain currency when the action belongs on the blockchain. Use a membership web page when the buyer needs a supported web payment option. Once you separate those three routes, the payment setup becomes much easier to explain to customers.
