TgSuperstars Partner is a wholesale supplier of Telegram Stars and Premium with a REST API for shops, bots and resellers. Orders run from 50 to 50,000 stars or a 3-, 6- or 12-month Premium subscription, delivered to the recipient's username, usually within minutes. The wholesale price is the same for every partner and well below our own retail price.
Joining is free. The first top-up starts at 10 USDT, later ones from 5; the money stays in your account and pays for your orders.
Three ways to sell, one integration. Your storefront, chat bot and website all pull from the same catalog, and the price is the same for all three.
Your Telegram Stars shop runs without inventory and without a TON wallet of your own: we carry the exchange-rate risk. The moment a customer pays, the order goes straight into fulfillment. What's left for you is the look of the storefront and the price tag.
The customer gives a username and pays inside your bot — from there, delivering the stars is on us. The delivery logic stays on our side, so there's no hunting for someone else's source code. Even if you build a Telegram Stars bot from scratch, the selling part is exactly two API calls.
You already sell something — add stars to it with a single REST call: on your site, in a customer's account area, in an agency panel. The same call sells Telegram Premium too: instead of a number of stars, the request carries a term — three months, six months or a year.
Send a username and you get back the name from the profile; for Premium the response also says whether the person already has a subscription. It's hard to get the recipient wrong: your customer sees which account the stars will go to.
The balance is charged at this step. If the network fails you and the request goes out twice, the same key returns the first order and nothing is charged a second time.
The X-Signature header carries an HMAC-SHA256 of the body signed with your secret, so tampering shows up immediately. Webhook didn't arrive? Then you request the status by order number.
Set up your dashboard, add at least 10 USDT to your balance, create an API key and place your first order. You don't need code to start: buy by hand in the dashboard and leave the integration for later.
One figure for every partner. Work out your own margin with the calculator on the right.
The price doesn't depend on your volume, your history with us or how well you negotiate: it's the same for every partner and it's recalculated as the market moves. Settlement is in USDT, so no local currency rate goes into the price.
There are no tiers, no volume thresholds, no personal discounts and no haggling. You can see stars and Premium prices as soon as you sign in to the dashboard — on the first screen, before you click "Become a partner" or pay anything; once you've topped up, you'll find the same up-to-date prices in the Buy section and the API catalog.
The current price list for Telegram Stars and the three subscription plans lives in the catalog with your prices. Wholesale Telegram Stars are available right after your first top-up: the minimum order is 50 stars, and the total scales with the quantity.
To work out your markup, start from our own retail price for stars — what end customers pay per star on our site. The gap between that number and your wholesale cost is your margin, and it's yours to use however you like.
Now and then the price is unavailable for a minute. The catalog then answers plainly that we're "not selling right now", and the order is refused: selling at an unknown price is a bad idea for both sides.
A rough estimate: the default $0.016 per ★ is a placeholder, not our price. Take your cost from the dashboard; what you charge is yours to set. Your margin is the gap between the two.
Your balance is charged the partner price for the order — the same one everyone pays. The difference is yours to keep, whether it sits on your storefront or in a price list for a client. Everything between your price and your cost stays with you in full.
The customer pays you, through your own payment methods — card processing, bank transfers, crypto, whatever you've set up. Only the wholesale part reaches us: the partner price comes off your prepaid balance, and everything above it is yours.
The balance works as prepayment and you top it up with a USDT transfer — the payment details are in your dashboard, and crediting is automatic. It's spent on orders only; if a delivery fails, the charge comes back to the same place.
Telegram Stars from 50 to 50,000 per order. No fixed denominations: whatever number of stars you put in the request is what gets billed, at the price per star.
Premium for three months, six months or a year. It's ordered by username with the same call as stars: no separate integration for subscriptions.
You issue the key yourself. Click "create" in the dashboard and you get a pk_live_…; no account manager is involved. If you want, the key can be restricted to a list of IPs.
The limits are stated up front. 120 requests per minute per key and bursts of up to 30 — the numbers are published, not discovered under load in production.
A refusal instead of a wait. If the balance is short, the order is rejected at once instead of waiting for a top-up.
Refunds and retries. If delivery doesn't go through, the order amount is refunded to your balance automatically; if a transfer went out but wasn't confirmed, we decide after a manual check. If the delivery network drops out, orders wait for it and go out later.
The documentation is public. Methods, error codes and the OpenAPI spec are all out in the open: you can size up the integration before you pay anything.
Fragment exposes nothing to the outside — no credentials, no method reference, no test environment. There's no public API for buying stars or Premium there. And the "Fragment API" results you find in search are third-party services, not something Telegram publishes.
Doing that yourself means opening a wallet, keeping a TON buffer in it against rate swings, watching over delivery and patching it every time the messenger changes something on their side. While you patch, sales stop.
We've already done that work and we run the machinery ourselves. Behind your storefront there's a real Telegram Stars and Premium supplier, not a homemade script: on your side it's an HTTP call and a prepaid account. Treat that as the Telegram Stars and Premium API. A detailed walkthrough with methods and parameters is in the article on the Telegram Stars API.
The audience is already there and delivery runs itself — all the storefront has to do is turn subscribers into buyers.
The commission the marketplace used to take becomes your margin as soon as the customer comes to you directly.
One predictable interface instead of buying by hand from middlemen: your clients' orders go out right away, with no chat threads in between.
Reselling stars takes no inventory and no couriers — you need a storefront and a price tag. The partner program is open, with no application to fill in: sign in, top up and you're ready to go.
Predictable REST: idempotent orders, status webhooks, a catalog with your prices. Methods, error codes and the OpenAPI spec are open before you connect.
curl -X POST https://pay.tgsuperstars.com/api/partner/v1/orders \ -H "Authorization: Bearer pk_live_..." \ -d '{ "type": "stars", "params": { "quantity": 100, "recipient": "username" }, "idempotency_key": "a1b2c3" }'
There's no entry fee. The only outlay is the first top-up of your prepaid balance, from 10 USDT; later ones start at 5 USDT. That money stays yours instead of turning into a fee for us: your orders are paid from it.
No. TgSuperstars Partner is a wholesale program: you buy stars and Premium from us over an API and resell them. Telegram's own affiliate program for bots and mini apps is separate, and so is the referral program of our retail site tgsuperstars.com. TgSuperstars is an independent service and is not affiliated with Telegram.
We're a Telegram Stars supplier with the price list in the API: one price for every partner, no haggling and no "special terms", recalculated as the market moves. You can see it on the dashboard's first screen as soon as you sign in (before you click "Become a partner"); after your first top-up it's in the Buy section and the API catalog, and each order locks in the price at the moment it's created.
Yes. A dashboard, an API key and money on your prepaid account are enough — we don't ask for a contract or company details.
That's the whole point: you buy at the wholesale price, retail is your call, and there's no ceiling on what you earn. How to count revenue and what eats into your margin is covered in the article on building a bot that sells stars.
No. Delivery is entirely on our side: your code creates an order and listens for a webhook. You won't need delivery plumbing of your own or somebody else's source code — we went through the code of three public builds and showed what's missing from them.
No. The Bot API has no method for buying stars for real money and sending them to another user. A bot can gift Premium with giftPremiumSubscription, but it pays in stars from its own balance — 1,000 for 3 months, 1,500 for 6, 2,500 for 12 — and there's no API method for buying stars to top up that balance either. That's why shops buy stars and Premium from a supplier: we deliver them to the recipient's username and charge your prepaid balance.
You can't: Fragment issues no programmatic access — no tokens, no method reference. Services that call themselves a "Fragment API" are third-party; Telegram doesn't publish them. What we put there instead is a request and a prepaid balance.
The order amount is refunded to your balance automatically, and the final status arrives in a webhook. If a transfer went out but delivery wasn't confirmed, we check the order by hand: if it arrived, we mark it completed; if not, we refund it.
Not with the same idempotency key. You get the first order back and you're charged only once, so a retry after a timeout is safe.
Telegram Stars, Premium for three months, six months or a year, and NFT gifts — collectible Telegram gifts paid from a separate NFT balance in TON.
The order is still accepted and charged right away, and the new subscription starts automatically when the current one expires; if it still hasn't gone through within 365 days, the amount is refunded to your balance automatically. While that order is pending, a second one for the same account is rejected, and a pending order can only be cancelled through support. If you order over the API and would rather not wait, call validate/recipient first: for Premium it returns already_premium.
No, it's prepayment for goods: it's spent on orders. If an order fails, its amount returns to your balance.
Usually within minutes: the stars are credited to the recipient's account and show up in Telegram itself. Either way, the final status comes in a webhook.
Prices show as soon as you sign in, the API key after your first top-up, and the documentation is already public. The rest is your storefront and your markup.