الدفع المشفر المدمج مقابل إعادة التوجيه: التحويلات والمقايضات
الدفع المشفر المدمج مقابل إعادة التوجيه: كيف يؤثر كل نموذج على التحويل والتحكم والجهد. عنصر Qvard مباشر الآن. قارن واختر.
يبقى الدفع المشفر المدمج داخل صفحتك، بينما تحويل العميل إلى صفحة مستضافة. لكل نموذج مقايضات في التحويل والتحكم والجهد. عنصر Qvard المدمج مباشر الآن، لذلك يقارن هذا الدليل النموذجين ويوضح كيفية الاختيار.
ما يعنيه الدفع المدمج
الدفع المدمج هو نافذة دفع تفتح مباشرة على صفحتك عبر عنصر JavaScript. يمكن أن تكون نافذة بصرية أو نموذج مدمج. يبقى العميل في سياق موقعك ويدفع دون المغادرة. منطق الدفع مماثل لصفحة مستضافة؛ العرض فقط مختلف.
كيفية عمله في Qvard
يُحمّل العنصر من https://qvard.com/checkout.js ويفتح نافذة دفع بصيغة بصرية أو مدمجة. النافذة هي نفس صفحة الدفع في Qvard: يختار العميل الأصل والشبكة، والمبلغ محدد بطلبك. تستقبل نسخة العنصر مفتاحك العام (qvard_pk_...) لإنشاء الدفع بالمتصفح، أو معرّف الدفع لإنشاؤه بالخادم. اكتشف منصة اللعب على https://qvard.com/en/embedded-checkout/playground/.
طريقتان لإنشاء الدفع
جانب المتصفح: مرر المفتاح العام (qvard_pk_...) والمبلغ للعنصر؛ ينشئ الدفع ويفتح النافذة. جانب الخادم: ينشئ النظام الخلفي الخاص بك الدفع عبر POST /api/v1/payment ويمرر معرّف الدفع للعنصر. للطلبات برسم ثابت أو حدود المخزون، استخدم الإنشاء من الخادم حتى لا يغير العميل السعر في المتصفح. أو تخط العنصر وأعد توجيه العملاء إلى صفحة الدفع المستضافة.
<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();من الخادم: أنشئ الدفع أولًا
يرسل خادمك معرّف الطلب والسعر بالدولار مع ترويسة x-api-key. تعيد الاستجابة معرّف الدفع و 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
}تحقق من الدفع من webhook
عندما يصبح الحالة paid، يستقبل نقطة webhook الخاصة بك المعرّف والحالة، موقّعة برويسة X-Qvard-Signature (HMAC-SHA256). تحقق من التوقيع بمفتاحك السري (qvard_sk_...) والتأكد من تطابق المبلغ. علّم الطلب كمدفوع فقط بعد التحقق من التوقيع.
متى اختر النافذة المدمجة
استخدم عنصر بصري أو مدمج لإبقاء العملاء على صفحتك. تعمل الصفحة المستضافة بإعادة توجيه بنفس الطريقة وهي خيار إذا كنت تفضل عدم دمج نافذة الدفع. يستخدم كلا النهجين نفس تدفق إنشاء الدفع والـ webhook.
FAQ
هل الدفع المشفر المدمج متاح في Qvard اليوم؟
نعم. حمّل العنصر من https://qvard.com/checkout.js ومرّر مفتاحك العام (qvard_pk_...) للإنشاء بالمتصفح، أو أنشئ الدفع من الخادم ومرّر المعرّف.
كيف أضيف العنصر إلى موقعي؟
أدرج الوسم <script src="https://qvard.com/checkout.js"></script> وابدأ QvardCheckout بمفتاحك والمبلغ والوضع (بصري أو مدمج). اطّلع على أمثلة الكود في هذه المقالة والعرض التوضيحي.
هل توقيع الدفع مهم؟
نعم. تحقق دائمًا من ترويسة X-Qvard-Signature في webhook بمفتاحك السري، والتأكد من تطابق المبلغ.
هل يمكنني استخدام إعادة التوجيه بدلاً من النافذة المدمجة؟
نعم. صفحة الدفع المستضافة بـ redirectUrl تعمل بنفس الطريقة ولا تحتاج عنصرًا. يستخدم كلا النهجين نفس API والـ webhook.
