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

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

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

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

नेटवर्क	मुद्रा	कॉन्ट्रैक्ट / Mint	टोकन के दशमलव स्थान
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2कॉपी करें	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913कॉपी करें	6

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

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

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

• Base मुख्य नेटवर्क का chain ID 8453 है, Base Sepolia नहीं। व्यापारी वॉलेट सेट करता है; व्यवस्थापक RPC और नेटवर्क सक्षम करना सँभालता है। USDC मूल Circle और USDT तय ब्रिज संस्करण है; USDbC शामिल नहीं है। स्कैन L1-finalized सुरक्षित ऊँचाई से होता है: समय समाप्त होने से पहले भेजें; पुष्टि बाद में आ सकती है और तय समय नहीं है। WooCommerce का स्थापित संस्करण और समर्थित नेटवर्क व मुद्राएँ जाँचें।

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

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

# 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":"BASE","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"

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

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

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