Для оплаты в 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 проверьте перед реализацией.