Оплата в телеграм-боте: как подключить Payme и Click
Оплата в телеграм боте убирает главный разрыв в воронке: момент, когда клиент уходит «оплатить потом» и не возвращается. Ниже разобрано, как подключить Payme и Click, как устроен поток платежа, что проверить до запуска и из чего складывается цена.
Два способа принять оплату в боте
Первый способ — встроенные платежи Telegram. Бот отправляет счёт, клиент платит прямо в окне Telegram, а платёжный провайдер подключается через BotFather. Второй способ — кнопка со ссылкой на страницу или приложение Payme либо Click: бот создаёт заказ, клиент переходит к оплате, а провайдер уведомляет ваш сервер о результате.
Выбор зависит от задачи. Встроенный счёт делает путь клиента короче. Ссылка на оплату даёт больше гибкости: свои статусы заказа, один и тот же механизм для бота и сайта, нестандартные сценарии вроде предоплаты. Какие варианты доступны именно вам, уточняйте у провайдера при заключении договора.
Что подготовить до начала интеграции
Нужны юридическое лицо или ИП, расчётный счёт и договор с провайдером — Payme, Click или обоими сразу. Многие подключают оба: у аудитории есть устойчивые привычки, и лишний способ оплаты снимает часть отказов на последнем шаге.
Чек-лист перед стартом: доступ в кабинет мерчанта и тестовые реквизиты; сервер с HTTPS для приёма уведомлений; база с товарами, ценами и статусами заказов; тексты сообщений для успешной оплаты, отказа и ожидания; назначенный человек, который отвечает за ежедневную сверку. Боевые ключи подключайте в самую последнюю очередь, когда тестовые платежи проходят без ошибок.
Как устроена оплата в телеграм боте шаг за шагом
Типовой поток такой. Бот формирует заказ с уникальным номером и суммой. Затем создаёт счёт и показывает кнопку оплаты. Клиент оплачивает в приложении или на странице провайдера. Провайдер обращается к вашему обработчику: у Payme это набор методов для проверки, создания и выполнения транзакции, у Click — два этапа, подготовка и завершение. Сервер меняет статус заказа, и только после этого бот отправляет подтверждение.
Ключевой принцип: заказ считается оплаченным только после подтверждения от провайдера на сервере. Никогда не подтверждайте оплату по факту того, что пользователь вернулся в чат: возврат в бот не означает, что деньги списаны.
Отдельно проверьте формат суммы. У провайдеров он различается, например Payme работает с тийинами. Ошибка в множителе — самая частая причина того, что тестовые платежи проходят на суммы в сто раз больше или меньше нужных. Также сделайте обработчик идемпотентным: одно и то же уведомление может прийти повторно, и заказ не должен выполниться дважды.
Что делать, если оплата не прошла
Клиент закрыл страницу оплаты, платёж завис, на карте не хватило средств, счёт просрочен. Каждый из этих случаев должен вести к понятному сообщению и кнопке «Оплатить снова», а не к тишине. Заказ при этом остаётся в корзине, и человеку не нужно собирать всё заново.
Неоплаченные счета закрывайте по таймауту, обычно через 15–30 минут, и освобождайте зарезервированный товар или слот записи. Иначе склад и расписание будут заблокированы брошенными корзинами. Для зависших платежей добавьте повторный запрос статуса у провайдера: если ответ не пришёл за несколько минут, бот сам уточняет состояние и сообщает клиенту результат.
Возвраты, сверка и безопасность
Механику возврата продумайте до запуска: кто его инициирует, в какой срок и как это отражается в боте. Возврат через кабинет провайдера должен менять статус заказа и в вашей базе, иначе учёт разъедется, а клиент получит сообщение, которое не соответствует действительности.
Раз в день сверяйте платежи из кабинета провайдера с заказами в базе. Расхождения возникают из-за потерянных уведомлений и сбоев сети, и лучше найти их самим, чем через жалобу клиента.
Ключи провайдера хранятся только на сервере, не в коде Mini App и не в репозитории с открытым доступом. Проверяйте подпись или авторизацию входящих запросов: без этого посторонний может подтвердить чужой заказ обычным запросом к вашему обработчику. На экране оплаты показывайте итоговую сумму, состав заказа и название компании, совпадающее с тем, что клиент увидит в выписке.
Сколько стоит и сколько занимает
Цена складывается из нескольких частей: сам бот с каталогом и заказами, подключение каждого провайдера, обработка ошибок и возвратов, панель или уведомления для менеджера, тестирование. Комиссия провайдера в стоимость разработки не входит и определяется вашим договором. Ориентир по рынку: подключение одного провайдера к готовому боту обходится примерно в 2 000 000–5 000 000 сум, два провайдера с обработкой ошибок и сверкой — примерно в 5 000 000–10 000 000 сум. Это не оферта, точная цена зависит от задачи.
По срокам: сама интеграция занимает обычно одну–три недели вместе с тестированием, но оформление договора с провайдером может идти дольше, поэтому начинайте с него. Студия 4 Digital делает Telegram-боты с приёмом платежей, стоимость бота начинается от 999 000 сум.
Частые вопросы
Можно ли подключить и Payme, и Click одновременно? Да, это распространённая практика: клиент выбирает привычный способ, а ваш сервер обрабатывает оба типа уведомлений в единой таблице заказов.
Нужно ли юридическое лицо? Для договора с провайдером обычно требуются юрлицо или ИП и расчётный счёт. Точный список документов уточняйте у самого провайдера.
Как проверить оплату до запуска? Пройдите весь путь в тестовой среде: успешный платёж, отказ, повторное уведомление, просроченный счёт и возврат. Только после этого подключайте боевые ключи.
Что если уведомление от провайдера не пришло? Бот должен сам запросить статус платежа через несколько минут, а ежедневная сверка с кабинетом найдёт оставшиеся расхождения.