Принять оплату в Telegram-боте можно двумя способами, и выбор между ними определяет тип товара. Физические товары и услуги, которые человек получает вне мессенджера, оплачиваются картой через платёжного провайдера — в Узбекистане это Payme и CLICK. Цифровые товары и подписки внутри Telegram продаются только за Telegram Stars.
Коротко
Бот не списывает деньги сам: он выставляет счёт, а деньги проводит платёжный провайдер. Telegram выступает посредником интерфейса — он не собирает платёжные данные и не берёт комиссию за Payments API, а данные карты обрабатывает и хранит провайдер.
Цепочка одна и та же для бота и для Mini App:
Идентификатор платежа стоит сохранять сразу: по нему потом ищут операцию при разборе спорной оплаты и оформляют возврат.
Важно Для каждой валюты Telegram задаёт минимальную и максимальную сумму счёта: ориентир — примерно от 1 до 10 000 долларов в эквиваленте, точные значения по каждой валюте опубликованы в справочнике Payments API. Крупные заказы в боте дробят на части или уводят на платёжную страницу провайдера.
Граница проходит по тому, где человек получает купленное. Физический товар, доставка, визит в клинику, участие в офлайн-мероприятии — это оплата картой через провайдера. Доступ к курсу, подписка на канал с материалами, снятие лимита внутри сервиса — это цифровой товар.
Цифровые товары и услуги внутри Telegram продаются исключительно за Telegram Stars. Это не рекомендация Telegram, а следствие правил App Store и Google Play, и правило действует, даже если у компании есть свой сайт с приёмом оплаты картой. В документации Telegram прямо сказано, что принимать оплату за цифровые товары и виртуальные услуги от пользователей iOS разработчикам ботов нельзя.
| Что сравниваем | Оплата через провайдера | Telegram Stars |
|---|---|---|
| Что можно продавать | Физические товары, доставку, офлайн-услуги | Цифровые товары и услуги, доступ к контенту |
| Как платит клиент | Картой в интерфейсе Telegram | Звёздами, купленными в Telegram |
| Что нужно компании | Договор с провайдером и касса или терминал | Только бот, договор не нужен |
| Данные клиента | Можно запросить адрес доставки, телефон, почту | Личные данные не запрашиваются |
| Возврат | По правилам провайдера и банка | Методом возврата звёзд в Bot API |
| Деньги на счёт компании | Приходят от провайдера по договору | Звёзды конвертируются по правилам Telegram |
Для большинства задач узбекистанского бизнеса — запись, заказ, доставка, билеты на мероприятие — работает первый столбец. Stars становятся обязательными, когда компания продаёт обучение, подписку или закрытый контент прямо внутри Telegram.
Провайдер выбирается в настройках бота в @BotFather, и набор доступных систем зависит от страны. Для Узбекистана в списке есть Payme и CLICK; оба подключаются по одной схеме — договор и касса на стороне провайдера, затем токен в настройках бота.
Практическая разница для проекта невелика — она в условиях договора и в том, чем уже пользуется ваша аудитория. Чаще подключают обе системы: клиент платит тем, что у него привычно стоит на телефоне.
Совет Договор с провайдером оформляйте до старта разработки. Тестовый терминал позволяет отладить сценарий, но боевой токен выдаётся только активному бизнесу с расчётным счётом, и это обычно самый долгий шаг в проекте.
Если оплата нужна не только в боте, но и на сайте, в личном кабинете и в приложении, платёжный контур проектируют отдельно от бота — об этом статья биллинг и приём оплат на веб-платформе.
Счёт в боте — не только «купить товар». Один и тот же механизм закрывает бронирование, рассрочку по договорённости и продление подписки; отличается логика на стороне бота.
| Сценарий | Когда нужен | Что делает система |
|---|---|---|
| Полная оплата заказа | Товар со склада, готовая услуга | Списывает сумму, переводит заказ в статус «оплачен», запускает выполнение |
| Предоплата или бронь | Запись, бронирование, мероприятие | Списывает часть суммы, держит слот, напоминает об остатке |
| Оплата по ссылке | Счёт от менеджера, продажа в переписке | Создаёт ссылку на счёт, которую можно отправить в любой чат |
| Подписка | Доступ к сервису или закрытому контенту | Списывает по периоду, предупреждает о продлении |
| Частичная оплата | Дорогой заказ, оплата частями | Считает остаток и напоминает о следующем платеже |
| Возврат | Отмена, брак, недоступная услуга | Оформляет возврат и меняет статус в CRM |
Регулярные списания картой возможны не всегда: они зависят от того, поддерживает ли провайдер привязку карты и выпуск токена. Для подписок за Telegram Stars период фиксирован — 30 дней, другого интервала в Bot API нет.
Ценность платёжной интеграции появляется не в момент списания, а в том, что происходит в следующие несколько секунд. Если после оплаты не меняется ничего, кроме сообщения «спасибо», менеджер всё равно разбирает заказы руками.
Как связать бота и CRM технически, какие поля передавать и что делать, если CRM в этот момент недоступна, разобрано в статье интеграция Telegram-бота с CRM.
После оплаты клиенту нужны не рассылки, а ответы на три вопроса: деньги дошли, что я получил, что дальше. Всё остальное добавляется только тогда, когда у сообщения есть измеримая цель.
Бот пишет только тем, кто сам его запустил, поэтому база для таких сообщений собирается из клиентов, а не покупается. Метрики самих уведомлений — доставка, переходы, повторные оплаты — считаются так же, как в мобильных приложениях: об этом статья push-уведомления в приложении.
Карточные данные хранит и обрабатывает платёжный провайдер. Бот получает только статус операции и идентификатор платежа — этого достаточно, чтобы найти операцию, оформить возврат и свести отчётность.
Отдельный пункт — поддержка. Боты, которые продают за Telegram Stars, обязаны отвечать на команду поддержки по платежам и разбирать обращения клиентов, иначе нарушаются условия платформы.
Большая часть потерь приходится не на технику, а на пробелы в сценарии: система умеет принимать деньги, но не умеет вести себя, когда что-то пошло не так.
Проверять эти места нужно до запуска, на тестовом терминале: провести успешную оплату, отменённую, повторную и возврат.
Отдельной цены на «кнопку оплаты» нет: подключение считается внутри проекта бота. Бот для приёма заявок, записи и выдачи QR-билетов — от 1 200 $, и оплата входит в него как один из сценариев.
На стоимость влияют число платёжных сценариев, количество провайдеров, возвраты и подписки, а также то, в какие системы уходят данные после оплаты. Состав работ — на странице услуги ИИ и автоматизация. Комиссию провайдера компания платит отдельно, по своему договору.
Syntra Systems начинает с разбора пути клиента: где он выбирает, где соглашается на цену и в какой момент удобно платить. Только после этого выбираются провайдер и тип счёта.
Дальше мы собираем сценарий целиком, вместе с неуспешными путями: отменённая оплата, повторная попытка, возврат, недоступная CRM. Проверяем всё на тестовом терминале, затем переключаем на боевой и смотрим первые реальные оплаты. Что умеет сам бот помимо оплаты — в статье разработка Telegram-бота для бизнеса.
Обсудим вашу задачу
Расскажите, что нужно сделать, — оценим сроки и стоимость и предложим решение.
Механизм тот же: счёт выставляет бот, а Mini App открывает интерфейс оплаты. Разница в удобстве — в Mini App можно показать каталог, корзину и расчёт доставки на одном экране. Правило о цифровых товарах действует одинаково для бота и Mini App.
Без договора с провайдером бот оплату не примет, а подключают только действующий бизнес с расчётным счётом. У Payme это регистрация в Payme Business и отдельная касса под бота, у CLICK — рабочий терминал. Пока документы оформляются, сценарий оплаты отлаживают на тестовом подключении — оно есть у обоих.
Найти операцию по идентификатору платежа, который бот сохранил при списании, и выдать товар вручную. Затем разобрать причину: чаще всего это сбой на шаге после оплаты. Чтобы такие случаи не повторялись, выдачу делают отдельным шагом с повторной попыткой.
Только если провайдер поддерживает привязку карты и списание по токену — это условие договора, а не возможность Telegram. Если такой опции нет, подписку ведут напоминаниями: бот присылает счёт перед каждым периодом, а клиент подтверждает оплату.
Деньги по карте возвращает платёжный провайдер по своим правилам и правилам банка: бот отправляет запрос и меняет статус заказа. Если клиент платил звёздами Telegram (Telegram Stars), бот возвращает их сам — по номеру платежа, который сохранил при оплате.
Валюта задаётся в счёте, и один бот может выставлять счета в разных валютах, если это позволяет договор с провайдером. На практике для местной аудитории счёт выставляют в сумах, а для зарубежных клиентов подключают отдельного провайдера.
Бот не должен верить сообщению клиента о том, что он заплатил. Источник правды — служебное сообщение Telegram об успешном платеже и подтверждение от провайдера с проверенной подписью. Сумма при этом считается на сервере по данным заказа, а не берётся из запроса.
