نافذة الدفع المنبثقة بالكريبتو: كيف تعمل وما المخطط لها
شرح نافذة الدفع المنبثقة بالكريبتو: كيف تعمل، وما يخطط له SDK Qvard لها، وما يمكن تشغيله اليوم. مع كود عملي. مع أمثلة كود عملية وخطوات واضحة للمطورين.
نافذة الدفع المنبثقة بالكريبتو هي نافذة دفع تُفتح فوق الصفحة الحالية، فيدفع العميل دون مغادرة الموقع. وهي مخططة ضمن SDK Qvard ولم تُطلق بعد. يشرح هذا الدليل كيف تعمل هذه النافذة وما الذي يمكنك تشغيله اليوم عبر API.
كيف تعمل نافذة الدفع
تستدعي الصفحة دالة، فتُفتح نافذة فوق المحتوى، ويكمل العميل الدفع داخلها، ثم تُغلق النافذة. يبقى المتجر في الخلفية، ويُؤكَّد الطلب على الخادم.
الحالة: النافذة ضمن خارطة الطريق
نافذة الدفع المنبثقة من Qvard لم تُطلق بعد، ولا يصفها هذا المقال كميزة مكتملة. الكود في الوسائط معاينة للاستدعاء المخطط.
ما يعمل اليوم
أنشئ الدفعة بـPOST /api/v1/payment مع ترويسة x-api-key، ثم وجّه العميل إلى redirectUrl في صفحة الدفع المستضافة، واستلم الحالة النهائية عبر webhook. بهذا يحصل العميل على نتيجة الدفع نفسها دون نافذة منبثقة.
x-api-key: sk_live_…
{
"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
}فتح نافذة جديدة بحذر
إن فضّلت نافذة منفصلة فافتح redirectUrl في تبويب جديد بعد نقرة فقط. تحجب المتصفحات النوافذ التي تُفتح دون فعل من المستخدم، لذلك يجب أن تأتي النقرة أولًا.
أكّد الدفع على الخادم
ستعرض النافذة، عند صدورها، التقدم داخل الصفحة، لكن حالة الدفع يجب أن تستمر في القدوم من الـwebhook. ابنِ منطق الطلب حول الـwebhook الآن.
// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });ما يجب تجنبه
لا تعتبر النافذة المغلقة دفعة فاشلة، ولا تضع علامة مدفوع على الطلب عند إغلاقها. انتظر نتيجة الـwebhook.
FAQ
هل توجد اليوم نافذة دفع منبثقة من Qvard؟
ليس بعد. النافذة مخططة ضمن الـSDK في خارطة الطريق. واليوم تكفي صفحة الدفع المستضافة أو تبويب جديد.
هل يمكن أن تُفتح النافذة دون نقرة؟
تحجبها المتصفحات عادة. افتح صفحة الدفع بعد نقرة من المستخدم.
ماذا لو أغلق العميل النافذة؟
لا تحسم النتيجة من حدث الإغلاق. تحقق من حالة الطلب عبر الـwebhook.
كيف أختبر التدفق؟
أنشئ فاتورة تجريبية وتحقق من نتيجة الـwebhook.
