Accept Card Payments in a Telegram Bot with Stripe
A Telegram bot can take card payments in two ways. The first is Telegram Stars: buyers buy Stars inside Telegram with a card, Apple Pay or Google Pay, then pay your bot in Stars. The second is a direct card checkout through your own Stripe account: the bot sends a secure Stripe payment page, and the money goes to your Stripe balance and then your bank. In TeleCrow you can switch on either or both for a shop or paid-channel bot. This guide compares them honestly, including Telegram's own rule for digital goods, and shows how to connect Stripe step by step.
Telegram's rule, checked 9 November 2026. Telegram's payments documentation says that a bot selling digital goods and services must take those payments in Telegram Stars ("all transactions must be carried out in Telegram Stars"). Third-party providers such as Stripe are documented for physical goods and services. You are the seller, so which methods you offer is your decision and your responsibility. If you sell digital products, Stars is the method Telegram itself documents.
Stars or Stripe: the short comparison
| Telegram Stars | Card through your Stripe | |
|---|---|---|
| How the buyer pays | In Telegram's own pay sheet, with Stars bought by card, Apple Pay or Google Pay | On Stripe's secure page: cards, Apple Pay and Google Pay where supported |
| Who holds the money | Telegram, in your bot's Stars balance | You, in your own Stripe account |
| How you get paid | Withdraw through Fragment as TON, after a hold of up to 21 days | To your bank, on your Stripe payout schedule |
| What it costs you | Telegram pays $0.013 per Star; at TeleCrow's default rate you keep about 65% of the price | Stripe's standard card fees, which depend on your country |
| TeleCrow fee | None | None |
| Refunds and disputes | Buyers use /paysupport; you refund with one button in TeleCrow | Handled by you in Stripe, including chargebacks |
| Who can use it | Any shop or paid-channel bot; withdrawing goes through Fragment, which may not pay out in every country | You need a Stripe account in a country Stripe supports (India: invite only) |
| Automatic renewals for channels | Yes, for monthly plans up to 10,000 Stars | No: buyers renew one period at a time |
Many sellers turn on both. TeleCrow always shows Stars first, then 💳 Pay by card, then any other method you use, so buyers pick what suits them.
What the buyer sees with Pay by card
- The buyer taps 💳 Pay by card on a product or a channel plan.
- The bot replies with a payment message: card, Apple Pay and Google Pay on Stripe's secure page, and who the payment goes to. The link works for a limited time; if it expires, the buyer just taps Pay by card again.
- The buyer pays on Stripe's page and comes back to Telegram.
- The bot confirms "Payment received" and delivers the order right away, with a receipt. For a paid channel, it sends the join link and the date access runs until.
If the bank declines the card, nothing is charged and the buyer can try again or pick another method. Cards pay for a product or a plan period directly. They can't be used to top up a balance in your bot.
How to connect Stripe in TeleCrow
It works for Digital Product Bots and Subscription Channel Bots. You need your own Stripe account; TeleCrow never sees your card money.
- Open the bot's Earnings & Withdrawals tab and press "Set up" on the Stripe row.
- Create a restricted key in Stripe. In your Stripe dashboard, create a restricted API key (it starts with
rk_) with the permissions TeleCrow lists. TeleCrow refuses a full secret key (sk_), a publishable key (pk_) and a signing secret (whsec_) on purpose: a restricted key can only do what the shop needs. - Paste it and press "Check key".
- Make the $1.00 test payment in test mode, to see the whole flow work.
- Repeat with a live restricted key, then press "Turn on Pay by card for buyers".
From then on, every product and plan in that bot shows Pay by card. You can switch it off on the same row at any time; Stars and your other methods keep working.
Money, refunds and chargebacks
- Payouts. Card payments land in your Stripe balance and go to your bank on your Stripe payout schedule. They never pass through TeleCrow, and they are not part of the TeleCrow balance on your Earnings tab.
- Refunds. You refund in Stripe. TeleCrow can't move money in your Stripe account, but it shows each refund in the bot's History.
- Chargebacks. A buyer can dispute a card payment with their bank. You answer the dispute in Stripe, and TeleCrow shows it in History. Clear product descriptions and fast support are your best protection.
- Delivery problems. If a payment arrives but the order can't be delivered automatically, the buyer is told and you are alerted, so you can deliver by hand or refund.
Before you choose card payments
- Check Telegram's rule for what you sell (see the box above). For digital goods, Stars is the method Telegram documents.
- Check Stripe's rules. Stripe has its own list of restricted and prohibited businesses, and can review or close accounts that break it.
- Check your country. Stripe works only in countries it supports. In India, Stripe accounts are by invite only, so most Indian sellers use Stars.
- Paid channels renew differently. With Stars, monthly plans renew by themselves. With a card, buyers get a reminder about 3 days before the end and renew with 💳 Renew by card; paying early adds the new period after the current one.
Frequently asked questions
Can a Telegram bot accept credit card payments?
Yes. Buyers can pay by card indirectly through Telegram Stars, which they buy with a card inside Telegram, or directly on a card checkout page from a provider such as Stripe. Telegram's documentation asks bots that sell digital goods and services to use Stars.
Does TeleCrow take a fee on card payments?
No. Card payments go straight to your own Stripe account and TeleCrow adds no fee. Stripe charges its own card fees. Your TeleCrow plan is separate (see pricing).
Which Stripe key do I need?
A restricted key that starts with rk_, created in your Stripe dashboard with the permissions TeleCrow lists. Secret keys (sk_) are refused.
Can buyers top up their balance by card?
No. Cards pay for one product or one plan period at a time. Balance top-ups use crypto.
Can I use Stripe from India?
Only if Stripe has invited your account, as Stripe accounts in India are invite only. Telegram Stars works without a Stripe account.
Want the simplest start? Turn on Telegram Stars in three taps, and add card payments when you need them. To see where every payment method's money goes, read where your bot's money goes. Start with a digital product shop bot or a paid channel bot. Create your bot for free.