Крипто-платежі в міні-додатках Telegram

Telegram вимагає власну валюту Stars (XTR) для цифрових товарів та послуг, що продаються всередині ботів та Mini Apps. 

Крипто-платіжні шлюзи використовуються для всього, що не покриває Stars: реальні послуги, фізичні товари, баланси на платформах, депозити та виплати B2B. Цей посібник пояснює, що насправді дозволено, два практичні способи налаштування прийому криптовалюти, які витрати, а також обхідний шлях для однієї речі, яку криптовалюта поки що не може зробити — регулярні підписки.

Боти проти Міні-додатків

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

Міні-додаток відрізняється: це повноцінний веб-додаток, який відкривається безпосередньо в Telegram як WebView, з власним інтерфейсом, навігацією і — якщо ви хочете — власним процесом оплати, вбудованим в інтерфейс, а не прикріпленим як посилання. 

Криптогаманець — доступний з іконки вкладення в будь-якому чаті Telegram — є хорошим прикладом того, як це насправді виглядає на практиці: баланси, потоки надсилання/отримання, власна навігація, все без виходу з чату.

Якщо ви створюєте підписний сервіс, маркетплейс або платформу iGaming, ви, напевно, створюєте Міні-додаток, а не простого бота. Кроки налаштування, наведенні нижче, застосовуються до обох, але досвід оформлення замовлення помітно кращий у Міні-додатку, оскільки сторінка оплати може бути в межах вашого інтерфейсу, а не перенаправляти користувача кудись ще.

Telegram Stars проти крипто-шлюзів

Документація Telegram щодо бот-платежів вимагає, щоб цифрові товари та послуги, що продаються всередині бота або Міні-додатку, використовували Telegram Stars (код валюти XTR) — не картки, не криптовалюту. Це охоплює такі речі, як розблокування преміум-контенту, купівля внутрішньоігрової валюти для гри або оплата цифрової підписки, яка повністю споживається всередині Telegram. 

Де крипто-платіжні шлюзи є правильним і легітимним інструментом:

• Послуги, що надаються поза Telegram — VPN-з'єднання, хостинг, SaaS-продукт, консалтинг, все, що користувач споживає поза платформою, навіть якщо він платить за це всередині бота Telegram.
• Фізичні товари — все, що відправляється або передається особисто.
• Баланс платформи та депозити — поповнення гаманця всередині вашого додатку (це також практичне рішення для проблеми підписки, описаної нижче).
• B2B та трансакції між країнами — виплати афіліатам, розрахунки на ринку між бізнесами, які повністю виходять за межі визначення "цифрові товари, що продаються в додатку" Telegram.

Платежі карткою всередині WebView Mini App

Є технічна причина, чому крипто зазвичай відчувається більш плавно, ніж картки, особливо в середовищі Telegram. Mini Apps працюють всередині WebView — вбудованого браузера, а не повноцінного — і процесори карток часто стикаються з труднощами в цьому середовищі: перевірки на шахрайство можуть давати збій, а вікна підтвердження 3D Secure часто не відкриваються належним чином або не повертають контроль на сторінку, залишаючи клієнта в середині платежу без чіткого наступного кроку.

Крипто обходить цю проблему, оскільки в циклі немає мережі карток і жодного етапу 3D Secure, який міг би зламатися всередині WebView. Давайте розглянемо це детальніше. 

Два способи приймати крипто в Telegram

Звичайно, ви завжди можете вручну поділитися адресою гаманця та перевірити платежі самостійно — але це не масштабується за межі випадкових одноразових рахунків. Для всього, що ви будуєте на тривалий термін, ви насправді обираєте між двома автоматизованими моделями.

Автоматизоване прийняття під управлінням

Це те, що насправді хочуть більшість бізнесів. Ви інтегруєте платіжний шлюз — через API або Hosted Checkout — і він обробляє весь процес:

• Шлюз автоматично генерує рахунок і платіжні дані для кожної покупки, витягуючи адресу з пулу та розраховуючи суму до сплати.
• Клієнт надсилає платіж; шлюз автоматично співвідносить його з рахунком.
• Шлюз сповіщає вашу бекенд-систему через вебхук, як тільки платіж підтверджено, щоб ви могли автоматично надати доступ.
• Кошти зараховуються на ваш торговий баланс — або в тій же криптовалюті, якою заплатив клієнт, або автоматично конвертуються в стейблкоїн або фіат, що корисно, якщо ваше ціноутворення встановлено в USD, і ви не хочете піддаватися волатильності крипто.

Читати далі: Вбудовані крипто-платежі: практичний посібник для ринків, SaaS та цифрових платформ

Всередині Telegram це виглядає по-різному в залежності від того, як ви інтегруєте:

• Через API ви самостійно створюєте інтерфейс у повідомленнях вашого бота або всередині екранів вашого Mini App. 
• Через Hosted Checkout Mini App відкриває веб-переглядач з готовою платіжною сторінкою — без необхідності розробки бекенду з вашого боку, і це працює однаково, незалежно від того, чи ви створюєте бота, чи повноцінний Mini App.

Автоматизоване некостодіальне прийняття (смарт-контракт)

Тут кошти взагалі не проходять через шлюз. Клієнт підключає свій гаманець безпосередньо до вашого оформлення замовлення і платить через смарт-контракт прямо на ваш гаманець. Шлюз бере невелику комісію за обробку, але ніколи не зберігає кошти; розрахунок відбувається повністю всередині самої транзакції.

Фактичний потік користувача виглядає так:

1. Клієнт натискає "Підключити гаманець".
2. Їх перенаправляють до додатку гаманця для підтвердження з'єднання — на мобільному це відкриває сам додаток гаманця; на настільному комп'ютері — розширення браузера або сканування QR-коду.
3. Їх повертають до вашого оформлення замовлення.
4. Вони підтверджують деталі транзакції.
5. Їх знову перенаправляють до їхнього гаманця для підписання платежу.
6. Їх повертають на сторінку підтвердження, яка чекає на завершення транзакції в блокчейні, перш ніж позначити замовлення як завершене.

Ще одна технічна деталь: API-сповіщення не є частиною смарт-контракту. Сам переказ в блокчейні — це єдине, що відбувається в блокчейні — все інше (оновлення статусу замовлення, надання доступу, надсилання підтвердження) є окремою логікою на вашій стороні, яка активується вебхуком, як тільки шлюз виявляє транзакцію.

Читати далі: Посібник для торговців по смарт-контрактам та оформленню замовлення через гаманець

Читати далі: Як користувачі криптовалюти насправді втрачають гроші у 2026 році

TON (Gram) як рідний блокчейн Telegram

TON (The Open Network), нещодавно знову перейменований на свою первісну назву Gram, є єдиним вибором для TON Connect у наведеному вище некостодіальному потоці. Це не рекомендація — це правило. Власні Умови обслуговування розробників ботів Telegram вимагають, щоб будь-який Міні-додаток, що торкається функціональності гаманця, підключався виключно через TON Connect.

Чому Telegram це вимагає: TON є власним блокчейном Telegram, і компанія має прямий, зростаючий інтерес у його успіху. У травні 2026 року Telegram взяв під прямий контроль інфраструктуру TON: компанія заблокувала 2,2 мільйона токенів, щоб стати найбільшим валідатором мережі, замінивши Фонд TON як основного оператора. 

Костодіальне прийняття через API Volet.com або Hosted Checkout взагалі не стикається з цим — крок підключення гаманця не відбувається всередині самого Міні-додатку, тому які активи ви можете приймати не обмежуються таким чином.

Читати далі: Яку блокчейн-мережу вибрати за випадком використання 

Проблема підписки

Сьогодні жоден блокчейн не підтримує автоматичне повторне виставлення рахунків так, як це робить мережа карток — найближчі аналогії вимагають або надання смарт-контракту постійного дозволу на безстрокове зняття коштів (значний компроміс у безпеці, який більшість бізнесів не повинні приймати), або створення чогось настільки крихкого, що це не варто відправляти.

Практичне рішення — це поповнювальний баланс замість підписки:

• Користувач поповнює баланс у вашому Міні-додатку, використовуючи криптовалюту — через той же костодіальний або некостодіальний потік, описаний вище.
• Ваш додаток відраховує вартість підписки з цього балансу за графіком, який ви контролюєте.
• Ви навіть можете утримувати та відображати цей баланс у фіатних термінах (щоб користувач бачив "$9.99 залишок" замість коливальної крипто-сумми), при цьому все ще приймаючи поповнення в криптовалюті.

Це вимагає трохи більше розробницької роботи всередині вашого Міні-додатку, але це версія, яка насправді працює сьогодні, не просячи користувачів передавати постійний дозвіл смарт-контракту.

Пропозиція Volet.com для платежів у Telegram

Крипто-придбання через Volet.com не вимагає мінімального обороту для початку, без налаштувальних зборів для API або Hosted Checkout, і без щомісячної вартості підписки.

Вказана ставка є базовим рівнем для прийняття платежів без конвертації. Додаткова конвертація під час розрахунку оцінюється окремо — і найпоширеніший випадок, стейблкоїни в USD, не коштує нічого додатково. Ось що насправді коштує конвертація під час розрахунку:

• USDT або USDC → USD: безкоштовно
• USDT або USDC → EUR: 0.5%
• BTC або ETH → USDT або USDC: 0.5%
• Будь-яка інша криптовалюта → стейблкоїн: 1%

Більше деталей: Комісії бізнес-акаунтів Volet.com

Приклад: одноразове поповнення балансу VPN-сервісу на $9.99, сплачене в USDT.

Костодіальний (API або Hosted Checkout):

1. Клієнт надсилає вам 9.99 USDT зі свого гаманця.
2. Вам зараховують $9.99 мінус комісія за придбання 0.25% (близько $0.02), тому приблизно $9.97 потрапляє у ваш бізнес-баланс Volet.com.
3. Цей баланс накопичується з кожним поповненням клієнта, а те, що коштує його виведення, залежить від того, що ви робите далі. 
4. Найдешевший варіант: пропустіть фіат і виведіть, скажімо, $1,000 на свій крипто-гаманець в тому ж активі — лише фіксована комісія мережі (близько $0.5–3.5 в залежності від мережі), тому ви збережете приблизно $996.50–$999.50. 
5. Якщо ви хочете фіат, конвертуйте в момент, коли приймаєте кожен платіж (розраховуючи в USD замість утримання USDT), а не конвертуйте пізніше — ця конвертація безкоштовна, тому виведення отриманого балансу $1,000 USD на ваш банк коштує лише комісію за виведення, від 1% в залежності від методу, залишаючи вам приблизно $990. 
6. Конвертація вже накопиченого балансу USDT в USD після факту, всередині вашого акаунту, коштує 1% зверху — плюс така ж комісія за виведення — тому ви в кінцевому підсумку отримаєте приблизно $980.

Некостодіальний (смарт-контракт):

1. Клієнт підключає свій гаманець і підписує той же платіж на 9.99 USDT.
2. Смарт-контракт направляє платіж безпосередньо у ваш гаманець, мінус та ж комісія за обробку 0.25% — ви отримуєте приблизно $9.97, вже сидячи у вашому гаманці.
3. Немає окремого кроку виведення і жодної комісії за виведення, оскільки кошти ніколи не перебували у шлюзі на початку. 
4. Збільште це до тих же $1,000 у загальних платежах клієнтів, використаних у прикладі з костодіальним варіантом вище, і порівняння є простим: $997.50 потрапляє безпосередньо у ваш гаманець.