Guide · Telegram Stars

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: template and examples

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.

PartWhat to sayExample wording
ScopeWhich products the policy covers"This policy applies to all purchases made in this bot with Telegram Stars."
EligibilityWhen a refund is normally given"If you paid and did not receive the item, or the item did not work as described."
ExclusionsWhen a refund is normally not given"Items that were delivered and fully used, such as completed generations."
Time windowHow long buyers have to ask"Please contact us within the number of days stated here after purchase."
How to askThe exact steps"Send /paysupport, describe the problem and include your order number."
OutcomeWhat 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 /terms or help command, and in the message shown before the invoice.
  • Connect it to your data. Store the telegram_payment_charge_id from each successful_payment update. You need it, together with the user ID, to call refundStarPayment.
  • 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

  1. Write your policy with the six parts above and keep it under about 150 words.
  2. Add a /paysupport handler that asks for the order number and problem description.
  3. Store charge IDs and test a refund in a test environment before going live.
  4. 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%.

Get started