TON Wallet в Mini-App: 6 правил, чтобы не сломать вход и не потерять деньги

TON Wallet в Mini-App: 6 правил, чтобы не сломать вход и не потерять деньги

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

• Не просите лишние разрешения: один экран — одно действие.
• Всегда показывайте сумму, сеть и адрес получателя до подтверждения.
• Делайте idempotency для платежей: повторный клик не создаёт дубль.
• Храните минимум данных на клиенте, а критичные операции валидируйте на сервере.

UX здесь работает вместе с безопасностью: если пользователь не видит, что происходит, он уходит. Если вы прячете подпись в глубине интерфейса, это уже не онбординг, а ловушка. Лучший паттерн — явный статус: «ожидаем подпись», «подтверждено», «платёж отклонён», без двусмысленных сообщений.

На стороне логики держите раздельно: экран приложения, слой вызова кошелька, сервер проверки транзакции. Это упрощает отладку и спасает от ситуации, когда UI говорит «успешно», а платёж ещё не подтверждён.

Экономика на Stars: считайте профит только после того, как сценарий оплаты прозрачен и повторяем. Чем короче путь от намерения до подтверждения, тем меньше ошибок, возвратов и поддержки.