تكامل مدفوعات العملات المستقرة على Base

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

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

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

الشبكة	العملة	العقد / Mint	المنازل العشرية للرمز
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2نسخ	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. نفّذ تسليم الطلب بطريقة تمنع التنفيذ المكرر.

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

• معرّف شبكة Base الرئيسية 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 تسليم طلبك.

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