USDT ödeme entegrasyonu rehberi

Ana ağda desteklenen token kimlikleri

Sözleşmeler ve Mint adresleri ön tanımlıdır, canlı kanal durumu değildir. Sipariş için etkin ağ ve varlık ile geçerli satıcı cüzdanı gerekir. Her zaman API’nin payment.address adresine ödeme yapın; sözleşme veya Mint adresine göndermeyin.

Ana ağda desteklenen token kimlikleri

Ağ	Para birimi	Sözleşme / Mint	Token ondalık basamakları
TRC20	USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6tKopyala	6
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7Kopyala	6
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955Kopyala	18
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8FKopyala	6
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBKopyala	6
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2Kopyala	6

Satıcı kurulumu

1. Ağa ait alıcı cüzdanı ve etkin Webhook URL’si ile anahtarını ayarlayın. API Key ve HMAC anahtarını yalnızca sunucuda tutun.
2. network / currency çiftinin kullanılabilirliğini kontrol edin. RPC, ağ ve varlıkları yöneticiler yönetir; satıcılar tarayıcı dağıtmak zorunda değildir.
3. Yanıttaki payment.amount, payment.address, currency, network ve süre sonunu gösterin. QR verisi bir görüntü değildir.
4. HTTP 2xx yanıtından önce imzayı doğrulayın, tekrarları ayıklayın ve olayı kalıcı kaydedin. Sipariş teslimatını idempotent işleyin.

Ağ ve varlık notları

USDT altı ağda desteklenir. BNB Smart Chain için yapılandırılan token 18 ondalık basamak kullanır; diğer beş ağda bu sayı 6’dır. Bu, sipariş tutarı hassasiyetinden farklıdır. Base yapılandırılmış köprü USDT sürümünü kullanır; BoltUtil ağlar arasında para taşımaz. Sipariş ağını ve listelenen token sürümünü seçin: aynı sembol veya adres ağları ya da tokenları birbirinin yerine kullanılabilir yapmaz.

• TRC20, TRON için API kodudur; yalnızca USDT destekler, currency=USDC kullanmayın. USDT 6 token ondalığına sahiptir; API tutarını aynen kullanın. Onay yapılandırma ve taramaya bağlıdır, sabit saniye garantisi yoktur.

İmzalı istek ve yanıt örnekleri

25.00 örnek tutardır. Gerçek sipariş tutarını kullanın ve varlığın alt sınırını karşılayın. Adres, sipariş ve işlem karmaları örnektir. Kopyalanan cURL / Java istek gönderir: çalıştırmadan önce kendi anahtarlarınızı ayarlayın.

# 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"

Onay ve bildirim işleme

Algılama onay değildir. Durumu ve doğrulanmış callback’leri kullanın: PAID onay bekler. CONFIRMED / COMPLETED elle kabul sonucu da olabilir; paidAmount, shortfallAmount, settlementType alanlarını kontrol edin. COMPLETED teslimatı kanıtlamaz.

Entegrasyon soruları