डेवलपर दस्तावेज़

USDT भुगतान एकीकरण गाइड

छह नेटवर्क पर USDT स्वीकार करें। हस्ताक्षरित ऑर्डर बनाने और पुष्टि संभालने से पहले समर्थित टोकन संस्करण, कॉन्ट्रैक्ट या Mint और दशमलव सटीकता जांचें।

मुख्य नेटवर्क के समर्थित टोकन की पहचान

कॉन्ट्रैक्ट और Mint पहले से तय पहचान हैं, चैनल की वर्तमान स्थिति नहीं। ऑर्डर के लिए सक्षम नेटवर्क और एसेट तथा वैध व्यापारी वॉलेट चाहिए। हमेशा API के payment.address पर भेजें, कॉन्ट्रैक्ट या 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

व्यापारी का सेटअप

नेटवर्क का प्राप्ति वॉलेट और सक्षम Webhook URL व कुंजी सेट करें। API Key और HMAC कुंजी केवल सर्वर पर रखें।
network / currency की उपलब्धता जाँचें। व्यवस्थापक RPC, नेटवर्क और एसेट सँभालते हैं; व्यापारी को स्कैनर लगाने की जरूरत नहीं है।
उत्तर से payment.amount, payment.address, currency, network और समाप्ति समय दिखाएँ। QR डेटा चित्र नहीं है।
HTTP 2xx देने से पहले हस्ताक्षर जाँचें, डुप्लिकेट हटाएँ और घटना स्थायी रूप से सहेजें। ऑर्डर की डिलीवरी इडेम्पोटेंट रखें।

नेटवर्क और एसेट संबंधी जानकारी

नेटवर्क

USDT छह नेटवर्क पर समर्थित है। BNB Smart Chain में कॉन्फ़िगर किया गया टोकन 18 दशमलव स्थान उपयोग करता है; अन्य पांच में 6 हैं। यह ऑर्डर राशि की पहचान सटीकता से अलग है। Base कॉन्फ़िगर किए गए ब्रिज USDT का उपयोग करता है; BoltUtil नेटवर्क के बीच धन हस्तांतरण नहीं करता। ऑर्डर का नेटवर्क और सूचीबद्ध टोकन संस्करण चुनें: समान नाम या वॉलेट पता नेटवर्क या टोकन को परस्पर बदलने योग्य नहीं बनाता।

TRC20, TRON का API कोड है और केवल USDT समर्थित है; currency=USDC न भेजें। USDT में टोकन के 6 दशमलव स्थान हैं; API की देय राशि ज्यों की त्यों रखें। पुष्टि कॉन्फ़िगरेशन और स्कैन पर निर्भर है, तय सेकंड की गारंटी नहीं है।

हस्ताक्षरित अनुरोध और उत्तर के उदाहरण

25.00 उदाहरण राशि है। वास्तविक ऑर्डर राशि लें और एसेट की न्यूनतम राशि पूरी करें। पते, ऑर्डर और हैश उदाहरण हैं। कॉपी किया cURL / Java अनुरोध भेजेगा: चलाने से पहले अपनी कुंजियाँ सेट करें।

create / cURL

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

पते, लेनदेन हैश और ऑर्डर इसके उदाहरण हैं। उन्हें अपने स्वयं के परीक्षण data से बदलें।

Base URL

PROD

https://api.boltutil.com

ऑर्डर के सभी पैरामीटर →

पुष्टि और कॉलबैक प्रबंधन

पहचान और पुष्टि अलग हैं। स्थिति और सत्यापित कॉलबैक से निर्णय लें: PAID अभी पुष्टि की प्रतीक्षा में है। CONFIRMED / COMPLETED मैन्युअल स्वीकृति से भी आ सकते हैं; paidAmount, shortfallAmount और settlementType जाँचें। COMPLETED डिलीवरी का प्रमाण नहीं है।

एकीकरण संबंधी प्रश्न

क्या समर्थित मुद्रा अभी उपलब्ध है?

जरूरी नहीं। नेटवर्क व एसेट सक्षम हों और वॉलेट व Webhook वैध हों। स्थिर तालिका वर्तमान उपलब्धता नहीं दिखाती।

क्या ग्राहक राशि राउंड कर सकता है?

पूरी payment.amount दें। एक वॉलेट के ऑर्डर अलग करने के लिए सिस्टम राशि ऊपर राउंड करके छोटा अंतर जोड़ सकता है। स्वयं राशि न काटें या राउंड करें।

वॉलेट बैलेंस बढ़ने पर सामान दे सकते हैं?

पुष्ट ऑर्डर परिणाम और सूचना की प्रामाणिकता जाँचें। गलत नेटवर्क, टोकन संस्करण, राशि और दोहराई गई घटना को संभालना चाहिए। बैलेंस बढ़ना ऑर्डर भुगतान के परिणाम का विकल्प नहीं है।