StarsPaymee
Open the bot
Business

Auto‑selling gifts via the Telegram Gifts API

With the Telegram Gifts API sell gifts in a bot or site automatically: catalog, order, anonymous sending, webhook and payment in so‘m/rubles. Full flow and 19 Q&A.

Short answer

The Telegram Gifts API is an interface for automatically selling Telegram gifts in your bot or website. The customer picks a gift and pays, your system sends the order via the API, and the gift is delivered automatically to the @username. StarsPaymee Business provides the Gifts API together with Stars and Premium under one key.

What is the Gifts API?

Telegram Gifts are digital gifts users send to each other. The Gifts API lets you pick gifts from a catalog, create an order and deliver automatically. This fully automates gift selling for resellers and shops.

Gifts API capabilities
  • Catalog — available gifts and their price (in stars).
  • Order — the gift and recipient @username.
  • Anonymous sending and comment options.
  • Webhook — status returns on delivery.
  • Payment — via Click, Payme, card or SBP.

How is a gift sent automatically?

  1. 1. Fetch the catalogVia GET /gifts you fetch available gifts and prices.
  2. 2. Create an orderVia POST /orders you pass gift_id and the recipient @username.
  3. 3. Collect paymentYou collect payment from the customer in your own channel.
  4. 4. Delivery and statusThe gift is sent automatically, and «delivered» arrives via webhook.

Want to automate gift selling? Contact Business.

@StarsPaymee_bot

Related topics

Sell Stars and Premium alongside gifts: Stars API, Premium API. For payment — Click API and SBP API. General — Business.

Sources

Frequently asked questions

What is the Telegram Gifts API?
An API for auto‑selling Telegram gifts in a bot or website. Through StarsPaymee Business it connects together with Stars/Premium.
How is a gift delivered?
The order specifies gift_id and @username; after payment the gift is sent automatically.
How do I get the catalog?
Via GET /gifts you get available gifts and the price in stars.
Can I send anonymously?
Yes. You can choose anonymity in the order.
Can I add a comment?
Yes. There is a comment option for the gift.
Is there a webhook?
Yes. On gift delivery the status arrives at your server.
How is payment?
Via Click, Payme, card or SBP; you accept it in your own channel.
Is the price real‑time?
Yes. The catalog shows the current price in stars.
Is there a reseller price?
Yes. You sell with your own markup.
Is there a Sandbox?
Yes. The flow is tested in a test environment.
Is it in JSON?
Yes. The REST API is in JSON.
Can I send several gifts at once?
Yes. You send many orders in sequence.
Is there a refund?
An undelivered order is refunded per the settlement policy.
Are there collectible gifts?
It depends on the catalog; the list of available gifts is visible via the API.
Can I sell together with Stars and Premium?
Yes. All products through one API.
What about security?
The API key is server‑side; authentication by token.
Is documentation provided?
Yes. With endpoints and examples.
Is there support?
Yes, @StarsPaymeeSupport.
How do I start?
Submit a request on the StarsPaymee Business page.

Automate gift selling

Through StarsPaymee Business, sell gifts automatically — together with Stars and Premium.

Open the bot