Telegram Payments API Integration Guide 2026
What if your customers could pay for your product or service without leaving their chat window? No redirecting to a website, no separate checkout page, no friction. Just a button, a confirmation, and payment done — all inside Telegram.
That is exactly what the Telegram Payments API makes possible. In this guide, we cover everything you need to know: how it works technically, which payment providers it supports, what you can and cannot do with it, and how much it costs to get it integrated into your bot.
What Is the Telegram Payments API?
The Telegram Payments API is a native feature of the Telegram Bot API that allows bots to send invoices and accept payments directly inside a Telegram chat. Users see a clean payment interface, enter their card details (or use Apple Pay / Google Pay), and complete the transaction — without ever leaving Telegram.
Telegram itself does not process payments or hold funds. It acts as the interface layer. All actual payment processing happens through third-party payment providers that you connect to your bot. Telegram charges no additional fee on top of whatever your payment provider charges.
Supported Payment Providers (2026)
| Provider | Countries | Cards | Apple/Google Pay | Crypto |
|---|---|---|---|---|
| Stripe | 46+ | ✅ | ✅ | — |
| Paymob | Middle East, Africa | ✅ | ✅ | — |
| YooMoney | Russia, CIS | ✅ | — | — |
| Sberbank | Russia | ✅ | — | — |
| CLICK | Uzbekistan | ✅ | — | — |
| PAYME | Uzbekistan | ✅ | — | — |
| Smart Glocal | Global | ✅ | ✅ | — |
| Telegram Stars | Global (digital goods) | ✅ via App Store/Play | — | — |
| Custom crypto | Global | — | — | ✅ BTC/ETH/USDT |
💡 Stripe is the most popular choice for businesses targeting the US, UK, and EU. For Middle Eastern clients we typically use Paymob. For crypto payments, we build a custom integration using a crypto payment gateway like NOWPayments or CoinGate.
How the Telegram Payment Flow Works
Bot Sends an Invoice Message
Your bot calls the sendInvoice API method with the product title, description, price, currency, and payload. Telegram displays this as a special message with a "Pay" button.
User Clicks "Pay"
A native Telegram payment screen opens inside the app. The user enters their card details or uses a saved payment method. On mobile, Apple Pay or Google Pay can be used with a single tap.
Telegram Sends a Pre-Checkout Query
Before charging, Telegram calls your bot with a pre_checkout_query. Your bot validates the order — checks stock, verifies pricing, confirms the user is eligible — and responds with OK or an error message.
Payment Is Processed
The payment provider charges the user's card. Funds go directly to your payment provider account — Telegram never touches the money.
Bot Receives Successful Payment Confirmation
Telegram sends a successful_payment update to your bot with the full transaction details. Your bot then fulfills the order — sends the digital product, grants access, creates the subscription, or triggers your fulfillment workflow.
Example: Sending an Invoice with Python
What Can You Sell via Telegram Payments?
Telegram supports payments for physical goods, digital products, and services. However, there are restrictions:
- ✅ Digital products (e-books, courses, templates, software licenses)
- ✅ Subscriptions (VIP access, premium channels, SaaS plans)
- ✅ Physical goods (with shipping address collection supported)
- ✅ Services (consulting calls, design work, bot development)
- ✅ Event tickets
- ⌠Adult content
- ⌠Gambling or betting
- ⌠Regulated financial services (depends on jurisdiction)
Telegram Stars — The New In-App Currency
Telegram launched Stars as an in-app currency for digital goods. Users purchase Stars using Apple Pay or Google Pay through the app stores, and spend them on digital content inside Telegram. For sellers, Stars are converted to TON cryptocurrency and withdrawn. This model is particularly useful for bot developers selling digital products who want to avoid credit card processing complexity.
How Much Does Telegram Payment Integration Cost?
At aziqdev, Telegram Payments API integration is priced based on complexity:
| Integration Type | Features | Cost | Timeline |
|---|---|---|---|
| Basic invoice bot | Single product, Stripe, success handling | $150–$300 | 3–5 days |
| Subscription bot | Multiple plans, recurring billing, access control | $350–$550 | 1–2 weeks |
| E-commerce bot | Product catalog, cart, payments, order management | $500–$800 | 2–3 weeks |
| Crypto payments | BTC/ETH/USDT acceptance, confirmations, wallet | $300–$500 | 1–2 weeks |
Common Mistakes When Integrating Telegram Payments
- Not handling pre-checkout queries fast enough. Telegram requires your bot to respond to
pre_checkout_querywithin 10 seconds. If it times out, the payment fails. Use async handling and keep validation logic lightweight. - Skipping the test payment environment. Telegram provides a test provider token for Stripe. Always test the full payment flow before going live — including edge cases like declined cards and cancelled payments.
- No refund handling. Telegram does not automate refunds. Your bot should include an admin refund command that triggers a refund via the payment provider API and revokes access.
- Storing card data. Never do this. Payment processing happens through the provider. Your bot only receives a transaction ID — never card numbers or CVV.