· AvaGuru · guides · 7 min read

Telegram Stars Payments: Digital Sales, Refunds, and Rewards

Learn when Telegram Stars are required, how confirmed payments trigger delivery, and why buyer prices, merchant balances, and developer rewards differ.

Telegram Stars are Telegram’s payment method for digital goods and services sold inside bots and Mini Apps. If you sell a downloadable guide, template pack, or paid channel membership through a Telegram shop, Stars are the required checkout currency. A successful payment confirms the purchase; fulfillment, customer support, and refunds still need a reliable workflow.

This guide separates Telegram’s payment rules from AvaGuru’s store behavior. Official sources were checked on November 16, 2026. For price estimates, use the existing Telegram Stars calculator, then confirm the amount shown in your actual store checkout.

When must a Telegram shop use Stars?

Telegram’s digital payments guide requires digital goods and services sold within Telegram apps to use Stars exclusively. The rule covers bots and Mini Apps, including businesses that also sell through an external website. Another payment processor or cryptocurrency is not a substitute for Stars in that in-app digital checkout.

Physical goods and services have a separate Telegram payments flow. Do not apply its payment-provider instructions to digital downloads or channel access.

For a creator, common digital offers include:

  • A finished ebook, worksheet, design template, or downloadable course pack.
  • A software license or another digitally delivered entitlement.
  • Recurring access to a private channel or group.

Choose the offer first. The digital downloads guide covers a one-time product, while the paid channel subscription guide covers membership access and renewals.

How a Stars payment becomes a delivered order

Telegram documents a sequence that matters whether you build your own bot or use a Telegram store builder.

  1. Create the order and invoice. A Stars invoice uses the currency code XTR. Telegram permits an empty payment-provider token for Stars. The invoice payload connects the payment to the intended order.
  2. Check the purchase before charging. Telegram sends a pre_checkout_query. The bot must answer within 10 seconds and should confirm that the order can still be fulfilled.
  3. Wait for payment confirmation. Approving pre-checkout is not payment confirmation. Fulfillment must wait for Telegram’s successful_payment update.
  4. Record the charge and deliver. Save the Telegram payment charge ID, match the payment to the order, and provide the purchased file, license, or access. Handling a repeated payment notification must not create a second delivery or duplicate revenue record.
  5. Keep a support trail. Retain the order, payment, and delivery status so a buyer can get help when payment succeeds but delivery encounters a problem.

In AvaGuru, buyers pay the merchant’s own store bot. The product’s delivery mode determines what happens after confirmed payment. For a channel subscription, the first confirmed charge activates access and schedules a personal invitation. Opening an invoice or seeing a checkout screen does not establish membership.

One-time payments and recurring Stars subscriptions

A one-time digital product charges for a defined purchase. A subscription charges for another access period when renewal succeeds.

Telegram’s invoice-link API currently requires a recurring Stars period of 30 days, with a maximum subscription price of 10,000 Stars. Thirty days is not always the same as a calendar month. AvaGuru accepts subscription prices from 1 to 10,000 Stars and uses Telegram’s confirmed payment expiration to update access.

AvaGuru supports buyer subscriptions for eligible stores with a current paid merchant plan and the feature enabled. A real Stars purchase, membership delivery, and automatic 30-day renewal pilot had not yet been verified for this publication. Documented support and implemented renewal handling are not evidence of a completed live renewal cycle.

Refunds, cancellation, and payment support

Telegram requires bots and Mini Apps to handle /paysupport and resolve payment issues. Publish clear purchase terms and a support route before accepting payment. The merchant handles purchase support; Telegram does not take over the fulfillment dispute.

The refundStarPayment method refunds a successful Stars payment using the buyer’s Telegram user ID and the original Telegram payment charge ID. Its parameters do not include a partial-refund amount. Keep those identifiers available rather than relying on a screenshot of a receipt.

A subscription cancellation and a refund have different consequences:

  • Canceling renewal stops future automatic renewals while preserving the paid current period.
  • Refunding a subscription payment in AvaGuru cancels that subscription’s renewal and current entitlement. This also applies when the refunded charge belongs to an earlier period of the same subscription. Another independently entitled subscription to the same chat remains protected.
  • Refunding a downloaded product cannot make a file already saved on the buyer’s device disappear. Write terms that match what you can deliver and control.

For a missing delivery, check the recorded payment and delivery state before asking the buyer to pay again. For a failed refund attempt, resolve its status before issuing another provider request.

Buyer price, Stars balance, and developer rewards are different

A displayed Stars amount is not a guaranteed bank payout. There are several distinct amounts to track:

Amount What it represents
Buyer’s cost to acquire Stars What the buyer pays Telegram or a supported purchase channel; taxes and fees can affect that cost.
Product’s Stars price How many Stars the invoice charges for the product or access period.
Bot’s earned Stars balance Stars received by the merchant bot, subject to refunds, applicable fees, and Telegram’s terms.
Eligible developer reward What eligible earned Stars can be redeemed for under Telegram and Fragment’s current rules.

As checked on November 16, 2026, Telegram’s Bot Developer Terms, section 6.2.4 state 0.013 USD worth of rewards per Star. Telegram sets that reward value independently of the buyer’s purchase cost and may change it. It is not a universal retail exchange rate or a promise of net cash proceeds.

The same terms say earned Stars can remain unavailable for rewards or advertising for up to 21 days. Reward processing is handled by Fragment and depends on its terms and eligibility, including country restrictions. A payment confirmation therefore does not mean that an equivalent cash amount has settled into a merchant’s bank account, and the availability period is not a guaranteed payout deadline.

Telegram also specifies fees for some optional features. For example, its current terms apply a 15% fee to Stars purchases while private-chat topics are enabled for the app. Check the rules for your bot’s configuration rather than assuming every earned Star will be redeemable without deductions. Refunds and payment chargebacks can also reduce a balance.

AvaGuru’s USD-to-Stars product pricing uses a configured fixed fiat anchor. It does not follow a TON or other cryptocurrency market feed. That pricing rule is separate from Telegram’s reward value. Use the Stars calculator as an estimate, not a settlement statement or guaranteed earnings calculation.

What does AvaGuru charge?

AvaGuru earns from merchant SaaS subscriptions and takes no per-sale commission. Your merchant plan pays for the store software. A buyer’s membership subscription pays your store bot for access to your content. These are separate subscriptions with different purposes.

“No AvaGuru per-sale commission” does not mean Telegram purchases, reward redemption, taxes, or other applicable costs disappear. Review AvaGuru pricing alongside Telegram’s current terms. If you are moving a catalog, the Gumroad alternative for Telegram guide explains the storefront choice; transferring an external recurring payment mandate is a separate, unsupported operation.

Before taking the first order

Make the product description, delivery method, Stars price, support route, and refund terms visible. Run a small purchase through your own store, verify the recorded successful payment and actual delivery, and check the refund outcome. For memberships, also verify joining, cancellation, expiry, and renewal behavior over time. A completed checkout alone does not prove every later step works.

Sources

AvaGuru product descriptions in this guide were checked against the current product documentation and implementation. This is a product guide, not a merchant earnings case study.

Back to Blog

Related Posts

View All Posts »