قبول الكريبتو دون تحويل: نافذة الدفع المدمجة من Qvard
قبل الكريبتو دون تحويل باستخدام نافذة الدفع المدمجة من Qvard. عنصر JavaScript في صفحتك، طريقتان لإنشاء الدفعات والتحقق من توقيع الويبهوك. لماذا يهم وكيف يعمل.
قبول الكريبتو دون تحويل يعني أن يدفع العميل دون مغادرة صفحتك. نافذة الدفع المدمجة من Qvard تفعل ذلك بالضبط: أضفِ سكريبت من qvard.com/checkout.js، أنشِ دفعات عبر API أو المتصفح وتعامل مع توقيع الويبهوك. هذا الدليل يوضح كيفية القيام به.
لماذا يكلّف التحويل تحويلات مفقودة
كل تحويل لحظة قد يتراجع فيها العميل. يغادر المتجر، ويرى صفحة غير مألوفة، ويضطر إلى الثقة بموقع جديد. إبقاء الدفع في صفحتك يقلل هذا الاحتكاك ويساعد العميل على إتمام الطلب.
كيف يعمل في Qvard
نافذة الدفع المدمجة من Qvard حية وجاهزة للاستخدام. أضفِ السكريبت https://qvard.com/checkout.js إلى صفحتك، أنشِ دفعة من خادمك أو مباشرة من المتصفح وافتح النافذة. نافذة الدفع هي صفحة Qvard في iframe أو منفثقة: يرى العميل لغته، يختار أصل وشبكة ويدفع. زُر صفحة العرض التوضيحي لترى كيف تعمل.
طريقتان لإنشاء الدفعة
من الخادم (آمن): POST /api/v1/payment مع مفتاحك السري qvard_sk_... في رأس x-api-key؛ تستقبل id وredirectUrl. من المتصفح (سريع): مرِّ مفتاحك العام qvard_pk_... للنافذة واترك العميل يدفع من الصفحة—يرسل متصفحه المبلغ، تحقّق منه في الويبهوك. إذا فضّلت عدم الدمج وجّه إلى redirectUrl في الصفحة المستضافة؛ هذا التدفق أيضاً يعمل.
X-Qvard-Signature: t=1760950000,v1=…
{ "id": "order_1024", "status": "paid" }قلّل الاحتكاك حول التحويل
أنشئ الدفعة فقط عندما يضغط العميل على الدفع، لا قبل ذلك. اعرض الإجمالي والعملة قبل التحويل حتى يعرف العميل ما سيراه في الصفحة التالية. يجب أن يبقى معرّف الطلب والإجمالي كما هما من السلة حتى الدفع.
تحقّق من توقيع الويبهوك
كل ويبهوك يحمل رأس X-Qvard-Signature: وقِّع متن الطلب بمفتاحك السري باستخدام HMAC-SHA256، الصيغة t=<الطابع الزمني>,v1=<hex>. تحقّق من التوقيع، تأكّد أن الطابع الزمني طازج (ارفض الطلبات القديمة) وفقط ثم ضع علامة مدفوع على الطلب إذا أكّد الويبهوك معرّف الدفعة وحالة مدفوع. ثم أرسل التأكيد للعميل.
متى اختر النافذة المدمجة
اختر النافذة المدمجة عندما يفقد مسار البيع لديك عملاء عند التحويل. تبقي النافذة العملاء في صفحتك أثناء الدفع. يختار العميل أصل وشبكة؛ تؤكد النافذة المبالغ والتفاصيل، لذا يعرف بالضبط ما يتوقعه.
FAQ
هل تقبل Qvard الكريبتو دون تحويل اليوم؟
نعم. استخدم نافذة الدفع المدمجة من qvard.com/checkout.js للإبقاء على نافذة الدفع في صفحتك. يدفع العميل دون المغادرة وتتعامل مع الويبهوك لتأكيد الدفع.
هل يخفض التحويل معدل التحويل؟
قد يفعل، لأن العملاء قد يغادرون في الطريق. تحل النافذة المدمجة هذا بالإبقاء على الدفع في صفحتك وعرض لغة العميل والمبالغ النهائية على الفور.
ما الذي أحتاجه لدمج النافذة؟
أضفِ السكريبت https://qvard.com/checkout.js، أنشِ دفعة عبر API أو المتصفح واستمع إلى أحداث onSuccess أو onClose أو onError. يؤكد الويبهوك الدفعة بعد أن يدفع العميل.
هل من الآمن وضع المفتاح العام في المتصفح؟
نعم، المفتاح العام qvard_pk_... مصمم للمتصفح. ضع حدوداً على المواقع التي يمكنها استخدامه في لوحة التحكم. لكن تحقّق دائماً من المبلغ في الويبهوك لأن المبلغ في المتصفح قد يتغير.
