Перехід платежів Telegram-бота на Stars: гід для Stripe і YooKassa

Перехід платежів Telegram-бота на Stars: гід для Stripe і YooKassa

Коротко. Якщо бот продає цифровий товар чи послугу — підписку, пакет даних, додаткові функції — Telegram вимагає оплату в Stars (XTR), а не через Stripe чи YooKassa. Це правило діє відтоді, як з'явився Stars, і не є новиною. Фізичні товари й далі працюють на звичному фіатному провайдері. Справжня міграція — це паралельна робота двох рейок: один інвойс — одна валюта, ніколи не змішані, поки кожна цифрова позиція не перейде на Stars, а фізична — не лишиться на місці. Але для багатьох українських операторів ботів "перехід зі Stripe" — це питання, яке навіть не мало виникати: нижче пояснюємо, чому.

Хочете припинити перемикатися між консолями оплат і плануванням постів вручну? Autogram бере автопостинг на себе, поки ви розбираєтеся з платежами.

Що перевірити перед початком

• Які позиції бота цифрові? Підписки, внутрішні валюти бота, додаткові рівні чи використання, "подібні нематеріальні товари", що продаються всередині застосунку Telegram — усе це підпадає під вимогу Stars.
• Які товари фізичні або доставляються поза Telegram? Товар з доставкою, послуга офлайн, рахунок за роботу, виставлений поза платформою — на це вимога Stars не поширюється, і Stripe чи YooKassa продовжують працювати як раніше.

Більшість ботів, які запитують "як перейти на Stars", насправді мають змішаний асортимент — і чесна відповідь: переводите цифрову половину, решту лишаєте без змін. Плутанина між цими двома категоріями — найпоширеніша помилка в усьому процесі.

Крок 1 — Спершу факт, який часто пропускають: Stripe тут ніколи й не працював

Правило, буквально з офіційної документації Telegram Bot Payments API (перевірено у вересні 2026): цифрові товари й послуги, що продаються через ботів і міні-застосунки, мають оплачуватися виключно в Telegram Stars. Telegram пояснює це відповідністю політикам Apple та Google щодо покупок усередині застосунку — Stars це відповідь Telegram на те саме правило, якому підпорядковується будь-який застосунок, що розповсюджується через App Store чи Google Play.

Але для оператора з України є ще один шар, про який рідко пишуть: Stripe офіційно не входить до списку підтримуваних країн для мерчант-акаунтів — і це не санкційне обмеження, як для Росії чи Білорусі, а звичайна відсутність Stripe на цьому ринку. Тобто "мігрувати з Stripe" для більшості українських ботів — це не крок 1, а факт, який був правдою ще до того, як з'явився Stars: реальною точкою відліку завжди була YooKassa (для тих, хто працює з РФ-аудиторією) або інший локальний провайдер, а не Stripe.

Фізичні товари вимога Stars не торкається. Пост про запуск Stars прямо каже: "покупки фізичних товарів лишаються незмінними — через будь-якого підтримуваного Telegram платіжного провайдера".

Photo by DS stories on Pexels

Крок 2 — Запустіть обидві рейки паралельно ("подвійна валюта" на практиці)

Ось що API не дозволяє обійти: один інвойс Telegram — це одна валюта. Згідно з чейнджлогом Bot API за травень 2024, createInvoiceLink і sendInvoice вимагають, щоб розбивка цін містила рівно один пункт, коли валюта — XTR, а provider_token для інвойсу в Stars має бути повністю пропущено — не можна прикріпити токен провайдера до інвойсу в Stars і не можна вказати в одному інвойсі одразу USD і Stars.

Тож "подвійна валюта" на практиці — це два окремі посилання на інвойс, а не один інвойс:

1. Лишаєте наявний виклик createInvoiceLink для фіатної ціни (через YooKassa чи інший провайдер) без змін.
2. Додаєте другий виклик createInvoiceLink із currency: "XTR", порожнім provider_token і ціною в Stars.
3. Показуєте користувачу обидві кнопки — і даєте вибрати.

Тут же більшість команд помічають, що їхня цінова сітка не перекладається прямо: Telegram не публікує фіксований курс, і за оцінками стороннх трекерів курс коливається приблизно $0,013–$0,02 за Star залежно від платформи й розміру покупки — тож округлюйте ціни в Stars до розумних чисел, а не рахуйте точну конвертацію.

Крок 3 — Переводьте рекурентну цифрову позицію на Stars, решту лишайте на фіаті

Для підписок і інших рекурентних цифрових платежів createInvoiceLink і sendInvoice підтримують subscription_period, але лише коли currency — XTR: рекурентні платежі в Stars не є "опційною валютою", вони прив'язані до Stars за конструкцією. Якщо переводите рекурентний цифровий продукт — це момент, коли варто прибрати старий токен провайдера саме для цього продукту, а не тримати рекурентну підписку на YooKassa "про запас": коли паралельний період завершується, у цифрового SKU лишається рівно один шлях оплати.

Що варто побудувати заздалегідь:

• Повернення коштів. refundStarPayment (додано в Bot API 8.0) — це виклик з боку бота, а не заявка в підтримку Telegram. Вбудуйте це у флоу підтримки вже зараз: "усі продажі Stars остаточні" з боку користувача означає, що ваш бот — єдиний шлях повернення для покупця.
• Очікування щодо виведення. Stars, які ви заробляєте, виводяться через Fragment у TON за умови мінімуму 1000 Stars і 21-денного утримання кожної партії з дня нарахування. Плануйте на це затримку — це не миттєва виплата, як у картковому еквайрингу.

Photo by Tranmautritam on Pexels

Типові помилки

• Сприймати "Stars проти Stripe" як вибір на рівні всього бота. Це вибір на рівні кожної позиції товару, а не бота цілком. Цифрові й фізичні позиції можуть — і зазвичай мають — працювати на різних рейках в одному боті.
• Намагатися відправити один інвойс і з фіатною, і з зірковою ціною. API відхилить розбивку цін, що не є рівно однією валютою — робіть два окремі посилання на інвойс.
• Думати, що Stripe колись був опцією для українського бота. Stripe офіційно не працює в Україні — це прогалина ринку, а не санкція, але результат той самий: реальна точка відліку для міграції — не Stripe, а той локальний провайдер, який уже стояв замість нього.
• Прогнозувати доходи в Stars за номінальною ціною. Те, що отримуєте за Star, менше за те, що заплатив покупець, а конвертація Fragment у TON додає власний спред — плануйте на суму нарахування, а не на прайс-лист.

Що читати далі

• Telegram Star Subscriptions: налаштування для рекурентного доходу — механіка subscription_period, на яку спирається крок 3 цієї міграції.
• Повернення Telegram Stars: як насправді працює refundStarPayment — побудуйте це до того, як прибираєте старий флоу повернень.
• TON до фіату для операторів каналів: виведення через Fragment — що відбувається після того, як Stars потрапили на баланс.
• Монетизація Telegram Stars: інструментарій для власника каналу у 2026 — ширша картина монетизації, не лише платежі бота.

FAQ

Чи маю я переводити на Stars усе, що продає бот?

Ні — лише цифрові товари й послуги, що продаються всередині застосунку Telegram: підписки, внутрішні валюти бота, додаткові функції та подібні нематеріальні товари. Фізичні товари й офлайн-послуги можуть лишатися на Stripe, YooKassa чи будь-якому іншому підтримуваному провайдері.

Чи може один інвойс мати і фіатну ціну, і ціну в Stars?

Ні. createInvoiceLink і sendInvoice вимагають, щоб розбивка цін містила рівно один пункт, коли currency — XTR, і відхилять змішану позицію фіат-плюс-Stars. Пропонуйте два окремі посилання на інвойс і дайте покупцю обрати.

Чи працює Stripe в Україні взагалі?

Ні — Україна відсутня у списку офіційно підтримуваних країн Stripe для мерчант-акаунтів. Це прогалина доступності ринку, а не санкційне обмеження (яке стосується Росії й Білорусі), але практичний результат однаковий: український оператор бота не міг відкрити стандартний акаунт Stripe для прийому платежів.

Чи лишається YooKassa робочим варіантом для Telegram-ботів?

Так — власна документація YooKassa щодо інтеграції з Telegram-ботами лишається чинною, останнє оновлення — квітень 2026 року. Це робочий канал для всього, що не підпадає під обов'язкову вимогу Stars для цифрових товарів.

Як працюють повернення коштів на Stars?

Через метод Bot API refundStarPayment, доданий у Bot API 8.0 — ваш бот має викликати його самостійно. Умови Telegram кажуть, що покупки в Stars остаточні з боку покупця, тож якщо бот не доставив обіцяне — ваш бот є єдиним шляхом повернення для покупця.

Скільки часу до виведення зароблених Stars?

Виведення через Fragment потребує мінімуму 1000 Stars на балансі, і кожна партія Stars розблоковується через 21 день з моменту нарахування — плануйте грошовий потік із врахуванням цієй затримки, а не миттєвої виплати.

Скільки насправді коштує один Star у реальних грошах?

Telegram не публікує фіксований курс, і він змінюється залежно від платформи й розміру покупки — за оцінками сторонніх трекерів, орієнтовно $0,013–$0,02 за Star станом на 2026 рік. Округлюйте ціни в Stars до розумних чисел, а не гоняйтеся за точною конвертацією, яка все одно змінюється.

Підсумок

Тарифи в Autogram. Підключіть перший канал і отримайте 7 днів доступу до Solo з AI-бюджетом $1. Банківська картка не потрібна.

Джерела зображень

• Головне: Photo by Mikhail Nilov on Pexels
• Вбудоване 1: Photo by DS stories on Pexels
• Вбудоване 2: Photo by Tranmautritam on Pexels