What you can build with it
Four ways to use Telegram Stars and Premium, each with a piece of what you see.
01Telegram Stars
Reward people inside a bot or mini app
Sending Stars by hand, one username at a time, stops working at the first campaign.
Your bot places one order for each winner, with their username and how many Stars. Your system is told when each one arrives.
Telegram Stars500 Stars to @nasfam_test_ok
order.succeeded
02Telegram Stars
Sell Stars in your own store
A customer pays you first, and the Stars must reach the account they named.
Quote the order to check the recipient and fix the price, take your customer's payment, then place the order before the quote ends, up to 60 seconds later.
Telegram StarsQuote for 500 Stars
- @nasfam_test_ok can receive it
- Price held for up to 60 seconds
03Telegram Premium
Gift Premium to members
A gift has to reach the right account for the right term, and you need to know it arrived.
Send one order with a username and a term. An account that cannot receive Premium is refused before anything is set aside.
Telegram Premium3 months of Premium to @nasfam_test_ok
order.processing
04Telegram Premium
Loyalty rewards in a wallet or fintech app
A reward must be given once, even when a request times out and your system sends it again.
Each reward carries its own key, so a retry returns the first order instead of placing a second.
Telegram Premium- First request
Idempotency-Key: reward-7f3aOrderord_…000002placed - Same request again
Idempotency-Key: reward-7f3aOrderord_…000002returned, not placed again
Create your Nasfam Business account.
Manage your API services, business transactions and account balance in one place.
