Техническая архитектура зависит от конкретного проекта, но общий процесс можно представить следующим образом.
1. Создать Telegram-бота
Mini App работает в связке с Telegram-ботом. Через BotFather настраивается бот и подключается основное Mini App. После этого пользователь сможет открывать приложение непосредственно из Telegram.
2. Разработать Mini App
Далее создается интерфейс магазина. Это обычное веб-приложение, адаптированное под Telegram. На этом этапе реализуются:
- каталог;
- карточки товаров;
- корзина;
- оформление заказа;
- пользовательские данные;
- интеграция с backend бизнеса.
3. Подключить backend
Не стоит строить всю платежную логику только на стороне Mini App. Backend бизнеса должен отвечать за:
- создание заказа;
- расчет итоговой суммы;
- проверку товаров;
- создание платежа;
- получение результата операции;
- изменение статуса заказа;
- взаимодействие с CRM, складом и другими системами.
4. Создать платеж
Когда пользователь подтверждает заказ, сервер передает необходимые параметры в платежную систему. Например:
- номер заказа;
- сумму;
- валюту;
- описание;
- информацию, необходимую для проведения операции.
После этого запускается платежный сценарий.
5. Пользователь подтверждает оплату
Клиент выбирает доступный платежный метод и завершает операцию. Если используется банковская карта, могут применяться дополнительные механизмы безопасности, включая 3-D Secure.
6. Backend получает статус операции
После оплаты сервер бизнеса должен получить результат от платежной системы. Не стоит определять успешность заказа только по тому, какой экран увидел пользователь. именно серверный статус должен использоваться для решения: выдавать товар или услугу либо нет.
7. Клиент получает подтверждение
Mini App показывает результат, а Telegram-бот может отправить дополнительное уведомление. Например:
«Спасибо! Мы получили оплату и начали собирать ваш заказ».