دليل التكامل

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

عندما يقول العميل أنه دفع ولكن الطلب لا يزال معلقًا، فأنت بحاجة إلى طريقة قابلة للتكرار لمقارنة حقائق blockchain مع حقائق الطلب. يشرح هذا الدليل الشيكات التي يجب على التجار تشغيلها عبر TRC20 وERC20 وBEP20 وPolygon وSolana.

الخطوات

عندما يقول العميل أنه دفع ولكن الطلب لا يزال معلقًا، فأنت بحاجة إلى طريقة قابلة للتكرار لمقارنة حقائق blockchain مع حقائق الطلب. يشرح هذا الدليل الشيكات التي يجب على التجار تشغيلها عبر TRC20 وERC20 وBEP20 وPolygon وSolana.

كيفية التحقق من دفع 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 والطابع الزمني وسجلات إعادة الإرسال على أتمتة التنفيذ بأمان.

تحقق من أن حالة المعاملة ناجحة وتحتوي على حدث نقل USDT / USDC.
Network matches the order
Configured token contract / mint matches
Destination matches the order wallet
Full payable amount matches
Payment time and order window checked
Required confirmations reached
Transaction association and fulfillment checked

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

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

ما الذي ينبغي التحقق منه بعد ذلك؟

احتفظ برقم الطلب الأصلي ومعرّف المعاملة. نجاح التحويل وتأكيد الدفع وتسليم Webhook حالات منفصلة.

إذا كانت A = 1.000 وB = 1.010 وC = 1.020 فإن دفع 1.020 يطابق C فقط عند استيفاء الشروط الأخرى. لا توجد مطابقة دقيقة للمبلغ 1.030.

مثال توضيحي فقط. لا يُقبل الفرق تلقائيًا؛ تحقق من القواعد والمهلة والطلب المرتبط. يمكن للحساب المجاني عرض سجلاته؛ قبول الربط أو رفضه يتطلب عضوية Pro سارية.

تطابق المبلغ بالكامل
قارن المبلغ الكامل والشبكة والرمز والمحفظة وفترة الدفع. التطابق الدقيق المستوفي للشروط له الأولوية على مرشحي مراجعة الفرق.
دفع ناقص أو زائد
قد ينشئ التحويل اليدوي المؤهل سجل مراجعة. تحقق من حدود الفرق والطلب المرتبط؛ لا تختَر الطلب الأقرب في المبلغ فقط.
الدفع قيد التأكيد
تعني PAID تسجيل الدفع مع استمرار التأكيد. تحقق من تأكيدات الشبكة وتقدم الفحص دون طلب الدفع مجددًا.
الدفع مؤكد والمتجر لم يتحدث
راجع تسليم Webhook واستجابة HTTP وتوقيع النص الخام وحفظ الطلب. أصلح جهة الاستقبال وأعد الإرسال وفق صلاحياتك ونفّذ التسليم مرة واحدة.
شبكة أو رمز مختلف
تحقق من الشبكة الفعلية والعقد أو عنوان Mint. تشابه الاسم أو تنسيق العنوان لا يجعل التحويل على مسار آخر دفعًا لهذا الطلب.

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

لا تكشف مفتاح 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 أكثر نظافة

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