Info about the current Telegram Star subscriptions, balance and transaction history ».
payments.starsStatus#bbfa316c flags:# balance:long subscriptions:flags.1?Vector<StarsSubscription> subscriptions_next_offset:flags.2?string subscriptions_missing_balance:flags.4?long history:flags.3?Vector<StarsTransaction> next_offset:flags.0?string chats:Vector<Chat> users:Vector<User> = payments.StarsStatus;| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| balance | StarsAmount | Current Telegram Star balance. |
| subscriptions | flags.1?Vector<StarsSubscription> | Info about current Telegram Star subscriptions, only returned when invoking payments.getStarsTransactions and payments.getStarsSubscriptions. |
| subscriptions_next_offset | flags.2?string | Offset for pagination of subscriptions: only usable and returned when invoking payments.getStarsSubscriptions. |
| subscriptions_missing_balance | flags.4?long | The number of Telegram Stars the user should buy to be able to extend expired subscriptions soon (i.e. the current balance is not enough to extend all expired subscriptions). |
| history | flags.3?Vector<StarsTransaction> | List of Telegram Star transactions (partial if next_offset is set). |
| next_offset | flags.0?string | Offset to use to fetch more transactions from the transaction history using payments.getStarsTransactions. |
| chats | Vector<Chat> | Chats mentioned in history. |
| users | Vector<User> | Users mentioned in history. |
Fetch Telegram Stars transactions.
The inbound and outbound flags are mutually exclusive: if none of the two are set, both incoming and outgoing transactions are fetched.
Obtain a list of active, expired or cancelled Telegram Star subscriptions ».
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.