Оплата звёздами в Telegram-боте: что я узнал на тысячах платежей
Хорошая новость: подключить звёзды проще, чем эквайринг. Договор с банком и провайдер не нужны, счёт бот выставляет сам. Плохая: у звёзд есть несколько особенностей, о которых узнаёшь уже на живых деньгах. Я делаю бота, через которого проходят тысячи платежей звёздами, и вот что стоит знать заранее.
1. На подтверждение оплаты у бота 10 секунд
Перед тем как списать звёзды, Telegram спрашивает бота: «принимаешь платёж?» Если бот не ответил за 10 секунд, платёж отменяется, а покупатель видит ошибку и уходит. Поэтому на этот вопрос нужно отвечать сразу, а всё тяжёлое — проверку остатков, выдачу, письма — делать уже после.
У нас был период, когда ответ иногда шёл дольше из-за нагрузки, и каждая такая заминка — это потерянный покупатель, который больше не вернётся.
2. Сохраняйте номер каждого платежа
После оплаты Telegram присылает номер платежа. Без него вы не сможете вернуть звёзды покупателю и не докажете, что платёж был. Храните его вместе с заказом с первого дня — восстановить потом нечем.
3. Деньги не сразу: 21 день
Звёзды падают на баланс бота мгновенно, но вывести каждую можно только через 21 день после получения, через Fragment и от 1 000 звёзд. Это нужно закладывать в оборотные средства: месяц продаж фактически заморожен.
4. Покупатель может вернуть звёзды
В течение этих трёх недель Telegram может вернуть звёзды покупателю — и они исчезнут с баланса бота. Поэтому ценный товар или деньги за звёзды не стоит отдавать сразу и всем подряд: для новых покупателей разумно держать паузу или лимит, а постоянным — доверять больше. Нам это однажды сэкономило заметную сумму: звёзды вернули через сутки после продажи, а выплату по ней мы ещё не успели сделать.
5. Обязательная команда /paysupport
Бот, который принимает звёзды, обязан отвечать на команду /paysupport — это требование Telegram. Она должна отвечать каждому, в том числе человеку, который только что открыл бота: если ваш бот сначала просит пройти проверку или выбрать язык, /paysupport нужно пропускать мимо этих шагов. Мы на этом однажды споткнулись.
Что в итоге
Звёзды — самый простой способ брать оплату за цифровое в Telegram, но это не обычный эквайринг: короткое окно на подтверждение, долгий путь до денег и возвраты, которые инициирует не продавец. Технически всё подключается за вечер: пошаговая инструкция с методами Bot API — оплата звёздами в боте.
Раскрываю интерес: я делаю бота Shiba Bank (@shiba_bank_app) — через него покупают и продают Telegram Stars.