Stripe works with Telegram in two ways. You can connect Stripe to your Telegram bot as a payment provider through @BotFather, so buyers pay on Telegram's own payment sheet, the way a Telegram payment bot takes payment in the chat. Or you can connect your Stripe account directly with Stripe Connect, so buyers pay on Stripe's secure checkout page. This guide compares the two and walks through each one, from the Stripe account to a test card and the first live order, in a Tiny Shops Telegram store.
Stripe is for physical goods and offline services. Digital goods sold inside Telegram must be paid in Stars: see Telegram Stars vs Stripe. For the bigger picture, see how Telegram payments work and the list of Telegram payment methods.
Two ways to connect Stripe to Telegram#
| Stripe via @BotFather | Stripe Connect | |
|---|---|---|
| Where the buyer pays | Telegram's payment sheet, over the chat | Stripe's checkout page, opened from the store |
| What you paste | A provider token from BotFather | Nothing: you sign in to Stripe |
| Other payment methods | Can sit next to other methods | Cards become the only way to pay in the store |
| Tiny Shops percent | Billed with your plan | Taken at charge time, from the payment |
| Where it's set up | Checkout β Payment methods, as the Telegram Invoice method | Checkout β Payment methods, as the Stripe method |
Either way, the money goes to your own Stripe account, and Stripe charges its own processing fee. Telegram takes no commission on provider payments.
What you need#
- A Telegram bot connected to your Tiny Shops store.
- A Stripe account for your business country, with verification finished before live charges.
- A store currency your Stripe account accepts (USD, EUR, GBP and so on), not
XTR.
Way 1: Stripe as a Telegram payment provider (BotFather)#
Step 1 β Get a Stripe token in BotFather#
- Open @BotFather β
/mybotsβ your store bot. - Tap Bot Settings β Payments.
- Choose Stripe TEST MODE and complete the Stripe connection if asked.
- Copy the test provider token.
Later you'll come back for Stripe LIVE MODE. A live token has :LIVE: in the middle (for example 123:LIVE:XXXX). Keep it private.
You don't need Stripe API keys for this way. BotFather's Stripe connection issues the token the store uses.
Step 2 β Paste the token into Tiny Shops#
- In the dashboard open Checkout β Payment methods, click Add method and pick Telegram Invoice.
- The new row shows Not connected and its editor opens below. Click Connect.
- Click Add Provider and fill in:
- Provider Name: type
Stripe. It's your own label; the list has no ready-made Stripe entry. - Provider Token: the Stripe TEST MODE token.
- Test Mode: on while testing.
- Active: on, so checkout can use it.
- Provider Name: type

- Click Save Provider. The row shows Test Mode and Active, with Edit Provider and Delete Provider buttons.

- Check the store currency in the card at the top of the same page. It has to be a currency your Stripe account supports.
- Press Save changes (top right) so Telegram Invoice reaches your storefront.
Step 3 β Place a test order#
Open your store in Telegram, add a product and pay with Stripe's test card:
| Field | Test value |
|---|---|
| Card | 4242 4242 4242 4242 |
| Expiry | any future date |
| CVC | any 3 digits |
Real cards don't work in Stripe TEST MODE. Stripe keeps the current list of test cards. Check that the payment shows in your Stripe dashboard (test mode), not only in Orders.
Step 4 β Go live#
- Finish Stripe's verification so the account can take live payments.
- In BotFather β Payments, connect Stripe LIVE MODE and copy the live token.
- In Tiny Shops, click Edit Provider, paste the live token, turn Test Mode off, keep Active on and click Save Provider.
- Place a small real order and check it in the live Stripe dashboard.
Before going live, also go through Telegram's checklist: two-step verification on the account that owns the bot, a /terms command, a /support command, and readiness to handle disputes and chargebacks.
Way 2: Stripe Connect#
- Open Checkout β Payment methods and find the Stripe Connect card.
- Under Where is your business registered?, pick your business country. Stripe fixes this country when the account is created, so choose where the business is registered, not where you are now.
- Click Connect Stripe and complete Stripe's onboarding.
- Wait for the status Ready to take cards. If Stripe needs more details, the card shows Continue Stripe setup.
Once connected, Stripe Connect is the only way to pay in that store, and other payment methods turn off. The card shows the Tiny Shops commission per sale; Stripe's processing fee applies on top. If Stripe Connect isn't available for your business country, use Way 1.
Fees#
- Telegram: no commission on payments through providers.
- Stripe: its own processing fee, which depends on your country, the card and your contract. See stripe.com/pricing and your Stripe dashboard.
- Tiny Shops: the plan's percent of every order: 7% on Free, 3% on Starter ($9.99 a month), 1.5% on Pro ($29), 0.7% on Scale ($79). Each account's first $100 in sales are commission-free, once, not every month. With Stripe Connect the percent is taken at charge time; with a BotFather token it's billed with your plan. See pricing.
FAQ#
Does Telegram support Stripe? Yes. Stripe is one of Telegram's payment providers, with Stripe TEST MODE and Stripe LIVE MODE in @BotFather β Bot Settings β Payments.
Do I need Stripe API keys? No. Way 1 needs only the BotFather token; Way 2 signs you in to Stripe from the dashboard.
Why does a payment fail with PAYMENT_PROVIDER_INVALID?
Usually the store currency isn't one your Stripe account supports. Change it at the top of Checkout β Payment methods or check your Stripe settings.
Can I use Stripe for digital downloads in Telegram? No. Telegram requires Stars for digital goods and services sold inside bots and Mini Apps.
Will Apple Pay and Google Pay work? Telegram's payment sheet supports Apple Pay and Google Pay, and they appear when Stripe and the buyer's device support them. There's nothing to switch on in the store.
Sources#
- Telegram Bot Payments (Stripe TEST MODE and LIVE MODE)
- Telegram Stars for digital goods
- Stripe pricing Β· Stripe test cards
- Tiny Shops docs: Telegram Payments
Selling in Central Asia? Use Freedom Pay instead. Open your store at tiny-shops.com β
