Telegram Payments Integration | Stars, TON & Stripe

Telegram Payments & Stars Integration

We implement every payment rail available in Telegram: Telegram Stars (required for digital goods and subscriptions sold inside Telegram), TON and USDT through TON Connect, and card payments through Stripe, Adyen or regional providers for physical goods and services. Includes checkout UX, webhooks, refunds, reconciliation and reporting. From $1,500, usually 1–3 weeks.

Starting from*

$1,500

Typical timeline

1–3 weeks

Engagement

Fixed price or T&M

* Indicative prices. The final quote depends on the complexity of the task, the number of specialists involved and the timeline you choose; every project is estimated individually. Pricing terms

The prices for Telegram Payments & Stars Integration are indicative

Every project is priced individually: the final cost depends on the complexity of the task, how many developers and specialists it needs and the timeline you want. Your project may come in lower or higher than the ranges shown. Send us a short brief and we reply with a fixed price and timeline within one business day.

Ask on Telegram

What's included

Payment rail selection against Telegram's rules and your geography

Telegram Stars: one-time purchases, subscriptions, refunds, Stars-to-TON withdrawal flow

TON Connect: TON and USDT payments with backend confirmation

Card payments: Stripe, Adyen, Paddle or a regional provider via Telegram invoices

Checkout UX in the Mini App with pending and failure states

Webhooks, idempotency, reconciliation, accounting exports

Fraud and chargeback handling, test and live mode switch

The three payment rails in Telegram

Rail	Use for	Fees and payout	Integration time
Telegram Stars	Digital goods, subscriptions, in-app items (mandatory)	Telegram and app stores take a share; payout in TON via Fragment or spend on Ads	1–2 weeks
TON / USDT via TON Connect	Crypto-native products, rewards, large tickets	Network fees only; instant settlement to your wallet	1–3 weeks
Cards via Stripe, Adyen, regional PSPs	Physical goods, bookings, services outside Telegram	Processor fees (about 3%); payout to your bank	1–2 weeks

Most products end up with two rails: Stars for in-app digital value and either cards or TON for the rest. We design the checkout so the user never has to understand why.

Telegram Stars in practice

Stars is Telegram’s in-app currency bought through Apple, Google or directly. For developers it is the only compliant way to sell digital goods inside Mini Apps on mobile. We implement:

sendInvoice with Stars (currency XTR), pre-checkout validation and successful_payment handling.
Subscriptions with recurring Stars payments and entitlement checks on every session.
Refund tooling and policies, including partial automation for failed deliveries.
Reporting: gross Stars, Telegram’s share, net value in TON and your local currency.
Edge cases: duplicate updates, users switching devices mid-payment, timeouts.

Full business guide: Telegram Stars explained.

TON and USDT

Through TON Connect the user approves a transaction in the Telegram Wallet or Tonkeeper; our backend confirms it on-chain via an indexer before releasing the order. We handle gas estimation, retries, under- and over-payments, and refunds to the sender address. For token projects we can add Jetton payments and discounts for holders. See TON development.

Cards and invoices

For physical goods and services we use Telegram’s invoice API with Stripe or another supported provider, or an external checkout opened from the Mini App when the provider is not supported natively. Apple Pay and Google Pay work through these providers. We implement webhooks, idempotent order creation, 3-D Secure and chargeback evidence collection.

What you receive

A payments module with tests, an admin view of orders and refunds, accounting exports (CSV, Google Sheets or your ERP), monitoring for failed payments and a live/test mode switch. Typical cost is $1,500–$6,000 per rail; combined projects with all three rails run $6,000–$12,000.

* All prices and ranges on this page are indicative. The final cost is calculated for each project individually and depends on the complexity of the task, the number of developers and specialists required, and the delivery timeline you set. Use the ranges to understand the typical bracket, not as a fixed offer; the fixed price is confirmed in writing after scoping. Read our pricing terms.

Telegram Payments & Stars Integration: FAQ

Which payment method must I use in a Telegram Mini App?

Digital goods and services consumed inside Telegram (premium features, content, in-game items, subscriptions) must be sold through Telegram Stars. Physical goods and services delivered outside Telegram can use any provider through Telegram's invoice API or an external checkout. Crypto payments on TON are allowed for both.

What does Telegram Stars integration cost?

$1,500–$3,500 for one-time purchases and refunds, $3,000–$6,000 with subscriptions, entitlement management and reporting.

How do refunds work with Stars?

The Bot API provides refundStarPayment; we implement a refund policy, admin tooling and automatic reversal of entitlements. Telegram's share is not refunded to you on refunded purchases, so the policy matters.

Can I accept Apple Pay or Google Pay?

For physical goods and off-platform services, yes, through Stripe or Adyen checkout. For digital goods inside Telegram, Stars is the only compliant option on iOS and Android.

How do I get money out of Telegram Stars?

Developers withdraw Stars as TON through Fragment after a holding period, or use Stars to pay for Telegram Ads. We build the reporting that shows gross Stars, Telegram's share and your net.