Приём USDT в сети TRON (TRC20)

#Как проходит платёж в USDT (TRC20)

Платёж в USDT (TRC20) в CryptoLike проходит четыре шага и три статуса: new, pending и paid. Страница оплаты, API и вебхуки показывают один и тот же статус, поэтому логике заказа достаточно одного поля. Плательщику не нужен аккаунт в CryptoLike — только кошелёк TRON, где есть USDT и немного TRX.

1. Вы создаёте платёж через POST /v1/invoices, плагин WooCommerce, модуль OpenCart или ссылку на оплату. Статус: new.
2. Плательщик видит, что отправить: точную сумму в USDT, сеть (TRON), адрес с QR-кодом и оставшееся время.
3. Перевод обнаружен. Статус: pending, «Платёж обнаружен. Ожидаем подтверждения.»
4. Платёж подтверждён. Когда подтверждений становится 19, статус меняется на paid, деньги на балансе, приходит подписанный вебхук invoice.paid.

#Что нужно знать плательщику о сети TRON

CryptoLike принимает USDT в сети TRON только с официального контракта Tether и только на адрес TRON, который начинается с T. Комиссию сети TRON кошелёк плательщика оплачивает в TRX — энергией и пропускной способностью, поэтому рядом с USDT нужно держать немного TRX. Сумма со страницы оплаты должна прийти целиком и только в сети TRON.

• Адрес. 34 символа, начинается с T. После вставки сверьте первые и последние символы со страницей.
• Комиссия сети. Перевод TRC20 расходует энергию и пропускную способность; если своей энергии у аккаунта нет, сеть сжигает за неё TRX. С кошелька, где есть USDT, но нет TRX, отправить не получится.
• Контракт. Зачисляется только USDT контракта Tether TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t.
• Точная сумма. Если биржа вычитает свою комиссию за вывод из суммы, платёж придёт неполным и получит статус underpaid. Доплатите разницу на тот же адрес, пока не истекло время.
• Сеть. USDT, отправленные в другой сети, до платежа не дойдут, и вернуть их невозможно.

#Как создать платёж в USDT (TRC20)

Чтобы создать платёж в USDT (TRC20) в CryptoLike, возьмите id актива с ticker USDT и network tron из GET /v1/currencies и передайте его как coin_id в POST /v1/invoices. Цену можно указать в USDT или в долларах: тогда CryptoLike пересчитает её по текущему курсу и зафиксирует курс на время жизни платежа.

COIN_ID=$(curl -s https://api.cryptolike.net/v1/currencies \
  | jq -r '.currencies[] | select(.ticker=="USDT" and .network=="tron") | .id')

BODY='{"amount":"49.90","currency":"USD","coin_id":"'"$COIN_ID"'","order_id":"A-1001"}'
curl -s https://api.cryptolike.net/v1/invoices \
  -H "Content-Type: application/json" -H "Idempotency-Key: order-A-1001" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Signature: $SIG" -d "$BODY"

В ответе есть address, payer_amount и checkout_url — отправьте плательщика туда. Подпись запроса — в разделе аутентификация API, все поля — в справочнике API.

#Вопросы и ответы

#Сколько подтверждений нужно для USDT TRC20?

CryptoLike зачисляет USDT (TRC20), когда число подтверждений сети TRON достигает 19. Порог задаётся для каждого актива, возвращается в GET /v1/currencies, а плательщик видит прогресс на странице оплаты. Подробнее — в статье о подтверждениях.

#Что будет, если плательщик отправит USDT в сети Ethereum (ERC20)?

Перевод до этого платежа не дойдёт, и вернуть его невозможно: платёж TRC20 ждёт перевод только на адрес TRON. Чтобы сеть выбирал сам плательщик, создайте платёж с currency: "USDT" без coin_id — на странице оплаты будут TRON и Ethereum (ERC20).

#Можно ли выставить цену в долларах?

Да. Передайте currency: "USD" вместе с coin_id USDT: CryptoLike пересчитает сумму по текущему курсу и зафиксирует его на время жизни платежа. Если свежего курса нет, API ответит 503 — повторите запрос или укажите цену в USDT.

#Можно ли выдать клиенту постоянный адрес USDT TRC20?

Да. POST /v1/addresses с coin_id USDT (TRC20) и вашим customer_id выдаёт статический адрес. Каждый перевод на него зачисляется, когда число подтверждений достигает 19, и о нём сообщает вебхук deposit.confirmed; удержанный для проверки перевод вместо этого присылает deposit.on_hold.

#Как работают выплаты в USDT TRC20?

POST /v1/withdrawals с coin_id, amount, to_address и вашим payout_id или CSV-файл до 1 000 строк в кабинете (массовые выплаты). Сначала POST /v1/withdrawals/estimate покажет комиссию платформы, зарезервированную комиссию сети (в USDT, баланс TRX не нужен) и итоговое списание. Выплаты доступны после верификации аккаунта; актуальные комиссии — на странице тарифов.