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