Writing a refund policy for your Telegram Stars bot: template and examples
What a refund policy for a Telegram Stars bot should cover: eligibility, time window, /paysupport and refundStarPayment, plus sample wording you can adapt.
Published:

Writing a refund policy for your Telegram Stars bot means answering four questions in plain words: who can get a refund, for what, within what time, and how to ask. Put the policy where users can find it before they pay, connect it to your /paysupport command, and apply it the same way every time. Below is a structure, sample wording and advice on handling disagreements politely.
Short answer in plain words
A refund policy is a short public text that tells buyers what happens if a purchase goes wrong. In Telegram bots that sell digital goods for Stars, refunds are made by the bot owner with the Bot API method refundStarPayment, which returns the Stars to the buyer's balance. Telegram expects bots that accept payments to offer support through /paysupport, and its developer terms apply to every bot. The general refund rules for buyers are explained in our /paysupport and refund guide; this article is about the text you, the developer, publish.
A good policy protects both sides. Buyers know what to expect, and you have a fair, written rule to point to when a request does not fit.
How it works: the parts of a policy, with an example
Most good policies cover the same six parts. Keep each one to one or two sentences.
| Part | What to say | Example wording |
|---|---|---|
| Scope | Which products the policy covers | "This policy applies to all purchases made in this bot with Telegram Stars." |
| Eligibility | When a refund is normally given | "If you paid and did not receive the item, or the item did not work as described." |
| Exclusions | When a refund is normally not given | "Items that were delivered and fully used, such as completed generations." |
| Time window | How long buyers have to ask | "Please contact us within the number of days stated here after purchase." |
| How to ask | The exact steps | "Send /paysupport, describe the problem and include your order number." |
| Outcome | What happens next | "Approved refunds are returned as Stars to the balance you paid from." |
A short template you can adapt
Refund policy. This policy covers purchases made in this bot with Telegram Stars. If you paid but did not receive your item, or the item does not work as described, send /paysupport within [your time window] of the purchase. Tell us your order number and what went wrong. We reply within [your response time]. If we approve a refund, the Stars go back to your Telegram balance. Items that were delivered and used in full are normally not refundable, except where required by Telegram's rules. If something is unclear, write to us through /paysupport before you buy.
Replace the parts in square brackets with your own numbers. Choose a time window and response time you can really keep, because users will hold you to them.
What it means for you as a developer
- Make it visible. Link the policy in the bot description, in a
/termsor help command, and in the message shown before the invoice. - Connect it to your data. Store the
telegram_payment_charge_idfrom eachsuccessful_paymentupdate. You need it, together with the user ID, to callrefundStarPayment. - Keep a log. Record each request, the decision and the reason. A log keeps decisions consistent when several people answer support.
- Write for translation. If your bot speaks several languages, translate the policy too. Short, simple sentences translate better.
Handling disputes politely
Some requests will fall outside the policy. Answer calmly, quote the relevant line, and explain what you can offer instead, such as re-delivering the item or fixing the problem. If you decide to make an exception, say it is a one-time decision so it does not become an expected rule. Never argue in public chats; move the conversation to private support.
Common misconceptions
- "Digital goods are never refundable." Your policy can limit refunds, but it cannot override Telegram's rules or remove support duties. Read the official terms linked below.
- "A refund policy invites abuse." A clear policy usually reduces disputes, because it sets expectations before payment. Abuse is better handled with logging and limits.
- "I can refund in another currency." A Stars payment is refunded in Stars through the Bot API, not in money.
- "Long legal text is safer." Users rarely read long text. A short, honest policy is easier to follow for both sides. For legal questions, consult a qualified professional.
Practical next steps
- Write your policy with the six parts above and keep it under about 150 words.
- Add a
/paysupporthandler that asks for the order number and problem description. - Store charge IDs and test a refund in a test environment before going live.
- Show a link to the policy next to every price, and review the text whenever your products change.
For the full payment flow, see Telegram Stars invoices (XTR) for developers. If you sell Stars or Premium yourself through an API, the PayStars API documentation explains how failed orders are returned to the balance automatically.
FAQ
Do Telegram bots have to offer refunds?
Bots that accept payments must provide support through /paysupport and follow Telegram's terms for developers and Stars. Your policy describes how you handle requests within those rules.
How do I refund Stars to a user?
Call the Bot API method refundStarPayment with the user's ID and the telegram_payment_charge_id from the original successful_payment update. The Stars return to the user's balance.
Where should I publish my refund policy?
Put it in the bot description or a help or terms command, and link it in the message that appears before the invoice so users see it before they pay.
What time window should a refund policy have?
Choose a window that fits your product and that you can actually honour. Short, clear windows are easier to apply consistently.
Can I refuse a refund request?
Yes, if the request falls outside your published policy and Telegram's rules allow it. Explain the reason politely and offer help such as re-delivery where possible.
Sources
Buy Stars and Premium with USD (USDT)
Via API key: 0% (plain Fragment price). Via the website: 5%.
More news
What happens to your Telegram Stars if you lose access to your accountStars belong to your Telegram account, not your phone. Learn what happens to them when you lose access, how to get back in, and how to protect your balance.Read →
Keeping records of Telegram Stars revenue as a creator or businessHow to keep clean records of Telegram Stars revenue: what to log, tracking Fragment withdrawals, separating personal and business, and what to ask an accountant.Read →
How to price digital goods in Telegram Stars: a framework for bot developersA practical framework to price digital goods in Telegram Stars: cost, value and market checks, test prices and how buyers' cost of Stars affects sales.Read →