Telegram Mini App с оплатой: Telegram Stars, ЮKassa, СБП — полное руководство

Telegram Mini App с оплатой — это приложение внутри Telegram, которое принимает платежи прямо в мессенджере. Пользователь не переходит на внешние сайты, не вводит данные карты в незнакомых формах — всё происходит в привычном интерфейсе Telegram.

Все способы оплаты в Telegram Mini App:

1. Telegram Payments (встроенная оплата). Стандартный платёжный шлюз Telegram. Пользователь нажимает кнопку «Оплатить», видит форму ввода карты прямо в Telegram, вводит данные и подтверждает платёж. Поддерживает Visa, Mastercard, МИР. Работает через провайдеров: Stripe, YooKassa, Sberbank, PayMaster, Tranzzo и другие.

2. Telegram Stars (внутренняя валюта). Пользователи покупают Stars за реальные деньги через Telegram и оплачивают товары/услуги. Минимальный путь до оплаты: 3 клика. Комиссия Telegram: 15-30% от суммы. Идеально для цифровых товаров: стикеры, подписки, контент, консультации.

3. ЮKassa (Яндекс.Касса). Популярный российский платёжный агрегатор. Через Mini App можно подключить: банковские карты (Visa, MC, МИР), СБП, SberPay, Тинькофф, ЮMoney, наличные через терминалы, банковские переводы. Комиссия: от 2,8% до 3,5%.

4. СБП (Система Быстрых Платежей). Оплата через банковское приложение по QR-коду или ссылке. Комиссия для юрлиц: от 0,4% до 0,7%. Самый дешёвый способ. Работает через любой банк-эквайер.

5. Криптовалюта (TON/USDT). Telegram поддерживает оплату через блокчейн TON. Пользователи платят с TON-кошелька. Комиссия: минимальная (газ блокчейна). Подходит для международных продаж и цифровых товаров.

Какой способ выбрать: - Продаете физические товары в России → ЮKassa (карта + СБП) - Продаете цифровые контент/подписки → Telegram Stars - Работаете с юрлицами → СБП (минимальная комиссия) - Международные продажи → Telegram Payments + крипто TON - Максимум конверсии → комбинация 2-3 способов

Подробнее о магазине в Mini App и разработке сервисов.

Telegram Stars — внутренняя валюта экосистемы Telegram. Пользователи покупают Stars за реальные деньги (через Google Play, Apple Pay, карту) и тратят их на товары и услуги внутри Telegram. Для бизнеса Stars — самый быстрый путь до оплаты.

Как работают Telegram Stars:

Шаг 1: Пользователь покупает Stars. Через настройки Telegram или при первом использовании. Цена: от 50 Stars за $0.99 (≈90 ₽). Пользователь уже имеет Stars, если покупал стикеры или подписки.

Шаг 2: Mini App запрашивает оплату. Через Telegram Bot API вызывается метод createInvoiceLink с параметром currency: "XTR" (Stars). Telegram показывает экран подтверждения оплаты с суммой в Stars.

Шаг 3: Пользователь подтверждает. Один тап — оплата списывается. Mini App получает callback с подтверждением. Всего 2-3 клика от выбора товара до оплаты.

Шаг 4: Бизнес получает Stars. Stars зачисляются на аккаунт бота. Можно вывести через Fragment.com на TON-кошелёк, а затем обменять на фиат. Или использовать Stars для продвижения в Telegram (реклама).

Техническая интеграция (псевдокод): 1. Вызвать Bot API: createInvoiceLink с title, description, payload, currency "XTR", prices (amount в Stars) 2. Отправить полученную ссылку пользователю как inline-кнопку 3. Обработать pre_checkout_query от Telegram (подтверждение доступности товара) 4. Обработать successful_payment (товар оплачен, выдать доступ)

Комиссия Telegram Stars: - Telegram берёт 30% от суммы при продаже цифровых товаров - Telegram берёт 15% от суммы при продаже физических товаров - Вывод через Fragment: комиссия ~5%

Когда Stars выгоднее карты: - Конверсия Stars на 40-60% выше, чем переход на внешний эквайринг - Нет необходимости подключать платёжную систему - Пользователи уже имеют Stars (800 млн+ пользователей Telegram) - Идеально для микроплатежей: 50-500 Stars (45-450 ₽) - Нет chargeback (возвратов)

Когда Stars НЕ выгодно: - Физические товары дороже 5 000 ₽ (комиссия 15% ощутима) - B2B-продажи (юрлица не могут оплатить Stars) - Нужен чек 54-ФЗ (Stars не поддерживают ОФД)

Подробнее о примерах Mini App с оплатой и магазине в Mini App.

ЮKassa (Яндекс.Касса) — самый популярный платёжный агрегатор в России. Интеграция с Telegram Mini App позволяет принимать оплату картами, СБП, SberPay и другими способами прямо внутри мессенджера.

Пошаговая интеграция ЮKassa:

Шаг 1: Регистрация в ЮKassa. Создаёте аккаунт в ЮKassa, проходите верификацию (ИП или ООО). Получаете shopId и secretKey. Время: 1-3 рабочих дня.

Шаг 2: Настройка платёжной модели. ЮKassa поддерживает две модели: получатель (вы принимаете деньги напрямую) и партнёр (вы — агрегатор). Для магазина в Mini App — модель «получатель».

Шаг 3: Создание платежа через API. Бэкенд Mini App создаёт платёж через API ЮKassa и получает ссылку на оплату. Telegram показывает встроенную форму оплаты. Параметры: сумма, валюта, описание, metadata (ID заказа), confirmation (redirect на return_url).

Шаг 4: Обработка webhook. ЮKassa отправляет webhook при изменении статуса платежа. Бэкенд обновляет статус заказа и уведомляет пользователя через бота.

Шаг 5: Возвраты и отмены. ЮKassa поддерживает полные и частичные возвраты через API. Бэкенд инициирует возврат, пользователь получает уведомление.

Техническая интеграция (псевдокод): 1. POST /payments в API ЮKassa с amount, currency "RUB", capture: true, confirmation: { type: redirect, return_url }, description, metadata 2. Получить confirmation_url из ответа 3. Перенаправить пользователя на confirmation_url или показать в WebView 4. Обработать webhook от ЮKassa: payment.succeeded → выдать товар, payment.canceled → отменить заказ

Способы оплаты через ЮKassa в Mini App:

Важные нюансы: - 54-ФЗ (онлайн-касса): ЮKassa интегрирована с ОФД. Автоматически формирует чеки и отправляет в ФНС. Нужна регистрация кассы или использование сервиса «ЮKassa Онлайн-касса». - Холдирование: можно заблокировать сумму на карте и списать только после подтверждения наличия товара. - Рекуррентные платежи: для подписок — автоматическое списание каждый месяц. - Рассрочка: ЮKassa поддерживает рассрочку через банки-партнёры.

Сроки интеграции: 3-5 дней. Включает: настройку аккаунта ЮKassa, интеграцию API, обработку webhook, тестирование платёжного потока.

Подробнее о магазине в Mini App и как создать Mini App.

Стоимость интеграции оплаты в Telegram Mini App зависит от количества способов оплаты, сложности бизнес-логики и необходимости онлайн-кассы. Вот реальные цены.

Базовая интеграция (1 способ оплаты) — от 15 000 до 30 000 ₽: Подключение одного способа: Telegram Payments, Stars или ЮKassa. Базовый платёжный поток: создание счёта → оплата → подтверждение. Без холдирования, возвратов, рекуррентных платежей. Срок: 2-3 дня.

Стандартная интеграция (2-3 способа) — от 30 000 до 60 000 ₽: Подключение 2-3 способов оплаты (карта + СБП + Stars). Холдирование, частичные возвраты, webhook-обработка. Интеграция с онлайн-кассой (54-ФЗ). Срок: 5-7 дней.

Полная интеграция (все способы + подписки) — от 60 000 до 120 000 ₽: Все способы оплаты. Рекуррентные платежи (подписки). Рассрочка. Мультивалютность. Интеграция с CRM и бухгалтерией. Автоматические чеки. Срок: 7-14 дней.

Операционные расходы (ежемесячно):

Сравнение комиссий при обороте 500 000 ₽/мес:

Рекомендация: для физических товаров оптимальный микс — ЮKassa (карта + СБП) как основной способ + Telegram Stars как дополнительный. Для цифровых товаров — Stars как основной, ЮKassa как запасной.

Подробнее о стоимости Mini App и заказе Mini App.

Расскажу, как онлайн-школа английского языка запустила Mini App с оплатой через Telegram Stars и ЮKassa, увеличив конверсию в продажу на 65%.

Задача: Онлайн-школа с 2 000+ учеников продавала курсы через лендинг + Telegram-бот для записи. Проблемы: 40% пользователей не доходили до оплаты (переход на внешний сайт), высокий процент брошенных корзин, сложный процесс покупки. Задача — продавать курсы прямо в Telegram с минимальным путём до оплаты.

Что внедрили: Telegram Mini App с двумя способами оплаты: - Telegram Stars для мини-курсов и разовых уроков (50-300 Stars) - ЮKassa (карта + СБП) для пакетов курсов (3 000-15 000 ₽) - Автоматическая выдача доступа после оплаты - Push-уведомления о начале занятий - Промокоды и скидки для Telegram-подписчиков

Технологии: React + TypeScript (Mini App), Node.js + Express (API), PostgreSQL, Telegram Bot API, Stars API, ЮKassa API, Notion (CMS курсов).

Результаты за 60 дней:

Финансовые показатели: - Стоимость разработки: 180 000 ₽ - Операционные расходы: 8 000 ₽/мес - Прирост выручки: +520 000 ₽/мес - Экономия на комиссиях (vs лендинг + эквайринг): +12 000 ₽/мес - ROI за первый месяц: 289% - Окупаемость: 11 дней

Ключевые инсайты: - Telegram Stars для мини-курсов показал конверсию 22% — в 2,5 раза выше, чем оплата картой - Студенты оценили оплату в 2 клика: «купил урок на перемене» - Автоматическая выдача доступа после оплаты сэкономила 15 часов/мес на ручной обработке - Промокод «STARS10» для Telegram-подписчиков привлёк 280 новых учеников

Школа планирует запустить абонементы через рекуррентные платежи ЮKassa. Подробнее о магазине в Mini App и примерах Mini App.

Безопасность платежей — главный вопрос при интеграции оплаты в Telegram Mini App. Вот как обеспечиваются безопасные транзакции и что нужно знать разработчику.

Уровни безопасности:

1. Шифрование данных. Telegram Payments использует end-to-end шифрование. Данные карты не попадают на ваш сервер — обработка идёт через защищённый канал Telegram → платёжный провайдер. PCI DSS compliance обеспечивает провайдер (ЮKassa, Stripe).

2. Аутентификация пользователя. Telegram гарантирует, что платёж инициирует именно владелец аккаунта. Двухфакторная аутентификация (2FA) в Telegram защищает от несанкционированного доступа. Данные initData Mini App подписаны HMAC — подделать невозможно.

3. Валидация на сервере. Никогда не доверяйте клиентской части. Всегда проверяйте сумму и статус оплаты на бэкенде через API провайдера. Не выдавайте товар на основании данных из Mini App — только после подтверждения от ЮKassa/Stripe.

4. Защита от мошенничества. ЮKassa и Stripe имеют встроенные антифрод-системы: проверка 3D Secure, velocity checks (ограничение частоты платежей), blacklist карт. Telegram Stars не имеют chargeback — защита от «дружественного мошенничества».

5. Безопасность webhook. Проверяйте подпись webhook от ЮKassa/Stripe. Используйте HTTPS для endpoint. Не обрабатывайте один и тот же webhook дважды (идемпотентность). Логируйте все входящие webhook.

Чек-лист безопасности: - Всегда проверяйте статус платежа через API провайдера перед выдачей товара - Используйте HTTPS для всех endpoint - Проверяйте подпись webhook - Логируйте все транзакции - Не храните данные карт на своём сервере - Используйте идемпотентные ключи для предотвращения дублирования - Настройте алерты на подозрительную активность

Юридические требования: - 54-ФЗ: онлайн-касса с чеками для физических лиц (через ОФД) - 152-ФЗ: защита персональ данных (хранение, обработка, согласие) - Лицензия: если работаете как платёжный агрегатор — нужна лицензия ЦБ

Подробнее о магазине в Mini App и как создать Mini App.

Выбор способа оплаты зависит от типа товара, аудитории и бизнес-модели. Вот подробное сравнение всех вариантов.

По конверсии в оплату: Telegram Stars показывает самую высокую конверсию — путь до оплаты всего 2-3 клика без ввода данных карты. ЮKassa (карта) — стандартная конверсия. СБП — средняя (нужно открыть банковское приложение). Крипто — низкая (мало кто держит TON-кошелёк).

По комиссии: СБП — самый дешёвый (0,4-0,7%). ЮKassa — стандартный (2,8-3,5%). Telegram Stars — дорогой для цифровых товаров (30%), но приемлемый для физических (15%). Крипто — минимальная (~0%).

По скорости зачисления: Все способы мгновенные, кроме крипто (1-5 минут на подтверждение блокчейна).

Рекомендации по типу бизнеса:

E-commerce (физические товары): Основной: ЮKassa (карта + СБП). Дополнительный: Telegram Stars. Причина: нужна онлайн-касса, чеки, возвраты. Stars как быстрый вариант для недорогих товаров.

Цифровые товары и подписки: Основной: Telegram Stars. Дополнительный: ЮKassa (карта). Причина: максимальная конверсия, микроплатежи, нет необходимости в кассе.

Услуги (консультации, курсы): Основной: ЮKassa (карта + СБП). Дополнительный: Stars для пробных уроков. Причина: средний чек 3 000-15 000 ₽, нужны чеки.

B2B: Основной: СБП или банковский перевод. Причина: минимальная комиссия, юрлица не могут оплатить Stars.

Международные продажи: Основной: Telegram Payments (карта). Дополнительный: крипто TON. Причина: глобальный охват, мультивалютность.

Подробнее о примерах Mini App и магазине в Mini App.

Интеграция оплаты в Telegram Mini App — это не просто «подключить SDK». Вот 7 ошибок, которые я видел у проектов, и как их избежать.

Ошибка 1: Один способ оплаты. Магазин принимает только карту. Пользователь хочет оплатить через СБП или Stars — не может. Потеря 10-15% заказов. Решение: минимум 2 способа оплаты.

Ошибка 2: Нет проверки на сервере. Mini App получает «оплату» от клиента и сразу выдаёт товар. Мошенник подделывает запрос — получает товар бесплатно. Решение: всегда проверять статус платежа через API провайдера на бэкенде.

Ошибка 3: Нет обработки ошибок. Платёж не прошёл (недостаточно средств, карта заблокирована) — Mini App показывает «Ошибка». Пользователь уходит. Решение: понятные сообщения об ошибках с кнопкой «Попробовать другой способ».

Ошибка 4: Нет возвратов. Нет механизма возврата средств. Клиент недоволен, оставляет негативный отзыв, открывает chargeback. Решение: реализовать возвраты через API провайдера. Автоматические возвраты при отмене заказа.

Ошибка 5: Нет логирования. Платёж прошёл, но товар не выдан. Нет логов — невозможно понять, что произошло. Решение: логировать каждый шаг платёжного потока: создание → подтверждение → webhook → выдача товара.

Ошибка 6: Отсутствие идемпотентности. Webhook приходит дважды (retry от провайдера) — товар выдаётся дважды, списание дважды. Решение: идемпотентные ключи. Проверка: если платёж уже обработан — пропустить повторный webhook.

Ошибка 7: Фиксированная валюта. Stars привязаны к USD. При изменении курса цена в рублях «плывёт». Решение: динамический пересчёт Stars → рубли на основе текущего курса. Обновление цен раз в сутки.

Главный принцип: оплата в Mini App — это критический бизнес-процесс. Ошибка = потеря денег. Тестируйте платёжный поток тщательно: успешная оплата, отклонённая, отменённая, возврат, повторная попытка.

Подробнее о создании Mini App и Mini App под ключ.

Оплата в Telegram Mini App — это ключ к конверсии. Чем короче путь до оплаты, чем больше способов предлагаете, тем больше продаж совершаете.

Три правила успешной оплаты в Mini App:

1. Минимум 2 способа оплаты. Карта + СБП для физических товаров. Stars + карта для цифровых. Это увеличивает конверсию на 15-25% по сравнению с одним способом.

2. Всегда проверяйте оплату на сервере. Никогда не доверяйте клиентской части. Проверяйте статус через API провайдера. Это защитит от мошенничества и потери денег.

3. Понятные сообщения об ошибках. Если платёж не прошёл — объясните почему и предложите альтернативу. Не показывайте «Ошибка 500». Покажите: «Карта отклонена. Попробуйте СБП или Stars».

Что вы получаете при интеграции оплаты: - Приём карт Visa, Mastercard, МИР - Оплата через Telegram Stars - СБП с минимальной комиссией - Автоматические чеки (54-ФЗ) - Возвраты и отмены - Аналитика платежей

Если вы хотите узнать больше, читайте магазин в Mini App, как создать Mini App и примеры Mini App.