Telegram Stars в боте: как принимать

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

Что это такое

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

Ключевое отличие от обычных платежей: посредник - сама платформа. Отсюда и плюсы, и ограничения.

Когда это нужно

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

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

Не подходит - для физических товаров и услуг вне мессенджера. Там используются обычные платежи.

Как устроен приём

Схема та же, что и у обычных платежей, и порядок шагов тот же:

1. Создать заказ в своей базе со статусом ожидания.
2. Выставить счёт в Stars с указанием идентификатора заказа.
3. Дождаться подтверждения от платформы. Нажатие кнопки оплатой не является.
4. Проверить, что заказ ещё не оплачен. Пропуск этого шага - причина двойной выдачи.
5. Отметить оплату и выдать товар.
6. Сообщить пользователю.

Требование идемпотентности здесь ровно то же: повторное подтверждение не должно выдавать товар второй раз. Развёрнуто - в статье про приём оплаты и в блоге: идемпотентные пайплайны.

Отличия от обычных платежей

Провайдер не нужен. Не нужен договор, юридическое лицо и подключение. Порог входа заметно ниже.

Валюта одна. Цена задаётся в Stars, а не в рублях или долларах. Это влияет на ценообразование: округление в Stars грубее, и красивая цена не всегда получается.

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

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

Что учесть заранее

• Правила меняются. Категории товаров, требующих Stars, уточнялись не раз. Проверяйте актуальную версию перед запуском.
• Ценообразование. Пересчёт из привычной валюты в Stars даёт некрасивые числа. Проще задавать цену сразу в Stars.
• Комиссии. Итоговая сумма отличается от номинала. Считайте экономику по тому, что получите, а не по цене на кнопке.
• Тестирование. Проверьте полный цикл, включая возврат, до того, как открывать продажи.
• Логи платёжных событий. При разборе спора нужна история, а не память.

Обзор всех способов приёма оплаты - платежи в боте. Как это выглядит на реальном проекте - бот продажи курсов. Обзор - гид по Telegram-ботам.