How to accept payments in Telegram Stars

← Back

In a Telegram mini app, the site balance is topped up with stars: the rate and packages are set in the app_tg section settings, and card payment is disabled there by default.

  1. Open the section with the app_tg module → «Module settings».
  2. Set the «Rate: rubles per 1 star» (1 by default) and the «Star packages», for example 50, 100, 300, 1000.
  3. If you wish, set the limits «Custom amount: from, stars» and «Custom amount: to, stars».
  4. Specify the «Terms page (/terms command)» and the «Reply to /paysupport». Telegram requires them from bots that accept payments.
  5. Save.

When the site is opened in Telegram, the «Finance» page shows the «Top up with Telegram Stars» block instead of card payment. The person selects a package or their own number of stars and pays in the Telegram window. The balance is credited with "stars × rate" rubles, and the bot sends a top-up message.

Stars accumulate on the bot. The bot owner withdraws them via Fragment.

According to Telegram's rules, digital goods and services in a mini app can only be sold for stars. That's why the pages from the «Card payment pages (closed in Telegram)» field don't open there. If the site sells physical goods (for example, printing), enable «Allow card payment in Telegram (physical goods only)». You can remove stars entirely with the «Disable payment with stars» checkbox.

If it didn't work

  • «Update Telegram — this version doesn't support payment with stars». The person has an old version of Telegram.
  • «Payment completed, the money will appear on your balance within a few minutes». The payment was accepted, crediting will catch up. If the balance hasn't changed for a long time, check «Check polling» on the section page.
  • «Card payment in Telegram is unavailable». That's expected for digital services — see the checkbox above.
Did the article help?

See also

What are site apps and integrations and where to enable themAn integration is a site section with a special module: create a section, choose the module in the “Integrations” tab of the module store and fill in the “Module settings”.How to send site requests to amoCRMCreate a section with the app_amo module, set up an integration in amoCRM, enter its ID and secret key and click “Connect amoCRM” — requests will become deals.How to send conversations to amoCRM chats and open the site from the amoCRM menuChats are connected with the «Connect chats» button after you get a channel from amoCRM support; the menu item is added with the widget.zip archive from the app_amo section page.How to open the site as an app in Bitrix24Create a section with the app_b24 module, add a local app on the portal with the addresses from the section page, and enter its client_id and client_secret in the module settings.

In the help section, you will find answers to frequently asked questions and useful instructions for working with the Site Look website builder. Here you can learn how to manage sections, add objects, and configure the website. The materials will be useful for both beginners and experienced users. If you haven't found an answer, contact support.