diff --git a/data/web/corefork.telegram.org/api/payments.html b/data/web/corefork.telegram.org/api/payments.html index fe062fbf68..b0577b9859 100644 --- a/data/web/corefork.telegram.org/api/payments.html +++ b/data/web/corefork.telegram.org/api/payments.html @@ -104,6 +104,7 @@ You can also attach an inline keyboard to the message using the reply_mark

The user receives an invoice deep link or an updateNewMessage constructor from the bot, containing a messageMediaInvoice constructor with basic info about the product.

For invoice messages, the message will also have a replyInlineMarkup keyboard attached to it. The first button of the keyboard will always be a keyboardButtonBuy button.

+

Pass XTR as currency to request payment in Telegram Stars.

2.2 Getting invoice info about the product

inputStorePaymentPremiumGiveaway#160544ca flags:# only_new_subscribers:flags.0?true winners_are_visible:flags.3?true boost_peer:InputPeer additional_peers:flags.1?Vector<InputPeer> countries_iso2:flags.2?Vector<string> prize_description:flags.4?string random_id:long until_date:int currency:string amount:long = InputStorePaymentPurpose;
 inputStorePaymentPremiumGiftCode#a3805f3f flags:# users:Vector<InputUser> boost_peer:flags.0?InputPeer currency:string amount:long = InputStorePaymentPurpose;
@@ -156,7 +157,7 @@ See the stars » documentation for more in
 The payment form also contains info about previously saved payment credentials and order information (name, phone number, email, shipping address & so on).

The full invoice contains info about the information required for the order, the price and the currency, and whether this is a test order. The recurring flag will be set for recurring payments, and recurring_terms_url will link to the terms of service of the recurring payment: the user must read and accept them before continuing.

-

A payments.paymentFormStars will be returned if the payment is to be made using Telegram Stars, see here » for more info (note that this constructor is used for payments in Telegram Stars to bots and peers, it will not be returned when topping up the Telegram Star balance of the current account using inputInvoiceStars).

+

A payments.paymentFormStars will be returned if the payment is to be made using Telegram Stars, see here » for more info (note that this constructor is used for payments in Telegram Stars to bots and peers, it will not be returned when topping up the Telegram Star balance of the current account using inputInvoiceStars): the associated invoice will use XTR as currency.

2.3 Verifying information

invoice#5db95a15 flags:# test:flags.0?true name_requested:flags.1?true phone_requested:flags.2?true email_requested:flags.3?true shipping_address_requested:flags.4?true flexible:flags.5?true phone_to_provider:flags.6?true email_to_provider:flags.7?true recurring:flags.9?true currency:string prices:Vector<LabeledPrice> max_tip_amount:flags.8?long suggested_tip_amounts:flags.8?Vector<long> terms_url:flags.10?string = Invoice;
 
diff --git a/data/web/corefork.telegram.org/api/stars.html b/data/web/corefork.telegram.org/api/stars.html
index 587eb8e55b..2f7150b064 100644
--- a/data/web/corefork.telegram.org/api/stars.html
+++ b/data/web/corefork.telegram.org/api/stars.html
@@ -95,7 +95,7 @@ To return all star transactions » (
 payments.sendStarsForm#02bb731d flags:# form_id:long invoice:InputInvoice = payments.PaymentResult;
 
 payments.refundStarsCharge#25ae8f4a user_id:InputUser charge_id:string = Updates;
-

The full flow to follow to make purchases using Telegram Stars is described along the traditional payment flow in the payments documentation ».

+

The full flow to follow to make purchases using Telegram Stars is described along the traditional payment flow in the payments documentation »: all invoices and constructors working with currency amounts will use the currency code XTR, and the amounts will be in Telegram Stars.

diff --git a/data/web/corefork.telegram.org/constructor/botInlineMessageMediaInvoice.html b/data/web/corefork.telegram.org/constructor/botInlineMessageMediaInvoice.html index bc2acf6342..e2aaecf889 100644 --- a/data/web/corefork.telegram.org/constructor/botInlineMessageMediaInvoice.html +++ b/data/web/corefork.telegram.org/constructor/botInlineMessageMediaInvoice.html @@ -99,7 +99,7 @@ currency string -Three-letter ISO 4217 currency code +Three-letter ISO 4217 currency code, or XTR for Telegram Stars. total_amount @@ -116,7 +116,9 @@

Type

BotInlineMessage

Related pages

-

Bot Payments API

+

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/constructor/invoice.html b/data/web/corefork.telegram.org/constructor/invoice.html index e7e0af4288..160190cb24 100644 --- a/data/web/corefork.telegram.org/constructor/invoice.html +++ b/data/web/corefork.telegram.org/constructor/invoice.html @@ -146,7 +146,9 @@

Type

Invoice

Related pages

-

Bot Payments API

+

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/constructor/messageActionPaymentSent.html b/data/web/corefork.telegram.org/constructor/messageActionPaymentSent.html index de19ac371d..c4028bdf87 100644 --- a/data/web/corefork.telegram.org/constructor/messageActionPaymentSent.html +++ b/data/web/corefork.telegram.org/constructor/messageActionPaymentSent.html @@ -102,6 +102,8 @@

MessageAction

Related pages

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

Deep links

Telegram clients must handle special tg:// and t.me deep links encountered in messages, link entities and in other apps by registering OS handlers.

Client configuration

diff --git a/data/web/corefork.telegram.org/constructor/messageActionPaymentSentMe.html b/data/web/corefork.telegram.org/constructor/messageActionPaymentSentMe.html index 8eb384c38d..d56c63f62e 100644 --- a/data/web/corefork.telegram.org/constructor/messageActionPaymentSentMe.html +++ b/data/web/corefork.telegram.org/constructor/messageActionPaymentSentMe.html @@ -84,7 +84,7 @@ currency string -Three-letter ISO 4217 currency code +Three-letter ISO 4217 currency code, or XTR for Telegram Stars. total_amount @@ -116,7 +116,9 @@

Type

MessageAction

Related pages

-

Bot Payments API

+

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/constructor/messageMediaInvoice.html b/data/web/corefork.telegram.org/constructor/messageMediaInvoice.html index 94b7c1dc3e..e67e5cba0a 100644 --- a/data/web/corefork.telegram.org/constructor/messageMediaInvoice.html +++ b/data/web/corefork.telegram.org/constructor/messageMediaInvoice.html @@ -104,7 +104,7 @@ currency string -Three-letter ISO 4217 currency code +Three-letter ISO 4217 currency code, or XTR for Telegram Stars. total_amount @@ -130,7 +130,9 @@

Button to buy a product

message

A message

-

Bot Payments API

+

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/constructor/payments.paymentReceiptStars.html b/data/web/corefork.telegram.org/constructor/payments.paymentReceiptStars.html index ab42dac01a..5ae6488313 100644 --- a/data/web/corefork.telegram.org/constructor/payments.paymentReceiptStars.html +++ b/data/web/corefork.telegram.org/constructor/payments.paymentReceiptStars.html @@ -104,12 +104,12 @@ currency string -  +Currency, always XTR. total_amount long -  +Amount of Telegram Stars. transaction_id diff --git a/data/web/corefork.telegram.org/constructor/payments.starsStatus.html b/data/web/corefork.telegram.org/constructor/payments.starsStatus.html index 293354fa67..f01009e124 100644 --- a/data/web/corefork.telegram.org/constructor/payments.starsStatus.html +++ b/data/web/corefork.telegram.org/constructor/payments.starsStatus.html @@ -103,6 +103,7 @@

Related pages

payments.getStarsTransactions

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.

Telegram Stars

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/constructor/starsTransactionPeerPremiumBot.html b/data/web/corefork.telegram.org/constructor/starsTransactionPeerPremiumBot.html index 72194857d9..1eabe2009f 100644 --- a/data/web/corefork.telegram.org/constructor/starsTransactionPeerPremiumBot.html +++ b/data/web/corefork.telegram.org/constructor/starsTransactionPeerPremiumBot.html @@ -4,16 +4,10 @@ starsTransactionPeerPremiumBot - + - + @@ -48,7 +42,8 @@ StarsTransactionPeer">

starsTransactionPeerPremiumBot

-

+

Describes a Telegram Star transaction made using @PremiumBot (i.e. using the inputInvoiceStars flow described here »).

+

+

StarsTransactionPeer

+

Related pages

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

+

inputInvoiceStars

+

Used to top up the current account's Telegram Stars balance.

diff --git a/data/web/corefork.telegram.org/constructor/updateBotPrecheckoutQuery.html b/data/web/corefork.telegram.org/constructor/updateBotPrecheckoutQuery.html index f7347a3075..f0337dab3b 100644 --- a/data/web/corefork.telegram.org/constructor/updateBotPrecheckoutQuery.html +++ b/data/web/corefork.telegram.org/constructor/updateBotPrecheckoutQuery.html @@ -99,7 +99,7 @@ currency string -Three-letter ISO 4217 currency code +Three-letter ISO 4217 currency code, or XTR for Telegram Stars. total_amount @@ -111,7 +111,9 @@

Type

Update

Related pages

-

Bot Payments API

+

Bot Payments API

+

Telegram Stars

+

Telegram Stars are an in-app currency that allows the user to pay for digital goods and services offered by Telegram bots or Telegram channels.

diff --git a/data/web/corefork.telegram.org/method/payments.getStarsTransactions.html b/data/web/corefork.telegram.org/method/payments.getStarsTransactions.html index 3b03c20717..19936caee3 100644 --- a/data/web/corefork.telegram.org/method/payments.getStarsTransactions.html +++ b/data/web/corefork.telegram.org/method/payments.getStarsTransactions.html @@ -4,10 +4,10 @@ payments.getStarsTransactions - + - + @@ -43,6 +43,7 @@

payments.getStarsTransactions

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.