Оплата в телеграм-боте: как подключить и что нужно юридически

Какие способы оплаты можно встроить в бота

Telegram поддерживает встроенные платежи через API: клиент вводит данные карты прямо в интерфейсе мессенджера, без перехода на сторонний сайт. Это работает через платёжных провайдеров - сервисы, которые обрабатывают транзакции и переводят деньги на ваш счёт.

Основные варианты для российского рынка: ЮKassa (Яндекс), Робокасса, CloudPayments, Tinkoff Acquiring. Все они поддерживают Telegram Payments API и работают с российскими картами. Комиссия - от 2,5 до 3,5% с каждой транзакции плюс фиксированная плата за подключение или абонентская.

Второй путь - не использовать встроенный API Telegram, а генерировать в боте ссылку на платёжную форму провайдера. Клиент переходит по ссылке, оплачивает, бот получает уведомление о платеже через webhook. Это работает почти со всеми провайдерами, даже если они не интегрированы в Telegram напрямую. Минус - дополнительный шаг для клиента, часть отваливается на переходе.

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

Как технически подключить платёжного провайдера

Сначала регистрируетесь у провайдера. Для этого нужны: ИНН, выписка из ЕГРИП или ЕГРЮЛ, описание бизнеса, сайт (если есть), ссылка на бота. Провайдер проверяет заявку - от нескольких часов до трёх дней. Могут запросить дополнительные документы, если сфера деятельности попадает в зону риска: ставки, займы, криптовалюта, алкоголь, БАДы.

После одобрения получаете API-ключи: токен для взаимодействия с провайдером и provider_token для Telegram API. Эти ключи вписываются в код бота. Если используете встроенный Telegram Payments API, в коде бота создаёте счёт (invoice) с описанием товара, суммой, валютой. Telegram показывает клиенту форму оплаты, провайдер обрабатывает платёж, бот получает уведомление через callback.

Если идёте через ссылку на внешнюю форму, провайдер предоставляет API для генерации платёжной страницы. Бот создаёт заказ через API, получает URL, отправляет клиенту. После оплаты провайдер шлёт webhook на ваш сервер - это POST-запрос с данными о платеже. Сервер проверяет подпись запроса (чтобы исключить подделку), записывает платёж в базу, обновляет статус заказа в боте.

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

Юридические требования: что обязательно

Первое - вы должны быть зарегистрированы как ИП или ООО. Платёжные провайдеры не работают с физлицами без статуса самозанятого (и даже с самозанятыми работают не все). Если вы ИП на УСН или патенте - это подходит.

Второе - онлайн-касса. По 54-ФЗ, если принимаете оплату от физических лиц, обязаны отправлять чек в ОФД (оператор фискальных данных). Исключение - некоторые виды деятельности и самозанятые на НПД. Большинство провайдеров предоставляют облачную кассу в комплекте: вы подключаете их ОФД, они автоматически формируют чек после оплаты и отправляют клиенту на email или в Telegram. Стоимость - от 3000 рублей в год за ОФД плюс абонентка провайдера.

Третье - договор оферты. Это публичный договор, в котором описаны условия покупки: что продаёте, сколько стоит, как происходит оплата, условия возврата, ваши реквизиты. Оферту нужно разместить в боте (обычно команда /terms или кнопка при оплате) и на сайте, если он есть. Без оферты клиент может оспорить платёж, и банк встанет на его сторону.

Четвёртое - политика обработки персональных данных (152-ФЗ). Если собираете email, телефон, имя для отправки чека - это персональные данные. Политика описывает, что вы собираете, зачем, как храните, кому передаёте. Её тоже публикуете в боте, клиент должен согласиться с ней до оплаты (галочка или кнопка «Согласен»).

Пятое - возвраты. По закону о защите прав потребителей клиент может вернуть товар или отказаться от услуги в течение 7-14 дней (зависит от категории). Вы обязаны вернуть деньги в тот же срок. Провайдер предоставляет API для возвратов - это делается через личный кабинет или программно. Чек возврата тоже пробивается автоматически.

Договор с платёжным провайдером: что в нём важно

Провайдер - это посредник между вами и банком-эквайером. Вы заключаете с ним договор на оказание услуг по приёму платежей. В договоре обязательно проверьте несколько пунктов.

Комиссия. Обычно указана вилка: например, 2,8% для среднего чека до 5000 рублей, 2,5% - выше. Уточните, включён ли в комиссию НДС (если вы на ОСНО, это важно для учёта). Есть ли абонентская плата, плата за вывод средств, за неактивность (если долго не было транзакций).

Холд и вывод средств. Деньги с транзакций поступают на ваш расчётный счёт не мгновенно. Обычно провайдер держит их 1-3 дня (холд), потом переводит пачкой. Если вы новый клиент или работаете в рисковой сфере, холд может быть 7-14 дней. Это нужно учитывать в планировании платежей.

Резерв. Провайдер может заморозить часть средств (5-10% от оборота) как страховку на случай возвратов или chargeback (оспаривание платежа клиентом через банк). Резерв возвращается через 3-6 месяцев, если претензий не было.

Ответственность за chargeback. Если клиент оспорил платёж и банк встал на его сторону, провайдер вернёт деньги клиенту, а с вас спишет сумму плюс штраф (обычно 300-500 рублей за каждый chargeback). Поэтому важно хранить доказательства оказания услуги: скриншоты переписки, акты, файлы, которые отправили клиенту.

Налоги и отчётность

Все платежи, которые проходят через провайдера, - это ваша выручка. Вы платите налог по своей системе налогообложения: 6% на УСН «Доходы», 15% на УСН «Доходы минус расходы», 13% НДФЛ для ИП на ОСНО, процент от потенциального дохода на патенте.

Провайдер не удерживает налоги за вас - он только посредник. Вы сами ведёте учёт и подаёте декларацию в налоговую. Данные о транзакциях берёте из личного кабинета провайдера: там есть выгрузка всех платежей в Excel или CSV. Эту выгрузку используете для книги доходов.

Если у вас ООО на ОСНО, нужно выставлять счета-фактуры и платить НДС. На УСН счета-фактуры не нужны (вы не плательщик НДС), но клиенту всё равно надо отдать закрывающие документы: акт или товарную накладную. Многие провайдеры предлагают автоматическую генерацию актов - это экономит время.

Комиссию провайдера можно учесть в расходах на УСН «Доходы минус расходы» или при расчёте налога на прибыль. Для этого нужен акт от провайдера (он формируется в кабинете ежемесячно) и платёжное поручение.

Частые ошибки при подключении оплаты

Не проверили webhook на боевом сервере. Локально всё работает, на продакшене платежи проходят, но бот не получает уведомления. Причина - провайдер не может достучаться до вашего сервера: нет SSL-сертификата (webhook должен быть по HTTPS), неправильный URL, файрвол блокирует запросы. Проверьте логи провайдера: там видно, отправляет ли он webhook и какой ответ получает.

Не реализовали идемпотентность. Провайдер может отправить webhook дважды (сбой сети, таймаут). Если ваш код не проверяет, обработан ли уже этот платёж, заказ засчитается дважды. Храните идентификатор транзакции в базе и проверяйте перед обработкой: если такой ID уже есть, просто возвращайте HTTP 200 без действий.

Забыли про тестовый режим. Все провайдеры предоставляют тестовые ключи для отладки. В тестовом режиме можно прогнать сценарии успешной оплаты, отклонения, возврата без реальных денег. Многие пропускают этот шаг и сразу пускают клиентов в бой - в результате первый же баг вылезает на реальной транзакции.

Не настроили таймауты. Клиент создал счёт, но не оплатил: отвлёкся, передумал, ушёл. Счёт висит в базе в статусе «ожидает оплаты» бесконечно. Нужно ставить время жизни счёта (обычно 15-30 минут) и автоматически отменять просроченные. Telegram API поддерживает параметр need_shipping_address - если случайно его включили, бот потребует адрес доставки даже для цифрового товара.

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

Когда встроенная оплата не нужна

Если у вас три клиента в месяц, встроенная оплата избыточна. Абонентка провайдера, касса, время на интеграцию - всё это окупится только при регулярном потоке. Для разовых заказов проще выставлять счёт вручную или принимать переводы по СБП.

Если продаёте что-то сложное, с индивидуальными условиями или длительным циклом сделки (B2B-услуги, проекты на несколько месяцев), оплата в боте тоже лишняя. Здесь важнее переписка, обсуждение деталей, подписание договора. Платёж - финальный шаг, и он обычно идёт по счёту через банк.

Если ваша целевая аудитория - юридические лица, встроенная оплата картой бесполезна. Компании платят с расчётного счёта по выставленному счёту, им нужны закрывающие документы с печатью. Бот может автоматизировать выставление счёта и отправку акта, но сам платёж пройдёт вне Telegram.

Что делаем мы в EFIMOV DEV

Мы разрабатываем ботов с интегрированными платежами под ключ: подключаем провайдера, настраиваем webhook, прописываем логику обработки платежей и возвратов, подключаем онлайн-кассу, готовим шаблоны оферты и политики обработки данных. Стоимость бота с оплатой - от 50 000 рублей, точная смета зависит от логики и количества интеграций. Если у вас уже есть бот, можем добавить в него оплату как отдельную доработку. Обсуждаем задачу напрямую с тем, кто будет вести проект - без менеджеров-посредников. Оставьте заявку на efimovdev.ru.