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

BNB Smart Chain स्टेबलकॉइन भुगतान एकीकरण

BNB Smart Chain की टोकन पहचान, पैरामीटर और पुष्टि जाँचें। API की पूरी राशि दें।

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

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

मुख्य नेटवर्क के समर्थित टोकन की पहचान
नेटवर्कमुद्राकॉन्ट्रैक्ट / Mintटोकन के दशमलव स्थान
BEP20 network logoBEP20USDT18
BEP20 network logoBEP20USDC18

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

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

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

  • BEP20 का अर्थ BNB Smart Chain मुख्य नेटवर्क है, Ethereum नहीं। तय USDT और USDC में 18 टोकन दशमलव हैं, जो ऑर्डर पहचान की सटीकता से अलग हैं। USDC Binance-Peg है, Circle का मूल USDC नहीं।

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

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":"BEP20","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 दें। एक वॉलेट के ऑर्डर अलग करने के लिए सिस्टम राशि ऊपर राउंड करके छोटा अंतर जोड़ सकता है। स्वयं राशि न काटें या राउंड करें।

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

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