2024-02-10 15:29:33 +01:00
<!DOCTYPE html>
< html class = "" >
< head >
< meta charset = "utf-8" >
< title > inputStorePaymentPremiumGiveaway< / title >
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< meta property = "description" content = "Used to pay for a giveaway, see here » for more info." >
< meta property = "og:title" content = "inputStorePaymentPremiumGiveaway" >
< meta property = "og:image" content = "" >
< meta property = "og:description" content = "Used to pay for a giveaway, see here » for more info." >
< link rel = "icon" type = "image/svg+xml" href = "/img/website_icon.svg?4" >
< link rel = "apple-touch-icon" sizes = "180x180" href = "/img/apple-touch-icon.png" >
< link rel = "icon" type = "image/png" sizes = "32x32" href = "/img/favicon-32x32.png" >
< link rel = "icon" type = "image/png" sizes = "16x16" href = "/img/favicon-16x16.png" >
< link rel = "alternate icon" href = "/img/favicon.ico" type = "image/x-icon" / >
< link href = "/css/bootstrap.min.css?3" rel = "stylesheet" >
< link href = "/css/telegram.css?236" rel = "stylesheet" media = "screen" >
< style >
< / style >
< / head >
< body class = "preload" >
< div class = "dev_page_wrap" >
< div class = "dev_page_head navbar navbar-static-top navbar-tg" >
< div class = "navbar-inner" >
< div class = "container clearfix" >
< ul class = "nav navbar-nav navbar-right hidden-xs" > < li class = "navbar-twitter" > < a href = "https://twitter.com/telegram" target = "_blank" data-track = "Follow/Twitter" onclick = "trackDlClick(this, event)" > < i class = "icon icon-twitter" > < / i > < span > Twitter< / span > < / a > < / li > < / ul >
< ul class = "nav navbar-nav" >
< li > < a href = "//telegram.org/" > Home< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
< li class = "hidden-xs" > < a href = "//telegram.org/apps" > Apps< / a > < / li >
< li class = "" > < a href = "/api" > API< / a > < / li >
< li class = "" > < a href = "/mtproto" > Protocol< / a > < / li >
< li class = "active" > < a href = "/schema" > Schema< / a > < / li >
< / ul >
< / div >
< / div >
< / div >
< div class = "container clearfix" >
< div class = "dev_page" >
< div id = "dev_page_content_wrap" class = " " >
< div class = "dev_page_bread_crumbs" > < ul class = "breadcrumb clearfix" > < li > < a href = "/api" > API< / a > < / li > < i class = "icon icon-breadcrumb-divider" > < / i > < li > < a href = "/schema" > TL-schema< / a > < / li > < i class = "icon icon-breadcrumb-divider" > < / i > < li > < a href = "/constructor/inputStorePaymentPremiumGiveaway" > inputStorePaymentPremiumGiveaway< / a > < / li > < / ul > < / div >
< h1 id = "dev_page_title" > inputStorePaymentPremiumGiveaway< / h1 >
< div id = "dev_page_content" > < p > Used to pay for a < a href = "/api/giveaways" > giveaway, see here »< / a > for more info.< / p >
2024-02-14 20:11:08 +01:00
< p > {schema}< / p >
2024-02-10 15:29:33 +01:00
< h3 > < a class = "anchor" href = "#parameters" id = "parameters" name = "parameters" > < i class = "anchor-icon" > < / i > < / a > Parameters< / h3 >
< table class = "table" >
< thead >
< tr >
< th > Name< / th >
< th style = "text-align: center;" > Type< / th >
< th > Description< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td > < strong > flags< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/%23" > #< / a > < / td >
< td > Flags, see < a href = "/mtproto/TL-combinators#conditional-fields" > TL conditional fields< / a > < / td >
< / tr >
< tr >
< td > < strong > only_new_subscribers< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .0?< a href = "/constructor/true" > true< / a > < / td >
< td > If set, only new subscribers starting from the giveaway creation date will be able to participate to the giveaway.< / td >
< / tr >
< tr >
< td > < strong > winners_are_visible< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .3?< a href = "/constructor/true" > true< / a > < / td >
< td > If set, giveaway winners are public and will be listed in a < a href = "/constructor/messageMediaGiveawayResults" > messageMediaGiveawayResults< / a > message that will be automatically sent to the channel once the giveaway ends.< / td >
< / tr >
< tr >
< td > < strong > boost_peer< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/InputPeer" > InputPeer< / a > < / td >
< td > The channel starting the giveaway, that the user must join to participate, that will receive the giveaway < a href = "/api/boost" > boosts< / a > ; see < a href = "/api/giveaways" > here »< / a > for more info on giveaways.< / td >
< / tr >
< tr >
< td > < strong > additional_peers< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .1?< a href = "/type/Vector%20t" > Vector< / a > < < a href = "/type/InputPeer" > InputPeer< / a > > < / td >
< td > Additional channels that the user must join to participate to the giveaway can be specified here.< / td >
< / tr >
< tr >
< td > < strong > countries_iso2< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .2?< a href = "/type/Vector%20t" > Vector< / a > < < a href = "/type/string" > string< / a > > < / td >
< td > The set of users that can participate to the giveaway can be restricted by passing here an explicit whitelist of up to < a href = "/api/config#giveaway-countries-max" > giveaway_countries_max< / a > countries, specified as two-letter ISO 3166-1 alpha-2 country codes.< / td >
< / tr >
< tr >
< td > < strong > prize_description< / strong > < / td >
< td style = "text-align: center;" > < a href = "/mtproto/TL-combinators#conditional-fields" > flags< / a > .4?< a href = "/type/string" > string< / a > < / td >
< td > Can contain a textual description of additional giveaway prizes.< / td >
< / tr >
< tr >
< td > < strong > random_id< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/long" > long< / a > < / td >
< td > Random ID to avoid resending the giveaway< / td >
< / tr >
< tr >
< td > < strong > until_date< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/int" > int< / a > < / td >
< td > The end date of the giveaway, must be at most < a href = "/api/config#giveaway-period-max" > giveaway_period_max< / a > seconds in the future; see < a href = "/api/giveaways" > here »< / a > for more info on giveaways.< / td >
< / tr >
< tr >
< td > < strong > currency< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/string" > string< / a > < / td >
< td > Three-letter ISO 4217 < a href = "/bots/payments#supported-currencies" > currency< / a > code< / td >
< / tr >
< tr >
< td > < strong > amount< / strong > < / td >
< td style = "text-align: center;" > < a href = "/type/long" > long< / a > < / td >
< td > Total price in the smallest units of the currency (integer, not float/double). For example, for a price of < code > US$ 1.45< / code > pass < code > amount = 145< / code > . See the exp parameter in < a href = "/bots/payments/currencies.json" > currencies.json< / a > , it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).< / td >
< / tr >
< / tbody >
< / table >
< h3 > < a class = "anchor" href = "#type" id = "type" name = "type" > < i class = "anchor-icon" > < / i > < / a > Type< / h3 >
< p > < a href = "/type/InputStorePaymentPurpose" > InputStorePaymentPurpose< / a > < / p >
< h3 > < a class = "anchor" href = "#related-pages" id = "related-pages" name = "related-pages" > < i class = "anchor-icon" > < / i > < / a > Related pages< / h3 >
< h4 > < a class = "anchor" href = "#messagemediagiveawayresults" id = "messagemediagiveawayresults" name = "messagemediagiveawayresults" > < i class = "anchor-icon" > < / i > < / a > < a href = "/constructor/messageMediaGiveawayResults" > messageMediaGiveawayResults< / a > < / h4 >
< p > A < a href = "/api/giveaways" > giveaway< / a > with public winners has finished, this constructor contains info about the winners.< / p >
< h4 > < a class = "anchor" href = "#channel-boosts" id = "channel-boosts" name = "channel-boosts" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/boost" > Channel boosts< / a > < / h4 >
< p > Telegram Premium users can grant their favorite channels additional features like the ability to post stories by giving them boosts.< / p >
< h4 > < a class = "anchor" href = "#giveaways" id = "giveaways" name = "giveaways" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/giveaways" > Giveaways< / a > < / h4 >
< p > Telegram channel administrators may launch giveaways to randomly distribute Telegram Premium subscriptions and other gifts among their followers, in exchange for boosts.< / p >
< h4 > < a class = "anchor" href = "#client-configuration" id = "client-configuration" name = "client-configuration" > < i class = "anchor-icon" > < / i > < / a > < a href = "/api/config" > Client configuration< / a > < / h4 >
< p > The MTProto API has multiple configuration parameters that can be fetched with the appropriate methods.< / p >
< h4 > < a class = "anchor" href = "#bot-payments-api" id = "bot-payments-api" name = "bot-payments-api" > < i class = "anchor-icon" > < / i > < / a > < a href = "/bots/payments" > Bot Payments API< / a > < / h4 > < / div >
< / div >
< / div >
< / div >
< div class = "footer_wrap" >
< div class = "footer_columns_wrap footer_desktop" >
< div class = "footer_column footer_column_telegram" >
< h5 > Telegram< / h5 >
< div class = "footer_telegram_description" > < / div >
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/faq" > FAQ< / a > < / li >
< li > < a href = "//telegram.org/privacy" > Privacy< / a > < / li >
< li > < a href = "//telegram.org/press" > Press< / a > < / li >
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#mobile-apps" > Mobile Apps< / a > < / h5 >
< ul >
< li > < a href = "//telegram.org/dl/ios" > iPhone/iPad< / a > < / li >
< li > < a href = "//telegram.org/android" > Android< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Mobile Web< / a > < / li >
< / ul >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps#desktop-apps" > Desktop Apps< / a > < / h5 >
< ul >
< li > < a href = "//desktop.telegram.org/" > PC/Mac/Linux< / a > < / li >
< li > < a href = "//macos.telegram.org/" > macOS< / a > < / li >
< li > < a href = "//telegram.org/dl/web" > Web-browser< / a > < / li >
< / ul >
< / div >
< div class = "footer_column footer_column_platform" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< ul >
< li > < a href = "/api" > API< / a > < / li >
< li > < a href = "//translations.telegram.org/" > Translations< / a > < / li >
< li > < a href = "//instantview.telegram.org/" > Instant View< / a > < / li >
< / ul >
< / div >
< / div >
< div class = "footer_columns_wrap footer_mobile" >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/faq" > About< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/blog" > Blog< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "//telegram.org/apps" > Apps< / a > < / h5 >
< / div >
< div class = "footer_column" >
< h5 > < a href = "/" > Platform< / a > < / h5 >
< / div >
< div class = "footer_column" >
2024-02-14 20:11:08 +01:00
< h5 > < a href = "https://twitter.com/telegram" target = "_blank" data-track = "Follow/Twitter" onclick = "trackDlClick(this, event)" > Twitter< / a > < / h5 >
2024-02-10 15:29:33 +01:00
< / div >
< / div >
< / div >
< / div >
< script src = "/js/main.js?47" > < / script >
< script > b a c k T o T o p I n i t ( " G o u p " ) ;
removePreloadInit();
< / script >
< / body >
< / html >
