دليل التكامل السريع

قم بتوصيل مدفوعات العملات المستقرة (USDT / USDC) في أربع خطوات. قم بتكوين مفتاح API وسر Webhook واستلام المحافظ للشبكات الممكّنة أولاً. المثال الموجود على اليمين يتحقق من مفتاح API الخاص بك.

1

إنشاء أمر دفع

الواجهة الخلفية

اتصل بـ /api/v1/order/create من الواجهة الخلفية لديك وأخبره بالسعر والعملة والشبكة وطلب التاجر ID. يحتوي الرد على محفظتك التي تم تكوينها والمبلغ النهائي المستحق الدفع؛ قد تشترك أوامر متعددة في نفس المحفظة.

GET /api/v1/ping يتحقق من مفتاح API الخاص بك. يتطلب إنشاء الطلب أيضًا timestamp وتوقيع الطلب.
2

عرض تفاصيل الدفع

الواجهة الأمامية

افتح checkoutUrl من الاستجابة، أو اعرض المبلغ والعنوان والشبكة والعملة من كائن payment. تصل الأموال مباشرة إلى محفظة الاستلام المهيأة.

استخدم payment.amount الكامل. يحتوي payment.qrData على QR data، وليس صورة.
3

انتظر تأكيد الدفع

BoltUtil

يطابق BoltUtil التحويلات حسب الشبكة والعملة والمحفظة والمبلغ، ثم يرسل إشعارًا إلى notifyUrl المرتبط عند استيفاء متطلبات التأكيد. تتطلب استثناءات الدفع المؤهلة مراجعة التاجر.

يعتمد التأكيد والتسليم على ظروف blockchain والشبكة. إعادة توجيه الصفحة لا تثبت الدفع.
4

التحقق والوفاء

الواجهة الخلفية

تحقق من توقيع نص الطلب الأصلي ومن الطابع الزمني، واربط الحدث بطلبك. راجع المبلغ المستحق والمبلغ المدفوع ونوع التسوية. أعد HTTP 2xx بعد حفظ الحدث بشكل دائم، ونفّذ العملية التجارية دون تكرارها للطلب نفسه.

استخدم eventId لاكتشاف الأحداث المكررة، ولا تسلّم الطلب التجاري أكثر من مرة. قد يكون المبلغ المدفوع أقل من المستحق عند قبول دفعة ناقصة يدويًا.

الشبكات والعملات

تحقق من العملات المدعومة وإصدارات الرموز المميزة وقواعد تأكيد الدفع.

عرض الشبكات المدعومة →