تضمين دفع العملات المستقرة في متجرك الإلكتروني
تضمين دفع العملات المستقرة في متجرك: كيفية استخدام الأداة المضمنة، إنشاء الدفع في المتصفح والخادم، والتحقق من الويب هوك.
تضمين دفع العملات المستقرة يعني وضع نافذة دفع بـ USDT أو USDC داخل متجرك الإلكتروني. أداة الدفع المضمنة في Qvard تقبل العملات المستقرة اليوم. عملاؤك يختارون الأصل المشفر والشبكة على صفحة الدفع، وتتحقق أنت من الدفع عبر الويب هوك.
ما هو دفع العملات المستقرة المضمن
دفع العملات المستقرة المضمن هو نافذة دفع تفتح على صفحتك عبر أداة JavaScript. يمكن أن تظهر كنافذة مشروطة (نافذة منبثقة) أو مضمنة في عنصر. يبقى عملاؤك على صفحتك ويدفعون بـ USDT أو USDC دون المغادرة. نافذة الدفع هي نفس صفحة Qvard في iframe: يرى العميل الصفحة بلغته، ويختار أصل العملة المستقرة والشبكة، والمبلغ يُحسب بسعر صرف ثابت لفاتورتك.
كيف يعمل في Qvard
تُحمّل الأداة من https://qvard.com/checkout.js وتفتح نافذة دفع العملات المستقرة كنافذة مشروطة أو مضمنة. تعرض النافذة الأصول والشبكات المتاحة؛ يختار العميل، والمبلغ المراد إرساله يُعرض. تصدر الأداة أحداثًا: onSuccess (تم الدفع)، onClose (أُغلقت النافذة)، onError (فشل الدفع). تتلقى نسخة الأداة مفتاحك العام (qvard_pk_...) لإنشاء من جانب المتصفح، أو معرّف الدفع لإنشاء من جانب الخادم. جرّب على صفحة العرض على qvard.com.
طريقتان لإنشاء الدفع
جانب المتصفح: مرّر المفتاح العام (qvard_pk_...) والمبلغ للأداة؛ تنشئ الدفع وتفتح النافذة. يمكن للعميل تغيير المبلغ في المتصفح، لذا استخدم هذا لأغراض إعلامية. يمكن تقييد مفتاحك العام بالمواقع المسموحة في لوحة التحكم الخاصة بك، والطلبات محدودة السرعة. جانب الخادم: يُنشئ الخادم الخلفي الدفع عبر POST /api/v1/payment ويمرّر معرّف الدفع للأداة. بالنسبة للطلبات ذات المبالغ الثابتة أو الحرجة، استخدم إنشاء جانب الخادم وتحقق دائمًا من المبلغ في ويب هوك الخاص بك. أو تخطَّ الأداة وأعد توجيه العملاء إلى صفحة الدفع المستضافة.
جانب الخادم: أنشئ الدفع أولاً
يرسل خادمك طلب POST إلى /api/v1/payment برقم الطلب والسعر بالدولار الأمريكي، باستخدام رأس x-api-key مع مفتاحك السري (qvard_sk_...). الرد يُعيد { id, redirectUrl }. مرّر المعرّف للأداة في المتصفح، أو استخدم redirectUrl للتحويل. احفظ مفتاحك السري على الخادم فقط؛ لا يجب أن يتم الطلب من المتصفح.
x-api-key: qvard_sk_…
{
"id": "order_1024",
"price": 149.99,
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}تحقق من الدفع من الويب هوك
عندما تكون الحالة مدفوعة، يتلقى ويب هوك الخاص بك { id, status }، موقّعًا برأس X-Qvard-Signature بالصيغة t=...,v1=... (HMAC-SHA256 مع مفتاحك السري). تحقق من التوقيع باستخدام مفتاحك السري (qvard_sk_...) وتأكد من أن المبلغ في ويب هوك يطابق طلبك. المفاتيح القديمة بدون بادئة qvard_sk_ تتلقى أيضًا رأس x-api-key. علّم الطلب كمدفوع فقط بعد التحقق من التوقيع. انظر إرشادات التوقيع في توثيق Qvard.
متى تختار النافذة المضمنة
استخدم الأداة المشروطة المضمنة أو المضمنة للحفاظ على العملاء على صفحتك وتقديم دفع عملات مستقرة سلس. تعمل الصفحة المستضافة مع إعادة التوجيه بنفس الفعالية وهي خيار إذا كنت تفضل عدم تضمين نافذة الدفع. يشترك كلاهما في نفس عملية إنشاء الدفع، وتدفق الويب هوك، والتحقق من التوقيع.
FAQ
هل دفع العملات المستقرة المضمن متاح في Qvard اليوم؟
نعم. حمّل الأداة من https://qvard.com/checkout.js ومرّر مفتاحك العام (qvard_pk_...) لإنشاء جانب المتصفح، أو أنشئ الدفع جانب الخادم ومرّر المعرّف.
كيف يختار العملاء عملة مستقرة وشبكة على الأداة؟
يرى العملاء أصول العملات المستقرة والشبكات المتاحة على صفحة الدفع ويختارون أيها يستخدمون. يُحدّث المبلغ المراد إرساله بناءً على اختيارهم.
لماذا يجب أن أتحقق من المبلغ في ويب هوك؟
المبلغ في ويب هوك هو مصدر الحقيقة من Qvard. تحقق دائمًا من أنه يطابق طلبك، حتى لو أنشأت الدفع جانب الخادم، لأن العميل اختار العملة المستقرة والشبكة.
كيف أختبر قبل الإطلاق؟
استخدم صفحة العرض على qvard.com لاختبار الأداة ورؤية أحداث ويب هوك. تأكد من أن ويب هوك الخاص بك يتحقق من التوقيع ويعلّم الطلب كمدفوع.
