Руководство по приёму платежей USDT

Идентификаторы токенов основной сети

Контракты и Mint — предустановленные значения, а не текущий статус каналов. Для заказа нужны включённые сеть и актив и действительный кошелёк. Платите на payment.address из API, никогда на контракт или Mint.

Идентификаторы токенов основной сети

Сеть	Валюта	Контракт / Mint	Разрядность токена
TRC20	USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6tКопировать	6
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7Копировать	6
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955Копировать	18
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8FКопировать	6
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBКопировать	6
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2Копировать	6

Настройка продавца

1. Настройте кошелёк сети и включённый Webhook с URL и ключом. Храните API Key и ключ HMAC только на сервере.
2. Проверьте доступность network / currency. Администратор управляет RPC, сетями и активами; продавцу не нужно развёртывать сканеры.
3. Покажите payment.amount, payment.address, currency, network и срок действия из ответа. Данные QR — не изображение.
4. Проверьте подпись, устраните дубликаты и надёжно сохраните событие до ответа HTTP 2xx. Выдавайте заказ идемпотентно.

Примечания о сетях и активах

USDT поддерживается в шести сетях. Настроенный токен BNB Smart Chain имеет 18 десятичных знаков, остальные пять — 6. Это отличается от точности суммы заказа. Base использует настроенную мостовую версию USDT; BoltUtil не переводит средства между сетями. Выбирайте сеть заказа и точную указанную версию токена: одинаковый символ или адрес не делает сети и токены взаимозаменяемыми.

• TRC20 — код TRON в API, поддерживается только USDT, не currency=USDC. У USDT 6 знаков токена; сохраняйте сумму из API. Подтверждение зависит от конфигурации и сканирования, без гарантированного числа секунд.

Примеры подписанного запроса и ответа

25.00 — сумма для примера. Используйте реальную сумму заказа с учётом минимума актива. Адреса, заказы и хеши вымышлены. Скопированный cURL или Java отправляет запрос: настройте собственные ключи перед запуском.

# Run against your account only when ready; this sends an API request.
: "${BOLTUTIL_API_KEY:?Set your complete API Key}"
: "${BOLTUTIL_WEBHOOK_SECRET:?Set your Webhook secret}"
timestamp=$(python3 -c 'import time; print(int(time.time()*1000))')
body='{"amount":"25.00","currency":"USDT","network":"TRC20","externalOrderId":"INV-20260209-99281"}'
signature=$(printf '%s.%s' "$timestamp" "$body" | openssl dgst -sha256 -hmac "$BOLTUTIL_WEBHOOK_SECRET" | awk '{print $NF}')

curl --request POST "https://api.boltutil.com/api/v1/order/create" \
  --header 'Content-Type: application/json' \
  --header "X-Bolt-Key: $BOLTUTIL_API_KEY" \
  --header "X-Bolt-Timestamp: $timestamp" \
  --header "X-Bolt-Signature: $signature" \
  --data-binary "$body"

Подтверждение и уведомления

Обнаружение не равно подтверждению. Используйте статус и проверенные callbacks: PAID ждёт подтверждения. CONFIRMED / COMPLETED возможны и после ручного принятия; проверьте paidAmount, shortfallAmount и settlementType. COMPLETED не доказывает выдачу товара.

Вопросы интеграции