· AvaGuru · tutorials · 8 min read
How to Sell Telegram Channel Subscriptions with Stars
Set up paid channel or group access in AvaGuru and understand the full buyer lifecycle: invitations, renewal, cancellation, grace periods, refunds, and removal.
To sell Telegram channel subscriptions through AvaGuru, connect a private channel or group, create a digital product with Channel / group access, and let buyers subscribe through a recurring Stars invoice. Confirmed payment activates access and schedules a personal invitation. Future confirmed payments extend the membership period.
This guide describes the current documented and implemented workflow. A real Stars purchase, membership delivery, and automatic 30-day renewal pilot had not yet been verified for this publication on November 16, 2026. Follow the setup with a controlled purchase and lifecycle check before depending on it for a large launch.
What you need before setup
Prepare a Telegram store with its own connected bot, a private channel or group you control, and a current paid AvaGuru merchant plan. The buyer-subscriptions feature must also be enabled for the store. The Paid channels page shows whether the required plan and feature are available.
Decide what members receive during each 30-day period. Telegram’s recurring bot invoices currently use 30 days, which does not always equal a calendar month. State the content schedule, price, cancellation policy, and support route in the offer.
AvaGuru’s merchant plan and your buyer membership are separate subscriptions. You pay AvaGuru for store software; a buyer pays your own store bot in Stars for content access. AvaGuru takes no per-sale commission. Telegram’s applicable terms and costs still apply. See the Stars payment guide for the distinction between product pricing and redeemable rewards.
If you still need a storefront, start with the Telegram store builder. If your offer is a finished file rather than ongoing access, use the digital downloads guide.
Step 1: Give the store bot the required permissions
Add your store bot to the private channel or group as an administrator. Give it permission to Invite users and Restrict members. It needs both to deliver access and remove a buyer after entitlement ends.
Keep those permissions in place throughout the membership’s lifetime. Removing the bot or taking away its rights can prevent invitations and removals even if a buyer’s payment state is recorded correctly.
Use an ordinary buyer account for your purchase test. Channel owners and administrators are exempt from automated removal, so an administrator account cannot prove the expiry path works for a normal member.
Step 2: Detect and connect the chat
Open Paid channels in the AvaGuru Admin Portal. A newly added bot can appear there after Telegram sends its membership update. If the bot was already present, enter the chat’s ID in Chat username or ID and choose Detect chat. Detection also accepts an available public @username, but a public channel is not a substitute for a private paid-access boundary.
Check the detected chat title and permissions, then choose Connect. AvaGuru checks the bot’s current Telegram permissions before connecting. Use Refresh to check again after changing rights. The page reports missing permissions or a removed bot so you can correct the setup.
Do not publish a general invitation to the paid chat as your sales link. Share the store product so buyers go through the membership purchase and identity checks.
Step 3: Create the recurring access product
Create a digital product, choose Channel / group access as the delivery mode, and select the connected channel or group. Set the price and explain what a buyer receives for the recurring period.
Current price constraints are:
- Supported store currencies for channel subscriptions are USD and XTR.
- The resulting invoice must be between 1 and 10,000 Stars per 30-day period.
- USD prices use AvaGuru’s configured fixed fiat anchor to calculate Stars. The conversion does not follow a TON or cryptocurrency market feed.
- If the USD anchor is unavailable or the currency is unsupported, a new subscription cannot be created.
Review the calculated Stars amount in the product and buyer checkout. The Stars calculator can help with estimates, but the actual invoice is the amount the buyer authorizes.
Chat-access products do not reserve or decrement stock. Once a product has subscription history, its delivery mode and connected chat cannot change. Create another product if you need to sell access to a different chat.
Step 4: Check purchase and joining as a buyer
Open the store through Telegram using the buyer account, find the product, and choose Subscribe. Telegram opens a recurring invoice. AvaGuru waits for a confirmed payment before activating the subscription and scheduling an invitation.
The bot sends a personal Join link. It has a one-member limit and expires within 24 hours, or sooner if the buyer’s remaining access ends first. Requesting a new invitation revokes the previous one, and link requests are limited to five per hour.
Confirm that the buyer can join the intended chat. In Paid channels → Subscribers, check the product, Telegram user, status, current period end, and joined time. A successful charge without a joined time may mean the buyer has not followed the invitation yet; investigate before asking for another payment.
What happens after the first payment?
| Event | Access behavior in AvaGuru |
|---|---|
| First confirmed charge | Activates the subscription and schedules the personal invitation. |
| Confirmed renewal | Extends the paid period and records the distinct charge as an order and payment. |
| Buyer cancels renewal | Preserves access until the current period ends; there is no additional cancellation grace period. |
| Buyer resumes while eligible | Re-enables renewal before the paid period has ended. |
| Active subscription reaches its end without renewal | Keeps access for a 24-hour grace period, then becomes eligible for expiry and removal. |
| Subscription payment is refunded | Cancels renewal and the current entitlement of that subscription, with removal handled through cleanup. |
Telegram’s subscription API distinguishes canceling future extension from ending the already-paid period. AvaGuru’s 24-hour failed-renewal grace is an application access rule; it is not a promise that Telegram will successfully charge the buyer during that window.
Each distinct confirmed renewal creates a real order and payment. Repeated notifications for the same charge do not count twice. A scheduled renewal is not earned revenue until the payment succeeds.
Cancellation, expiry, and removal are separate steps
Cancellation stops automatic renewal. The buyer can still use the membership until the current paid period ends. For an active subscription with no successful renewal, AvaGuru allows 24 hours of grace. A canceled subscription does not receive that extra day.
A cleanup process scheduled every five minutes identifies expired access and queues membership removal. Removal uses a ban followed by an unban so a future purchaser can rejoin. That schedule is not a guarantee of removal within five minutes: queued work, Telegram errors, or missing bot permissions can delay the action. Failed Telegram operations remain retryable.
Before removing a member, AvaGuru checks for another current entitlement to the same chat within the store. Ending one product must not remove access that the buyer still holds through another subscription. Channel owners and administrators are exempt from removal.
Refunds can end an existing membership immediately
Use the existing admin Stars refund flow for the relevant payment. In AvaGuru, refunding any period of a subscription, including an older renewal, cancels that subscription’s renewal and current entitlement. This is different from a buyer merely canceling the next renewal.
Membership cleanup follows the refund. An independent repurchase or another entitled subscription to the same chat remains protected, but an old charge on the same subscription is not treated as unrelated to today’s access. Check the subscription before refunding a historical period and explain the effect to the buyer.
Ending entitlement does not guarantee an instantaneous Telegram removal. The same permission and retry limits apply. See Telegram Stars payments and refunds for the payment side of the process.
What access control does and does not cover
AvaGuru checks membership updates associated with its stored subscription invitation or subscription alias. If someone forwards that invitation, the joining Telegram identity must have current access; an unauthorized visitor is scheduled for removal. This is an enforcement step after a membership update, not a guarantee that a forwarded link can never be opened or briefly used.
Ordinary invitations unrelated to a subscription are left alone. Existing members, manually shared invite links, or public access should not be assumed to fall under automatic subscription enforcement. Review your other invitations and membership practices before selling access.
The bot also cannot retract screenshots, copied messages, or files a member already downloaded. Describe paid access as access to the private chat, without promising copy protection.
Ongoing operations and migration limits
Keep the bot connected and check its permissions after administrative changes. Subscriber inspection and permission refresh remain available for support even when new subscription setup is unavailable.
A merchant downgrade or feature disablement blocks new setup and new subscriptions, but existing buyer subscriptions are designed to keep receiving renewal processing and access. Downgrading the software plan is not a membership cancellation tool. A chat cannot be disconnected while subscriptions or outstanding membership removals prevent that operation.
AvaGuru does not import InviteMember subscriptions or transfer external recurring payment mandates. Existing buyers need a new Stars subscription for this offer. If you are moving from a catalog platform, see the Gumroad alternative for Telegram and plan the old and new billing dates explicitly to avoid confusing buyers.
Before inviting the wider audience
Verify the first purchase and invitation with an ordinary member account. Check cancellation while paid time remains, expiry after cancellation, the failed-renewal grace behavior, a repurchase, and a refund. Observe a real renewal when its 30-day period is due rather than inferring success from the first charge or an automated test.
Keep the offer’s publishing and support commitments realistic. The creator monetization guide helps compare a recurring membership with a one-time product if the ongoing workload is still uncertain.
Sources and scope
- Telegram: Payments for Digital Goods and Services
- Telegram Bot API: createInvoiceLink and recurring limits
- Telegram Bot API: SuccessfulPayment subscription fields
- Telegram Bot API: editUserStarSubscription
- Telegram Bot API: refundStarPayment
AvaGuru setup, grace, invitation, and removal behavior were checked against current product documentation and implementation. They describe supported behavior, not a claim of completed live renewal testing.