Как принимать оплату в USDT на своём сайте
Как выбрать сеть и токен USDT, подключить адрес к приёму на сайте, показать точные реквизиты и отличить отправленный перевод от оплаченного заказа.
Обновлено:
Чтобы принимать USDT на сайте, подготовьте адрес получения в выбранной сети, подключите его к нужной услуге Cryptanio и показывайте покупателю реквизиты конкретного платежа. Для разовой оплаты можно разместить платёжную ссылку. Для магазина с автоматическим учётом заказов удобнее отдельный инвойс на каждую покупку.
Это руководство посвящено особенностям USDT: как не перепутать сеть, токен и валюту цены, а затем правильно проверить поступление. Общая схема подключения сайта разобрана в отдельном руководстве.
Сначала определите, какую версию USDT принимаете
USDT существует в нескольких блокчейнах. Поэтому надписи «Оплатить USDT» недостаточно: рядом должна быть понятна сеть. Одинаковый вид адреса и одинаковый тикер в двух приложениях не доказывают совместимость перевода.
Для выбранного варианта одновременно проверьте три условия:
- кошелёк получателя поддерживает USDT в этой сети и выдаёт подходящий адрес получения;
- Cryptanio позволяет использовать эту пару сети и актива в нужной услуге проекта;
- кошелёк или сервис отправителя умеет отправлять именно этот вариант USDT.
Идентификатор токена сверяйте с официальным справочником Tether, а не только с названием и логотипом. В справочнике есть исторические сведения о прекращённой поддержке: наличие старого раздела ещё не означает действующую поддержку протокола. Доступность в Cryptanio проверяется отдельно. Справочник сверён 14 ноября 2026 года.
Подготовьте адрес и подключите правильный актив
В кабинете выберите проект сайта с активной услугой Payments для инвойсов или Links для платёжных ссылок. Добавьте публичный адрес получения либо выберите его из адресной книги и подключите к выбранной услуге. Сохранение записи только в книге не включает приём платежей этой услугой.
В настройках использования адреса проверьте поле «Актив». Для USDT оно должно обозначать поддерживаемый токен выбранной сети. Пустое поле означает нативную монету, а не USDT. Поддерживаемые обозначения вроде USDT разрешаются через каталог сервиса; при указании контракта или mint используйте точный идентификатор для этой сети. Не вставляйте адрес токена из другой сети.
Для такого подключения не нужны seed-фраза и приватный ключ, позволяющий тратить средства. Проверьте, что адрес принадлежит вашему кошельку и что вы сможете управлять полученным USDT самостоятельно.
Выберите ссылку или инвойс
Если сайт представляет услугу и вы подтверждаете оплату вручную, откройте «Платёжные ссылки» и нажмите «Новая платёжная ссылка». Задайте фиксированную сумму и оставьте нужный вариант USDT в доступных способах оплаты. Разместите полученную постоянную ссылку на сайте. Для проекта должны быть доступны адреса, подключённые именно к Links.
Для автоматического магазина создавайте инвойс через API v1 на сервере. В варианте с заранее выбранным активом указываются project, chain, asset и строковая amount в единицах USDT. Цена заказа в долларах и ожидаемая криптосумма имеют разное назначение: котировка в USD не означает приём долларов или обмен полученных токенов.
Сохраните связь заказа с ID инвойса. Для новой операции задавайте уникальный Idempotency-Key, а при повторе того же запроса после сбоя сохраняйте прежний. Секретный API-ключ должен оставаться на сервере.
Показывайте реквизиты без округления и подмены
Покупателю нужны сеть, актив, адрес, точная сумма и срок оплаты с текущей страницы или из ответа инвойса. Если указаны обязательные memo, destination tag или другие дополнительные реквизиты, их также нужно передать. Для QR используйте возвращённый payment_uri, если он есть: не пересобирайте его из одного адреса и не теряйте дополнительные реквизиты.
Не заменяйте точную сумму округлённой ценой с витрины. Не обещайте, что USDC или другой токен будет принят вместо USDT из-за похожей стоимости. При смене способа оплаты покупатель должен пользоваться актуальными реквизитами своей попытки, а не ранее сохранённым адресом.
Отдельно проверьте комиссию перевода USDT: какой актив потребуется кошельку для оплаты комиссии и сколько реально получит продавец. Комиссия не должна незаметно уменьшить сумму, ожидаемую по заказу.
Проверяйте оплату по инвойсу
Скриншот, сообщение покупателя и обнаруженная транзакция не подтверждают полную оплату заказа. Для автоматической обработки проверяйте текущее состояние инвойса: успехом является paid. Недоплата, частичная оплата, переплата или поздний перевод могут требовать отдельного решения.
Сервер может получать подписанный webhook и сверять результат по API либо проверять состояние через API без webhook. Повторное событие или повторная проверка не должны выдавать товар второй раз. Если нужен обработчик уведомлений, используйте руководство по webhook.
Что проверить перед первым заказом
Откройте оплату со стороны покупателя и сверьте сеть, актив и реквизиты. При проверке реальным переводом учитывайте комиссию и используйте собственные средства: открытие страницы само по себе поступление не проверяет.
Если перевод отправлен, но заказ остаётся неоплаченным, сохраните TXID, проверьте сеть, точный токен, полученную сумму и подтверждения. Порядок разбора недоплаты и ошибок сайта есть в инструкции по неоплаченному заказу.