TON Connect в боте: как подключить кошелёк без лишней боли и ошибок

TON Connect в боте: как подключить кошелёк без лишней боли и ошибок

TON Connect нужен там, где бот не просто показывает баланс, а просит пользователя подписать действие: пополнить счёт, подтвердить покупку, вывести TON или открыть платную фичу. Главная идея простая: бот не хранит приватные ключи, он получает только факт подключения и разрешение на конкретную операцию.

На практике схема такая:
— бот выдаёт кнопку подключения;
— пользователь открывает кошелёк и подтверждает сессию;
— кошелёк возвращает адрес и публичные данные;
— дальше бот шлёт запрос на подпись транзакции или message payload.
Если вы строите Mini App, держите один и тот же wallet-state между ботом и приложением, иначе упрётесь в лишние повторные коннекты.

Что важно:
— проверяйте, что адрес реально принадлежит этой сессии, а не просто пришёл в callback;
— не просите подпись “на всё сразу”, дробите действия на короткие шаги;
— сразу показывайте пользователю, за что он платит и что именно подпишет;
— храните у себя не кошелёк, а связку user_id ↔ wallet_address ↔ статус подключения.

На практике самые частые провалы — это лишние редиректы, путаница между сетью и адресом, а также попытка сделать checkout без нормального экрана подтверждения. Чем меньше экранов между кнопкой и подписью, тем выше конверсия и меньше отказов.

Если делаете монетизацию через TON, начинайте не с платежа, а с сценария подключения: сначала доверие и понятный экран, потом транзакция.