اربط جهاز الكاشير ببرنامج الولاء
يعمل BonusQR بمفرده باستخدام ماسح على الهاتف. وإن أردت أن يتولى جهاز الكاشير أيضًا مهام الولاء، يمكن لمورّد نظام نقاط البيع ربطه عبر واجهة REST API الموثّقة لدينا – فيمسح الكاشير رمز العميل ويطبّق الخصم ويستبدل المكافآت في خطوة واحدة.
- واجهة REST API موثّقة
- خصومات ومكافآت عند الكاشير
- اختياري – يعمل BonusQR من دونه

تم مسح بطاقة الولاء – طُبّق خصم 10%
ما هو ربط برنامج الولاء بنظام نقاط البيع؟
يتيح ربط برنامج الولاء بنظام نقاط البيع لجهاز الكاشير التواصل مع برنامج الولاء. فبدلًا من المسح في تطبيق منفصل، يمسح الموظفون رمز QR الخاص بولاء العميل عند الكاشير، ويطبّق الجهاز ما يمنحه البرنامج.
يوفّر BonusQR لهذا الغرض واجهة REST API. يرسل الكاشير الرمز الممسوح، ومبلغ الفاتورة عند الحاجة، فيردّ BonusQR بما يجب فعله – تطبيق خصم بنسبة مئوية أو بمبلغ، أو استبدال قسيمة أو مكافأة نقاط – مع رسائل جاهزة للموظفين.
الربط اختياري، ويُنفَّذ كمشروع مخصص مع مورّد نظام نقاط البيع لديك. ويُصدر BonusQR مفاتيح API، ويُسعَّر الربط بشكل منفصل.
ما يحصل عليه جهاز الكاشير من مسح واحد
لمحة من توثيق API التفاعلي الذي يستخدمه مورّد نظام نقاط البيع لربط جهاز الكاشير لديك.
- 1
التعرّف على العميل
يمسح الكاشير رمز QR للولاء ويحصل على اسم العميل ورقم زيارته وأرصدته.
- 2
تطبيق الخصومات
تعود الخصومات بالنسبة المئوية أو بالمبلغ في صورة إجراءات يطبّقها الكاشير على الفاتورة.
- 3
استبدال المكافآت
تُستبدل القسائم ومكافآت النقاط والدفع برصيد الاسترداد النقدي مباشرةً عند الكاشير.
- 4
رسائل للموظفين
كل ردّ يتضمن رسائل جاهزة للموظفين بلغة نشاطك التجاري.
/api/pos/configإعداد برنامج الولاء لجهاز الكاشير/api/pos/scanمسح رمز عند الكاشير{ "code": "12345", "bill_amount": 12.50 }Responses{
"status": "completed",
"kind": "customer",
"customer": { 1
"name": "مريم خالد",
"visit_number": 12,
"loyalty": { "credit": 13.55 }
},
"actions": [{ 2
"type": "apply_percent_discount",
"percent": 10,
"reason": "أعضاء نادي الولاء"
}],
"messages": [{ 4
"level": "warning",
"title": "خصم 10%",
"lines": ["اخصمه من الفاتورة."]
}],
"rewards_earned": []
}/api/pos/scan/{scan_id}إرسال مبلغ الفاتورة أو عدد المنتجات/api/pos/scan/{scan_id}/cancelإلغاء مسح معلّقيحصل مورّد نظام نقاط البيع لديك على توثيق API تفاعلي وكاشير تجريبي ليجرّب الربط عليه.
كيف يعمل الربط
هكذا تتم عملية شراء واحدة مع جهاز كاشير مرتبط.
- العميلالكاشيريعرض رمز QR الخاص بالولاء
- الكاشيرBonusQRيرسل الرمز الممسوح
POST /api/pos/scan - BonusQRالكاشيريطلب مبلغ الفاتورة عند الحاجة
input_required - الكاشيرBonusQRيردّ بالمبلغ الذي يدفعه العميل
POST /api/pos/scan/{scan_id} - BonusQRالكاشيريعيد الخصم والمكافآت ورسائل الموظفين
completed - الكاشيريطبّق الخصم ويُتمّ البيع
- BonusQRالعميليرى الأختام والنقاط والمكافآت في التطبيق
صُمّم الربط بحيث لا يؤخّر برنامج الولاء أي عملية دفع: إذا لم يستجب BonusQR، تستمر عملية البيع.
من دون الربط، يمسح الموظفون ببساطة بهاتف أو جهاز لوحي – فـBonusQR يعمل بالكامل بمفرده.
يعمل مع كل برامج الولاء
تفهم واجهة API كل البرامج في عرضك. على سبيل المثال:
تظهر المكافآت المكتسبة عند الكاشير في تطبيق العميل لزيارته التالية.
بطاقة الأختام – يرسل الكاشير عدد المنتجات
خصم ثابت – نسبة مئوية من الفاتورة
استرداد نقدي – الرصيد يدفع الفاتورة كخصم بمبلغ
قسيمة مكافأة – تُستبدل عند الدفع
النقاط – مكافأة من الكتالوج تُستبدل عند الكاشير
مكافأة على الإنفاق – تُحتسب الفاتورة نحو القسيمة التالية
REST APIمصمَّم لعملية دفع حقيقية
يمسح الكاشير وقت الدفع. وإذا احتاج BonusQR إلى المزيد – مبلغ الفاتورة أو عدد المنتجات – فإنه يطلبه ويجيب الكاشير. ويمكن إلغاء المسح المعلّق، ولا تتوقف عملية البيع أبدًا.
- حالات واضحة: مكتمل، يتطلب إدخالًا، فشل
- يمكن إلغاء عمليات المسح المعلّقة
- المبالغ بعملة نشاطك التجاري
- حتى 60 طلبًا في الدقيقة لكل مفتاح
الربط مع نقاط البيع مقابل ماسح BonusQR
كلاهما يعمل. اختر ما يناسب نقطة الدفع لديك.
التكامل مع نقاط البيع (POS)
- الإعداد
- مشروع مخصص مع مورّد نظام نقاط البيع
- أين يمسح الموظفون
- عند الكاشير
- الخصومات
- يطبّقها الكاشير تلقائيًا
- السعر
- يُحدَّد بشكل منفصل
ماسح BonusQR
- الإعداد
- جاهز خلال دقائق
- أين يمسح الموظفون
- على هاتف أو جهاز لوحي أو ماسح على المنضدة
- الخصومات
- تُعرض للموظفين ليطبّقوها
- السعر
- مشمول في كل الخطط
أسئلة حول الربط مع نقاط البيع
أكثر ما يسأل عنه أصحاب الأنشطة ومورّدو أنظمة نقاط البيع.
هل أحتاج إلى الربط مع نقاط البيع لاستخدام BonusQR؟
لا. يعمل BonusQR بالكامل بمفرده – يمسح الموظفون رموز العملاء بهاتف أو جهاز لوحي أو ماسح على المنضدة. والربط اختياري.
ما أنظمة نقاط البيع التي يمكن ربطها؟
أي نظام يستطيع مورّده استدعاء واجهة REST API. لا تتوفر لدى BonusQR إضافات جاهزة لأجهزة كاشير بعينها، إذ يُجري المورّد الربط باستخدام التوثيق لدينا.
كم تبلغ تكلفة الربط؟
إنه مشروع مخصص، لذا يُسعَّر بشكل منفصل. راسلنا وسنُعدّ عرضًا بالتعاون مع مورّد نظام نقاط البيع لديك.
كيف نحصل على مفاتيح API؟
يُصدرها BonusQR عند الطلب. ويمكن قصر المفتاح على فرع واحد من فروع نشاطك التجاري.
ماذا يتلقى الكاشير بعد المسح؟
اسم العميل ورقم زيارته وأرصدته، والإجراءات المطلوب تطبيقها – خصم بنسبة مئوية أو بمبلغ، أو قسيمة، أو مكافأة نقاط – والمكافآت المكتسبة، ورسائل جاهزة للموظفين.
ماذا لو احتاج الكاشير إلى معلومات إضافية؟
يطلبها BonusQR – مثل مبلغ الفاتورة أو عدد المنتجات – ويجيب الكاشير. ويمكن أيضًا إلغاء المسح المعلّق.
هل يتوفر توثيق؟
نعم. يتوفر توثيق API تفاعلي، مع كاشير تجريبي يمكن لمورّدك استخدامه للاختبار.
وماذا عن المتاجر الإلكترونية؟
تتوفر لـWooCommerce وShopify عمليات تكامل جاهزة ضمن خطة Basic.
هل تريد الولاء مباشرةً عند الكاشير؟
أخبرنا بنظام نقاط البيع الذي تستخدمه، وسنُعدّ عرضًا للربط.