SDK جافاسكريبت للدفع بالكريبتو: ما هو مخطط وما الذي يعمل اليوم

سيفتح SDK جافاسكريبت للدفع بالكريبتو نافذة دفع بعدة أسطر من الكود على موقعك. وSDK Qvard منخفض الكود ضمن خارطة الطريق ولم يُطلق بعد. يشرح هذا الدليل الفكرة ويعرض تدفق v1 الفعلي الذي يمكنك استخدامه الآن.

ماذا يفعل SDK الدفع

SDK الدفع مكتبة جافاسكريبت صغيرة يحمّلها الموقع لبدء الدفعة. يرسم نافذة الدفع، ويقود العميل عبر الخطوات، ويعيد الحالة إلى الصفحة. يبقى منطق الطلب على خادم التاجر.

الحالة: الـSDK ضمن خارطة الطريق

لم يُطلق SDK Qvard منخفض الكود بعد، ولا يصفه هذا المقال بأنه مكتبة جاهزة. المقطع أدناه معاينة للاستدعاء المخطط، وليس كودًا يمكن تشغيله اليوم.

ما يعمل اليوم

أنشئ الدفعة على خادمك بـPOST /api/v1/payment مع ترويسة x-api-key، ووجّه العميل إلى redirectUrl المرتجع في صفحة الدفع المستضافة، واستلم الحالة النهائية عبر webhook. وهذا مكافئ وظيفيًا لاستدعاء الـSDK المخطط.

POST/api/v1/payment

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
}

الاستدعاء من الخادم

أرسل معرّف الطلب في id والسعر بالدولار في price. احتفظ بمفتاح API على الخادم؛ ولا يستلم المتصفح إلا الـredirectUrl الذي يعيده الخادم.

JSroadmap: not released yet

// ROADMAP preview: the SDK is not released yet.
QvardCheckout.open({ amount: 149.99, currency: "USD", orderId: "order_1024" });

استدعاء الـSDK المخطط

من المتوقع أن يفتح الـSDK الوارد في خارطة الطريق التدفق نفسه من الصفحة باستدعاء واحد. قد يتغير اسم الطريقة وخياراتها قبل الإصدار، لذا لا تبنِ على المعاينة الآن.

كيف تستعد

احتفظ بإنشاء الدفعة في دالة واحدة في الخلفية، وافصل معالج الـwebhook. عند صدور الـSDK يتغير استدعاء الواجهة الأمامية وحده، أما استدعاء الخادم والـwebhook فيبقيان كما هما.

FAQ

هل يوجد اليوم SDK جافاسكريبت للدفع من Qvard؟

لا. الـSDK منخفض الكود ضمن خارطة الطريق. اليوم تحصل على النتيجة نفسها عبر API وصفحة الدفع المستضافة وwebhook.

هل يمكنني استخدام استدعاء QvardCheckout.open() الآن؟

لا. يُعرض فقط كمعاينة لواجهة مخططة. استخدم POST /api/v1/payment ووجّه إلى redirectUrl.

هل أحتاج إلى مكتبة جافاسكريبت لقبول الكريبتو اليوم؟

لا. يكفي زر عادي يستدعي خلفيتك ويوجّه إلى redirectUrl، ويؤكد الـwebhook الدفع.

كيف أختبر التدفق؟

أنشئ فاتورة تجريبية وتأكد من أن الـwebhook يستقبل الحالة النهائية.

SDK جافاسكريبت للدفع بالكريبتو: مخطط ويعمل اليوم

ماذا يفعل SDK الدفع

الحالة: الـSDK ضمن خارطة الطريق

ما يعمل اليوم

الاستدعاء من الخادم

استدعاء الـSDK المخطط

كيف تستعد

FAQ

مقالات ذات صلة

زر الدفع بالكريبتو: كيف تضيف زر ادفع بالكريبتو إلى موقعك

المدفوعات بالكريبتو منخفضة الكود: ما معناها وما الذي يعمل اليوم

نافذة الدفع المنبثقة بالكريبتو: كيف تعمل وما المخطط لها