Stars и та граница правил, которую API позволит перейти без единого возражения

Stars разрешено использовать только для цифровых товаров и услуг, но не для физических.

Это ограничение правил, а не техники. API спокойно выставит счёт за физический товар, а последствие придёт боту — поэтому пункт относится к архитектуре, а не к чек-листу перед релизом.

На `pre_checkout_query` нужно ответить примерно за 10 секунд, иначе платёж не пройдёт.

У всего, что стоит на этом пути, жёсткий бюджет задержки. Синхронный вызов медленного стороннего API во время pre-checkout время от времени съедает продажи, и диагностировать это тяжело, потому что эффект зависит от нагрузки.

Платежи в Stars можно вернуть через Bot API в пределах ограниченного окна.

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

Telegram удерживает долю выручки в Stars, а выплата зависит от порогов и его собственного графика.

Фактическая ставка и сроки поступления денег отличаются от карточного эквайринга. На низких чеках выигрыш в конверсии обычно перевешивает; на высоких — обычно нет.

Обновления об оплате доставляются как минимум один раз и могут прийти повторно.

Выдача прав доступа идемпотентна по идентификатору платежа. Без этого повторная доставка продлит подписку дважды, и расхождение всплывёт при сверке, а не в момент события.

Pre-checkout не уложился в срок, потому что проверка была слишком медленной.

Данные, нужные на pre-checkout, кэшируются заранее. Клиент видит неудавшийся платёж без видимой причины, а это один из худших вариантов отказа, какие вообще бывают.

Обновление об успешной оплате пришло дважды.

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

Возврат сделан, а доступ у клиента остался.

Право доступа — это запись, которую бот читает при каждой проверке, а не одноразовый флаг, поставленный в момент оплаты. Отзовите право, и следующая проверка не пройдёт; именно это заставляет возврат сработать вместо того, чтобы оставить внутри навсегда человека, заплатившего однажды.

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

Pre-checkout отклоняет покупку, которая дублировала бы действующее право доступа, и объясняет причину. Вернуть деньги потом можно, но это заметно хуже, чем не взять их вовсе.

Глобально, внутри Telegram

Работает везде, где работает Telegram, без подключения мерчанта по странам. Покупателю нужны аккаунт в Telegram и баланс в Stars.

Физические товары

Не разрешены нигде. Именно это ограничение чаще всего заставляет держать рядом со Stars второй платёжный канал.

Объединённые Арабские Эмираты

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

Крупные платежи

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