01Различаем физические и цифровые продукты
Продажа цифровых товаров и услуг внутри Telegram использует Telegram Stars. Для физических товаров и услуг действует отдельная схема Bot Payments с платёжными провайдерами. Конкретный маршрут выбирается после классификации продукта.
02Храним связь заказа и операции
Заказ получает собственный идентификатор, а подтверждённая оплата связывается с ним. Сервер проверяет ожидаемую операцию и фиксирует результат до запуска выдачи или исполнения.
03Повтор не означает новую покупку
Платёжное событие может обрабатываться повторно. Нужна защита от второй выдачи, дублирования заказа и повторного изменения баланса. При неизвестном состоянии система показывает ожидание, а не выдуманный успех.
04Возврат — отдельный рабочий сценарий
Команда должна найти операцию, проверить её состояние и выполнить согласованный возврат доступным способом. Возврат платежа и изменение права доступа или заказа связываются явно. Покупателю нужен контакт поддержки.