diff --git a/telegram/_bot.py b/telegram/_bot.py
index cc2ba38fb3a..08db838b461 100644
--- a/telegram/_bot.py
+++ b/telegram/_bot.py
@@ -24,7 +24,7 @@
import copy
import pickle
from collections.abc import Sequence
-from datetime import datetime
+from datetime import datetime, timedelta
from types import TracebackType
from typing import (
TYPE_CHECKING,
@@ -8024,6 +8024,8 @@ async def create_invoice_link(
send_phone_number_to_provider: Optional[bool] = None,
send_email_to_provider: Optional[bool] = None,
is_flexible: Optional[bool] = None,
+ subscription_period: Optional[Union[int, timedelta]] = None,
+ business_connection_id: Optional[str] = None,
*,
read_timeout: ODVInput[float] = DEFAULT_NONE,
write_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -8036,6 +8038,9 @@ async def create_invoice_link(
.. versionadded:: 20.0
Args:
+ business_connection_id (:obj:`str`, optional): |business_id_str|
+
+ .. versionadded:: NEXT.VERSION
title (:obj:`str`): Product name. :tg-const:`telegram.Invoice.MIN_TITLE_LENGTH`-
:tg-const:`telegram.Invoice.MAX_TITLE_LENGTH` characters.
description (:obj:`str`): Product description.
@@ -8062,6 +8067,13 @@ async def create_invoice_link(
.. versionchanged:: 20.0
|sequenceargs|
+ subscription_period (:obj:`int` | :class:`datetime.timedelta`, optional): The time the
+ subscription will be active for before the next payment, either as number of
+ seconds or as :class:`datetime.timedelta` object. The currency must be set to
+ ``“XTR”`` (Telegram Stars) if the parameter is used. Currently, it must always be
+ :tg-const:`telegram.constants.InvoiceLimit.SUBSCRIPTION_PERIOD` if specified.
+
+ .. versionadded:: NEXT.VERSION
max_tip_amount (:obj:`int`, optional): The maximum accepted amount for tips in the
*smallest units* of the currency (integer, **not** float/double). For example, for
a maximum tip of ``US$ 1.45`` pass ``max_tip_amount = 145``. See the ``exp``
@@ -8127,6 +8139,12 @@ async def create_invoice_link(
"is_flexible": is_flexible,
"send_phone_number_to_provider": send_phone_number_to_provider,
"send_email_to_provider": send_email_to_provider,
+ "subscription_period": (
+ subscription_period.total_seconds()
+ if isinstance(subscription_period, timedelta)
+ else subscription_period
+ ),
+ "business_connection_id": business_connection_id,
}
return await self._post(
diff --git a/telegram/constants.py b/telegram/constants.py
index 10f887a938f..bcb45153921 100644
--- a/telegram/constants.py
+++ b/telegram/constants.py
@@ -2902,6 +2902,10 @@ class InvoiceLimit(IntEnum):
.. versionadded:: 21.6
"""
+ SUBSCRIPTION_PERIOD = datetime.timedelta(days=30).total_seconds()
+ """:obj:`int`: The period of time for which the subscription is active before
+ the next payment, passed as :paramref:`~telegram.Bot.create_invoice_link.subscription_period`
+ parameter of :meth:`telegram.Bot.create_invoice_link`."""
class UserProfilePhotosLimit(IntEnum):
diff --git a/telegram/ext/_extbot.py b/telegram/ext/_extbot.py
index 66921e415df..b9842781a8c 100644
--- a/telegram/ext/_extbot.py
+++ b/telegram/ext/_extbot.py
@@ -20,7 +20,7 @@
"""This module contains an object that represents a Telegram Bot with convenience extensions."""
from collections.abc import Sequence
from copy import copy
-from datetime import datetime
+from datetime import datetime, timedelta
from typing import (
TYPE_CHECKING,
Any,
@@ -1171,6 +1171,8 @@ async def create_invoice_link(
send_phone_number_to_provider: Optional[bool] = None,
send_email_to_provider: Optional[bool] = None,
is_flexible: Optional[bool] = None,
+ subscription_period: Optional[Union[int, timedelta]] = None,
+ business_connection_id: Optional[str] = None,
*,
read_timeout: ODVInput[float] = DEFAULT_NONE,
write_timeout: ODVInput[float] = DEFAULT_NONE,
@@ -1204,6 +1206,8 @@ async def create_invoice_link(
write_timeout=write_timeout,
connect_timeout=connect_timeout,
pool_timeout=pool_timeout,
+ subscription_period=subscription_period,
+ business_connection_id=business_connection_id,
api_kwargs=self._merge_api_rl_kwargs(api_kwargs, rate_limit_args),
)
diff --git a/tests/_payment/test_invoice.py b/tests/_payment/test_invoice.py
index 585f4fd3e62..a28aedc43b8 100644
--- a/tests/_payment/test_invoice.py
+++ b/tests/_payment/test_invoice.py
@@ -17,6 +17,7 @@
# You should have received a copy of the GNU Lesser Public License
# along with this program. If not, see [http://www.gnu.org/licenses/].
import asyncio
+import datetime as dtm
import pytest
@@ -122,10 +123,14 @@ async def make_assertion(*args, **_):
protect_content=True,
)
- async def test_send_all_args_create_invoice_link(self, offline_bot, monkeypatch):
+ @pytest.mark.parametrize("subscription_period", [42, dtm.timedelta(seconds=42)])
+ async def test_send_all_args_create_invoice_link(
+ self, offline_bot, monkeypatch, subscription_period
+ ):
async def make_assertion(*args, **_):
kwargs = args[1]
- return all(kwargs[i] == i for i in kwargs)
+ sp = kwargs.pop("subscription_period") == 42
+ return all(kwargs[i] == i for i in kwargs) and sp
monkeypatch.setattr(offline_bot, "_post", make_assertion)
assert await offline_bot.create_invoice_link(
@@ -149,6 +154,8 @@ async def make_assertion(*args, **_):
send_phone_number_to_provider="send_phone_number_to_provider",
send_email_to_provider="send_email_to_provider",
is_flexible="is_flexible",
+ business_connection_id="business_connection_id",
+ subscription_period=subscription_period,
)
async def test_send_object_as_provider_data(
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy