اربط جهاز الكاشير ببرنامج الولاء

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

  • واجهة REST API موثّقة
  • خصومات ومكافآت عند الكاشير
  • اختياري – يعمل BonusQR من دونه
كاشير عند جهاز نقاط البيع في مقهى وعميل يحمل رمز QR للولاء
POSالآن

تم مسح بطاقة الولاء – طُبّق خصم 10%

يقرأ جهاز الكاشير رمز الولاء ويطبّق النتيجة بنفسه.

ما هو ربط برنامج الولاء بنظام نقاط البيع؟

يتيح ربط برنامج الولاء بنظام نقاط البيع لجهاز الكاشير التواصل مع برنامج الولاء. فبدلًا من المسح في تطبيق منفصل، يمسح الموظفون رمز QR الخاص بولاء العميل عند الكاشير، ويطبّق الجهاز ما يمنحه البرنامج.

يوفّر BonusQR لهذا الغرض واجهة REST API. يرسل الكاشير الرمز الممسوح، ومبلغ الفاتورة عند الحاجة، فيردّ BonusQR بما يجب فعله – تطبيق خصم بنسبة مئوية أو بمبلغ، أو استبدال قسيمة أو مكافأة نقاط – مع رسائل جاهزة للموظفين.

الربط اختياري، ويُنفَّذ كمشروع مخصص مع مورّد نظام نقاط البيع لديك. ويُصدر BonusQR مفاتيح API، ويُسعَّر الربط بشكل منفصل.

ما يحصل عليه جهاز الكاشير من مسح واحد

لمحة من توثيق API التفاعلي الذي يستخدمه مورّد نظام نقاط البيع لربط جهاز الكاشير لديك.

  1. 1

    التعرّف على العميل

    يمسح الكاشير رمز QR للولاء ويحصل على اسم العميل ورقم زيارته وأرصدته.

  2. 2

    تطبيق الخصومات

    تعود الخصومات بالنسبة المئوية أو بالمبلغ في صورة إجراءات يطبّقها الكاشير على الفاتورة.

  3. 3

    استبدال المكافآت

    تُستبدل القسائم ومكافآت النقاط والدفع برصيد الاسترداد النقدي مباشرةً عند الكاشير.

  4. 4

    رسائل للموظفين

    كل ردّ يتضمن رسائل جاهزة للموظفين بلغة نشاطك التجاري.

BonusQR APIOAS 3.0
POSامسح رمز العميل عند الكاشير واعرف ما يجب أن يفعله جهاز الكاشير.
GET/api/pos/configإعداد برنامج الولاء لجهاز الكاشير
POST/api/pos/scanمسح رمز عند الكاشير
Request body application/json
{ "code": "12345", "bill_amount": 12.50 }
Responses
200completedinput_requiredvoucher3failed
{
  "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": []
}
POST/api/pos/scan/{scan_id}إرسال مبلغ الفاتورة أو عدد المنتجات
POST/api/pos/scan/{scan_id}/cancelإلغاء مسح معلّق

يحصل مورّد نظام نقاط البيع لديك على توثيق API تفاعلي وكاشير تجريبي ليجرّب الربط عليه.

كيف يعمل الربط

هكذا تتم عملية شراء واحدة مع جهاز كاشير مرتبط.

العميلالكاشيرBonusQR
  1. العميلالكاشيريعرض رمز QR الخاص بالولاء
  2. الكاشيرBonusQRيرسل الرمز الممسوحPOST /api/pos/scan
  3. BonusQRالكاشيريطلب مبلغ الفاتورة عند الحاجةinput_required
  4. الكاشيرBonusQRيردّ بالمبلغ الذي يدفعه العميلPOST /api/pos/scan/{scan_id}
  5. BonusQRالكاشيريعيد الخصم والمكافآت ورسائل الموظفينcompleted
  6. الكاشيريطبّق الخصم ويُتمّ البيع
  7. BonusQRالعميليرى الأختام والنقاط والمكافآت في التطبيق

صُمّم الربط بحيث لا يؤخّر برنامج الولاء أي عملية دفع: إذا لم يستجب BonusQR، تستمر عملية البيع.

من دون الربط، يمسح الموظفون ببساطة بهاتف أو جهاز لوحي – فـBonusQR يعمل بالكامل بمفرده.

يعمل مع كل برامج الولاء

تفهم واجهة API كل البرامج في عرضك. على سبيل المثال:

تظهر المكافآت المكتسبة عند الكاشير في تطبيق العميل لزيارته التالية.

مقهىالآن

بطاقة الأختام – يرسل الكاشير عدد المنتجات

صالون شعرالآن

خصم ثابت – نسبة مئوية من الفاتورة

مطعمالآن

استرداد نقدي – الرصيد يدفع الفاتورة كخصم بمبلغ

مخبزالآن

قسيمة مكافأة – تُستبدل عند الدفع

نادٍ رياضيالآن

النقاط – مكافأة من الكتالوج تُستبدل عند الكاشير

متجرالآن

مكافأة على الإنفاق – تُحتسب الفاتورة نحو القسيمة التالية

شاشة لمس لنقاط البيع وماسح QR يقرأ رمز ولاء العميلREST API

مصمَّم لعملية دفع حقيقية

يمسح الكاشير وقت الدفع. وإذا احتاج BonusQR إلى المزيد – مبلغ الفاتورة أو عدد المنتجات – فإنه يطلبه ويجيب الكاشير. ويمكن إلغاء المسح المعلّق، ولا تتوقف عملية البيع أبدًا.

  • حالات واضحة: مكتمل، يتطلب إدخالًا، فشل
  • يمكن إلغاء عمليات المسح المعلّقة
  • المبالغ بعملة نشاطك التجاري
  • حتى 60 طلبًا في الدقيقة لكل مفتاح

الربط مع نقاط البيع مقابل ماسح BonusQR

كلاهما يعمل. اختر ما يناسب نقطة الدفع لديك.

التكامل مع نقاط البيع (POS)

الإعداد
مشروع مخصص مع مورّد نظام نقاط البيع
أين يمسح الموظفون
عند الكاشير
الخصومات
يطبّقها الكاشير تلقائيًا
السعر
يُحدَّد بشكل منفصل
مقابل

ماسح BonusQR

الإعداد
جاهز خلال دقائق
أين يمسح الموظفون
على هاتف أو جهاز لوحي أو ماسح على المنضدة
الخصومات
تُعرض للموظفين ليطبّقوها
السعر
مشمول في كل الخطط

أسئلة حول الربط مع نقاط البيع

أكثر ما يسأل عنه أصحاب الأنشطة ومورّدو أنظمة نقاط البيع.

هل أحتاج إلى الربط مع نقاط البيع لاستخدام BonusQR؟

لا. يعمل BonusQR بالكامل بمفرده – يمسح الموظفون رموز العملاء بهاتف أو جهاز لوحي أو ماسح على المنضدة. والربط اختياري.

ما أنظمة نقاط البيع التي يمكن ربطها؟

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

كم تبلغ تكلفة الربط؟

إنه مشروع مخصص، لذا يُسعَّر بشكل منفصل. راسلنا وسنُعدّ عرضًا بالتعاون مع مورّد نظام نقاط البيع لديك.

كيف نحصل على مفاتيح API؟

يُصدرها BonusQR عند الطلب. ويمكن قصر المفتاح على فرع واحد من فروع نشاطك التجاري.

ماذا يتلقى الكاشير بعد المسح؟

اسم العميل ورقم زيارته وأرصدته، والإجراءات المطلوب تطبيقها – خصم بنسبة مئوية أو بمبلغ، أو قسيمة، أو مكافأة نقاط – والمكافآت المكتسبة، ورسائل جاهزة للموظفين.

ماذا لو احتاج الكاشير إلى معلومات إضافية؟

يطلبها BonusQR – مثل مبلغ الفاتورة أو عدد المنتجات – ويجيب الكاشير. ويمكن أيضًا إلغاء المسح المعلّق.

هل يتوفر توثيق؟

نعم. يتوفر توثيق API تفاعلي، مع كاشير تجريبي يمكن لمورّدك استخدامه للاختبار.

وماذا عن المتاجر الإلكترونية؟

تتوفر لـWooCommerce وShopify عمليات تكامل جاهزة ضمن خطة Basic.

هل تريد الولاء مباشرةً عند الكاشير؟

أخبرنا بنظام نقاط البيع الذي تستخدمه، وسنُعدّ عرضًا للربط.