Как принимать оплату в Telegram-боте: эквайринг, Stars и чеки

Если клиенты уже приходят к вам через Telegram, логично и продавать там же: переход на сайт ради оплаты — это лишний шаг, на котором часть людей теряется. Но «прикрутить оплату к боту» — задача не про одну кнопку. Нужно выбрать способ оплаты, выдать чек, открыть доступ и не сломать всё это, если уведомление об оплате придёт дважды.

Три способа принять оплату

Первый — встроенные платежи Telegram через подключённого провайдера: пользователь платит в стандартном окне Telegram, бот получает подтверждение. Второй — Telegram Stars, внутренняя валюта платформы. Третий — платёжная страница банка, которую бот или Mini App открывает по ссылке, а бэкенд узнаёт об оплате из уведомления банка (вебхука).

Что выбрать: зависит от того, что вы продаёте

По правилам Telegram цифровые товары и услуги внутри ботов продаются за Stars. Физические товары и офлайн-услуги — доставку, запись, выезд специалиста — можно оплачивать обычным эквайрингом банка. Поэтому первый вопрос на созвоне всегда один: что именно покупает клиент. От ответа зависит и схема оплаты, и то, какие документы понадобятся.

Чеки

При оплате от физических лиц чек по 54-ФЗ, как правило, обязателен. Технически его не нужно «печатать» вручную: платёжные провайдеры и онлайн-кассы формируют чек автоматически, если передать им состав покупки вместе с платежом, а у самозанятых чек создаётся через «Мой налог». Какой вариант нужен именно вашему бизнесу, стоит подтвердить с бухгалтером — техническая часть настраивается под любой из них.

Главная техническая ловушка — повторные уведомления

Банк сообщает об оплате вебхуком и, если не получил ответ вовремя, присылает его снова. Если бэкенд наивно выдаёт доступ на каждое уведомление, один платёж превращается в две подписки. Правильная схема — идемпотентная обработка: каждый платёж имеет идентификатор, и повторное уведомление просто подтверждает уже выданное. В моём собственном подписочном сервисе эта проверка закрыла реальную гонку, когда два уведомления приходили почти одновременно.

Подписки: оплата — только начало

Для подписочной модели платёж — это начало жизненного цикла: дальше напоминания о продлении, неоплаченные счета, заморозка, промокоды, возвраты. Всё это лучше сразу строить фоновыми задачами, а не надеяться на ручные напоминания. Если вам нужен бот, который сам продаёт и сам продлевает, — это задача для бота с оплатой и чеками.