![]()
Telegram Stars API and Telegram Premium API
Digital commerce APIs for businesses
The Telegram Stars API and the Telegram Premium API let you sell and deliver digital products from your own app, bot or store, and see every order through to its end.
- 01Your customerPays you
Your customer pays you and names the Telegram account to receive it.
- 02Your app, bot or storeAsks for a quote
A quote checks the recipient and fixes the price.
- 03Nasfam BusinessSets it aside
The order sets the amount aside and runs.
- 04Your customerReceives it
Stars or Premium reach the account your customer named.
- 05Your app, bot or storeHears the result
A signed event tells your system the result.
Priced per order, in USD.
The problem it solves
A digital product is simple to sell and slow to deliver by hand.
Delivery by hand
Buying Stars or Premium one username at a time stops working at your first campaign.
The right account
A customer pays you first, and the product must reach the account they named.
An answer for every order
Without a status and an event, your team learns what happened when a customer asks.
Digital Commerce APIs
Digital-product fulfilment with one order shape for every product we serve.
Telegram Stars API
Reward people or sell Stars inside your own product. A quote checks who receives them and fixes the price first.
Telegram Stars APISample Quote for 500 Stars
- @nasfam_test_ok can receive it
- Price held for up to 60 seconds
Telegram Premium API
Gift a term of Premium to the right account. An account that cannot receive it is refused before anything is set aside.
Telegram Premium APISample 3 months of Premium to @nasfam_test_ok
order.processingOrder management
Create, list and read every order. A retry with the same key returns the first order instead of placing a second.
Orders and statusesSample - First request
Idempotency-Key: reward-7f3aOrderord_…000002placed - Same request again
Idempotency-Key: reward-7f3aOrderord_…000002returned, not placed again
- First request
Delivery status and webhooks
A status on every order and a signed event at every change, so your system knows the result without asking.
WebhooksSample 500 Stars to @nasfam_test_ok
order.succeeded
Who it is for
- Bots and mini apps that reward people with Stars or Premium.
- Stores that sell digital products to their own customers.
- Wallets and fintech apps that run loyalty or gifting.
How to begin
- Open your Nasfam Business account with your email.
- Fund your account with crypto.
- Create an API key and place your first order.
See every call an order makes.
Quotes, orders, statuses and signed events, each documented with examples.
