Clients pay for a custom workout plan with Telegram Stars through a native Telegram invoice, without leaving the chat. On Fitexchange the payment sits in escrow until the client starts the first workout (or 7 days pass), unlocks 30 days after purchase, and is paid out in TON to your wallet on the 1st or 15th.
That is the short version. The rest of this guide walks through what Stars actually are, how your clients get them, what happens to the money at each step, and when it lands in your wallet. I have written it for coaches who want to sell plans inside Telegram and need to explain the payment side to clients without guessing.
What are Telegram Stars?
Telegram Stars are Telegram's own in-app currency for digital goods and services. Telegram's developer documentation describes them as "an in-app virtual item" that a bot or mini app can accept and later convert into a reward (Telegram Stars payments, core.telegram.org).
Three facts matter for coaches:
- Digital goods must be paid in Stars. For digital products sold through a bot or mini app, Telegram requires transactions in Stars (currency code `XTR`). A workout plan delivered inside an app counts as a digital product.
- Stars have a fixed reward value for developers. Telegram's Bot Developer Terms state that developers can receive the equivalent of 0.013 USD in rewards per Star. The price your client pays for Stars in their app store can differ from that, because store pricing and fees vary.
- Payouts go through Fragment and TON. Telegram outsources reward processing to Fragment, and rewards are withdrawn in Toncoin (TON).
So when you set a price "in Stars", you are setting a price in a currency your client already has, or can buy in a few taps, inside Telegram.
How do clients buy Telegram Stars?
Your client does not need a card form, a PayPal account or a separate website. According to Telegram's announcement of Stars, Stars can be bought:
- Through in-app purchases via Apple (App Store) or Google (Google Play), right inside the Telegram app.
- Through the official @PremiumBot.
- On Fragment, where users can top up a Stars balance for themselves or someone else.
In practice, most clients never "buy Stars" as a separate step. When they tap Pay on an invoice and their balance is too low, Telegram offers to top it up on the spot. For a coach, that removes the most common drop-off point in online sales: the moment a client has to leave the conversation to find a checkout page.
How to accept payments in a Telegram mini app as a coach
If you built your own bot, you would need to issue Stars invoices through the Bot API, store payment IDs, handle refunds and manage withdrawals yourself. On Fitexchange that plumbing is already done. Here is the flow from the coach's side:
- Set your price per custom request. You choose the price in Stars. It can also be free, which some coaches use for a first plan or for existing clients.
- The client fills a 7-step intake. Fitness profile, goals, schedule, preferences, health, languages, then coach and price. You get the context you need before you accept anything. If you want to see what a good intake covers, read our client intake questionnaire template.
- The client pays with a native Telegram invoice. No external checkout page. Stars leave the client's balance and go into escrow.
- You accept, or auto-accept. You can turn on auto-accept, and you control the response timeout (48 hours by default).
- You deliver the plan inside the app. Structured workouts built from an exercise library of 314 exercises, with AMRAP blocks, timers, rest blocks and post-workout feeling ratings. The delivery timeout defaults to 7 days.
- Each request has its own chat, so questions about one client's plan stay attached to that plan.
If you have not set a price yet, our guide on how to price online workout plans covers the math.
What does escrow mean for coaches and clients?
Escrow means the client's Stars are held by the platform, not sent straight to the coach. It protects both sides:
- The client knows they will not pay for a plan that never arrives. If you reject a request, or it expires because nobody responded in time, the Stars are refunded automatically. The client can also open a dispute before the payment is released.
- The coach knows the money is already committed. You are not chasing a transfer after you have done the work.
Release happens at one of two moments, whichever comes first:
- The client starts the first workout of the plan.
- 7 days pass without the client starting or disputing (automatic release).
Release is not the same as payout. Released earnings still go through a holding period before they can be withdrawn, which is the part most coaches ask about.
When do coaches get paid? The payout timeline
On Fitexchange, earnings unlock 30 days after each purchase. That 30-day window covers the period in which a Stars purchase can still be refunded. Telegram's own terms also say Stars on a developer balance may not be available for rewards for up to 21 days after receipt, and that Telegram can withhold or debit Stars in response to user refunds (Bot Developer Terms, section 6.2). Holding coach earnings for 30 days means you are not paid money that may be clawed back later.
Once unlocked, earnings are paid out twice a month, on the 1st and the 15th, converted to TON and sent to the TON wallet you connect in the app.
Here is what that looks like with two real-calendar examples:
| Step | Example A: client starts quickly | Example B: auto-release |
|---|---|---|
| Client pays (purchase) | October 3 | October 20 |
| You deliver the plan | October 4 | October 20 |
| Payment released from escrow | October 5 (client starts workout 1) | October 27 (7 days, no dispute) |
| Earnings unlock (purchase + 30 days) | November 2 | November 19 |
| Payout in TON to your wallet | November 15 | December 1 |
Two things to notice. First, the unlock date counts from the purchase, not from release, so a fast client start does not delay anything. Second, the payout lands on the next 1st or 15th after unlock, so the total wait from purchase to wallet is roughly 30 to 45 days.
Telegram Stars vs other ways coaches get paid
Stars are not the only option, and they are not always the best one. Here is an honest comparison of the common setups:
| Setup | How the client pays | Where the plan lives | Best fit |
|---|---|---|---|
| Fitexchange (Stars) | Native Telegram invoice | Inside the mini app, with timers and history | Coaches selling custom plans to clients already on Telegram |
| Subscription platforms (Boosty, Patreon) | Payment on the platform's own site | Posts or files on the platform | Recurring content for a large audience |
| Google Forms + payment link | External payment page | PDF or spreadsheet you send | Very low volume, no app needed |
| Instagram DMs + bank transfer | Manual transfer | Whatever you send in DMs | Coaches with a strong Instagram following and few clients |
If most of your income is a monthly membership for hundreds of followers, a subscription platform is built for that. If you sell individual, personalised plans and your clients are already messaging you on Telegram, keeping the whole flow in one app is simpler for everyone. We compare these options in more detail in Fitexchange vs Tribute, Boosty and Google Forms.
How to explain Stars payments to your clients
Clients who have never bought Stars sometimes hesitate. A short message usually solves it. Points worth covering:
- "You pay inside Telegram, with Apple or Google, like any in-app purchase."
- "Your payment is held until you start your plan. If I can't take your request, you get your Stars back automatically."
- "You can raise a dispute before the payment is released."
Keep it factual. You do not need to explain Fragment, TON or the 30-day unlock to a client, that part only affects you.
A checklist before you take your first paid request
- Connect a TON wallet in the app, so payouts on the 1st and 15th have somewhere to go.
- Set your price per request, and decide whether your first plan is free.
- Review the response timeout (48h default) and delivery timeout (7 days default) and adjust them to your real schedule.
- Decide on auto-accept. It is convenient, but only if you can always deliver on time.
- Set the languages you coach in.
- Remember that accepting requests and then abandoning them has a cost: coaches with high reject or abandon rates are paused from discovery.
Coach applications are reviewed by hand, so apply early if you want to start taking paid requests. You can open the app from the bot at @FitExchangeBot. For the bigger picture of selling inside Telegram, see how fitness creators sell workout plans in Telegram.
Frequently asked questions
Do my clients need a crypto wallet to pay in Telegram Stars?
No. Clients buy Stars inside Telegram through Apple or Google in-app purchases, through @PremiumBot, or on Fragment, and pay with a native Telegram invoice. Only the coach connects a TON wallet, because Fitexchange pays coach earnings out in TON. The client never has to touch crypto or leave the Telegram app.
What happens if I reject a paid request or miss the deadline?
The client's Stars are refunded automatically. On Fitexchange the payment stays in escrow until the client starts the first workout or 7 days pass, so a rejected or expired request never reaches your earnings. Frequent rejections or abandoned requests can pause your profile from discovery, so set timeouts you can actually meet.
How long does it take to get paid after a client buys a plan?
Earnings unlock 30 days after each purchase, then Fitexchange pays them out on the next 1st or 15th of the month, converted to TON. In practice that means roughly 30 to 45 days from purchase to wallet. The 30-day hold protects you from refunds being clawed back after you have already been paid.
Can I offer a free first plan and charge in Stars later?
Yes. Coaches set their own price per custom request, and the price can be zero. A free first plan lets a new client see how plans, timers and workout history work in the app. Later requests can be priced in Stars and go through the same escrow and payout schedule as any paid request.
