دليل الربط السريع

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

1

بدء النظام الخلفي: إنشاء الطلب

Backend

قم باستدعاء نقطة النهاية /api/v1/orders/create. تقوم بوابتنا بربط عنوان المستلم المهيأ مسبقاً بمعاملة محددة.

نصيحة أمنية: تأكد من تضمين X-Bolt-Key والتوقيع الرقمي في رأس HTTP (Header).
2

توجيه الواجهة الأمامية: واجهة الدفع

Frontend

استخدم رابط checkoutUrl من الاستجابة لإعادة توجيه المستخدمين إلى صفحة الدفع المبسطة الخاصة بنا، أو قم بعرض رمز QR مباشرة. سيقوم المستخدمون بتحويل الأموال من محافظهم الشخصية مباشرة إلى عنوانك الحصري.

متوافق تماماً مع شبكة TRON (TRC20) والمحافظ الرئيسية مع دعم أصلي لاستدعاء التطبيقات (App-invocation).
3

دفع النظام: استقبال التنبيهات

Webhook

تقوم مجموعات العقد لدينا بمراقبة سجل سلسلة الكتل (Blockchain Ledger) في الوقت الفعلي. بمجرد اكتشاف تأكيد المعاملة، يرسل النظام فوراً طلب POST إلى notifyUrl الخاص بك مع تفاصيل الدفع الكاملة، بما في ذلك هاش المعاملة (txHash).

للتعامل مع تقلبات الشبكة، تأكد من أن نقطة النهاية الخاصة بك تدعم خاصية التأثير الثابت (Idempotency) لمعالجة التنبيهات المكررة المحتملة بأمان.
4

تنفيذ العمل: التحقق والإتمام

Backend

عند استلام الويب هوك، تحقق من مصدر البيانات باستخدام خوارزمية التوقيع الخاصة بنا. بمجرد مطابقة مبلغ التنبيه مع الطلب، قم بتحديث حالة النظام وإتمام عملية التسليم للمستخدم.

مبدأ الثقة المعدومة (Zero Trust): لا تقم أبداً بتنفيذ طلب دون التحقق بنجاح من توقيع HMAC ومطابقة المبلغ.