تكاملات نقاط البيع

تربط صفحة إعدادات التكاملات خادم HandyCafe المؤهل بجهاز Ödeal D2D. ويُتحقق من الأهلية عبر سحابة HandyCafe. وتُخفى القائمة والصفحة تمامًا عندما لا يكون مسموحًا للمقهى باستخدام Ödeal.

قبل أن تبدأ

تحتاج إلى اشتراك نشط في سحابة HandyCafe ومفتاح تاجر Ödeal ومفتاح سري من Ödeal. كما يجب إنشاء الجهاز في قسم Cihazlarım لدى Ödeal. والاسم الدقيق المسنَد إلى ذلك الجهاز هو externalDeviceKey الخاص به. ابدأ ببيئة Stage. ولا تنتقل إلى بيئة Production إلا بعد أن تعتمد Ödeal بيانات الإنتاج وإعداد الاستدعاء الراجع.

إعداد Ödeal

1. افتح الإعدادات واختر التكاملات.
2. في قسم حساب Ödeal أدخل مفتاح التاجر والمفتاح السري اللذين قدّمتهما Ödeal. يرسل HandyCafe هذه القيم مباشرة إلى سحابة HandyCafe. وهي مشفّرة ولا تُخزَّن في قاعدة البيانات المحلية ولا تُعرض مرة أخرى.
3. اختر اختبار الاتصال. عند وجود مفاتيح جديدة يحفظها HandyCafe بشكل آمن قبل اختبار الاتصال بواجهة Ödeal البرمجية. يتحقق هذا الاختبار من حساب Ödeal فقط. وهو لا يثبت أن الجهاز مقترن أو متصل.
4. أضف الجهاز. أدخل اسمًا محليًا واضحًا للجهاز. وفي حقل اسم جهاز Ödeal (externalDeviceKey) أدخل اسم الجهاز الدقيق كما أُنشئ في Ödeal. ثم أدخل قيمة PaxID الاختيارية والبيئة ومدة انتظار الدفع ومدينة العميل ومنطقته ونسبة ضريبة القيمة المضافة للجلسة ونسبتها للطلب.
5. فعّل خيار تكامل نقاط البيع نشط واختر حفظ.
6. أتمم عملية إيصال نقدي في بيئة Stage ودفعة بالبطاقة في البيئة نفسها للتحقق من اقتران الجهاز ومن مساري التسوية معًا.

يدعم هذا الإصدار جهاز Ödeal نشطًا واحدًا لكل خادم فقط. ويمنع هذا توجيه دفعة إلى جهاز غير مقصود قبل توفر أداة اختيار الجهاز للكاشير.

يحفظ HandyCafe قائمة الأجهزة محليًا قبل أن تتحقق السحابة من زوج بيانات اعتماد جديد. ورفض Ödeal لبيانات الاعتماد لا يلغي اسم الجهاز ولا حقول الاقتران. ويُخزَّن الجهاز الذي يحتاج إلى بيانات اعتماد جديدة على أنه غير نشط حتى يتم التحقق من تلك البيانات للبيئة المحددة له.

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

إذا رفضت Ödeal الإعداد يعرض HandyCafe الشرح الذي أعادته Ödeal. واستجابة عدم العثور على ملف المؤسسة تعني أن زوج مفتاح التاجر والمفتاح السري لا ينتمي إلى مؤسسة في بيئة Stage أو Production المحددة.

سلوك الدفع

عندما تكون طريقة الدفع النشطة نقدًا أو بطاقة ترسل تسوية جلسة الكمبيوتر وتسوية جلسة وحدة التحكم وإغلاق الطلب المستقل سلة محمية من التكرار إلى Ödeal. يُرسَل النقد باستخدام خيار الدفع CASH الموثّق لدى Ödeal. ويسجّل الجهاز الدفعة النقدية ويطبع القسيمة الضريبية أو إيصال الأرشيف الإلكتروني دون فتح شاشة التحصيل بالبطاقة. أما البطاقة فتُرسل باسم CREDITCARD وينتظر HandyCafe نتيجة الاستدعاء الراجع بينما يُكمل العميل الدفع على الجهاز. والتسوية التي تجمع النقد والبطاقة معًا ترسل خياري الدفع بالمبلغ الخاص بكل منهما.

يمكن للعميل اختيار التقسيط على الجهاز عندما تدعم البطاقة واتفاقية التاجر ذلك. ويحفظ HandyCafe عدد الأقساط المُبلَّغ به مع عملية البيع المحلية. ولا تُعتمد عملية البيع المحلية إلا بعد أن تؤكد Ödeal المعاملة. وإذا فشل الاعتماد المحلي بعد التأكيد يطلب HandyCafe إلغاءً في اليوم نفسه. والإلغاء الفاشل يُنتج خطأً يستوجب مطابقة يدوية ويجب فحصه في تقرير معاملات Ödeal. أما طرق الدفع غير النقد والبطاقة فتستمر عبر مسار التسوية الحالي في HandyCafe.

الاختبارات وعمليات الجهاز

يتحقق اختبار الاتصال من بيانات اعتماد تاجر Ödeal ومن الوصول إلى واجهتها البرمجية فقط. وهو لا يطبع إيصالًا ولا يخصم من بطاقة ولا يثبت أن externalDeviceKey مقترن بالجهاز.

لا تعرّف وثائق واجهة D2D البرمجية المتوفرة نقاط نهاية منفصلة لـ طباعة إيصال اختباري أو عملية خصم اختبارية. ويستخدم اختبار القبول سلالًا عادية في بيئة Stage: أرسل سلة نقدية وتحقق من القسيمة المطبوعة، ثم أرسل سلة بطاقة وأكمل معاملة بدفعة واحدة أو بالتقسيط على الجهاز. استخدم فقط بيانات بطاقات الاختبار التي توفرها Ödeal لبيئة Stage.

تشمل حالات القبول لدى Ödeal إغلاق اليوم وإعادة طباعة آخر إيصال. غير أن هاتين العمليتين تُنفَّذان على الجهاز نفسه. ولا توثّق D2D أي استدعاءات برمجية بعيدة لهما. لذلك لا يعرضهما HandyCafe كأزرار للتحكم عن بُعد.

التفعيل والتعطيل عن بُعد

يتحكم مسؤولو HandyCafe في Ödeal من الإدارة > إعدادات الإدارة > مزوّدو نقاط البيع في لوحة التحكم. زر التبديل العام هو أداة التحكم الرئيسية. وتستخدم الإعدادات الافتراضية للدول رموز ISO المكوّنة من حرفين مثل TR. ويمكن لعناصر التحكم الخاصة بالمقهى فتح Ödeal أو إغلاقه صراحةً لترخيص واحد. والقرار الخاص بالمقهى يتجاوز الإعداد الافتراضي لدولته. وإعادة تعيين قرار المقهى تجعله يتبع دولته من جديد.

ترتيب القرار هو زر التبديل العام ثم القرار الخاص بالمقهى ثم الإعداد الافتراضي للدولة. ويغلق زر التبديل العام المعطّل Ödeal أمام كل المقاهي. والإغلاق الصريح لمقهى يخفي الصفحة حتى لو كانت دولته مفتوحة. والفتح الصريح لمقهى يسمح بالصفحة حتى لو لم تكن دولته ضمن القائمة الافتراضية. ويمنع إيقاف الوصول إنشاء سلال جديدة فورًا. أما المعاملات المعلّقة القائمة فيمكن فحصها أو إلغاؤها كي لا تبقى دفعة جارية عالقة.

يتحقق الخادم من الأهلية عبر سحابة HandyCafe ويخزّن مؤقتًا آخر قرار دولة أو مقهى تم التحقق منه بنجاح. ويعيد كتالوج المزوّدين الرمز HTTP 200 مع حقل error.code منظَّم عندما تكون بيانات اعتماده غير صالحة. ويتعامل تطبيق سطح المكتب مع تلك الاستجابة بتحديث بيانات الاعتماد وإعادة المحاولة. ولا يؤدي أي فشل مؤقت في المصادقة أو الشبكة إلى تفسير قرار تفعيل صادر عن المسؤول على أنه تعطيل، فتبقى قائمة التكاملات ثابتة. وأي استجابة ناجحة لاحقة تحدّث الذاكرة المؤقتة فورًا بما في ذلك قرار التعطيل الصادر عن المسؤول. وفي غياب قرار سابق تم التحقق منه تبقى الصفحة مخفية عند وجود دولة مقهى غير معروفة أو اشتراك غير نشط أو مزوّد معطّل. وتُصرَّح عمليات Ödeal الجديدة دائمًا من جديد عبر السحابة حتى عند استخدام حالة الظهور المخزنة مؤقتًا. وتُستخدم الدولة المحفوظة على الترخيص عندما لا يحتوي ملف المقهى المتزامن على دولة.

الأمان والاسترجاع

تُشفَّر بيانات اعتماد Ödeal في سحابة HandyCafe بمفتاح خزنة النشر. وتُصادَق طلبات الاستدعاء الراجع بمفتاح الطلب المُعد أو بترويسات مفتاح تاجر Ödeal والمفتاح السري. ورموز مرجع السلة ثابتة لكل طلب أو جلسة. وتكرار التسوية نفسها لا ينشئ عملية خصم ثانية.

الإلغاء لدى Ödeal متاح فقط ضمن قواعد اليوم نفسه وقبل إغلاق دفعة الجهاز. ويمكن إزالة سلة معلّقة على حدة قبل اكتمال الدفع. ولا توفر Ödeal D2D عملية استرداد عامة. استخدم لوحة الإدارة الخلفية لدى Ödeal وتقرير المعاملات عندما تكون نافذة الإلغاء قد انقضت.

لا توفر Ödeal D2D تقرير Z موثّقًا ولا عملية إغلاق يوم عن بُعد. أكمل إغلاق اليوم على الجهاز. ويستطيع HandyCafe قراءة تقارير المعاملات لأغراض المطابقة وتسجيل استدعاءات الدفع الراجعة الواردة من Ödeal.