Як приймати платежі в USDT (BEP20, BNB Smart Chain)

USDT у мережі BNB Smart Chain популярний, бо перекази швидкі, а комісія мережі низька. Цей гайд показує мінімальну інтеграцію з ChainPay: без реєстрації й без API-ключа.

Модель

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

Кошти лишаються у вас: призначення — це ваша forwardAddress.

Створіть адресу

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

ticker: "bep20/usdt" вибирає мережу BNB Smart Chain і токен USDT.
forwardAddress — звичайна адреса 0x… вашого гаманця в BSC.
Повторний запит з тими самими параметрами повертає ту саму адресу, тож ретраї безпечні.

Обробіть вебхук

Після підтвердження депозиту ChainPay надсилає POST на ваш callbackUrl:

{
  "status": "confirmed",
  "externalReference": "order-123",
  "chain": "bsc",
  "tokenSymbol": "USDT",
  "tokenAddress": "0x55d398326f99059fF775485246999027B3197955",
  "isNative": false,
  "amount": "25.000000000000000000",
  "txHash": "0x…"
}

Перевіряйте значення token зі свого callbackUrl: вебхуки не підписуються.
Знаходьте замовлення за externalReference і зараховуйте його лише при status: "confirmed".
Зробіть обробник ідемпотентним: одна подія може прийти кілька разів. Див. рекомендації щодо вебхуків.

Вкажіть платнику мережу

Показуйте мережу поруч з адресою: BNB Smart Chain (BEP20). Токен, надісланий іншою мережею, не надійде як BEP20-депозит, тому чітка підказка прибирає більшість звернень у підтримку.

Комісія

Комісія — 1% плюс невелика фіксована частина за реальною вартістю газу мережі. Газ у BSC низький, тому менші платежі мають сенс частіше, ніж у TRON. Актуальні числа — на сторінці Pricing, мінімальні суми — у Networks.