ودجت الدفع بالكريبتو: كيف تضيفه إلى موقعك
دليل ودجت الدفع بالكريبتو: ادمج الدفع المدمج من Qvard في موقعك. إنشاء الدفع على الخادم والمتصفح، التحقق من توقيع webhook، تجربة حية.
ودجت الدفع بالكريبتو هو widget JavaScript يفتح نافذة دفع على موقعك. ودجت Qvard الآن نشط على https://qvard.com/checkout.js. يشرح هذا الدليل كيفية عمله وكيفية دمجه.
ما هو ودجت الدفع بالكريبتو
الودجت عنصر دفع مدمج يضعه الموقع لبدء الدفع. في Qvard، يفتح الودجت نفس صفحة الدفع التي يراها عملاؤك في شكل modal أو نموذج مدمج. يختار العميل الأصل والشبكة؛ المبلغ يحدده طلبك.
كيفية عمله في Qvard
يُحمّل الودجت من https://qvard.com/checkout.js ويفتح نافذة الدفع بوضع modal (نافذة منبثقة) أو مدمج. النافذة هي نفس صفحة الدفع في Qvard: يختار العميل الأصل والشبكة بسعر صرف ثابت مدة الفاتورة. تستقبل نسخة الودجت مفتاحك العام (qvard_pk_…) لإنشاء الدفع في المتصفح، أو معرّف الدفع لإنشاء الدفع على الخادم. جرّب مباشرة على صفحة التجربة.
<script src="https://qvard.com/checkout.js"></script>
new QvardCheckout({
mode: 'modal',
publishableKey: 'qvard_pk_…',
price: 10,
onSuccess: function (e) {
console.log('paid', e.paymentId);
}
}).open();طريقتان لإنشاء الدفع
في المتصفح: مرّر المفتاح العام (qvard_pk_…) والمبلغ إلى الودجت؛ ينشئ الدفع ويفتح النافذة. على الخادم: ينشئ backend الخاص بك الدفع عبر POST /api/v1/payment ويمرّر معرّف الدفع إلى الودجت. للطلبات بسعر ثابت أو حدود مخزون، استخدم الإنشاء على الخادم حتى لا يتمكن العميل من تغيير السعر في المتصفح. بدلًا من ذلك، تخطّ الودجت وأعد توجيه العملاء إلى صفحة الدفع المستضافة.
الاستدعاء من الخلفية
يرسل خادمك معرّف الطلب في id والسعر بالدولار في price مع ترويسة x-api-key. تعيد الاستجابة معرّف الدفعة و redirectUrl. مرّر معرّف الدفع إلى الودجت في المتصفح، أو استخدم redirectUrl لإعادة توجيه. لا تُرسل أبدًا المفتاح السري (qvard_sk_…) إلى المتصفح.
تحقق من الدفع من webhook
عندما تكون الحالة paid يستقبل endpoint الـ webhook الخاص بك المعرّف والحالة، موقّعة برويسة X-Qvard-Signature (HMAC-SHA256). تحقق من التوقيع باستخدام مفتاحك السري (qvard_sk_…) وتأكد من تطابق المبلغ مع طلبك. ضع علامة على الطلب كمدفوع فقط بعد التحقق من التوقيع. ملاحظة: حدث onSuccess للودجت ليس إثباتًا للدفع.
متى تختار النافذة المدمجة
استخدم modal مدمج أو نموذج مدمج للاحتفاظ بالعملاء على صفحتك. صفحة الدفع المستضافة بإعادة توجيه تعمل بشكل متساوٍ وهي خيار إذا فضّلت عدم دمج نافذة الدفع. يشترك كلا النهجين في نفس API و webhook.
FAQ
هل ودجت الدفع بالكريبتو من Qvard متاح اليوم?
نعم. حمّل الودجت من https://qvard.com/checkout.js ومرّر مفتاحك العام (qvard_pk_…) لإنشاء الدفع في المتصفح، أو أنشئ الدفع على الخادم ومرّر معرّفه.
كيف أضيف الودجت إلى موقعي?
أضف وسم <script src="https://qvard.com/checkout.js"></script> وأنشئ نسخة QvardCheckout بمفتاحك والمبلغ والوضع (modal أو مدمج). انظر إلى أمثلة الأكواد في هذا المقال والتجربة الحية.
هل يحتفظ الودجت بالعميل على موقعي?
نعم، بأوضاع modal أو المدمجة. إعادة التوجيه إلى الصفحة المستضافة تأخذ العميل إلى موقع آخر، لكنه يعود عبر رابط بعد اكتمال الدفع.
كيف أختبر التدفق?
أنشئ دفعة تجريبية وتأكد من أن معالج الـwebhook يستقبل التوقيع والمبلغ يتطابق، قبل الإطلاق.
