Fragment Donor SDKИсходный код

Версия 0.1.3 · Команды установки используют точные версии.

Telegram Stars API и Bot Payments API: различия

Когда нужен подарок Stars по username, а когда — приём Stars за цифровые товары в боте или Mini App.

Выбор зависит от направления оплаты. Чтобы принимать Stars от клиента за цифровые товары внутри бота или Mini App, используйте официальный Telegram Bot Payments API и счета XTR. Чтобы отправить Stars получателю по username из backend, независимый Fragment Donor API реализует другой сценарий.

Bot Payments использует bot token, invoice или invoice link, pre-checkout и обновления successful_payment. Fragment Donor использует mnemonic кошелька и cookie Fragment на доверенном сервере. Эти данные и риски нельзя смешивать.

Для подарка проверьте получателя, выберите одно количество, отправьте одну покупку и сверяйте неопределённый результат. Для продажи товаров следуйте официальной документации Telegram по invoice, pre-checkout, исполнению и возвратам.

Fragment Donor — независимый проект, а не официальный SDK Telegram, Fragment или TON. Не называйте его пакеты официальными клиентами.

Пример

Receive Stars for digital goods -> Telegram Bot Payments API (XTR)
Send Stars to a username       -> Fragment Donor buy-stars
Gift Premium to a username     -> Fragment Donor buy-premium

Читайте дальше

API Telegram Stars: отправка Stars по username · Как отправить Telegram Stars пользователю по username · Вопросы об API и SDK Fragment Donor

OpenAPI 3.0 · Postman collection