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

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

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

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

الشبكة	العملة	العقد / Mint	المنازل العشرية للرمز
TRC20	USDT	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6tنسخ	6
ERC20	USDT	0xdAC17F958D2ee523a2206206994597C13D831ec7نسخ	6
BEP20	USDT	0x55d398326f99059fF775485246999027B3197955نسخ	18
POLYGON	USDT	0xc2132D05D31c914a87C6611C10748AEb04B58e8Fنسخ	6
SOLANA	USDT	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYBنسخ	6
BASE	USDT	0xfde4c96c8593536e31f229ea8f37b2ada2699bb2نسخ	6

إعداد التاجر

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

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

تدعم USDT ست شبكات. يستخدم الرمز المهيأ على BNB Smart Chain دقة 18 منزلة عشرية، بينما تستخدم الشبكات الخمس الأخرى 6 منازل. تختلف هذه الدقة عن دقة مبلغ الطلب. تستخدم Base إصدار USDT المهيأ عبر الجسر؛ ولا تنقل BoltUtil الأموال بين الشبكات. اختر شبكة الطلب وإصدار الرمز المحدد: تطابق الاسم أو عنوان المحفظة لا يجعل الشبكات أو الرموز قابلة للاستبدال.

• TRC20 هو رمز TRON في API ويدعم USDT فقط؛ لا ترسل currency=USDC. لدى USDT ست منازل عشرية للرمز؛ استخدم المبلغ الذي يعيده API كاملًا. التأكيد حسب الإعدادات والمسح دون ضمان عدد ثوانٍ ثابت.

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

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

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