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