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

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

पाँच नेटवर्क में USDC संस्करण, कॉन्ट्रैक्ट या Mint और दशमलव जाँचें। समर्थन से वर्तमान उपलब्धता की गारंटी नहीं होती।

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

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

मुख्य नेटवर्क के समर्थित टोकन की पहचान
नेटवर्क	मुद्रा	कॉन्ट्रैक्ट / Mint	टोकन के दशमलव स्थान
ERC20	USDC	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	6
BEP20	USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	18
POLYGON	USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359	6
SOLANA	USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913	6

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

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

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

नेटवर्क

Ethereum, Polygon, Solana और Base मूल USDC उपयोग करते हैं। BNB Smart Chain में 18 दशमलव वाला Binance-Peg USDC है। TRC20 में USDC समर्थित नहीं है। USDbC, USDC.e या दूसरे कॉन्ट्रैक्ट सूचीबद्ध पहचान के विकल्प नहीं हैं।

यहाँ ERC20 का अर्थ Ethereum मुख्य नेटवर्क है, इस मानक के सभी नेटवर्क नहीं। एक ही 0x पता कई EVM नेटवर्क पर हो सकता है; ऑर्डर का नेटवर्क और टोकन संस्करण उपयोग करें। USDC मूल Circle संस्करण है; ब्रिज संस्करण उसका विकल्प नहीं है।

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

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

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

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