Складні Telegram Mini App: авторизація, оплати, бекенд і навантаження

2026-11-14

Простий Telegram Mini App - це вебсторінка, відкрита всередині месенджера. Таке можна зробити швидко. Але мені пишуть з іншими задачами: маркетплейс з продавцями і модерацією, сервіс бронювання з оплатою і календарем, гра з рейтингами і внутрішньою економікою, CRM для команди продажів, яка живе в Telegram, програма лояльності на десятки тисяч користувачів. Тут Mini App - лише інтерфейс, а основна робота відбувається на бекенді.

У статті розповідаю, з чого складається такий проєкт і де найчастіше помиляються. Про загальний підхід до Mini App я писав раніше: https://zavada.dev/ua/blog/how-i-build-telegram-mini-apps.

Авторизація, якій можна довіряти

Telegram передає застосунку initData - дані про користувача, підписані ключем бота. Найпоширеніша і найнебезпечніша помилка - довіряти цим даним на клієнті або брати user id з запиту без перевірки. Тоді будь-хто може видати себе за іншого користувача, отримати чужі бонуси чи доступ до адмінки.

Правильно так: кожен запит до API несе initData, сервер перевіряє підпис і строк дії, і лише після цього створює сесію. Ролі (клієнт, продавець, менеджер, адміністратор) зберігаються на сервері і перевіряються в кожному ендпоінті, а не приховуються кнопками в інтерфейсі.

Оплати всередині Telegram

Варіанти оплат у Mini App
СпосібКоли підходитьНа що зважати
Telegram StarsЦифрові товари і послуги всередині застосункуДля цифрових товарів це вимога правил платформ; повернення і бухгалтерія мають свої особливості
Платіжні провайдери через ботаФізичні товари і послугиПідтвердження оплати лише через серверний апдейт, не з клієнта
Зовнішній еквайрингСкладні сценарії: підписки, розщеплення платежів, B2BПовернення користувача в застосунок і синхронізація статусу
КриптоплатежіІгри та міжнародна аудиторіяПідтвердження транзакцій, курси, вимоги комплаєнсу

У будь-якому випадку статус оплати змінюється лише на сервері після підтвердження від провайдера, з ідемпотентністю і журналом. Детальніше про надійні платежі та інтеграції: https://zavada.dev/ua/blog/crm-erp-and-payment-integrations.

Бекенд, а не лише фронтенд

У складному Mini App більшість логіки живе на сервері: каталоги, замовлення, бронювання з перевіркою конфліктів, баланси і транзакції внутрішньої валюти, реферальні програми, антифрод. Зазвичай це Node.js або Python з PostgreSQL, Redis для кешу і черг, і окремий бот, який надсилає сповіщення, нагадування і статуси замовлень.

Бот і Mini App працюють разом: бот приводить користувача в потрібний екран через deep link, надсилає нагадування про неоплачене замовлення, повідомляє продавця про нову заявку. Розсилки на десятки тисяч користувачів ідуть через чергу з урахуванням лімітів Telegram, інакше бот отримає блокування.

Realtime і ігрова логіка

Чати між покупцем і продавцем, статуси замовлень у реальному часі, мультиплеєрні ігри і рейтинги потребують WebSocket або аналогічного каналу. В іграх критично, щоб результати рахував сервер, а не клієнт: інакше рейтинг і нагороди швидко зламають. Про ігри в Mini App окрема стаття: https://zavada.dev/ua/blog/online-games-in-telegram-mini-apps.

Адмінка, інтеграції і аналітика

Бізнесу потрібна не лише клієнтська частина. Адмін-панель для модерації, керування каталогом, замовленнями, користувачами і виплатами. Інтеграції з CRM, складом, обліком і доставкою. Аналітика воронки: скільки людей відкрили застосунок, дійшли до оплати, повернулися. Часто адмінка - це окремий вебзастосунок, а частина функцій для менеджерів доступна просто в Telegram.

Навантаження і піки

Mini App може отримати тисячі користувачів за годину після однієї розсилки або згадки у великому каналі. Тому з самого початку: статика через CDN, легкий перший екран, кешування, черги для важких операцій, обмеження частоти запитів, горизонтальне масштабування API і моніторинг помилок та затримок. Навантажувальне тестування перед великим запуском дешевше, ніж падіння в момент піку.

Чек-лист складного Mini App
ОбластьЩо має бути
БезпекаПеревірка initData на сервері, ролі, rate limiting, захист від повторних запитів
ОплатиСерверне підтвердження, ідемпотентність, журнал транзакцій, повернення
БекендPostgreSQL, черги, бот для сповіщень і deep links
UXТема Telegram, кнопки MainButton і BackButton, швидкий перший екран
ОпераціїАдмінка, логи, моніторинг, аналітика воронки
МасштабCDN, кеш, ліміти розсилок, навантажувальні тести

Як проходить проєкт

1. Бриф і розбір сценаріїв: хто користувачі, які ролі, як заробляє продукт, з якими системами треба інтегруватися.

2. Архітектура і план етапів: що входить у першу версію, що далі.

3. Розробка з регулярними демо в тестовому боті.

4. Запуск, моніторинг під реальним трафіком і подальший розвиток.

Вартість залежить від кількості ролей, оплат, інтеграцій і вимог до навантаження, тому я називаю ціну після брифу, з письмовим обсягом робіт і етапами.

Висновок

Складний Telegram Mini App - це повноцінний продукт з бекендом, безпекою, платежами і операційною частиною, просто з інтерфейсом всередині месенджера. Якщо закласти це з першого дня, застосунок витримає і перші тисячі користувачів, і наступні сотні тисяч.

Якщо ви плануєте Mini App з оплатами, ролями, інтеграціями чи ігровою механікою, подивіться, як я працюю з такими проєктами: https://zavada.dev/ua/telegram-mini-apps. Опишіть ідею у формі заявки: https://zavada.dev/ua/contacts?service=telegram-mini-apps

Шукаєте розробника надовго?

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

Запитайте про досвід чи послуги