Short answer: use Telegram Stars when you sell digital goods or services to ordinary users inside a Mini App, and use TON payments when your buyers are crypto-native and want to pay from their own wallet. Many products offer both. The choice is less about which is better and more about who pays, what they buy, how you want to receive the money and which rules apply to you. This article walks through the questions to answer first.
What each option is
Telegram Stars is a virtual currency inside Telegram. A user buys Stars through the app and spends them with bots and Mini Apps. Your bot sends an invoice, the user confirms in a native Telegram screen, and your server gets a confirmation to deliver the item. Because the payment sits inside Telegram's own system, the user does not need a wallet or a card form from you.
TON payments are transfers of Toncoin, or of a token on the TON network, from the user's wallet to an address you control or to a smart contract. The user connects a wallet, approves a transaction and your server watches the chain to confirm that the transfer happened. It suits users who already hold crypto and products where the payment itself is part of the experience.
The questions that decide it
What are you selling?
Telegram's platform rules treat digital goods differently from physical goods, and they can change over time. In general, digital items such as game upgrades, premium features or subscriptions inside a Mini App are expected to use Stars, while physical goods and some services can use other payment providers. Read the current rules for your category before you design the checkout. If you are unsure, ask us and check the official documentation, because we cannot give legal advice or promise that a design will stay allowed.
Who is your buyer?
A mainstream audience that has never owned crypto will find Stars much easier. A community of traders or token holders may prefer to pay in TON or in a token and may be put off by an extra currency. If your audience is mixed, offering both is common, as long as you test both flows.
How do you want to receive money?
Stars are collected by your bot account and then handled under Telegram's terms for balances, conversion and withdrawal. Those terms, fees and limits are set by Telegram and may change, so confirm them before you build a business model on them. TON payments arrive at an address you control, which gives you direct custody but also means you are responsible for key security and for accounting.
What happens when something goes wrong?
Refunds, failed deliveries and disputes need a plan. Stars have a refund method in the bot platform, so a refund flow can be built in. A TON transfer is final once it is confirmed, so a refund is a separate outgoing transfer that you must initiate and fund. Decide your refund policy in writing before you launch.
How the flows differ for the build
Stars flow
- The user taps a buy button in the Mini App.
- Your server asks the bot to create an invoice priced in Stars.
- Telegram shows a payment screen and the user confirms.
- Your bot receives a pre-checkout request and must answer it quickly, so the check on stock or eligibility has to be fast.
- Your bot receives a successful payment message, and your server marks the order paid and delivers the item.
TON flow
- The user connects a wallet through the standard connection method.
- Your server creates an order with a unique reference and an amount.
- The user approves a transaction that includes that reference.
- Your server watches the network, matches the transfer to the order and waits for enough confirmation.
- Your server delivers the item and records the transaction hash.
In both flows the rule is the same: the front end can ask for a payment, but only your server decides that an order is paid, and it decides only after the payment system or the chain says so. Handle duplicate messages safely too, because a confirmation can arrive more than once and must not deliver the item twice.
Cost and effort, honestly
The Stars flow is usually the smaller build, because Telegram handles the payment screen and you handle two bot events. The TON flow needs wallet connection, chain monitoring, handling of pending and failed transfers, and careful treatment of amounts and decimals. If you use a smart contract to receive or split payments, add a security review of that contract, which reduces risk but cannot remove it. No one can promise a contract is free of bugs.
Typical prices and timelines depend on scope and on how quickly feedback arrives, and a written quote follows a scoping conversation. You can see the usual ranges on the pricing page.
Rules and limits to keep in mind
- Telegram's rules for Stars, bots and Mini Apps can change, and so can the network's terms for TON. Plan to review them before launch and again later.
- Taxes, accounting and consumer protection rules depend on your country and your customers. Talk to a qualified adviser. We build software and do not give legal or financial advice.
- If you hold or move user funds, you may fall under financial regulation. That is the client's responsibility to check.
- Do not build price promises or token value claims into your marketing.
A simple way to decide
- Selling digital items to a general audience: start with Stars.
- Selling to crypto-native users, or accepting a specific token: start with TON.
- Both audiences: build Stars first, add TON when the core product works.
- Physical goods or services: check the rules, and consider a payment provider instead.
If you want us to check a specific design, see our page on Telegram Stars payment integration. Or chat on Telegram or WhatsApp at +1 (929) 450-3261 and tell us what you sell, who buys it and where you plan to launch.