Telegram payments let a buyer pay a bot or a Mini App without leaving the chat. The bot sends an invoice, Telegram opens its own payment sheet, and the money goes to the seller through a payment provider (for physical goods) or as Telegram Stars (for digital goods). This guide explains how Telegram payments work, which option fits what you sell, what each one costs, and how to start accepting payments step by step, with or without code. If you want a bot that takes the payment right in the chat, see how a Telegram payment bot works.
Looking for the full list of methods a shop can connect, including TON and Southeast Asian wallets? That's in Telegram payment methods. This page is about how payments in Telegram work and how to switch them on.
How Telegram payments work#
Telegram's Bot Payments API is a free, open platform. It has two lanes:
- Physical goods and services are paid through third-party providers. Telegram works with more than 20 of them, and buyers can pay from over 200 countries. Telegram takes no commission on these payments and does not store card details; the provider handles the card. Telegram supports Apple Pay and Google Pay on the payment sheet.
- Digital goods and services must be paid in Telegram Stars, currency code
XTR. Telegram says it cannot show your bot or Mini App to mobile users if you sell digital goods through other currencies or third-party providers.
A payment always follows the same path:
- Invoice. The bot sends an invoice with the items and the total (
sendInvoice), or a Mini App opens one from a link. - Shipping (optional). If delivery cost depends on the address, Telegram asks the bot for shipping options first.
- Pre-checkout check. Before charging, Telegram asks the bot to confirm the order. The bot has 10 seconds to answer, or the payment is cancelled.
- Payment. The buyer confirms on the sheet: card, Apple Pay, Google Pay or Stars.
- Confirmation. The bot receives a
successful_paymentmessage and delivers the order.
Which option fits what you sell#
| Option | Buyer pays with | For | What Telegram takes | Setup |
|---|---|---|---|---|
| Telegram Stars | Stars balance | Digital goods: files, access, memberships | Seller receives about $0.013 per Star | Nothing to connect |
| Card provider via @BotFather (Stripe, Freedom Pay and others) | Card, Apple Pay, Google Pay on Telegram's sheet | Physical goods and offline services | Nothing; the provider charges its own fee | A provider token |
| Stripe Connect (Tiny Shops) | Card on Stripe's secure checkout page | Physical goods in Stripe countries | Nothing; Stripe's fee applies | Stripe onboarding from the dashboard |
| TON | Any TON wallet | Crypto-savvy buyers, cross-border | Nothing | A wallet address |
| Manual order | Whatever you agree: cash, transfer | Local delivery, cash on delivery | Nothing | Nothing |
Provider fees vary by country and contract. Stripe publishes its rates at stripe.com/pricing; providers like Freedom Pay set them in your agreement. Check your provider, not a blog table, for the number that applies to you.
Telegram Stars in short#
Buyers get Stars through Apple or Google in-app purchases or @PremiumBot, then spend them in bots and Mini Apps. For the seller, Telegram's bot developer terms set the value:
- About $0.013 per Star as a reward, processed through Fragment.
- $0.02 per Star if you spend the balance on Telegram Ads instead.
- Up to 21 days before received Stars become available for rewards or ads.
Stars are whole numbers only, tips are not available, and Telegram does not pass the buyer's name, phone or address with a Stars payment. Refunds go back through the Bot API (refundStarPayment), and a bot that sells for Stars must answer the /paysupport command. The full comparison with cards, with a Stars-to-USD table, is in Telegram Stars vs Stripe.
How to accept payments on Telegram (the general way)#
If you build the bot yourself, these are the steps from Telegram's docs:
- Create a bot with @BotFather. Our bot guide walks through it.
- Get a provider token. In @BotFather:
/mybotsβ your bot β Bot Settings β Payments. Pick a provider, finish its sign-up and copy the token. Start with the test one. For Stars, skip this step: the token is an empty string. - Send invoices from your code with
sendInvoiceorcreateInvoiceLink, in a currency your provider supports. - Answer the pre-checkout query within 10 seconds, and the shipping query if you use flexible shipping.
- Handle
successful_payment: mark the order paid and send the goods. - Go through Telegram's live checklist: two-step verification on the account that owns the bot, a
/termscommand buyers agree to, a/supportcommand, and readiness to handle disputes and chargebacks yourself. Then swap the test token for the live one (it has:LIVE:in the middle).
A store builder does steps 3 to 5 for you, along with the catalog, the cart and order alerts.
How to accept Telegram payments in Tiny Shops#
Tiny Shops is a no-code Telegram Mini App shop builder. Your store opens inside your own bot, and the checkout ends on Telegram's payment sheet.
Cards through a Telegram provider#
- Get a test token in @BotFather β
/mybotsβ your store bot β Bot Settings β Payments. Step-by-step guides for two providers: Stripe and Freedom Pay. - Open Checkout β Payment methods. Click Add method and pick Telegram Invoice. The new row shows Not connected and its editor opens below.
- Click Connect, then Add Provider. Fill in Provider Name (any label, for example "Stripe"), paste the token into Provider Token, leave Test Mode and Active on, and click Save Provider.
- Check the store currency in the currency card at the top of the same page. It must be one your provider supports. If a payment fails with
PAYMENT_PROVIDER_INVALID, the currency is the usual cause. - Press Save changes (top right) to publish the method list to your storefront. Telegram Invoice shows Connected once an active provider exists.

- Choose the invoice fields. In Invoice Field Configuration, switch on Request Name, Request Phone Number, Request Email or Request Shipping Address as you need. Flexible Shipping Pricing lets the delivery price depend on the address. Enable Tips adds up to 4 suggested tip amounts and a Maximum Tip Amount.
- Place a test order from your phone. With a Stripe test token, use Telegram's test card
4242 4242 4242 4242, any future date and any CVC. - Go live. Take the live token from @BotFather, click Edit Provider, paste it, turn Test Mode off and save.
Telegram Stars#
- In Checkout β Payment methods, set the store currency to Telegram Stars (XTR) in the currency card at the top. No token and no provider needed.
- Click Add method, add Telegram Stars and press Save changes.
- Price your products in whole Stars.
One store has one currency, so a store takes either Stars or a card provider. If you sell both parcels and digital goods, run them as two stores on one account.
Other options#
Stripe Connect (cards on Stripe's checkout page, payouts to your own Stripe), TON, Xendit for Indonesia, the Philippines and Malaysia, and Manual order are all set up from Checkout β Payment methods. The steps for each are in Telegram payment methods.
Telegram Apple Pay and Google Pay#
You don't switch wallets on separately. Telegram's payment sheet supports Apple Pay and Google Pay, and they appear when your provider and the buyer's device support them. If a buyer doesn't see Apple Pay, check whether your provider offers it in your country. Stars payments don't use wallets at all: the buyer pays from their Stars balance.
What it costs#
Telegram takes nothing on provider payments; your provider charges its own fee. Tiny Shops costs $0 on Free, $9.99 on Starter, $29 on Pro and $79 on Scale a month, and every order pays the plan's percent of its total: 7%, 3%, 1.5% or 0.7%. Each account's first $100 in sales are commission-free, once, not every month. Stars sales pay the percent from the first sale. Details on pricing.
Troubleshooting#
| Symptom | Likely cause | Fix |
|---|---|---|
Payment fails with PAYMENT_PROVIDER_INVALID | The provider doesn't support your store currency | Change the store currency at the top of Checkout β Payment methods or ask the provider which currencies it accepts |
| Telegram Invoice shows Not connected | No active provider | Click Connect in the method's editor, add a provider and keep Active on |
| Stars isn't offered at checkout | Store currency isn't XTR | Set the store currency to Telegram Stars (XTR) at the top of Checkout β Payment methods |
| Test payments work, real ones don't | Still on the test token | Paste the live token and turn Test Mode off |
| No order alert | No alert destination | Set it under Order Notifications and press Send test order alert |
FAQ#
How do Telegram payments work? The bot sends an invoice, Telegram shows a native payment sheet, the buyer pays by card, wallet or Stars, and the bot gets a confirmation and delivers the order. Cards go through a third-party provider; Stars stay inside Telegram.
Does Telegram charge a fee for payments? Not on payments through third-party providers; the provider charges its own fee. With Stars, the seller receives about $0.013 per Star as a reward, per Telegram's developer terms.
Can I accept Apple Pay in Telegram? Yes, when your provider supports it. Apple Pay and Google Pay appear on Telegram's payment sheet with no extra setup in the store.
Can I sell digital products for cards in Telegram? Not inside the bot or Mini App. Telegram requires Stars for digital goods and services, and may hide a bot from mobile users that sells them for other currencies.
Do I need a developer? Not with a store builder. In Tiny Shops the setup is a token from @BotFather and a few settings in the dashboard.
Open your store and take your first Telegram payment at tiny-shops.com β
