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

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

purchase_stars

purchase_stars(username, amount, show_sender=True)

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

Parameters:

  • username (str) – Юзернейм получателя (например, "@durov").

  • amount (int) – Количество звезд (от 50 до 1,000,000).

  • show_sender (bool) – Если True, получатель увидит, кто отправил подарок.

Returns:

StarsResult

Raises:

UserNotFoundError, WalletError

purchase_premium

purchase_premium(username, months, show_sender=True)

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

Parameters:

  • username (str) – Юзернейм получателя.

  • months (int) – Длительность: 3, 6 или 12.

Returns:

PremiumResult

topup_ton

topup_ton(username, amount, show_sender=True)

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

Parameters:

  • username (str) – Юзернейм или ссылка на канал.

  • amount (int) – Сумма в TON.

Returns:

AdsTopupResult