News · Telegram Stars

Digital goods in bots and Mini Apps must be paid with Telegram Stars

Under Telegram's rules, digital goods and services in bots and Mini Apps are sold only for Stars (XTR). What this means for users and developers.

Published:

Digital goods in bots and Mini Apps must be paid with Telegram Stars

What is the rule?

According to the Telegram Bot API documentation, payments for digital goods and services sold inside a bot or Mini App must be accepted exclusively in Telegram Stars. Invoices use the currency code XTR. The rule exists to comply with Apple and Google store policies.

Examples of digital goods include e-books, in-app bonuses, subscriptions, premium features and access to content. Physical goods and real-world services may still use other payment providers.

For users

  • Stars can be bought inside the Telegram app or via Fragment;
  • one balance works across different bots;
  • each payment is confirmed in a Telegram window.

For developers

A bot sets currency=XTR in sendInvoice or createInvoiceLink and leaves provider_token empty. After a successful payment the bot receives a successful_payment message, and refunds are done with refundStarPayment. See the official documentation for details.

Why it matters

Thanks to this rule, users do not need to enter card details for every bot: a single Stars balance works for payments in any bot. Developers can withdraw earned Stars via Fragment or spend them on Telegram Ads. Stars are also used for subscriptions, paid channel posts and gifts.

If your bot sells digital goods through another payment method, review the official documentation and the Bot Developer Terms: bots that break the rule may be restricted.

Sources

Buy Stars and Premium with USD (USDT)

Via API key: 0% (plain Fragment price). Via the website: 5%.

Get started