Telegram Bot Payments in 2026: When You Must Use Stars (and When You Don't)

Short answer: a Telegram Stars payment bot is mandatory only for digital goods and services. Telegram requires Stars (currency code XTR) for them because of App Store and Google Play rules. Physical goods and services are different: a bot can still take card, Apple Pay, and Google Pay payments through third-party payment providers. "Stars only" depends on what you sell, not on selling through a bot.

Telegram Stars: Telegram's in-app virtual currency, written as XTR in invoices. Bots and mini apps must use Stars to sell digital goods and services, and users buy Stars through Apple or Google in-app purchases or through @PremiumBot.

Rule Digital goods and services Physical goods and services Source
Payment method Telegram Stars only (XTR) Third-party providers: cards, Apple Pay, Google Pay Stars, Payments
provider_token Can be left empty Token from @BotFather Same pages
Buyer details None required Name, phone, email, shipping address (optional) Same pages
Refunds refundStarPayment method Through your payment provider Same pages
Telegram commission Set by Telegram's Star pricing table and developer terms None, per Telegram Same pages
Other currencies, crypto, your own website Not allowed inside Telegram apps Allowed Stars FAQ

Mavibot is an automation platform for chatbots, a CRM, online stores, and online booking. In Telegram, it sends invoices through a payment provider you connect, and it does not accept Telegram Stars.

Do Telegram bots have to use Stars for payments?

Only when the bot sells digital goods and services. Telegram's Stars page says those sales must happen in Stars with the XTR currency tag, while its separate page for physical goods and services still lets bots accept payments through third-party providers. A bakery bot taking cake orders can charge a card; a bot selling wallpaper packs must charge Stars.

Telegram's Bot Payments API for Digital Goods and Services page is blunt:

"Since your bot sells digital goods and services, all transactions must be carried out in Telegram Stars, with currency tag XTR."

The reason is app store policy: Telegram's FAQ on the same page says it "cannot display your bot or mini-app to mobile users if you attempt to sell digital goods and services via other currencies or through third-party payment providers."

The Bot Payments API for Physical Goods and Services page is far looser: Telegram says it "doesn't collect payment information and takes no commission," and that you can "accept payments from over 200 countries using more than 20 providers."

So "Telegram bots can only take Stars now" overstates the rule. It covers paid content, bot features, and mini app upgrades, not a florist, a repair shop, or a restaurant taking orders in Telegram.

What counts as digital goods and what counts as physical?

Digital goods and services are things the buyer receives and uses inside or through Telegram: content, access, bot features, or mini app upgrades. Physical goods and services are delivered or performed in the real world, like shipped products, a haircut, or a repair visit. Telegram doesn't publish a complete list, so unclear cases need a careful look.

Clearly digital (Stars) Clearly physical (providers) Gray zone (Telegram gives no list)
Paid posts, files, or media in a bot Products shipped to an address Online consultation by video call
Premium features of a bot or mini app Offline services: haircut, dinner, repair Online course
In-game items in a mini app Tickets to an offline event Gift card for an offline service
Digital downloads such as e-books or presets Food delivery and takeaway Access to a paid channel

Telegram doesn't publish a full list. If what the buyer gets is delivered digitally inside or through Telegram, treat it as digital. For anything in the gray-zone column, read the Telegram Bot Platform Developer Terms and, if real money depends on the answer, ask a lawyer before you build the checkout.

A quick test for clear cases: switch Telegram off in your head. If a courier still brings the cake, it's physical; if the buyer gets only a file or a bot feature, it's digital.

Decision diagram for Telegram bot payments: digital goods go to Telegram Stars, physical goods and services go to a payment provider

How do Telegram Stars payments work in a bot?

A Stars payment runs through the Bot API in five steps: the bot sends an invoice in XTR, Telegram sends a pre-checkout query, the bot approves it within 10 seconds, Telegram confirms with a successful_payment update, and the bot delivers the goods. The buyer pays with Stars bought through Apple, Google, or @PremiumBot.

Per Telegram's Stars documentation:

  1. Send an invoice. Call sendInvoice with currency set to "XTR". provider_token can be an empty string, since no outside provider is involved.
  2. Wait for the pre-checkout query. When the buyer taps Pay, the Bot API sends a pre_checkout_query update with the order details.
  3. Answer within 10 seconds. Reply with answerPreCheckoutQuery. Telegram says the bot must respond "within 10 seconds after receiving this update or the transaction is canceled."
  4. Wait for successful_payment. Answering the pre-checkout query doesn't guarantee payment, so deliver only after this update.
  5. Store the charge ID and deliver. Save telegram_payment_charge_id (you'll need it for refunds), then send the purchase.

The Stars invoice doesn't ask the buyer for a full name, shipping address, or card details. You can test Stars payments for free in Telegram's test environment before switching to production. What sellers receive for Stars is set by the Star pricing table and Section 6.2 of the developer terms, so check current figures there.

Telegram Stars payment flow in a bot: XTR invoice, pre-checkout query answered within 10 seconds, successful_payment, and delivery

Mavibot doesn't accept Telegram Stars, so a Stars checkout needs a developer or another tool.

How do you accept card payments in a Telegram bot for physical goods?

Connect a payment provider in @BotFather under Bot Settings, then Payments, and copy the provider token it gives you. Your bot sends invoices with that token in a regular currency, and buyers pay by card, Apple Pay, or Google Pay. Telegram doesn't charge a commission for this, but your provider's fees apply.

Setup, per Telegram's physical goods page:

  1. In @BotFather, send /mybots and pick your bot.
  2. Open Bot Settings, then Payments, and choose a provider.
  3. Finish the provider's sign-up in the bot it opens, then return to @BotFather.
  4. Copy the token listed next to the provider and use it as provider_token in invoices.
  5. Test with a test mode first, for example "Stripe TEST MODE," then switch to live mode.

In a provider invoice, the buyer can:

  • Pay with a new or saved card, Apple Pay, or Google Pay.
  • Share a full name, phone number, email, or shipping address, if you ask.
  • Pick a delivery option, which your bot offers through answerShippingQuery.
  • Add a tip, if you set max_tip_amount above 0.

Telegram says each currency's minimum and maximum "roughly correspond to the limit of US$ 1-10000," and that for currencies other than USD the limits move with exchange rates (supported currencies). Telegram also "does not impose any limits on what products or services your bot can offer," but your provider's rules still apply.

How do you set up provider payments in Mavibot?

In Mavibot, the tg_send_invoice function sends a Telegram invoice with your provider token from @BotFather, a supported currency, and your price lines. Setup is covered in Payment in Telegram. If the invoice asks for contact details, Mavibot saves them to #{tg_payment_name}, #{tg_payment_phone}, and #{tg_payment_email}, and the docs say Mavibot answers the pre-checkout query automatically after the payment webhook.

For physical goods and services, Mavibot's Payment button gives the customer a link to a connected payment system such as Stripe, and an online shop or online booking with prepayment can take the payment on a web page. Use these outside links for physical sales only: Telegram's Stars FAQ says your own website doesn't exempt digital goods.

Telegram invoice for a cake order paid by card through a payment provider, sent by a Mavibot bot

What must every seller do before going live?

Before going live, a Telegram seller needs terms the buyer accepts before paying, a clear support channel, delivery only after successful_payment, and a pre-checkout reply within 10 seconds. Stars sellers also answer /paysupport and keep charge IDs for refunds. In both cases, disputes are yours to resolve, not Telegram's.

Requirement Stars (digital) Providers (physical)
/terms command or an easy link to terms, accepted before purchase Required Required
/support command or another clear support channel Required Required
/paysupport for payment issues Required Not mentioned
Answer the pre-checkout query within 10 seconds Required Required
Deliver only after successful_payment Required Required
Store telegram_payment_charge_id Needed for refundStarPayment Refunds go through the provider
Disputes and chargebacks The seller handles them The bot developer, provider, and banks
2-step verification on the owner's Telegram account Highly recommended Highly recommended

Sources: Stars live checklist and FAQ and physical payments live checklist and FAQ.

Telegram also asks you to tell buyers that Telegram support and bot support can't help with purchases made through your bot; one line in /support covers it.

What do the Stars rules mean for a small business?

For most small businesses, very little changes. A shop, salon, restaurant, or service company selling real-world products can keep taking card payments through a provider, inside Telegram or through a payment link. Only businesses selling digital goods inside Telegram must switch to Stars and plan refunds and /paysupport around them.

Three typical cases:

  • Physical products or offline services. Keep a provider token in @BotFather or a payment link from your shop or booking page.
  • Digital goods inside Telegram. Stars are mandatory, even with a website. Budget developer time for the Stars flow and refunds.
  • Both. Split the catalog: a pottery studio takes cards for workshop seats and mugs, and Stars for video lessons in the bot.

Broadcast limits don't depend on payments. Bots send about 30 messages per second for free; paid broadcasts reach 1,000 per second at 0.1 Stars per message above the free 30 but need at least 100,000 Stars on balance and at least 100,000 monthly active users (Bots FAQ). Small bots should just spread big broadcasts over a few hours.

More on the Telegram bot, CRM, and how to create a Telegram broadcast in 15 minutes; for basics, see how to make a Telegram bot, Telegram business features without Premium, and Telegram mini apps for business.

Selling real products or services through Telegram? Mavibot is an automation platform that sends Telegram invoices through your connected provider, shares payment links, keeps every subscriber in a CRM, and runs broadcasts. Create a free account on mavibot.ai. The standard trial is 3 days; promo code MAVI10 extends it to 10 days.

Telegram bot payments: frequently asked questions

Based on Telegram's documentation as of November 19, 2026.

What is XTR in Telegram payments?

XTR is the currency code for Telegram Stars. Put it in the invoice's currency field for digital goods or services, and the price is counted in Stars instead of dollars or euros. A Stars invoice must contain exactly one price item; the provider token can stay empty.

Can I use Stripe in a Telegram bot?

Yes, for physical goods and services. Stripe is one of the providers you can connect in @BotFather; Telegram's own docs use it for test and live mode. Supported currencies depend on the country set in your Stripe account. You can't use Stripe to sell digital goods inside Telegram, where Stars are required.

Can I sell digital products through my website instead of Stars?

Not inside Telegram. Telegram says a bot or mini app must use Stars for digital sales inside its apps, whatever web portals or payment providers you run elsewhere. Sending buyers to your own checkout for a digital product breaks that rule and risks your bot being hidden from mobile users.

Can I accept crypto for digital goods in a Telegram bot?

No. Telegram's Stars FAQ answers this directly: every bot and mini app payment for digital goods and services inside Telegram apps must use Stars, to comply with App Store and Play Store guidelines. Providers remain open for physical goods.

How do refunds work for Telegram Stars?

The bot returns the Stars itself by calling refundStarPayment with the buyer's user ID and the telegram_payment_charge_id saved at checkout. Without that ID there's no API refund, so store it with each order. The seller alone resolves disputes and must answer the /paysupport command promptly.

Why is my Telegram Stars payment not working?

One documented cause is timing: if your bot doesn't answer the pre-checkout query within 10 seconds, Telegram cancels the transaction. Check that your server replies quickly, that the invoice uses XTR with a single price item, and test in Telegram's test environment before going live.

Can a Telegram bot sell subscriptions?

Yes, in Stars. The Bot API lets a bot create an invoice link with a subscription period, which currently must be 30 days, in XTR only, with a price of up to 10,000 Stars (Bot API). Mavibot doesn't support Stars, so these subscriptions need another solution.

Does Telegram take a commission on card payments?

No. For physical goods and services paid through a provider, Telegram says it charges no commission and never sees card details; they go straight to the provider. Your provider's own fees still apply. Disputes go to you, the provider, and the banks, not to Telegram.