Оплата в Mini App прервалась: что должен видеть клиент

Покупатель подтвердил платёж, вернулся в Mini App и снова увидел кнопку «Оплатить». Он не знает, дошли ли деньги, и боится второго списания. Даже аккуратный каталог теряет доверие в такой момент. Экран после оплаты должен объяснять состояние заказа и предлагать безопасное следующее действие.

Ниже разберём сценарий покупки физического товара через встроенное платёжное окно Telegram. Для внешней платёжной страницы понадобятся отдельные проверки по документации выбранного сервиса.

Разделите закрытие окна и результат платежа

В документации Telegram Mini Apps у события закрытия счёта указаны четыре состояния: успешная оплата, закрытие без оплаты, неудачная попытка и обработка платежа. Поэтому закрывшееся окно само по себе ничего не говорит об успехе покупки.

Попросите разработчика описать, как каждое состояние связано с заказом на сервере. Интерфейс должен получать актуальный результат проверки и показывать его покупателю. Пока результат неизвестен, надпись «Заказ оплачен» будет преждевременной.

Состояние заказа	Что видит покупатель
Оплата подтверждена сервером	Номер заказа и следующий этап получения
Покупатель закрыл окно до оплаты	Сохранённый заказ и возможность вернуться к оплате
Платёж завершился неудачей	Понятное сообщение и доступные действия после проверки
Результат ещё уточняется	Сообщение об ожидании и кнопка проверки статуса

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

Сохраните заказ при возвращении в приложение

После закрытия Mini App человек должен найти тот же заказ, его состав и сумму. Заранее определите, где он его увидит: на стартовом экране, в истории покупок или по ссылке из сообщения бота. Порядок размещения таких сведений разобран в статье о личном кабинете Mini App.

Для состояния ожидания подойдёт сообщение: «Уточняем результат оплаты заказа. Проверьте статус через несколько минут или напишите в поддержку». Используйте его, только если система действительно продолжает проверку. Бесконечный индикатор загрузки скрывает проблему и оставляет человека без выхода.

Укажите номер заказа рядом с обращением в поддержку. Сотруднику будет проще найти операцию, чем восстанавливать её по скриншотам переписки.

Разрешайте повторную попытку после проверки

Повторный клик должен проходить проверку текущего состояния заказа на сервере. Одна лишь заблокированная кнопка в интерфейсе не защитит от повторного запроса после перезапуска приложения.

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

Перед повторной попыткой также проверьте состав и сумму. Если за время ожидания покупатель изменил количество товара, покажите новые условия и запросите подтверждение. Правила изменения позиции стоит согласовать с поведением корзины Mini App.

При разработке Mini App с Feature IT такие переходы можно описать ещё до создания экранов. Для оценки проекта полезнее список конкретных ситуаций, чем требование «сделать удобную оплату».

Подготовьте поддержку к неопределённому статусу

В карточке обращения сотруднику нужны номер заказа, сумма, время попытки и идентификатор операции. Доступ к этим сведениям выдавайте по рабочей необходимости. Просить реквизиты банковской карты в чате для поиска заказа не нужно.

Задайте порядок действий для случая «покупатель сообщает о списании, подтверждение ещё не получено». Сотрудник сверяет операцию через предусмотренный канал платёжного сервиса и сообщает клиенту результат проверки. Обещание возврата требует подтверждённых сведений о платеже и согласованной процедуры.

Проверьте возврат к заказу перед запуском

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

Откройте заказ с другого устройства под той же учётной записью: сведения должны соответствовать серверному состоянию. При проверке интерфейса поможет список проверок Mini App перед запуском.

Сохраните результаты вместе с правилами обработки заказов. Передайте список проблем на разбор команде Feature IT, чтобы исправления можно было проверить теми же сценариями.