Адрес на клиента или счёт на сумму: как устроить приём USDT

Три модели приёма USDT: счёт на сумму, адрес на срок, постоянный адрес

Когда вы подключаете приём USDT, первым делом приходится решить, как клиент будет платить. Можно выставлять счёт на точную сумму, как в обычном интернет-магазине. Можно дать клиенту адрес и зачислять всё, что на него придёт. Выбор кажется техническим, но от него зависит, сколько обращений получит поддержка и сколько платежей придётся разбирать вручную.

Три модели приёма

Счёт на сумму. Клиент выбирает «пополнить на 50 USDT», получает адрес и сумму, а платёж считается оплаченным, только если пришло ровно 50. Модель привычна для магазинов с корзиной, где у заказа фиксированная цена.

Адрес на срок. Клиент получает адрес, закреплённый за ним на ограниченное время, например на час. Всё, что пришло на адрес за это время, зачисляется клиенту в той сумме, в какой пришло. Потом адрес возвращается в общий пул и может достаться другому клиенту.

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

Три модели приёма USDT: счёт на сумму, адрес на срок и постоянный адрес; что происходит при недоплате, переплате и повторном переводе
Как три модели ведут себя в типичных ситуациях

Где модели расходятся: недоплата, переплата, опоздание

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

Недоплата

Самая частая причина недоплаты не в клиенте, а в бирже. Некоторые биржи вычитают свою комиссию из суммы перевода: клиент вводит 50, а приходит 49. Бывает, что клиент просто опечатался.

  • В модели «счёт на сумму» платёж зависает в статусе «недоплачен». Клиент пишет в поддержку, поддержка просит доплатить разницу, а доплата требует ещё одной комиссии биржи.
  • В моделях с адресом клиенту зачисляется 49, и он видит это сразу. Если нужна полная сумма, он доплачивает сам.

Переплата

Клиент перевёл 55 вместо 50, например округлил. В модели со счётом нужно решать, что делать с лишними пятью: возвращать переводом (с комиссией), зачислять на баланс вручную или держать до запроса. С адресом вопроса нет, на баланс приходит 55.

Повторный перевод

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

Опоздание

Клиент открыл страницу оплаты, ушёл на биржу, прошёл проверку и вывел деньги через два часа. Если адрес был закреплён на час, платёж приходит после срока. Хорошо, когда процессинг даёт запас на такие задержки и не выдаёт адрес другому клиенту сразу после окончания срока.

Сравнение

Ситуация Счёт на сумму Адрес на срок Постоянный адрес
Точная сумма вовремя Оплачено Зачислено Зачислено
Недоплата Ручной разбор или доплата Зачислено столько, сколько пришло Зачислено столько, сколько пришло
Переплата Ручной разбор или возврат Зачислено столько, сколько пришло Зачислено столько, сколько пришло
Повторный перевод Ручной разбор Зачислено в срок, после него разбор Зачислено
Сколько адресов нужно По одному на счёт Пул, адреса переиспользуются По одному на клиента

Когда что выбирать

Счёт на сумму подходит, если вы продаёте товары с фиксированной ценой и вам важно, чтобы заказ был оплачен целиком. Например, интернет-магазин, где после оплаты сразу отгружается товар. Закладывайте время поддержки на недоплаты.

Адрес на срок подходит для сервисов с внутренним балансом: клиент пополняет счёт и потом тратит его. Адресов нужно немного, потому что они переиспользуются, а значит, меньше затрат на сбор средств с адресов и на их обслуживание. Клиенту нужно чётко сказать, что адрес действует ограниченное время и сохранять его нельзя.

Постоянный адрес удобен постоянным клиентам, которые пополняют баланс регулярно. Клиент один раз сохраняет адрес и больше не ошибается. Минус в том, что адресов становится столько же, сколько клиентов, и каждый нужно обслуживать: следить за ним, собирать с него деньги. В TRON сбор с каждого адреса стоит заметно дороже, чем в других сетях. Почему, разобрано в статье Комиссия за перевод USDT в TRC-20.

Модели можно сочетать. Например, новым клиентам выдавать адрес на срок, а постоянным по запросу закреплять личный адрес.

Что показать клиенту на странице оплаты

Какую бы модель вы ни выбрали, на странице оплаты стоит показать:

  • сеть крупно рядом с адресом: «USDT, сеть TRON (TRC-20)»;
  • адрес с кнопкой копирования и QR-код;
  • срок действия адреса, если он ограничен;
  • для счёта на сумму: точную сумму и предупреждение, что биржа может удержать комиссию из перевода;
  • статус: «ждём перевод», «перевод найден», «зачислено».

Как сделать страницу, на которой трудно ошибиться сетью, рассказано в статье Клиент отправил USDT не в ту сеть. Порядок интеграции с API описан в статье Как подключить оплату в USDT через API.

Что из этого делать самому

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

Частые вопросы

Можно ли в модели с адресом всё-таки требовать полную сумму?

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

Что будет, если клиент отправит деньги на адрес после окончания срока?

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

Почему не выдавать каждому клиенту новый адрес на каждый платёж?

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


В KosPay есть обе модели с адресом. Адрес на срок выдаётся на 60 минут, и в течение нескольких часов после этого он не достаётся другому клиенту: перевод, задержанный биржей, всё равно зачислится тому, кто платил. Постоянный адрес закрепляется за клиентом навсегда. В обеих моделях зачисляется фактически пришедшая сумма, недоплаты и переплаты не требуют разбора. Платёж, пришедший после срока, остаётся на вашем балансе, и его можно привязать к клиенту запросом к API. Описание запросов в документации API, тарифы на главной странице.