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

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

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

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

الشبكة	العملة	العقد / Mint	المنازل العشرية للرمز
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7	6
ERC20	USDC	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48	6

إعداد التاجر

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

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

• 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":"USDT","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 تسليم طلبك.

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