Telegram позволяет принимать оплату прямо внутри бота или мини-приложения без сложных сценариев для пользователя. В этой статье разберем, как настроить подписки, платежи и checkout, а также повысить доверие клиентов к оплате.
Подробнее о сценариях оплаты, системах и точных настройках по сценариям, мы рассказали в нашей статье: Как принимать платежи в Telegram: сценарии оплаты, подписки, чек‑аут, доверие
Два главных мира платежей в Telegram: «фиат через провайдера» и «цифровое через Stars»
Продукт в Telegram обычно принимает платежи одним из двух путей:
Платежи через сторонних провайдеров (фиат, карты, Apple Pay / Google Pay) — подходят для физических товаров и услуг, доставки, записи, бронирований, где нужна валюта, адрес и т. п. Telegram при этом не обрабатывает платеж и не хранит данные карты — это делает провайдер. Source
Платежи за цифровые товары и услуги через Telegram Stars — подходят для цифрового контента/функций внутри Telegram (доступ, подписки, внутриигровые покупки, цифровые сервисы). Для таких продаж Telegram требует оплату в Stars (валюта XTR). Source
Ключевой смысл разделения: Telegram (и магазины приложений) по‑разному смотрят на «цифру» и «физику». Если продукт продаёт цифровое внутри Telegram‑клиента, то официальный рекомендованный путь — Stars. Source
Что именно можно «продавать» в Telegram: сценарии монетизации
Ниже — наиболее частые продуктовые сценарии, которые реально хорошо «садятся» на Telegram‑механику.
Разовая оплата – one‑time purchase
Подходит для:
- цифровых единиц (кредиты, токены, разовая разблокировка функции),
- консультации/созвона «1 раз»,
- разовой покупки физического товара.
Технически реализуется через invoice (инвойс) — сообщение со встроенной карточкой и кнопкой Pay.
Источник: Source
Корзина и чек‑аут
Подходит для магазинов, доставки, мерча, а также для «пакетов услуг».
Обычно делается так:
- корзина и конфигурация товара — в Mini App (Telegram WebApp),
- итоговый платёж — через инвойс, открываемый прямо из Mini App.
В документации Mini Apps прямо отмечено, что мини‑приложения поддерживают платежи через провайдеров (включая Apple Pay / Google Pay), а также могут открывать инвойс из WebApp. Source
Подписки
Подходит для:
- доступа к контенту/функциям по времени,
- премиальных тарифов,
- закрытых разделов/возможностей в Mini App.
В экосистеме Telegram это чаще всего завязано на Stars и поддерживается, как продуктовая механика (включая планы). Mini Apps получили поддержку подписок на Stars как часть расширения монетизации. Source
Дополнительно Stars как система описывает отдельные сущности и потоки, включая подписки. Source
Сравнение вариантов: Bots Payments vs Stars vs Mini App + invoice
Ниже — практичная сравнительная таблица, чтобы выбрать на старте.
| Критерий | Физические товары/услуги через провайдера | Цифровые товары через Telegram Stars | Mini App (WebApp) + инвойс |
|---|---|---|---|
| Что продаётся лучше всего | Доставка, мерч, офлайн‑услуги, бронирования | Доступ, функции, цифровой контент внутри Telegram | Любые сложные конфигурации/корзина, где нужен UI |
| Кто обрабатывает карту/Apple Pay | Платёжный провайдер, не Telegram | Только Telegram‑экосистема Stars (пополнение Stars пользователем) XTR (Stars) | Зависит от того, что оплачивается (часто провайдер или Stars) |
| Нужно ли собирать адрес/доставку | Да, если физический товар | Нет (обычно) | Можно собирать в UI Mini App и/или через платежный флоу |
| Риск «упасть» на сложном UX | Средний | Низкий (максимально нативно) | Низкий/средний (зависит от качества Mini App) |
| Где смотреть официальную базу | Bot Payments (physical) | Payments for digital goods via Stars | Mini Apps + платеж |
Как устроен чек‑аут в Telegram: на уровне событий и логики
Telegram‑оплаты — это не просто кнопка Pay. Это последовательность событий, где продукт обязан правильно подтвердить заказ и корректно выдать товар/доступ.
Общая модель: инвойс → pre‑checkout → successful_payment
Официальный «скелет» процесса для Bot Payments выглядит так:
- Продукт формирует invoice и отправляет пользователю (или в группу/канал).
- Пользователь нажимает Pay, вводит данные/выбирает метод.
- Перед финальным списанием Telegram присылает боту событие pre_checkout_query — и бот обязан ответить в течение 10 секунд, иначе транзакция отменится.
- Если всё успешно, бот получает сообщение типа successful_payment и только тогда должен выдавать товар/доступ.
Источник: Source
Это очень важный принцип для доверия: нельзя выдавать товар только потому, что пользователь «почти оплатил». Успех подтверждается только successful_payment.
Визуальная логика: как это выглядит для пользователя
Официальная документация показывает типовой интерфейс: карточка инвойса с кнопкой оплаты и экран выбора доставки/ввода данных (если включено). Примеры экранов (из официальной страницы Payments API):
Пример инвойса с Pay‑кнопкой:

Пример ввода shipping info:

Пример шага выбора доставки:

Сценарии оплаты: от «простого доната» до полноценного магазина
Самый простой сценарий: «одна кнопка — один продукт»
Когда у продукта один тариф или один товар (например, «доступ на месяц», «покупка консультации»), лучший UX часто выглядит так:
- бот объясняет ценность (2–5 сообщений),
- показывает кнопку «Купить»,
- после successful_payment выдаёт доступ/инструкции.
Почему работает:
- минимум когнитивной нагрузки,
- нативный чек‑аут Telegram,
- меньше шансов на «сломанные» состояния.
Каталог товаров в канале или группе (витрина)
Telegram прямо показывает пример «виртуальной витрины» — где посты содержат товары, а покупка происходит через бота и инвойсы. Source
Сильная сторона: канал уже умеет охваты, контент, прогрев. Воронка «контент → товар → инвойс» получается очень естественной.

Корзина + конфигуратор в Mini App
Если есть:
- много SKU,
- модификаторы (размер, цвет, допы),
- промокоды, персональные цены,
- сложная логика доставки,
Если есть:
- много SKU,
- модификаторы (размер, цвет, допы),
- промокоды, персональные цены,
- сложная логика доставки,

Важная продуктовая деталь: Mini App должен быть быстрым и «телеграм‑нативным» по ощущениям (соблюдать стили, safe areas, простую навигацию) — иначе конверсия падает. В документации Mini Apps отдельно даны дизайн‑принципы. Source
Подписки: как сделать, чтобы «не было стыда» и было меньше возвратов
Подписка — это не только механика списания. Это договор доверия: пользователь отдаёт право регулярно брать деньги за ценность.
Что важно в подписке с точки зрения UX
Хорошая подписка в Telegram‑продукте почти всегда включает:
- ясное описание «что входит» (не маркетинговые лозунги, а конкретика),
- период (7/30/365 дней) и правила продления,
- лёгкий способ отмены (команда /cancel или кнопка в Mini App),
- прозрачную поддержку по платежам.
Эта прозрачность напрямую связана с тем, что Telegram перекладывает ответственность за споры/поддержку на продавца: для классических платежей Telegram выступает «мессенджером», а не процессингом.
Stars‑подписки: почему они часто выигрывают у «внешней карты»
Для цифровых продуктов внутри Telegram Stars дают:
- меньше трения в оплате,
- меньше «страха ввода карты»,
- более нативный flow.
При этом в Stars‑мире продукт обязан мыслить «внутрителеграмно»: тарифы, подарки, подписки, вознаграждения и статистика завязаны на Stars‑баланс и системные правила. Source
Доверие: что сильнее всего влияет на конверсию в оплату
В Telegram пользователь принимает решение об оплате очень быстро — часто в течение 10–60 секунд. Поэтому доверие строится не «брендом в вакууме», а конкретными сигналами.
Сигнал №1: понятная витрина и правила до оплаты
Минимальный «набор взрослого продукта»:
- /terms (условия, оферта, что считается оказанной услугой),
- /support или /paysupport (куда писать по проблемам),
- понятное описание, что будет после оплаты.
Telegram прямо рекомендует иметь команду /terms и понятную поддержку — чтобы избежать юридических проблем и конфликтов. Source
Сигнал №2: корректная логика «денег → выдачи»
Классическая ошибка новичков: «пользователь нажал Pay → сразу выдаём доступ». Это неправильно. Выдача должна быть после успешного события successful_payment. Source
Сигнал №3: отсутствие «потерянных состояний»
Если продукт сложный (корзина, доставка, много шагов), пользователь легко может:
- закрыть экран,
- уйти в другой чат,
- вернуться через 2 часа.
Поэтому нужно
- сохранение черновика заказа,
- возможность «продолжить оплату»,
- понятная история покупок/доступов.
Mini Apps получили локальные хранилища (включая secure storage) и расширения, но даже без этого продукт обязан держать состояние на сервере и восстанавливать его по user_id.
Сигнал №4: честная работа с возвратами
В цифровых продажах через Stars существует официальный механизм refund для star‑платежей (через Bot API). Это важно не столько юридически, сколько продуктово: снижает страх покупки.
Источник: Source
Архитектурный минимум: что продукт обязан продумать до запуска
Webhook и обработка событий
У бота есть два способа получать события: getUpdates или webhooks, но для «боевого» платежного продукта почти всегда выбирают webhooks — чтобы не терять события и не зависеть от polling‑цикла. Общие принципы получения обновлений описаны в Bot API. Source
Идемпотентность и защита от дублей
Платежные события могут приходить повторно (или продукт сам может случайно повторить выдачу). Поэтому нужно:
- хранить ключ транзакции,
- проверять «выдавалось ли уже»
- делать выдачу идемпотентной.
Для Stars‑покупок Telegram отдельно рекомендует хранить идентификатор charge, который может понадобиться для возврата.
Источник: Source
Таймаут pre_checkout_query: 10 секунд — это мало
Telegram требует ответить на pre_checkout_query за 10 секунд, иначе транзакция отменяется.
Следствие для архитектуры:
- нельзя в этот момент ходить в «медленные» внешние сервисы без кэша,
- проверка наличия товара, лимитов, доступности должна быть быстрой
- всё «тяжёлое» — после successful_payment.
Практические паттерны UX, которые обычно поднимают оплату
Ниже — набор решений, которые в Telegram‑продуктах почти всегда окупаются.
Двухшаговая структура “ценность → оплата”
Сначала коротко: для кого, что будет, какой результат. Потом — кнопка «Оплатить».

Какие подходы выбрать: короткий «чек‑лист решения»
Если продукт продаёт физическое (товар/доставка/мероприятие): Bot Payments через провайдера + shipping/адрес, если нужно.
Если продукт продаёт цифровое внутри Telegram (доступ/подписка/контент/функции): Stars (XTR) + выдача после successful_payment.
Если продукту нужен сложный UI (корзина, конфигуратор, личный кабинет): Mini App как интерфейс + инвойсы/Stars для оплаты.
Заключение
Приём платежей в Telegram‑продукте — это не только “прикрутить оплату”, а выстроить понятный путь: сценарий покупки, быстрый чек‑аут, прозрачные условия и элементы доверия. Оптимальная схема начинается с выбора модели (разовый платёж, подписка, предоплата/депозит, оплата по счёту), затем — упрощение шагов (минимум полей, понятная сумма, мгновенное подтверждение), и дальше — снижение рисков: безопасная оплата, возвраты, поддержка, чеки/уведомления. Чем меньше трения и сомнений у пользователя, тем выше конверсия и повторные платежи. Поэтому сильный Telegram‑чек‑аут — это комбинация удобства (в 1–2 шага), предсказуемости (что будет после оплаты) и доверия (бренд, гарантии, отзывы, правила).
8 мин


