StarsPaymee
Open the bot
Business

What is the Telegram Stars API and how to connect? (2026)

The Telegram Stars API is a REST/JSON API for auto‑selling Stars, Premium and Gifts. How it works, who it's for and how to connect via StarsPaymee Business — a full guide and 27 Q&A.

Short answer

The Telegram Stars API is a programmatic interface for selling Telegram Stars, Premium and Gifts automatically. With StarsPaymee Business you get a REST/JSON key and connect it to your bot or website: an order is created, payment is collected, and Stars are delivered to the @username automatically in about 5 seconds.

What is the Telegram Stars API?

The Telegram Stars API is a software bridge that lets your app (a bot, Mini App or website) send requests to the StarsPaymee system and automatically sell Telegram Stars, Premium and Gifts. In short: a customer pays you, and your system tells StarsPaymee via the API to «deliver N stars to this user» — delivery then happens automatically.

Key facts
  • Format — REST API, requests and responses in JSON.
  • Products — Stars, Premium, Gifts, plus Click and SBP (RUB) payments.
  • Delivery — by @username, in ~5 seconds, without a password.
  • Webhook — your server is notified when an order status changes.
  • Sandbox — a test environment with no real money.

How does the API work?

Three parties are involved: the customer, your system and the StarsPaymee API. The customer picks a product in your bot or site, you collect payment, then you send the order to the API. StarsPaymee performs delivery on the Telegram side and returns the result via webhook.

  1. 1. Get your API keyRegister with StarsPaymee Business and receive your API key (token). The key authenticates each request.
  2. 2. Fetch prices and catalogUse GET /products to fetch current prices, packages and available products.
  3. 3. Create an orderIn the POST /orders request you pass the product, amount and recipient @username.
  4. 4. Track the statusVia webhook or GET /orders/{id} you check the order state (pending → delivered).

Want to connect the API or learn the price? Contact Business.

@StarsPaymee_bot

Who is it for?

Bot owners

Add Stars/Premium selling to your Telegram bot and fully automate sales.

Resellers & shops

Set your own price and resell Stars and Premium — settlement happens on the API side.

Websites

Pass the order from your site checkout to the API and deliver automatically.

White Label projects

A full platform under your own brand — StarsPaymee API runs on the backend.

How can you connect?

To connect, open the StarsPaymee Business page and submit a request. After sign‑up the API key is issued quickly and you can start testing in the Sandbox right away. For integration questions, @StarsPaymeeSupport will help. See also: Premium API, Click API and SBP (RUB) API.

Sources

Frequently asked questions

What is the Telegram Stars API?
An API for automatically selling Telegram Stars, Premium and Gifts. With StarsPaymee Business you get a key and connect it to your bot or website.
How long does it take to get the API?
After sign‑up and approval, API keys are issued very quickly and you can start integrating right away.
How much does the API cost?
The StarsPaymee Business API is offered at one of the lowest prices on the market. Special tariffs exist for resellers and high‑volume clients.
What can I sell through the API?
Telegram Stars, Telegram Premium, Telegram Gifts, plus Click and SBP (RUB) payments.
Is the API in JSON?
Yes. The REST API works in JSON — both request and response are JSON.
Is there a webhook?
Yes. When an order status changes (for example delivered) your server receives a notification.
Is there a Sandbox?
Yes. You can fully test the integration in a sandbox with no real money.
Is there a rate limit?
Yes. There are reasonable request limits; for large clients the limit is raised.
Is there White Label?
Yes. You can build a platform under your own brand, with the StarsPaymee API on the backend.
Can I become a reseller?
Yes. You set your own price and resell; settlement and delivery are automated on the API side.
Is support 24/7?
Yes. There is support for integration and operational questions — @StarsPaymeeSupport.
How is the API key protected?
The key must be kept server‑side only; each request is authenticated with a token. Never put the key in the client browser.
How are Stars delivered?
Directly to the @username from the order, in ~5 seconds, without a password or SMS.
Is Premium also via API?
Yes. Premium can be sold by username (3/6/12 months) or via login through the API.
Are Gifts sent via API?
Yes. You pick a gift from the catalog and create an order with the recipient's username.
What if an order fails?
If delivery is impossible for a technical reason, the order becomes failed and is refunded per the settlement policy.
Do I collect payment myself?
Yes, you collect payment in your own channel (Click, Payme, card), then deliver via the API. SBP/Click integrations are also available.
Are prices updated via API?
Yes. Through GET /products you fetch current prices and packages in real time.
Can I send to multiple usernames?
Yes. Each order specifies the target username; you can send many orders in sequence.
Is documentation provided?
Yes. After connecting you receive documentation with endpoints, examples and the webhook format.
Which programming language is needed?
Any — PHP, Python, Node.js, Go and others. Any environment that can send HTTP requests works.
What is the minimum order?
The minimum depends on the product; for Stars, for example, the smallest package starts at 50 stars.
Do I need to prefund a balance?
A reseller deposit model is often used; terms depend on the tariff and are agreed with Business.
Is there API statistics?
Yes. Order history and statuses are available via a request or in the panel.
Do I need a foreign card?
No. In Uzbekistan it works with local cards and Click/Payme in so‘m; for rubles there is an SBP integration.
Is integration complex?
No. Usually a few endpoints (products, orders, status) and one webhook are enough; with examples the connection is fast.
How do I start?
Submit a request on the StarsPaymee Business page, get the key and docs, test in Sandbox and switch to live.

Ready to connect the API?

Get your API key via StarsPaymee Business — Stars, Premium, Gifts, Click and SBP in one place.

Open the bot