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

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

Как отправить Telegram Stars пользователю по username

Практический процесс проверки получателя, баланса, покупки и сверки при отправке Stars по @username.

При покупке mnemonic кошелька и сессия/cookie Fragment передаются оператору API.

Шаг 1: нормализуйте username получателя и вызовите get-user-info без заголовков кошелька. Остановитесь, если получатель некорректен. Шаг 2: прочитайте баланс на backend и храните TON/USDT как decimal-строки.

Шаг 3: запишите одно внутреннее намерение покупки: username, количество Stars и способ оплаты. Шаг 4: один раз вызовите buy-stars с mnemonic и cookie Fragment, полученными во время выполнения.

Шаг 5: возвращённый успех — только HTTP success с ok=true. Сохраните tx_hash и дополнительные поля. При 429, 503, timeout, неверном ответе или unconfirmed=true отправьте результат на сверку, а не повторяйте покупку.

В автотестах используйте внедряемый mock transport. Поля, ошибки, редактирование секретов и отсутствие дублей проверяются без расходования реальных средств.

Пример

GET /get-user-info/?username=durov
GET /wallet-balance/
POST /buy-stars/

username=durov&amount=100&payment_method=usdt_ton

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

API Telegram Stars: отправка Stars по username · Купить и подарить Telegram Stars через API · Timeout платежа: защита от повторной покупки Telegram Stars

OpenAPI 3.0 · Postman collection