Send an offer to purchase a collectible gift », see here » for the full flow.
اسکیمای روش از لایه 220 در دسترس است. تغییر »
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| peer | InputPeer | Owner of the collectible gift: equal to starGiftUnique.owner_id. |
| slug | string | Identifier of the collectible gift: equal to starGiftUnique.slug. |
| price | StarsAmount | Offer price, in stars or TON. |
| duration | int | Duration of the offer, in seconds: must be one of 21600, 43200, 86400, 129600, 172800, or 259200; can also be 120 in test mode. |
| random_id | long | Random 64-bit identifier used to avoid sending the same offer twice in case of network issues. |
| allow_paid_stars | flags.0?long | If the destination peer has paid messages » enabled, specifies the amount of Telegram Stars the sending user has agreed to pay in order to send the offer (in addition to the amount for the offer itself, contained in price). |
| Code | Type | Description |
|---|---|---|
| 400 | INPUT_STARS_AMOUNT_INVALID | |
| 400 | INPUT_STARS_NANOS_INVALID | |
| 400 | INVOICE_INVALID | The specified invoice is invalid. |
| 400 | PEER_ID_INVALID | The provided peer id is invalid. |
| 400 | RESELL_STARS_TOO_FEW | |
| 400 | RESELL_STARS_TOO_MUCH | |
| 400 | STARGIFT_OFFER_INVALID | |
| 400 | STARGIFT_OFFER_NOT_ALLOWED | |
| 400 | STARGIFT_SLUG_INVALID | The specified gift slug is invalid. |
Represents a collectible star gift, see here » for more info.
The sticker that represents the gift is contained in a starGiftAttributeModel object in attributes.
Telegram Stars can be used to pay for sending messages to users, supergroups and channels that have configured paid messages, requiring a payment for every message sent to them.
Telegram Stars are virtual items that allow users to purchase digital goods and services from bots and mini apps inside the Telegram ecosystem, send gifts to content creators on the Telegram platform, and more.
Users can send Gifts to their friends. The recipients of gifts can display them on their profile pages or turn them into Telegram Stars ». Telegram Stars can be used for many things, including supporting creators and buying services in mini apps.