محطة دفع الكريبتو: ما هي وما الذي يعمل اليوم
شرح محطة دفع الكريبتو: جهاز نقاط بيع لمدفوعات الكريبتو، وما ضمن خارطة طريق Qvard، وما الذي يعمل اليوم عبر API وصفحة الدفع المستضافة. مع أمثلة عملية.
محطة دفع الكريبتو جهاز نقاط بيع يقبل مدفوعات العملات الرقمية عند الكاشير. لدى Qvard محطة ضمن خارطة الطريق ولم تُطلق بعد. يشرح هذا الدليل المفهوم والمسار العامل: خادم الكاشير الذي ينشئ الدفعات عبر API v1 الفعلية.
ماذا تفعل محطة دفع الكريبتو
تعرض محطة دفع الكريبتو المبلغ، وتتيح للعميل الدفع بمحفظته، وتؤكد النتيجة على الشاشة. وهي تحل محل قارئ البطاقات للأعمال التي تريد قبول الكريبتو عند كاونتر فعلي.
الحالة: المحطة ضمن خارطة الطريق
محطة نقاط البيع من Qvard لم تُطلق بعد، ولا يصفها هذا المقال كجهاز جاهز. المسار أدناه متاح اليوم عبر API والصفحة المستضافة وwebhook.
ما يعمل اليوم
ينشئ خادم الكاشير الدفعة بـPOST /api/v1/payment مع ترويسة x-api-key ويستلم redirectUrl. يدفع العميل في الصفحة المستضافة التي يشير إليها 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
}استدعاء من خادم الكاشير
أرسل معرّف عملية البيع في id والإجمالي بالدولار في price. احتفظ بمفتاح API على خادم الكاشير. تعيد الاستجابة redirectUrl الذي يعرضه الكاشير على العميل.
أكّد البيع عبر الـwebhook
يجب أن يضع الكاشير علامة مدفوع على البيع فقط بعد أن يرسل الـwebhook المعرّف والحالة paid. وحتى ذلك الوقت يبقى البيع معلقًا، حتى لو قال العميل إنه دفع.
الاستعداد لمحطة مخصصة
احتفظ بمنطق البيع والـwebhook في برنامج الكاشير. عند إطلاق محطة مخصصة يتغير الجهاز، لكن إنشاء الدفعة ومعالجة الحالة تبقيان كما هما.
FAQ
هل توجد اليوم محطة دفع كريبتو من Qvard؟
ليس بعد. محطة POS ضمن خارطة الطريق. واليوم يستخدم خادم الكاشير API وصفحة الدفع المستضافة وwebhook.
هل يمكنني استخدام برنامج الكاشير الخاص بي؟
نعم. أي برنامج يرسل HTTPS POST ويستقبل webhook يمكنه إنشاء الدفعات عبر API.
ماذا يرى العميل عند الكاشير؟
اليوم يعرض الكاشير الـredirectUrl كرمز QR أو رابط، وتفتح صفحة الدفع على جهاز العميل.
كيف أختبر قبل البيع الفعلي؟
أنشئ فاتورة تجريبية وادفعها في الصفحة المستضافة، وتأكد من أن الـwebhook يضع علامة على البيع.
