دليل تكامل مدفوعات USDC

هويات الرموز المدعومة على الشبكات الرئيسية

العقود وعناوين Mint إعدادات مسبقة وليست حالة القنوات الحالية. يتطلب إنشاء الطلب شبكة وأصلًا مفعّلين ومحفظة تاجر صالحة. ادفع دائمًا إلى payment.address من API، ولا تحوّل إلى العقد أو Mint.

هويات الرموز المدعومة على الشبكات الرئيسية

الشبكة	العملة	العقد / Mint	المنازل العشرية للرمز
ERC20	USDC	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48نسخ	6
BEP20	USDC	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580dنسخ	18
POLYGON	USDC	0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359نسخ	6
SOLANA	USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vنسخ	6
BASE	USDC	0x833589fcd6edb6e08f4c7c32d4f71b54bda02913نسخ	6

إعداد التاجر

1. اضبط محفظة الاستلام للشبكة وعنوان Webhook ومفتاحه مع تفعيله. احفظ API Key ومفتاح HMAC على الخادم فقط.
2. تحقق من توفر تركيبة network / currency. يدير مسؤولو المنصة RPC والشبكات والأصول؛ لا يحتاج التاجر إلى نشر ماسحات.
3. اعرض payment.amount وpayment.address وcurrency وnetwork ووقت الانتهاء من الاستجابة. بيانات QR ليست صورة.
4. تحقق من التوقيع وأزل التكرار واحفظ الحدث بشكل دائم قبل إرجاع HTTP 2xx. نفّذ تسليم الطلب بطريقة تمنع التنفيذ المكرر.

ملاحظات الشبكات والأصول

تستخدم Ethereum وPolygon وSolana وBase USDC الأصلي. تستخدم BNB Smart Chain Binance-Peg USDC بدقة 18 منزلة. لا تدعم TRC20 USDC. لا تستبدل USDbC أو USDC.e أو عقود أخرى الهويات المدرجة.

• ERC20 هنا يعني شبكة Ethereum الرئيسية وليس كل شبكة تستخدم المعيار. قد يوجد عنوان 0x نفسه في شبكات EVM مختلفة؛ استخدم شبكة الطلب وإصدار الرمز. USDC أصلي من Circle؛ لا تستبدله بإصدارات الجسور.

أمثلة الطلب الموقّع والاستجابة

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

التأكيد ومعالجة الإشعارات

الرصد ليس تأكيدًا. اعتمد على الحالة والإشعارات المتحقق منها: PAID ينتظر التأكيد. قد تنتج CONFIRMED / COMPLETED أيضًا عن قبول يدوي؛ راجع paidAmount وshortfallAmount وsettlementType. لا تثبت COMPLETED تسليم طلبك.

أسئلة التكامل