Added transfer_business_account_stars

Author: coder2020official

README.md

@@ -10,7 +10,7 @@
 <p align="center">A simple, but extensible Python implementation for the <a href="https://core.telegram.org/bots/api">Telegram Bot API</a>.</p>
 <p align="center">Both synchronous and asynchronous.</p>
 
-## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#february-12-2025"><img src="https://img.shields.io/badge/Bot%20API-8.3-blue?logo=telegram" alt="Supported Bot API version"></a>
+## <p align="center">Supported Bot API version: <a href="https://core.telegram.org/bots/api#april-11-2025"><img src="https://img.shields.io/badge/Bot%20API-9.0-blue?logo=telegram" alt="Supported Bot API version"></a>
 
 <h2><a href='https://pytba.readthedocs.io/en/latest/index.html'>Official documentation</a></h2>
 <h2><a href='https://pytba.readthedocs.io/ru/latest/index.html'>Official ru documentation</a></h2>

telebot/__init__.py

@@ -6507,6 +6507,23 @@ def get_business_account_star_balance(self, business_connection_id: str) -> type
         return types.StarAmount.de_json(
             apihelper.get_business_account_star_balance(self.token, business_connection_id)
         )
+    
+    def transfer_business_account_stars(self, business_connection_id: str, star_count: int) -> bool:
+        """
+        Transfers Telegram Stars from the business account balance to the bot's balance. Requires the can_transfer_stars business bot right. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#transferbusinessaccountstars
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param star_count: Number of Telegram Stars to transfer; 1-10000
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return apihelper.transfer_business_account_stars(self.token, business_connection_id, star_count)
 
     def get_available_gifts(self) -> types.Gifts:
         """

telebot/apihelper.py

@@ -2040,6 +2040,11 @@ def get_business_account_star_balance(token, business_connection_id):
     payload = {'business_connection_id': business_connection_id}
     return _make_request(token, method_url, params=payload)
 
+def transfer_business_account_stars(token, business_connection_id, star_count):
+    method_url = 'transferBusinessAccountStars'
+    payload = {'business_connection_id': business_connection_id, 'star_count': star_count}
+    return _make_request(token, method_url, params=payload, method='post')
+
 def create_new_sticker_set(
         token, user_id, name, title, stickers, sticker_type=None, needs_repainting=None):
     method_url = 'createNewStickerSet'

telebot/async_telebot.py

@@ -7963,6 +7963,24 @@ async def get_business_account_star_balance(self, business_connection_id: str) -
         return types.StarAmount.de_json(
             await asyncio_helper.get_business_account_star_balance(self.token, business_connection_id)
         )
+    
+    async def transfer_business_account_stars(self, business_connection_id: str, star_count: int) -> bool:
+        """
+        Transfers Telegram Stars from the business account balance to the bot's balance. Requires the can_transfer_stars business bot right. Returns True on success.
+
+        Telegram documentation: https://core.telegram.org/bots/api#transferbusinessaccountstars
+
+        :param business_connection_id: Unique identifier of the business connection
+        :type business_connection_id: :obj:`str`
+
+        :param star_count: Number of Telegram Stars to transfer; 1-10000
+        :type star_count: :obj:`int`
+
+        :return: Returns True on success.
+        :rtype: :obj:`bool`
+        """
+        return await asyncio_helper.transfer_business_account_stars(self.token, business_connection_id, star_count)
+
 
     async def get_available_gifts(self) -> types.Gifts:
         """

telebot/asyncio_helper.py

@@ -2014,6 +2014,10 @@ async def get_business_account_star_balance(token, business_connection_id):
     payload = {'business_connection_id': business_connection_id}
     return _process_request(token, method_url, params=payload)
 
+async def transfer_business_account_stars(token, business_connection_id, star_count):
+    method_url = 'transferBusinessAccountStars'
+    payload = {'business_connection_id': business_connection_id, 'star_count': star_count}
+    return await _process_request(token, method_url, params=payload, method='post')
 
 async def get_available_gifts(token):
     method_url = 'getAvailableGifts'