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