تكامل الدفع

خطافات الويب للدفع عبر USDT / USDC التي يمكن أن تثق بها الواجهة الخلفية لديك

يرسل BoltUtil حمولات خطاف الويب الموقعة مع معرف الطلب والحالة والشبكة والمبلغ والتأكيدات وتجزئة المعاملة بعد تأكيد الدفع.

الخطوات

تدفق تسليم الخطاف عبر الويب

الأفضل للفرق التي تحتاج إلى تنشيط الحساب تلقائيًا، أو إضافة الرصيد، أو تلبية الطلب، أو ترقية العضوية بعد الدفع.

  1. 01

    قم بتكوين عنوان URL لخطاف الويب الخاص بك والسر.

  2. 02

    قم بإنشاء طلب باستخدام عنوان URL للإشعار أو استخدم الرد التلقائي على الويب للتاجر.

  3. 03

    يكتشف BoltUtil تحويل USDT / USDC المطابق ويضع علامة على تأكيد الطلب.

  4. 04

    تقوم الواجهة الخلفية لديك بالتحقق من التوقيع وتحديث حساب العميل.

يتحقق BoltUtil من الدفع ويرسل إشعارات موقعة. يتحقق خادمك من التوقيع وحالة الطلب ويمنع التكرار قبل التسليم أو تفعيل الخدمة أو إضافة الرصيد.

ملاحظات التكامل

ما يهم قبل الإنتاج

التسوية غير الاحتجازية

تذهب المدفوعات إلى محفظة التاجر التي قمت بتكوينها. يقوم BoltUtil بمراقبة نشاط السلسلة ولا يحتاج إلى الاحتفاظ بأموال المستخدم.

6 شبكات للدفع

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. تدعم TRON عملة USDT فقط. تدعم Ethereum وPolygon وSolana وBase عملة USDC الأصلية؛ وتستخدم BNB Smart Chain إصدار Binance-Peg USDC. إصدار USDT على Base هو Bridged USDT. تعرض صفحة الدفع أزواج الشبكة والرمز المفعلة فقط مع محفظة استلام صالحة للتاجر. تحقق من العقد أو عنوان mint المحدد، وليس رمز العملة وحده.

الأتمتة عبر الويب أولاً

يتلقى نظامك رد اتصال موقعًا عند اكتشاف معاملة وتأكيدها على السلسلة.

HMAC-SHA256 · Signed payment notification
X-Bolt-Webhook-Timestamp: <timestamp>
X-Bolt-Webhook-Signature: <hex signature>

signed_content = timestamp + "." + raw_body
expected = HMAC_SHA256(signed_content, webhook_secret)

Verify timestamp + constant-time signature comparison
→ Parse JSON and validate local order / payment
→ Persist notification and process once
→ Return 2xx after durable acceptance

أمثلة للتكامل واستكشاف الأخطاء فقط. لا تُرسل طلبات. راجع بيانات الطلب وإعدادات الشبكة ووثائق API.

اقرأ مستندات API

يجب أن تكون معالجات Webhook غير فعالة

يمكن إعادة محاولة إشعار الدفع، أو إعادة إرساله يدويًا، أو استلامه بعد استعادة الخادم الخاص بك، لذلك يجب أن يتم التنفيذ مرة واحدة فقط لكل معرف طلب خارجي.

يجب أن يستخدم التحقق من التوقيع النص الخام

لا يجوز تحليل JSON إلا بعد حساب HMAC على نص الطلب الدقيق، وإلا فإن تغييرات التنسيق يمكن أن تؤدي إلى تعطيل عملية التحقق.

الاستجابة 2xx تعني أن خادمك قد قبل الحدث

لا تُرجع حالة HTTP ناجحة إلا بعد أن يقوم نظامك بتسجيل الحدث بأمان أو وضع المعالجة الداخلية الموثوقة في قائمة الانتظار.

تكامل الدفع

الأسئلة التي يطرحها التجار قبل بدء البث المباشر

هل يحتفظ BoltUtil بأموال التاجر؟

لا. تصل الأموال مباشرة إلى محفظة التاجر، بينما يراقب BoltUtil التحويلات ويرسل الإشعارات.

كيف تتم مطابقة دفعة USDT / USDC؟

يتحقق النظام من الشبكة والرمز والعنوان والمبلغ الدقيق وحالة الطلب ومدة صلاحيته.

ما الشبكات التي تدعم USDT وUSDC؟

تدعم TRON عملة USDT فقط. تستخدم Ethereum وBNB Smart Chain وPolygon وSolana وBase نسخ USDT / USDC المحددة. يعتمد التوافر على القنوات المفعلة ومحافظ التاجر.

ما الشبكات وإصدارات الرموز المدعومة؟

TRON, Ethereum, BNB Smart Chain, Polygon PoS, Solana, Base. تدعم TRON عملة USDT فقط. تدعم Ethereum وPolygon وSolana وBase عملة USDC الأصلية؛ وتستخدم BNB Smart Chain إصدار Binance-Peg USDC. إصدار USDT على Base هو Bridged USDT. تعرض صفحة الدفع أزواج الشبكة والرمز المفعلة فقط مع محفظة استلام صالحة للتاجر. تحقق من العقد أو عنوان mint المحدد، وليس رمز العملة وحده.

ابدأ تدفق دفعات USDT / USDC أكثر نظافة

يمكنك إنشاء الطلبات ومراقبة عمليات النقل وإخطار الواجهة الخلفية لديك دون مطالبة العملاء بإرسال لقطات شاشة.