Describes a Telegram Premium subscription option
premiumSubscriptionOption#b6f11ebe flags:# current:flags.1?true can_purchase_upgrade:flags.2?true months:int currency:string amount:long bot_url:string store_product:flags.0?string = PremiumSubscriptionOption;
Name | Type | Description |
---|---|---|
flags | # | Flags, see TL conditional fields |
current | flags.1?true | Whether this subscription option is currently in use. |
can_purchase_upgrade | flags.2?true | Whether this subscription option can be used to upgrade the existing Telegram Premium subscription. When upgrading Telegram Premium subscriptions bought through stores, make sure that the store transaction ID is equal to transaction , to avoid upgrading someone else's account, if the client is currently logged into multiple accounts. |
transaction | flags.3?string | Identifier of the last in-store transaction for the currently used subscription on the current account. |
months | int | Duration of subscription in months |
currency | string | Three-letter ISO 4217 currency code |
amount | long | Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145 . See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). |
bot_url | string | Deep link used to initiate payment |
store_product | flags.0?string | Store product ID, only for official apps |
Telegram clients must handle special tg:// and t.me deep links encountered in messages, link entities and in other apps by registering OS handlers.