دليل التكامل

لماذا قد ينجح خطاف الدفع عبر USDT / USDC فقط عند إعادة المحاولة

عند اكتمال عملية الدفع عبر blockchain بالفعل ولكن لا يتم تحديث تطبيق التاجر إلا بعد محاولة الرد التلقائي على الويب، تكون المشكلة عادةً في توفر نقطة النهاية، أو معالجة التوقيع، أو سلوك المهلة، أو التنفيذ غير الفعال.

ابدأ بقبول USDT / USDCاقرأ مستندات API

الخطوات

عند اكتمال عملية الدفع عبر blockchain بالفعل ولكن لا يتم تحديث تطبيق التاجر إلا بعد محاولة الرد التلقائي على الويب، تكون المشكلة عادةً في توفر نقطة النهاية، أو معالجة التوقيع، أو سلوك المهلة، أو التنفيذ غير الفعال.

لماذا قد ينجح خطاف الدفع عبر USDT / USDC فقط عند إعادة المحاولة

  1. 01

    أنشئ طلب الدفع من الخادم وحدد المبلغ والشبكة ومعرّف الطلب الخارجي.

  2. 02

    اعرض رابط الدفع والشبكة وعنوان الاستلام ورمز QR ومبلغ USDT / USDC الدقيق.

  3. 03

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

  4. 04

    بعد التأكيد، تحقق من توقيع Webhook ونفّذ الطلب بطريقة تمنع التكرار.

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

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

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

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

تصل USDT / USDC مباشرة إلى محفظة التاجر ولا يحتفظ BoltUtil بالأموال أو المفاتيح الخاصة.

ست شبكات للدفع

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

Webhooks موقعة

تساعد توقيعات HMAC والطابع الزمني وسجلات إعادة الإرسال على أتمتة التنفيذ بأمان.

تأكد من أن نقطة النهاية الخاصة بك لا تُرجع استجابة 2xx إلا بعد القبول الدائم.
timestamp + "." + raw_request_body
→ HMAC_SHA256 with webhook secret
→ Verify timestamp / signature
→ Validate order and payment
→ Persist and deduplicate
→ 2xx response

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

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

أنشئ الطلبات على الخادم

لا تكشف مفتاح API في المتصفح واحفظ معرّف الطلب قبل عرض صفحة الدفع.

اعرض الشبكة بوضوح

يجب توضيح TRC20 وERC20 وBEP20 وPolygon أو Solana إلى جانب العنوان.

نفّذ بعد التحقق

رابط العودة ليس دليلاً على الدفع؛ استخدم Webhook موقعاً أو استعلام الحالة من الخادم.

دليل التكامل

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

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

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

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

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

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

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

الموارد ذات الصلة

التحقق من توقيع إشعار الدفع

إعادة إرسال إشعار الدفع المؤكد

لماذا يمكن أن تظل دفعة USDT / USDC معلقة بعد قيام العميل بالدفع

أمثلة تكامل API

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

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

إنشاء حساب مجانياقرأ مستندات API