Заказ в Mini App должен сохранять выбранные позиции и показывать понятное состояние. Каталог, расчёт, создание заказа и подтверждение оплаты — разные части процесса. Правила оплаты дополнительно зависят от типа товара и условий платформы.
Опишите, что именно продаётся
Физический товар, цифровой продукт и услуга требуют разных сценариев. Для доставки понадобятся применимые параметры адреса и получения. Для цифрового продукта нужно согласовать выдачу доступа и связь с подтверждением оплаты.
Для цифровых товаров и услуг внутри ботов и Mini Apps Telegram требует Telegram Stars; условия описаны в официальном руководстве. Для физического ассортимента порядок интеграции проверяют отдельно. Не выбирайте платёжный механизм без классификации продукта.
Сохраняйте выбранный вариант
В каталоге должны быть понятны вариант, количество и условия заказа. При переходе к подтверждению пользователь видит тот же выбор. Если данные изменились, приложение объясняет изменение до окончательного действия.
Цена и доступность подтверждаются сервером. Значения из браузера помогают отображать интерфейс, но не должны самостоятельно определять итог операции.
Разделите состояния
| Состояние | Что должен видеть пользователь |
|---|---|
| Выбор | Актуальные позиции и параметры |
| Подтверждение | Состав и согласованный итог |
| Заказ создан | Идентификатор и следующее действие |
| Оплата ожидается | Возможность продолжить предусмотренный сценарий |
| Оплата подтверждена | Понятный результат и состояние выдачи |
| Ошибка | Причина в допустимых пределах и действие для продолжения |
Не выдавайте заказ как завершённый только после открытия платёжного окна. Приложение должно опираться на подтверждённое серверное событие.
Обрабатывайте повторные события
Пользователь может нажать кнопку снова, а интеграция — повторно передать уведомление. Определите идентификаторы и правила обработки, чтобы операция не создавала случайный дубль или повторную выдачу.
Сохраните связь заказа и платёжной операции. По ней поддержка сможет объяснить состояние. Отдельно определите, как восстанавливается процесс после закрытия приложения: человек должен найти свой заказ при следующем открытии.
Проверьте весь путь в тестовом режиме
Создайте заказ, подтвердите предусмотренную оплату и убедитесь, что он виден сотруднику или системе выдачи. Затем проверьте отказ, ожидание, повтор события и возвращение после закрытия Mini App.
Заранее определите канал поддержки для спорных состояний. Юридические и платёжные условия согласуют для конкретной модели продаж; технический сценарий должен реализовывать эти условия точно.
Процесс можно включить в Mini App на заказ или Telegram-витрину магазина. Для оценки нужны тип товара, модель заказа и требования к дальнейшей обработке.
