Довідка
Як вивести Telegram Stars на картку: інструкція для власника бота
Оновлено
Ця інструкція для тих, у кого є бот або Mini App, що приймає оплату зірками. Тут описано, як зірки потрапляють на баланс, коли їх можна вивести, скільки це в гривнях і що треба підготувати заздалегідь.
Правила Telegram змінюються. Перед виведенням звірте цифри з офіційними умовами, посилання є в кінці сторінки.
1. Звідки беруться зірки на балансі бота
Telegram Stars — це внутрішня валюта Telegram. Люди купують зірки в самому Telegram і платять ними в ботах і Mini App за цифрові товари: підказки, додаткові спроби, доступ до рівнів.
Для цифрових товарів у ботах Telegram дозволяє лише оплату зірками. Кожна оплата надходить на баланс бота, а баланс належить акаунту, який створив бота в @BotFather.
2. Коли зірки можна вивести
- Зароблені зірки стають доступними не одразу. За умовами Telegram для розробників кожна оплата може чекати до 21 дня. Відлік іде окремо для кожної оплати, а не для всього балансу.
- Мінімальна сума виведення — 1 000 зірок. Меншу суму вивести не вийде.
- Затримка потрібна на випадок повернення. Якщо бот повертає зірки покупцеві або покупець виграє спір, сума списується з балансу бота.
3. Скільки це в гривнях
Telegram нараховує розробнику еквівалент 0,013 $ за кожну зірку. Нижче приклад за курсом 41,5 ₴ за долар.
| Зірок | Долари | Гривні, приблизно |
|---|---|---|
| 1 000 | 13 $ | 540 ₴ |
| 5 000 | 65 $ | 2 700 ₴ |
| 10 000 | 130 $ | 5 400 ₴ |
Виплата приходить не в гривнях і не в доларах, а в криптовалюті мережі TON через Fragment. Сума в доларах перераховується в TON за курсом на момент виведення. Далі TON треба обміняти на гривні, і на цьому кроці будуть свої курс і комісії.
Є й інший спосіб використати зірки. Їх можна витратити на рекламу в Telegram Ads, і тоді одна зірка дорівнює 0,02 $ рекламного кредиту. Якщо ви все одно плануєте платити за рекламу в Telegram, це вигідніше за виведення.
4. Що підготувати заздалегідь
- Двоетапну перевірку. Увімкніть хмарний пароль на акаунті, який володіє ботом. Без нього Telegram не дасть вивести зірки. Пароль має бути старшим за добу, і сеанс, з якого ви виводите, теж має бути старшим за добу.
- Гаманець TON. Потрібен гаманець, який можна підключити до Fragment через TON Connect, наприклад Tonkeeper.
- Спосіб обміняти TON на гривні. Це може бути криптобіржа чи обмінник. Конкретний сервіс ми не радимо: порівняйте комісії, ліміти й умови перевірки особи.
- Податки. Дохід від бота — це дохід. Як його оформити й задекларувати, краще спитати бухгалтера.
5. Як вивести: покроково
- Перевірте, що на балансі бота є щонайменше 1 000 доступних зірок. Зірки, які ще чекають свого строку, вивести не можна.
- У Telegram відкрийте профіль бота й перейдіть у розділ із балансом зірок.
- Натисніть кнопку виведення, вкажіть суму й підтвердьте її хмарним паролем.
- Telegram відкриє Fragment. Підключіть гаманець TON і підтвердіть виплату.
- Коли TON надійдуть на гаманець, обміняйте їх на гривні й виведіть на картку через обраний сервіс.
6. Часті помилки
- Немає хмарного пароля або він щойно змінений. Виведення не спрацює, доки пароль не простоїть добу.
- Виведення з нового пристрою. Сеанс, створений менше доби тому, теж блокує виведення. Виводьте з пристрою, на якому давно ввійшли в Telegram.
- Рахувати баланс як уже доступні гроші. Частина зірок ще чекає свого строку, а повернення можуть зменшити баланс.
- Плутати ціну купівлі й виплату. Гравець платить за зірку більше, ніж отримує розробник. У ціні купівлі є комісії магазинів застосунків і Telegram.
7. Джерела
Перевірено 10 жовтня 2026 року.
- Умови Telegram для розробників ботів, розділи 6.2.1, 6.2.3 і 6.2.4: строк до 21 дня, 0,013 $ за зірку, 0,02 $ у Telegram Ads, повернення.
- Оплата зірками в ботах: лише зірки для цифрових товарів, повернення через refundStarPayment.
- Метод payments.getStarsRevenueWithdrawalUrl: виведення вимагає хмарного пароля, пароль і сеанс мають бути старшими за 24 години.
- Мінімум у 1 000 зірок наводять AdminHub і vc.ru.