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

Принять деньги в боте можно двумя путями, и выбор между ними определяет почти всё остальное: что увидит покупатель, что потребуется от вас как от продавца и сколько будет работы.

Способ первый: встроенные платежи телеграма

Телеграм умеет показывать форму оплаты внутри себя. Бот отправляет счёт, пользователь платит, не выходя из переписки, деньги идут через подключённого платёжного провайдера — ЮKassa, Robokassa и другие.

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

Минусы: список доступных провайдеров ограничен тем, что поддерживает платформа; оформление формы вам не принадлежит; подписки и сложные сценарии с частичной оплатой ложатся плохо.

Способ второй: ссылка на свою кассу

Бот формирует ссылку на оплату у вашего платёжного сервиса и отправляет её. Человек платит на странице провайдера и возвращается.

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

Минус — тот самый переход из мессенджера наружу.

Правило простое: разовая покупка внутри диалога — встроенные платежи; каталог, подписки, общая касса с сайтом — своя ссылка.

Что потребуется от вас

Платёжный провайдер работает не со всеми одинаково. Самозанятому доступны не все сервисы, и там, где доступны, обычно нужен статус в приложении «Мой налог» и привязанный счёт. Компании и ИП проходят проверку с уставными документами и расчётным счётом.

Чек по 54-ФЗ обязателен при продаже физическим лицам. Его выдаёт либо провайдер, если у него подключена онлайн-касса, либо вы сами. Это не техническая деталь, а требование закона, и решать его надо до запуска, а не после первой продажи.

Четыре места, где ломается

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

Уведомление пришло дважды. Провайдеры повторяют доставку, если не получили ответа. Без защиты один платёж превращается в два заказа. Лечится тем, что каждое уведомление обрабатывается по идентификатору операции и повторное игнорируется.

Оплата прошла, пока бот лежал. Деньги списались, уведомление не дошло, человек ждёт. Нужен либо повторный опрос статуса, либо очередь, которая доставит уведомление позже. Иначе разбираться придётся вручную — и узнаете вы об этом от клиента.

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

Что стоит помнить про деньги

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

И отдельная тема — если через бота платите не вы, а вам платят партнёры или наоборот. Учёт таких выплат руками разваливается на втором десятке: в партнёрском кабинете весь путь от клика до выплаты вознаграждения виден без таблиц и ручной сверки.

Порядок действий

Сначала решите, что продаёте и кому: разовая покупка или подписка, физлицам или компаниям. От этого зависит провайдер и вопрос с чеком. Потом выбирайте способ — внутри телеграма или своей ссылкой. Техническая часть после этого занимает меньше времени, чем согласование с провайдером.

Если непонятно, что из этого ваш случай, полчаса разговора обычно закрывают вопрос быстрее, чем чтение документации провайдера.