Приём USDT в сети TON: оплата из Telegram-кошельков
Если ваши клиенты живут в Telegram, многие из них уже держат USDT в сети TON: в кошельке внутри мессенджера, в Tonkeeper или в другом TON-кошельке. Для таких клиентов оплата в TON удобнее, чем в TRON: перевод стоит доли цента и проходит за секунды. Но у сети есть свои особенности, о которых стоит знать до подключения: форматы адресов, комментарий к переводу, поддельные токены и плата за новый кошелёк.
Как устроен USDT в TON
В TON токены называются жетонами (jetton). У каждого жетона есть главный контракт, а у каждого владельца отдельный маленький кошелёк этого жетона. Когда клиент отправляет USDT, его жетон-кошелёк пересылает токены на жетон-кошелёк получателя, а тот сообщает об этом владельцу.
Для вас это означает две практические вещи.
- Комиссия платится в TON. Чтобы отправить USDT, у клиента на кошельке должно быть немного TON. Если TON на кошельке нет, перевод не уйдёт, и клиенту придётся сначала его купить или получить.
- Перевод проходит в несколько шагов. Между ними может что-то пойти не так, и тогда токены возвращаются отправителю. Поэтому процессинг должен проверять, что перевод действительно дошёл, а не только то, что он начался.
Адреса: UQ и EQ
Адрес в TON обычно записывают в виде строки, которая начинается с UQ или EQ. Это один и тот же адрес в двух формах, отличаются они флагом «отскока».
EQ…(bounceable): если получатель не может принять перевод, например кошелёк ещё не развёрнут, средства вернутся отправителю.UQ…(non-bounceable): перевод дойдёт в любом случае. Эту форму рекомендуют для обычных кошельков пользователей.
Сравнивать адреса как строки нельзя: UQ… и EQ… одного кошелька выглядят по-разному. Процессинг должен приводить их к единому виду, иначе часть переводов не найдёт владельца.
Комментарий (memo): когда он нужен
При переводе в TON можно указать текстовый комментарий. Биржи используют его, чтобы понять, чей это депозит: у биржи один адрес на всех, а клиента определяют по комментарию. Если клиент забыл комментарий, депозит на бирже приходится восстанавливать через поддержку.
Если процессинг выдаёт каждому клиенту собственный адрес, комментарий не нужен: клиента определяют по адресу. Это проще и для клиента, и для вас: на один источник ошибок меньше.
Обратная ситуация возникает при выплатах. Если ваш клиент выводит USDT на биржу, биржа почти наверняка потребует комментарий. Без него деньги дойдут до биржи, но не попадут на счёт клиента автоматически. Поэтому в форме вывода стоит дать поле для комментария и подсказку, где его взять.
Поддельные USDT
В TON любой может выпустить жетон с названием «USDT» и такой же иконкой. Кошельки обычно помечают проверенные токены, но не всегда, и клиент может искренне не заметить разницы. Отличить настоящий USDT можно только по адресу главного контракта.
Адрес главного контракта USDT в TON, по данным Tether и обозревателей блоков: EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs.
Процессинг должен принимать только переводы этого жетона и игнорировать остальные, как бы они ни назывались. Если вы принимаете TON-платежи сами, проверяйте именно контракт, а не название или символ токена.
Сколько стоит перевод
Перевод USDT в TON для клиента дешёвый, комиссия платится в TON. Есть одна особенность: чтобы кошелёк в TON начал работать, его нужно развернуть, и сеть оставляет на нём небольшой резерв TON. Если вы строите приём сами, это разовая плата за каждый новый адрес клиента. Через шлюз она вас не касается.
Сравнение TON с TRON, BSC и Polygon по скорости и стоимости есть в статье TRC-20 или BEP-20, Polygon или TON: какую сеть выбрать. Почему TRON на этом фоне дорогой, объяснено в статье Комиссия за перевод USDT в TRC-20.
Как подключить оплату в TON для Telegram-проекта
Схема та же, что для любой другой сети.
- Пользователь нажимает «Пополнить» в боте или мини-приложении.
- Ваш сервер запрашивает у процессинга адрес в сети TON для этого пользователя.
- Бот показывает адрес, кнопку копирования и пометку «USDT, сеть TON». Можно добавить ссылку
ton://transfer/…, которая откроет кошелёк с заполненным адресом. - Процессинг видит перевод, проверяет контракт токена и отправителя, зачисляет сумму и присылает вебхук.
- Бот сообщает пользователю, что баланс пополнен.
Подробно об обработке уведомлений и проверке подписи в статье Как подключить оплату в USDT через API.
Что остаётся на вашей стороне
Из пяти шагов на вас только первый, третий и пятый: кнопка, показ адреса и сообщение о пополнении. Развёртывание кошельков, отсев поддельных жетонов и проверку отправителя берёт на себя процессинг. Если строить приём в TON самому, всё это придётся писать отдельно. Особенно важна проверка контракта: без неё на баланс клиента попадут жетоны, которые ничего не стоят.
Частые вопросы
Можно ли отправить USDT из TON на адрес в TRON?
Нет. Это разные сети с несовместимыми адресами, кошелёк не даст отправить USDT из TON на адрес T…. Что делать, если клиент всё-таки ошибся сетью в другой паре, разобрано в статье Клиент отправил USDT не в ту сеть.
Почему у клиента не уходит перевод USDT?
Чаще всего на кошельке нет TON для оплаты комиссии. Иногда причина в том, что клиент пытается отправить не тот жетон.
Нужен ли комментарий при оплате на сайт?
Если сайт выдаёт личный адрес под платёж, не нужен. Если сайт даёт один общий адрес на всех, комментарий обязателен, иначе платёж не с чем сопоставить.
В KosPay каждый клиент получает свой адрес в сети TON (UQ…), комментарий для оплаты не нужен. Принимаются только переводы настоящего USDT: фильтр идёт по адресу главного контракта, жетоны с тем же названием не зачисляются. Зачисление в TON занимает до минуты, приём бесплатный, вывод стоит 1 USDT с включённым газом, комментарий для биржи можно указать в выплате. Подробности на главной странице, запросы в документации API.