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