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

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

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

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

الشبكة	العملة	العقد / Mint	المنازل العشرية للرمز
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	6
SOLANA	USDC	EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v	6

إعداد التاجر

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

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

• تعرّف عناوين Mint رموز USDT / USDC؛ عنوان الدفع هو محفظة API. يستخدم الماسح slots من نوع finalized؛ رصد المعاملة لا يكمل الطلب فورًا. Mint حساس لحالة الأحرف؛ لا تستبدله بعقود EVM أو رموز تجريبية.

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

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

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