From dd3bbe85ca620710eb9d10c9ffe62a1c4c9b09e6 Mon Sep 17 00:00:00 2001
From: GitHub Action <github-action@users.noreply.github.com>
Date: Tue, 28 May 2024 11:46:49 +0000
Subject: [PATCH] Update content of files

---
 .../bots/api-changelog.html                   |  15 +
 .../core.telegram.org/bots/api-changelog.html |  15 +
 data/web/core.telegram.org/bots/api.html      | 337 +++++++++++++++---
 3 files changed, 318 insertions(+), 49 deletions(-)

diff --git a/data/web/blogfork.telegram.org/bots/api-changelog.html b/data/web/blogfork.telegram.org/bots/api-changelog.html
index fc2b59c391..7ce873a09d 100644
--- a/data/web/blogfork.telegram.org/bots/api-changelog.html
+++ b/data/web/blogfork.telegram.org/bots/api-changelog.html
@@ -55,6 +55,21 @@ To learn how to create…">
 <p>Subscribe to <a href="https://t.me/botnews">@BotNews</a> to be the first to know about the latest updates and join the discussion in <a href="https://t.me/bottalk">@BotTalk</a></p>
 </blockquote>
 <h3><a class="anchor" name="2024" href="#2024"><i class="anchor-icon"></i></a>2024</h3>
+<h4><a class="anchor" name="may-28-2024" href="#may-28-2024"><i class="anchor-icon"></i></a>May 28, 2024</h4>
+<p><strong>Bot API 7.4</strong></p>
+<ul>
+<li>Added support for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a> by introducing the new currency “XTR”.</li>
+<li>The parameter <em>provider_token</em> of the methods <a href="/bots/api#sendinvoice">sendInvoice</a> and <a href="/bots/api#createinvoicelink">createInvoiceLink</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>The field <em>provider_token</em> in the class <a href="/bots/api#inputinvoicemessagecontent">InputInvoiceMessageContent</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>Added the method <a href="/bots/api#refundstarpayment">refundStarPayment</a>.</li>
+<li>Added the field <em>effect_id</em> to the class <a href="/bots/api#message">Message</a>.</li>
+<li>Added the parameter <em>message_effect_id</em> to the methods <a href="/bots/api#sendmessage">sendMessage</a>, <a href="/bots/api#sendphoto">sendPhoto</a>, <a href="/bots/api#sendvideo">sendVideo</a>, <a href="/bots/api#sendanimation">sendAnimation</a>, <a href="/bots/api#sendaudio">sendAudio</a>, <a href="/bots/api#senddocument">sendDocument</a>, <a href="/bots/api#sendsticker">sendSticker</a>, <a href="/bots/api#sendvideonote">sendVideoNote</a>, <a href="/bots/api#sendvoice">sendVoice</a>, <a href="/bots/api#sendlocation">sendLocation</a>, <a href="/bots/api#sendvenue">sendVenue</a>, <a href="/bots/api#sendcontact">sendContact</a>, <a href="/bots/api#sendpoll">sendPoll</a>, <a href="/bots/api#senddice">sendDice</a>, <a href="/bots/api#sendinvoice">sendInvoice</a>, <a href="/bots/api#sendgame">sendGame</a>, and <a href="/bots/api#sendmediagroup">sendMediaGroup</a>.</li>
+<li>Added the field <em>show_caption_above_media</em> to the classes <a href="/bots/api#message">Message</a>, <a href="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <a href="/bots/api#inputmediaphoto">InputMediaPhoto</a>, <a href="/bots/api#inputmediavideo">InputMediaVideo</a>, <a href="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, <a href="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>, <a href="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <a href="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a>, <a href="/bots/api#inlinequeryresultcachedgif">InlineQueryResultCachedGif</a>, <a href="/bots/api#inlinequeryresultcachedmpeg4gif">InlineQueryResultCachedMpeg4Gif</a>, <a href="/bots/api#inlinequeryresultcachedphoto">InlineQueryResultCachedPhoto</a>, and <a href="/bots/api#inlinequeryresultcachedvideo">InlineQueryResultCachedVideo</a>.</li>
+<li>Added the parameter <em>show_caption_above_media</em> to the methods <a href="/bots/api#sendanimation">sendAnimation</a>, <a href="/bots/api#sendphoto">sendPhoto</a>, <a href="/bots/api#sendvideo">sendVideo</a>, <a href="/bots/api#copymessage">copyMessage</a>, and <a href="/bots/api#editmessagecaption">editMessageCaption</a>.</li>
+<li>Added support for “expandable_blockquote” entities in received messages.</li>
+<li>Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.</li>
+<li>Allowed to explicitly specify “expandable_blockquote” entities in formatted texts.</li>
+</ul>
 <h4><a class="anchor" name="may-6-2024" href="#may-6-2024"><i class="anchor-icon"></i></a>May 6, 2024</h4>
 <p><strong>Bot API 7.3</strong></p>
 <ul>
diff --git a/data/web/core.telegram.org/bots/api-changelog.html b/data/web/core.telegram.org/bots/api-changelog.html
index fc2b59c391..7ce873a09d 100644
--- a/data/web/core.telegram.org/bots/api-changelog.html
+++ b/data/web/core.telegram.org/bots/api-changelog.html
@@ -55,6 +55,21 @@ To learn how to create…">
 <p>Subscribe to <a href="https://t.me/botnews">@BotNews</a> to be the first to know about the latest updates and join the discussion in <a href="https://t.me/bottalk">@BotTalk</a></p>
 </blockquote>
 <h3><a class="anchor" name="2024" href="#2024"><i class="anchor-icon"></i></a>2024</h3>
+<h4><a class="anchor" name="may-28-2024" href="#may-28-2024"><i class="anchor-icon"></i></a>May 28, 2024</h4>
+<p><strong>Bot API 7.4</strong></p>
+<ul>
+<li>Added support for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a> by introducing the new currency “XTR”.</li>
+<li>The parameter <em>provider_token</em> of the methods <a href="/bots/api#sendinvoice">sendInvoice</a> and <a href="/bots/api#createinvoicelink">createInvoiceLink</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>The field <em>provider_token</em> in the class <a href="/bots/api#inputinvoicemessagecontent">InputInvoiceMessageContent</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>Added the method <a href="/bots/api#refundstarpayment">refundStarPayment</a>.</li>
+<li>Added the field <em>effect_id</em> to the class <a href="/bots/api#message">Message</a>.</li>
+<li>Added the parameter <em>message_effect_id</em> to the methods <a href="/bots/api#sendmessage">sendMessage</a>, <a href="/bots/api#sendphoto">sendPhoto</a>, <a href="/bots/api#sendvideo">sendVideo</a>, <a href="/bots/api#sendanimation">sendAnimation</a>, <a href="/bots/api#sendaudio">sendAudio</a>, <a href="/bots/api#senddocument">sendDocument</a>, <a href="/bots/api#sendsticker">sendSticker</a>, <a href="/bots/api#sendvideonote">sendVideoNote</a>, <a href="/bots/api#sendvoice">sendVoice</a>, <a href="/bots/api#sendlocation">sendLocation</a>, <a href="/bots/api#sendvenue">sendVenue</a>, <a href="/bots/api#sendcontact">sendContact</a>, <a href="/bots/api#sendpoll">sendPoll</a>, <a href="/bots/api#senddice">sendDice</a>, <a href="/bots/api#sendinvoice">sendInvoice</a>, <a href="/bots/api#sendgame">sendGame</a>, and <a href="/bots/api#sendmediagroup">sendMediaGroup</a>.</li>
+<li>Added the field <em>show_caption_above_media</em> to the classes <a href="/bots/api#message">Message</a>, <a href="/bots/api#inputmediaanimation">InputMediaAnimation</a>, <a href="/bots/api#inputmediaphoto">InputMediaPhoto</a>, <a href="/bots/api#inputmediavideo">InputMediaVideo</a>, <a href="/bots/api#inlinequeryresultgif">InlineQueryResultGif</a>, <a href="/bots/api#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>, <a href="/bots/api#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <a href="/bots/api#inlinequeryresultvideo">InlineQueryResultVideo</a>, <a href="/bots/api#inlinequeryresultcachedgif">InlineQueryResultCachedGif</a>, <a href="/bots/api#inlinequeryresultcachedmpeg4gif">InlineQueryResultCachedMpeg4Gif</a>, <a href="/bots/api#inlinequeryresultcachedphoto">InlineQueryResultCachedPhoto</a>, and <a href="/bots/api#inlinequeryresultcachedvideo">InlineQueryResultCachedVideo</a>.</li>
+<li>Added the parameter <em>show_caption_above_media</em> to the methods <a href="/bots/api#sendanimation">sendAnimation</a>, <a href="/bots/api#sendphoto">sendPhoto</a>, <a href="/bots/api#sendvideo">sendVideo</a>, <a href="/bots/api#copymessage">copyMessage</a>, and <a href="/bots/api#editmessagecaption">editMessageCaption</a>.</li>
+<li>Added support for “expandable_blockquote” entities in received messages.</li>
+<li>Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.</li>
+<li>Allowed to explicitly specify “expandable_blockquote” entities in formatted texts.</li>
+</ul>
 <h4><a class="anchor" name="may-6-2024" href="#may-6-2024"><i class="anchor-icon"></i></a>May 6, 2024</h4>
 <p><strong>Bot API 7.3</strong></p>
 <ul>
diff --git a/data/web/core.telegram.org/bots/api.html b/data/web/core.telegram.org/bots/api.html
index c064efe7c4..54895c75dd 100644
--- a/data/web/core.telegram.org/bots/api.html
+++ b/data/web/core.telegram.org/bots/api.html
@@ -53,6 +53,21 @@ To learn how to create…">
 <blockquote>
 <p>Subscribe to <a href="https://t.me/botnews">@BotNews</a> to be the first to know about the latest updates and join the discussion in <a href="https://t.me/bottalk">@BotTalk</a></p>
 </blockquote>
+<h4><a class="anchor" name="may-28-2024" href="#may-28-2024"><i class="anchor-icon"></i></a>May 28, 2024</h4>
+<p><strong>Bot API 7.4</strong></p>
+<ul>
+<li>Added support for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a> by introducing the new currency “XTR”.</li>
+<li>The parameter <em>provider_token</em> of the methods <a href="#sendinvoice">sendInvoice</a> and <a href="#createinvoicelink">createInvoiceLink</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>The field <em>provider_token</em> in the class <a href="#inputinvoicemessagecontent">InputInvoiceMessageContent</a> must be omitted for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</li>
+<li>Added the method <a href="#refundstarpayment">refundStarPayment</a>.</li>
+<li>Added the field <em>effect_id</em> to the class <a href="#message">Message</a>.</li>
+<li>Added the parameter <em>message_effect_id</em> to the methods <a href="#sendmessage">sendMessage</a>, <a href="#sendphoto">sendPhoto</a>, <a href="#sendvideo">sendVideo</a>, <a href="#sendanimation">sendAnimation</a>, <a href="#sendaudio">sendAudio</a>, <a href="#senddocument">sendDocument</a>, <a href="#sendsticker">sendSticker</a>, <a href="#sendvideonote">sendVideoNote</a>, <a href="#sendvoice">sendVoice</a>, <a href="#sendlocation">sendLocation</a>, <a href="#sendvenue">sendVenue</a>, <a href="#sendcontact">sendContact</a>, <a href="#sendpoll">sendPoll</a>, <a href="#senddice">sendDice</a>, <a href="#sendinvoice">sendInvoice</a>, <a href="#sendgame">sendGame</a>, and <a href="#sendmediagroup">sendMediaGroup</a>.</li>
+<li>Added the field <em>show_caption_above_media</em> to the classes <a href="#message">Message</a>, <a href="#inputmediaanimation">InputMediaAnimation</a>, <a href="#inputmediaphoto">InputMediaPhoto</a>, <a href="#inputmediavideo">InputMediaVideo</a>, <a href="#inlinequeryresultgif">InlineQueryResultGif</a>, <a href="#inlinequeryresultmpeg4gif">InlineQueryResultMpeg4Gif</a>, <a href="#inlinequeryresultphoto">InlineQueryResultPhoto</a>, <a href="#inlinequeryresultvideo">InlineQueryResultVideo</a>, <a href="#inlinequeryresultcachedgif">InlineQueryResultCachedGif</a>, <a href="#inlinequeryresultcachedmpeg4gif">InlineQueryResultCachedMpeg4Gif</a>, <a href="#inlinequeryresultcachedphoto">InlineQueryResultCachedPhoto</a>, and <a href="#inlinequeryresultcachedvideo">InlineQueryResultCachedVideo</a>.</li>
+<li>Added the parameter <em>show_caption_above_media</em> to the methods <a href="#sendanimation">sendAnimation</a>, <a href="#sendphoto">sendPhoto</a>, <a href="#sendvideo">sendVideo</a>, <a href="#copymessage">copyMessage</a>, and <a href="#editmessagecaption">editMessageCaption</a>.</li>
+<li>Added support for “expandable_blockquote” entities in received messages.</li>
+<li>Added support for “expandable_blockquote” entity parsing in “MarkdownV2” and “HTML” parse modes.</li>
+<li>Allowed to explicitly specify “expandable_blockquote” entities in formatted texts.</li>
+</ul>
 <h4><a class="anchor" name="may-6-2024" href="#may-6-2024"><i class="anchor-icon"></i></a>May 6, 2024</h4>
 <p><strong>Bot API 7.3</strong></p>
 <ul>
@@ -1043,6 +1058,11 @@ To learn how to create…">
 <td><em>Optional</em>. Options used for link preview generation for the message, if it is a text message and link preview options were changed</td>
 </tr>
 <tr>
+<td>effect_id</td>
+<td>String</td>
+<td><em>Optional</em>. Unique identifier of the message effect added to the message</td>
+</tr>
+<tr>
 <td>animation</td>
 <td><a href="#animation">Animation</a></td>
 <td><em>Optional</em>. Message is an animation, information about the animation. For backward compatibility, when this field is set, the <em>document</em> field will also be set</td>
@@ -1098,6 +1118,11 @@ To learn how to create…">
 <td><em>Optional</em>. For messages with a caption, special entities like usernames, URLs, bot commands, etc. that appear in the caption</td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>True</td>
+<td><em>Optional</em>. True, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>has_media_spoiler</td>
 <td>True</td>
 <td><em>Optional</em>. <em>True</em>, if the message media is covered by a spoiler animation</td>
@@ -1390,7 +1415,7 @@ To learn how to create…">
 <tr>
 <td>type</td>
 <td>String</td>
-<td>Type of the entity. Currently, can be “mention” (<code>@username</code>), “hashtag” (<code>#hashtag</code>), “cashtag” (<code>$USD</code>), “bot_command” (<code>/start@jobs_bot</code>), “url” (<code>https://telegram.org</code>), “email” (<code>do-not-reply@telegram.org</code>), “phone_number” (<code>+1-212-555-0123</code>), “bold” (<strong>bold text</strong>), “italic” (<em>italic text</em>), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users <a href="https://telegram.org/blog/edit#new-mentions">without usernames</a>), “custom_emoji” (for inline custom emoji stickers)</td>
+<td>Type of the entity. Currently, can be “mention” (<code>@username</code>), “hashtag” (<code>#hashtag</code>), “cashtag” (<code>$USD</code>), “bot_command” (<code>/start@jobs_bot</code>), “url” (<code>https://telegram.org</code>), “email” (<code>do-not-reply@telegram.org</code>), “phone_number” (<code>+1-212-555-0123</code>), “bold” (<strong>bold text</strong>), “italic” (<em>italic text</em>), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users <a href="https://telegram.org/blog/edit#new-mentions">without usernames</a>), “custom_emoji” (for inline custom emoji stickers)</td>
 </tr>
 <tr>
 <td>offset</td>
@@ -3334,7 +3359,7 @@ To learn how to create…">
 </tbody>
 </table>
 <h4><a class="anchor" name="keyboardbutton" href="#keyboardbutton"><i class="anchor-icon"></i></a>KeyboardButton</h4>
-<p>This object represents one button of the reply keyboard. For simple text buttons, <em>String</em> can be used instead of this object to specify the button text. The optional fields <em>web_app</em>, <em>request_users</em>, <em>request_chat</em>, <em>request_contact</em>, <em>request_location</em>, and <em>request_poll</em> are mutually exclusive.</p>
+<p>This object represents one button of the reply keyboard. At most one of the optional fields must be used to specify type of the button. For simple text buttons, <em>String</em> can be used instead of this object to specify the button text.</p>
 <table class="table">
 <thead>
 <tr>
@@ -3558,7 +3583,7 @@ To learn how to create…">
 </tbody>
 </table>
 <h4><a class="anchor" name="inlinekeyboardbutton" href="#inlinekeyboardbutton"><i class="anchor-icon"></i></a>InlineKeyboardButton</h4>
-<p>This object represents one button of an inline keyboard. You <strong>must</strong> use exactly one of the optional fields.</p>
+<p>This object represents one button of an inline keyboard. Exactly one of the optional fields must be used to specify type of the button.</p>
 <table class="table">
 <thead>
 <tr>
@@ -3616,7 +3641,7 @@ To learn how to create…">
 <tr>
 <td>pay</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Specify <em>True</em>, to send a <a href="#payments">Pay button</a>.<br><br><strong>NOTE:</strong> This type of button <strong>must</strong> always be the first button in the first row and can only be used in invoice messages.</td>
+<td><em>Optional</em>. Specify <em>True</em>, to send a <a href="#payments">Pay button</a>. Substrings “<img class="emoji" src="//telegram.org/img/emoji/40/E2AD90.png" width="20" height="20" alt="⭐" />” and “XTR” in the buttons&#39;s text will be replaced with a Telegram Star icon.<br><br><strong>NOTE:</strong> This type of button <strong>must</strong> always be the first button in the first row and can only be used in invoice messages.</td>
 </tr>
 </tbody>
 </table>
@@ -5474,6 +5499,11 @@ To learn how to create…">
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>has_spoiler</td>
 <td>Boolean</td>
 <td><em>Optional</em>. Pass <em>True</em> if the photo needs to be covered with a spoiler animation</td>
@@ -5522,6 +5552,11 @@ To learn how to create…">
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>width</td>
 <td>Integer</td>
 <td><em>Optional</em>. Video width</td>
@@ -5590,6 +5625,11 @@ To learn how to create…">
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>width</td>
 <td>Integer</td>
 <td><em>Optional</em>. Animation width</td>
@@ -5868,6 +5908,12 @@ To learn how to create…">
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -5884,7 +5930,7 @@ To learn how to create…">
 <h4><a class="anchor" name="formatting-options" href="#formatting-options"><i class="anchor-icon"></i></a>Formatting options</h4>
 <p>The Bot API supports basic formatting for messages. You can use bold, italic, underlined, strikethrough, spoiler text, block quotations as well as inline links and pre-formatted code in your bots&#39; messages. Telegram clients will render them accordingly. You can specify text entities directly, or use markdown-style or HTML-style formatting.</p>
 <p>Note that Telegram clients will display an <strong>alert</strong> to the user before opening an inline link (&#39;Open this link?&#39; together with the full URL).</p>
-<p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters, then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- <em>blockquote</em> entities can&#39;t be nested.<br>- All other entities can&#39;t contain each other.</p>
+<p>Message entities can be nested, providing following restrictions are met:<br>- If two entities have common characters, then one of them is fully contained inside another.<br>- <em>bold</em>, <em>italic</em>, <em>underline</em>, <em>strikethrough</em>, and <em>spoiler</em> entities can contain and can be part of any other entities, except <em>pre</em> and <em>code</em>.<br>- <em>blockquote</em> and <em>expandable_blockquote</em> entities can&#39;t be nested.<br>- All other entities can&#39;t contain each other.</p>
 <p>Links <code>tg://user?id=&lt;user_id&gt;</code> can be used to mention a user by their identifier without using a username. Please note:</p>
 <ul>
 <li>These links will work <strong>only</strong> if they are used inside an inline link or in an inline keyboard button. For example, they will not work, when used in a message text.</li>
@@ -5911,16 +5957,22 @@ pre-formatted fixed-width code block written in the Python programming language
 ```
 &gt;Block quotation started
 &gt;Block quotation continued
-&gt;The last line of the block quotation**
-&gt;The second block quotation started right after the previous\r
-&gt;The third block quotation started right after the previous</code></pre>
+&gt;Block quotation continued
+&gt;Block quotation continued
+&gt;The last line of the block quotation
+**&gt;The expandable block quotation started right after the previous block quotation
+&gt;It is separated from the previous block quotation by an empty bold entity
+&gt;Expandable block quotation continued
+&gt;Hidden by default part of the expandable block quotation started
+&gt;Expandable block quotation continued
+&gt;The last line of the expandable block quotation with the expandability mark||</code></pre>
 <p>Please note:</p>
 <ul>
 <li>Any character with code between 1 and 126 inclusively can be escaped anywhere with a preceding &#39;\&#39; character, in which case it is treated as an ordinary character and not a part of the markup. This implies that &#39;\&#39; character usually must be escaped with a preceding &#39;\&#39; character.</li>
 <li>Inside <code>pre</code> and <code>code</code> entities, all &#39;`&#39; and &#39;\&#39; characters must be escaped with a preceding &#39;\&#39; character.</li>
 <li>Inside the <code>(...)</code> part of the inline link and custom emoji definition, all &#39;)&#39; and &#39;\&#39; must be escaped with a preceding &#39;\&#39; character.</li>
 <li>In all other places characters &#39;_&#39;, &#39;*&#39;, &#39;[&#39;, &#39;]&#39;, &#39;(&#39;, &#39;)&#39;, &#39;~&#39;, &#39;`&#39;, &#39;&gt;&#39;, &#39;#&#39;, &#39;+&#39;, &#39;-&#39;, &#39;=&#39;, &#39;|&#39;, &#39;{&#39;, &#39;}&#39;, &#39;.&#39;, &#39;!&#39; must be escaped with the preceding character &#39;\&#39;.</li>
-<li>In case of ambiguity between <code>italic</code> and <code>underline</code> entities <code>__</code> is always greadily treated from left to right as beginning or end of <code>underline</code> entity, so instead of <code>___italic underline___</code> use <code>___italic underline_\r__</code>, where <code>\r</code> is a character with code 13, which will be ignored.</li>
+<li>In case of ambiguity between <code>italic</code> and <code>underline</code> entities <code>__</code> is always greadily treated from left to right as beginning or end of an <code>underline</code> entity, so instead of <code>___italic underline___</code> use <code>___italic underline_**__</code>, adding an empty bold entity as a separator.</li>
 <li>A valid emoji must be provided as an alternative value for the custom emoji. The emoji will be shown instead of the custom emoji in places where a custom emoji cannot be displayed (e.g., system notifications) or if the message is forwarded by a non-premium user. It is recommended to use the emoji from the <strong>emoji</strong> field of the custom emoji <a href="#sticker">sticker</a>.</li>
 <li>Custom emoji entities can only be used by bots that purchased additional usernames on <a href="https://fragment.com">Fragment</a>.</li>
 </ul>
@@ -5938,7 +5990,8 @@ pre-formatted fixed-width code block written in the Python programming language
 &lt;code&gt;inline fixed-width code&lt;/code&gt;
 &lt;pre&gt;pre-formatted fixed-width code block&lt;/pre&gt;
 &lt;pre&gt;&lt;code class=&quot;language-python&quot;&gt;pre-formatted fixed-width code block written in the Python programming language&lt;/code&gt;&lt;/pre&gt;
-&lt;blockquote&gt;Block quotation started\nBlock quotation continued\nThe last line of the block quotation&lt;/blockquote&gt;</code></pre>
+&lt;blockquote&gt;Block quotation started\nBlock quotation continued\nThe last line of the block quotation&lt;/blockquote&gt;
+&lt;blockquote expandable&gt;Expandable block quotation started\nExpandable block quotation continued\nExpandable block quotation continued\nHidden by default part of the block quotation started\nExpandable block quotation continued\nThe last line of the block quotation&lt;/blockquote&gt;</code></pre>
 <p>Please note:</p>
 <ul>
 <li>Only the tags mentioned above are currently supported.</li>
@@ -5966,7 +6019,7 @@ pre-formatted fixed-width code block written in the Python programming language
 <p>Please note:</p>
 <ul>
 <li>Entities must not be nested, use parse mode <a href="#markdownv2-style">MarkdownV2</a> instead.</li>
-<li>There is no way to specify “underline”, “strikethrough”, “spoiler”, “blockquote” and “custom_emoji” entities, use parse mode <a href="#markdownv2-style">MarkdownV2</a> instead.</li>
+<li>There is no way to specify “underline”, “strikethrough”, “spoiler”, “blockquote”, “expandable_blockquote” and “custom_emoji” entities, use parse mode <a href="#markdownv2-style">MarkdownV2</a> instead.</li>
 <li>To escape characters &#39;_&#39;, &#39;*&#39;, &#39;`&#39;, &#39;[&#39; outside of an entity, prepend the characters &#39;\&#39; before them.</li>
 <li>Escaping inside entities is not allowed, so entity must be closed first and reopened again: use <code>_snake_\__case_</code> for italic <code>snake_case</code> and <code>*2*\**2=4*</code> for bold <code>2*2=4</code>.</li>
 </ul>
@@ -6261,6 +6314,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>A JSON-serialized list of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td>Optional</td>
+<td>Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>has_spoiler</td>
 <td>Boolean</td>
 <td>Optional</td>
@@ -6279,6 +6338,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6384,6 +6449,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6476,6 +6547,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6568,6 +6645,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>A JSON-serialized list of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td>Optional</td>
+<td>Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>has_spoiler</td>
 <td>Boolean</td>
 <td>Optional</td>
@@ -6592,6 +6675,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6684,6 +6773,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>A JSON-serialized list of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td>Optional</td>
+<td>Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>has_spoiler</td>
 <td>Boolean</td>
 <td>Optional</td>
@@ -6702,6 +6797,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6788,6 +6889,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6868,6 +6975,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -6930,6 +7043,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent messages from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -7016,6 +7135,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -7120,6 +7245,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -7200,6 +7331,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -7340,6 +7477,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -7402,6 +7545,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -9248,6 +9397,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>A JSON-serialized list of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td>Optional</td>
+<td>Pass <em>True</em>, if the caption must be shown above the message media. Supported only for animation, photo and video messages.</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td>Optional</td>
@@ -9787,6 +9942,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -10510,6 +10671,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -10593,6 +10759,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -10676,6 +10847,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -10747,6 +10923,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>video_width</td>
 <td>Integer</td>
 <td><em>Optional</em>. Video width</td>
@@ -11316,6 +11497,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -11374,6 +11560,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -11432,6 +11623,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -11596,6 +11792,11 @@ pre-formatted fixed-width code block written in the Python programming language
 <td><em>Optional</em>. List of special entities that appear in the caption, which can be specified instead of <em>parse_mode</em></td>
 </tr>
 <tr>
+<td>show_caption_above_media</td>
+<td>Boolean</td>
+<td><em>Optional</em>. Pass <em>True</em>, if the caption must be shown above the message media</td>
+</tr>
+<tr>
 <td>reply_markup</td>
 <td><a href="#inlinekeyboardmarkup">InlineKeyboardMarkup</a></td>
 <td><em>Optional</em>. <a href="/bots/features#inline-keyboards">Inline keyboard</a> attached to the message</td>
@@ -11918,22 +12119,22 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>provider_token</td>
 <td>String</td>
-<td>Payment provider token, obtained via <a href="https://t.me/botfather">@BotFather</a></td>
+<td><em>Optional</em>. Payment provider token, obtained via <a href="https://t.me/botfather">@BotFather</a>. Pass an empty string for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>currency</td>
 <td>String</td>
-<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a></td>
+<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a>. Pass “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>prices</td>
 <td>Array of <a href="#labeledprice">LabeledPrice</a></td>
-<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)</td>
+<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>max_tip_amount</td>
 <td>Integer</td>
-<td><em>Optional</em>. The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0</td>
+<td><em>Optional</em>. The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0. Not supported for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>suggested_tip_amounts</td>
@@ -11968,37 +12169,37 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>need_name</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
+<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s full name to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_phone_number</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
+<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s phone number to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_email</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
+<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s email address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_shipping_address</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
+<td><em>Optional</em>. Pass <em>True</em> if you require the user&#39;s shipping address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_phone_number_to_provider</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s phone number should be sent to provider</td>
+<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s phone number should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_email_to_provider</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s email address should be sent to provider</td>
+<td><em>Optional</em>. Pass <em>True</em> if the user&#39;s email address should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>is_flexible</td>
 <td>Boolean</td>
-<td><em>Optional</em>. Pass <em>True</em> if the final price depends on the shipping method</td>
+<td><em>Optional</em>. Pass <em>True</em> if the final price depends on the shipping method. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 </tbody>
 </table>
@@ -12132,26 +12333,26 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>provider_token</td>
 <td>String</td>
-<td>Yes</td>
-<td>Payment provider token, obtained via <a href="https://t.me/botfather">@BotFather</a></td>
+<td>Optional</td>
+<td>Payment provider token, obtained via <a href="https://t.me/botfather">@BotFather</a>. Pass an empty string for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>currency</td>
 <td>String</td>
 <td>Yes</td>
-<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a></td>
+<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a>. Pass “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>prices</td>
 <td>Array of <a href="#labeledprice">LabeledPrice</a></td>
 <td>Yes</td>
-<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)</td>
+<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>max_tip_amount</td>
 <td>Integer</td>
 <td>Optional</td>
-<td>The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0</td>
+<td>The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0. Not supported for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>suggested_tip_amounts</td>
@@ -12199,43 +12400,43 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>need_name</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_phone_number</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_email</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_shipping_address</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_phone_number_to_provider</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the user&#39;s phone number should be sent to provider</td>
+<td>Pass <em>True</em> if the user&#39;s phone number should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_email_to_provider</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the user&#39;s email address should be sent to provider</td>
+<td>Pass <em>True</em> if the user&#39;s email address should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>is_flexible</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the final price depends on the shipping method</td>
+<td>Pass <em>True</em> if the final price depends on the shipping method. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>disable_notification</td>
@@ -12250,6 +12451,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>
@@ -12296,26 +12503,26 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>provider_token</td>
 <td>String</td>
-<td>Yes</td>
-<td>Payment provider token, obtained via <a href="https://t.me/botfather">BotFather</a></td>
+<td>Optional</td>
+<td>Payment provider token, obtained via <a href="https://t.me/botfather">@BotFather</a>. Pass an empty string for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>currency</td>
 <td>String</td>
 <td>Yes</td>
-<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a></td>
+<td>Three-letter ISO 4217 currency code, see <a href="/bots/payments#supported-currencies">more on currencies</a>. Pass “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>prices</td>
 <td>Array of <a href="#labeledprice">LabeledPrice</a></td>
 <td>Yes</td>
-<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)</td>
+<td>Price breakdown, a JSON-serialized list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.). Must contain exactly one item for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>max_tip_amount</td>
 <td>Integer</td>
 <td>Optional</td>
-<td>The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0</td>
+<td>The maximum accepted amount for tips in the <em>smallest units</em> of the currency (integer, <strong>not</strong> float/double). For example, for a maximum tip of <code>US$ 1.45</code> pass <code>max_tip_amount = 145</code>. See the <em>exp</em> 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). Defaults to 0. Not supported for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>suggested_tip_amounts</td>
@@ -12357,43 +12564,43 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>need_name</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s full name to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_phone_number</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s phone number to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_email</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s email address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>need_shipping_address</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order</td>
+<td>Pass <em>True</em> if you require the user&#39;s shipping address to complete the order. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_phone_number_to_provider</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the user&#39;s phone number should be sent to the provider</td>
+<td>Pass <em>True</em> if the user&#39;s phone number should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>send_email_to_provider</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the user&#39;s email address should be sent to the provider</td>
+<td>Pass <em>True</em> if the user&#39;s email address should be sent to the provider. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 <tr>
 <td>is_flexible</td>
 <td>Boolean</td>
 <td>Optional</td>
-<td>Pass <em>True</em> if the final price depends on the shipping method</td>
+<td>Pass <em>True</em> if the final price depends on the shipping method. Ignored for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a>.</td>
 </tr>
 </tbody>
 </table>
@@ -12467,6 +12674,32 @@ pre-formatted fixed-width code block written in the Python programming language
 </tr>
 </tbody>
 </table>
+<h4><a class="anchor" name="refundstarpayment" href="#refundstarpayment"><i class="anchor-icon"></i></a>refundStarPayment</h4>
+<p>Refunds a successful payment in <a href="https://t.me/BotNews/90">Telegram Stars</a>. Returns <em>True</em> on success.</p>
+<table class="table">
+<thead>
+<tr>
+<th>Parameter</th>
+<th>Type</th>
+<th>Required</th>
+<th>Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>user_id</td>
+<td>Integer</td>
+<td>Yes</td>
+<td>Identifier of the user whose payment will be refunded</td>
+</tr>
+<tr>
+<td>telegram_payment_charge_id</td>
+<td>String</td>
+<td>Yes</td>
+<td>Telegram payment identifier</td>
+</tr>
+</tbody>
+</table>
 <h4><a class="anchor" name="labeledprice" href="#labeledprice"><i class="anchor-icon"></i></a>LabeledPrice</h4>
 <p>This object represents a portion of the price for goods or services.</p>
 <table class="table">
@@ -12519,7 +12752,7 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>currency</td>
 <td>String</td>
-<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code</td>
+<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code, or “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a></td>
 </tr>
 <tr>
 <td>total_amount</td>
@@ -12646,7 +12879,7 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>currency</td>
 <td>String</td>
-<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code</td>
+<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code, or “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a></td>
 </tr>
 <tr>
 <td>total_amount</td>
@@ -12737,7 +12970,7 @@ pre-formatted fixed-width code block written in the Python programming language
 <tr>
 <td>currency</td>
 <td>String</td>
-<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code</td>
+<td>Three-letter ISO 4217 <a href="/bots/payments#supported-currencies">currency</a> code, or “XTR” for payments in <a href="https://t.me/BotNews/90">Telegram Stars</a></td>
 </tr>
 <tr>
 <td>total_amount</td>
@@ -13314,6 +13547,12 @@ pre-formatted fixed-width code block written in the Python programming language
 <td>Protects the contents of the sent message from forwarding and saving</td>
 </tr>
 <tr>
+<td>message_effect_id</td>
+<td>String</td>
+<td>Optional</td>
+<td>Unique identifier of the message effect to be added to the message</td>
+</tr>
+<tr>
 <td>reply_parameters</td>
 <td><a href="#replyparameters">ReplyParameters</a></td>
 <td>Optional</td>