Методы покупок
==============

Эти методы доступны в обоих клиентах.

purchase_stars
--------------
.. py:method:: purchase_stars(username, amount, show_sender=True)

    Покупка Telegram Stars для пользователя.

    :param str username: Юзернейм получателя (например, ``"@durov"``).
    :param int amount: Количество звезд (от 50 до 1,000,000).
    :param bool show_sender: Если ``True``, получатель увидит, кто отправил подарок.
    :return: :class:`~FragmentAPI.types.StarsResult`
    :raises: :class:`~FragmentAPI.exceptions.UserNotFoundError`, :class:`~FragmentAPI.exceptions.WalletError`

purchase_premium
----------------
.. py:method:: purchase_premium(username, months, show_sender=True)

    Подарок подписки Telegram Premium.

    :param str username: Юзернейм получателя.
    :param int months: Длительность: ``3``, ``6`` или ``12``.
    :return: :class:`~FragmentAPI.types.PremiumResult`

topup_ton
---------
.. py:method:: topup_ton(username, amount, show_sender=True)

    Пополнение баланса TON в рекламном кабинете Telegram Ads.

    :param str username: Юзернейм или ссылка на канал.
    :param int amount: Сумма в TON.
    :return: :class:`~FragmentAPI.types.AdsTopupResult`