Як приймати USDT (TRC20) на сайті чи в боті

USDT у мережі TRON — найпоширеніший спосіб платити крипто в багатьох регіонах: перекази швидкі й дешеві для платника. Тут мінімальна інтеграція з ChainPay.

Модель

Ваш бекенд просить у ChainPay адресу для депозиту на кожне замовлення (або кожного користувача).
Платник надсилає USDT на цю адресу.
Після підтвердження мережею ChainPay переводить кошти на ваш гаманець і викликає ваш webhook.

Кошти у вас: призначення — ваш forwardAddress, мерчантського балансу ChainPay не тримає.

Адреса на замовлення чи на користувача

На замовлення: новий externalReference для кожного замовлення. Проста звірка, один платіж на адресу.
На користувача: той самий externalReference для користувача. Адреса постійна й приймає багато депозитів; підходить для поповнень і балансів.

Створення адреси

curl -X POST https://api.chainpay.site/deposit-address \
  -H 'content-type: application/json' \
  -d '{
    "ticker": "trc20/usdt",
    "callbackUrl": "https://shop.example.com/crypto-webhook?token=SECRET",
    "forwardAddress": "TYourOwnTronWallet...",
    "externalReference": "order-123"
  }'

Обробка webhook

Перевіряйте значення token у query.
Знаходьте платіж за externalReference.
Зараховуйте замовлення лише на status: "confirmed".
Робіть обробник ідемпотентним: одна подія може прийти кілька разів.

Скільки платить клієнт

Кожен TRC20-переказ потребує TRON Energy, тому комісія має відсоткову частину (1%) і flat-частину за живою мережевою вартістю. У TRON flat наразі приблизно 4 USDT, тож дуже малі платежі невигідні. Виставте розумний мінімум суми замовлення. Актуальні цифри — на сторінці Ціни.

Перевірка

Щоб бачити адресу у своєму акаунті, зареєструйтесь у кабінеті, створіть API-ключ і надішліть той самий запит із x-api-key.