Блог RU
2026-10-11 16:51 Telegram и автоматизация

Оплата в Telegram-боте и Mini App: что проверить до разработки

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

До разработки проверьте весь путь: выбор товара, расчёт суммы, платёж, получение результата и обращение в поддержку. Способ оплаты согласуйте вместе с типом продукта и рынком.

Начните с того, что покупает клиент

Telegram разделяет оплату цифровых товаров и услуг и оплату физических товаров и услуг.

Для продажи цифровых товаров и услуг внутри ботов и Mini Apps обязательны Telegram Stars. Наличие собственного сайта с другой оплатой не отменяет это правило для продаж внутри Telegram. Правила цифровых платежей.

Для физических товаров и услуг предусмотрена работа со сторонними платёжными провайдерами. Telegram передаёт платёжные данные в соответствующий процесс, а условия обслуживания зависят от выбранного провайдера. Документация Telegram Payments.

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

Если классификация предложения неоднозначна, уточните требования платформы и провайдера до проектирования. Не закладывайте оплату картой как универсальный вариант для любой продажи.

Составьте карточку платёжного сценария

Для каждого вида заказа запишите:

  • предмет продажи и способ предоставления результата;
  • страну продавца и целевые рынки;
  • валюту или Stars, состав суммы и применяемые сборы;
  • доступный провайдер и требования к аккаунту;
  • необходимость доставки, контактов или записи на время;
  • момент резервирования товара или места;
  • события подтверждения платежа и выполнения заказа;
  • правила отмены, возврата и поддержки.

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

Для Stars отдельно оцените условия получения вознаграждения и доступность соответствующего процесса для бизнеса. Цена покупки Stars пользователем не равна автоматически выплате продавцу: Telegram описывает их как разные величины. Условия платформы.

Разделите отправку счёта, платёж и выполнение заказа

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

Для стандартного счёта Bot API проверка перед оплатой требует ответа бота в течение 10 секунд. На этом этапе нужно убедиться, что заказ ещё можно выполнить и его условия актуальны. Само согласование проверки не подтверждает оплату. Порядок проведения платежа.

Статус «Оплачен» устанавливайте после подтверждённого серверного события успешного платежа. Для встроенного сценария Bot API это successful_payment. Сохраняйте связь платежа с заказом и его идентификатор. Описание SuccessfulPayment.

Закрытие окна оплаты или сообщение клиента «Я оплатил» не должно само по себе открывать доступ к продукту. Повторное событие не должно повторно выдавать заказ, а новая покупка — блокироваться как дубликат.

Проверьте Mini App и серверную часть

В Mini App данные пользователя и сумма не должны считаться достоверными только потому, что пришли из интерфейса. Сервер должен проверять пользователя, заказ и расчёт по вашим правилам.

Telegram требует проверять данные initData перед использованием на сервере и предупреждает, что initDataUnsafe нельзя считать доверенными. Документация Mini Apps.

Определите, как заказ попадёт в CRM, склад или систему доступа. Если платёж уже подтверждён, а интеграция временно недоступна, заказ должен сохраниться для повторной обработки. Клиенту покажите реальное состояние, а ответственному отправьте сигнал о проблеме.

Подготовьте возвраты и поддержку

До оплаты клиент должен понимать, что он получит, на каких условиях и куда обратиться. Согласуйте тексты условий, сведения о продавце и необходимые документы для выбранных рынков с ответственными специалистами.

Для цифровых покупок Telegram требует обработку обращений по команде /paysupport. Назначьте сотрудника, который будет разбирать такие запросы. Требования к поддержке платежей.

В Bot API есть метод refundStarPayment для возврата успешного платежа в Stars. Для других способов порядок возврата определяется интеграцией провайдера. Возможность частичного возврата проверяйте отдельно, не обещайте её по умолчанию. Метод возврата Stars.

Опишите, что происходит с доступом, резервом товара и статусом CRM после возврата. Отдельно предусмотрите ситуацию, когда деньги возвращены, но обновление другой системы не прошло.

Чек-лист перед запуском

  • Тип продажи и допустимый способ оплаты подтверждены.
  • Аккаунт продавца и необходимые подключения готовы.
  • Цена, валюта, доставка и итоговая сумма показаны до оплаты.
  • Успешный, отклонённый и отменённый платёж обработаны.
  • Проверены повторные нажатия и повторная доставка событий.
  • Изменение наличия или условий перед оплатой не создаёт невыполнимый заказ.
  • Оплаченный заказ сохраняется при сбое CRM или выдачи доступа.
  • Возврат отражается в заказе и связанных системах.
  • Поддержка доступна, а уведомления и условия локализованы.
  • Проверены согласованные приложения Telegram, устройства и порядок восстановления после сбоя.

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

Для обсуждения разработки Telegram-бота и Mini App подготовьте карточки платёжных сценариев и данные используемых систем. Коммерческое предложение поможет согласовать объём разработки. Конкретный способ оплаты, доступность провайдера и текущие правила Telegram проверьте перед реализацией.