POS इंटीग्रेशन

इंटीग्रेशन सेटिंग्स पेज एक पात्र HandyCafe सर्वर को Ödeal D2D टर्मिनल से जोड़ता है। उपलब्धता की जाँच HandyCafe Cloud के माध्यम से होती है। जब कैफे को Ödeal उपयोग करने की अनुमति नहीं होती, तो मेनू और पेज पूरी तरह छिपे रहते हैं।

शुरू करने से पहले

आपको एक सक्रिय HandyCafe Cloud सदस्यता, एक Ödeal मर्चेंट कुंजी और एक Ödeal सीक्रेट कुंजी चाहिए। साथ ही आपको Ödeal के Cihazlarım क्षेत्र में टर्मिनल बनाना होगा। उस टर्मिनल को दिया गया सटीक नाम ही उसका externalDeviceKey है। शुरुआत Stage वातावरण से करें। Production पर तभी जाएँ जब Ödeal प्रोडक्शन क्रेडेंशियल और कॉलबैक सेटअप को मंज़ूरी दे दे।

Ödeal कॉन्फ़िगर करें

1. सेटिंग्स खोलें और इंटीग्रेशन चुनें।
2. Ödeal खाता में Ödeal द्वारा दी गई मर्चेंट कुंजी और सीक्रेट कुंजी दर्ज करें। HandyCafe इन मानों को सीधे HandyCafe Cloud को भेजता है। ये एन्क्रिप्ट किए जाते हैं तथा न स्थानीय डेटाबेस में संग्रहीत होते हैं और न दोबारा दिखाए जाते हैं।
3. कनेक्शन टेस्ट चुनें। नई कुंजियाँ मौजूद होने पर HandyCafe उन्हें Ödeal API कनेक्शन जाँचने से पहले सुरक्षित रूप से सहेज लेता है। यह टेस्ट केवल Ödeal खाते की पुष्टि करता है। यह इस बात का प्रमाण नहीं है कि टर्मिनल जुड़ा हुआ या ऑनलाइन है।
4. टर्मिनल जोड़ें। एक स्पष्ट स्थानीय डिवाइस नाम दर्ज करें। Ödeal डिवाइस नाम (externalDeviceKey) में वही सटीक डिवाइस नाम दर्ज करें जो Ödeal में बनाया गया था। इसके बाद वैकल्पिक PaxID, वातावरण, भुगतान प्रतीक्षा समय, ग्राहक का शहर, ग्राहक का ज़िला, सत्र वैट दर और ऑर्डर वैट दर दर्ज करें।
5. POS इंटीग्रेशन सक्रिय चालू करें और सहेजें चुनें।
6. टर्मिनल पेयरिंग तथा दोनों निपटान मार्गों की पुष्टि के लिए Stage में एक नकद रसीद और एक कार्ड भुगतान पूरा करें।

इस रिलीज़ में प्रति सर्वर केवल एक सक्रिय Ödeal टर्मिनल समर्थित है। इससे यह सुनिश्चित होता है कि कैशियर के लिए टर्मिनल चयनकर्ता उपलब्ध होने से पहले कोई भुगतान गलत टर्मिनल पर न चला जाए।

Cloud द्वारा नई क्रेडेंशियल जोड़ी सत्यापित किए जाने से पहले ही HandyCafe टर्मिनल सूची स्थानीय रूप से सहेज लेता है। Ödeal द्वारा क्रेडेंशियल अस्वीकार किए जाने पर टर्मिनल का नाम या पेयरिंग फ़ील्ड नष्ट नहीं होते। जिस टर्मिनल को नए क्रेडेंशियल चाहिए, वह तब तक निष्क्रिय के रूप में संग्रहीत रहता है जब तक उसके चुने गए वातावरण के लिए वे क्रेडेंशियल सत्यापित नहीं हो जाते।

इंटीग्रेशन पेज टर्मिनल सूची सीधे स्थानीय SQLite डेटाबेस से पढ़ता है और Cloud की प्रतीक्षा किए बिना दिखाता है। केवल एन्क्रिप्टेड क्रेडेंशियल स्थिति और रिमोट प्रदाता अनुमति के लिए Cloud अनुरोध आवश्यक होता है।

यदि Ödeal कॉन्फ़िगरेशन अस्वीकार करता है, तो HandyCafe उसके द्वारा लौटाया गया स्पष्टीकरण दिखाता है। संगठन प्रोफ़ाइल न मिलने वाले उत्तर का अर्थ है कि मर्चेंट और सीक्रेट की यह जोड़ी चुने गए Stage या Production वातावरण के किसी संगठन से संबंधित नहीं है।

भुगतान व्यवहार

जब सक्रिय भुगतान विधि नकद या कार्ड होती है, तो PC सत्र चेकआउट, कंसोल सत्र चेकआउट और स्वतंत्र ऑर्डर क्लोज़िंग Ödeal को एक आइडेमपोटेंट बास्केट भेजते हैं। नकद को Ödeal के प्रलेखित CASH भुगतान विकल्प के रूप में भेजा जाता है। टर्मिनल नकद भुगतान दर्ज करता है और कार्ड कलेक्शन स्क्रीन खोले बिना फ़िस्कल स्लिप या e-Archive रसीद प्रिंट करता है। कार्ड को CREDITCARD के रूप में भेजा जाता है; ग्राहक जब तक टर्मिनल पर भुगतान पूरा करता है, HandyCafe तब तक कॉलबैक परिणाम की प्रतीक्षा करता है। जिस चेकआउट में नकद और कार्ड दोनों शामिल हों, उसमें दोनों भुगतान विकल्प अपनी-अपनी राशि के साथ भेजे जाते हैं।

जब कार्ड और मर्चेंट समझौता इसकी अनुमति देते हैं, तो ग्राहक टर्मिनल पर किस्त का विकल्प चुन सकता है। HandyCafe रिपोर्ट की गई किस्तों की संख्या स्थानीय बिक्री के साथ संग्रहीत करता है। स्थानीय बिक्री तभी दर्ज होती है जब Ödeal लेन-देन की पुष्टि कर देता है। पुष्टि के बाद स्थानीय रिकॉर्ड दर्ज होने में विफलता होने पर HandyCafe उसी दिन रद्दीकरण का अनुरोध करता है। रद्दीकरण विफल होने पर एक मैनुअल मिलान त्रुटि बनती है, जिसे Ödeal लेन-देन रिपोर्ट में जाँचना आवश्यक है। नकद और कार्ड के अलावा अन्य भुगतान विधि प्रकार मौजूदा HandyCafe निपटान प्रवाह से ही आगे बढ़ते हैं।

टेस्ट और टर्मिनल संचालन

कनेक्शन टेस्ट केवल Ödeal मर्चेंट क्रेडेंशियल और API पहुँच की पुष्टि करता है। यह न रसीद प्रिंट करता है, न कार्ड से शुल्क लेता है और न ही यह प्रमाणित करता है कि externalDeviceKey टर्मिनल से जुड़ा हुआ है।

उपलब्ध कराए गए D2D API दस्तावेज़ में अलग से टेस्ट रसीद प्रिंट करें या टेस्ट चार्ज एंडपॉइंट परिभाषित नहीं हैं। स्वीकृति परीक्षण Stage वातावरण में सामान्य बास्केट से किया जाता है: पहले एक नकद बास्केट भेजें और प्रिंट हुई स्लिप जाँचें, फिर एक कार्ड बास्केट भेजें और टर्मिनल पर एकमुश्त या किस्त वाला लेन-देन पूरा करें। केवल Ödeal द्वारा दिए गए Stage टेस्ट कार्ड विवरण का उपयोग करें।

Ödeal के स्वीकृति परिदृश्यों में दिन बंद करना और अंतिम रसीद दोबारा प्रिंट करना शामिल है, लेकिन ये टर्मिनल पर किए जाने वाले संचालन हैं। D2D इनके लिए रिमोट API कॉल प्रलेखित नहीं करता, इसलिए HandyCafe इन्हें रिमोट बटन के रूप में उपलब्ध नहीं कराता।

रिमोट रूप से सक्षम और अक्षम करना

HandyCafe व्यवस्थापक Ödeal को डैशबोर्ड में एडमिन > एडमिन सेटिंग्स > POS प्रदाता से नियंत्रित करते हैं। ग्लोबल स्विच मुख्य नियंत्रण है। देश डिफ़ॉल्ट TR जैसे दो अक्षर वाले ISO कोड उपयोग करते हैं। कैफे नियंत्रण किसी एक लाइसेंस के लिए Ödeal को स्पष्ट रूप से खोल या बंद कर सकते हैं। कैफे-विशिष्ट निर्णय देश डिफ़ॉल्ट पर भारी पड़ता है। कैफे का निर्णय रीसेट करने पर वह कैफे दोबारा अपने देश का अनुसरण करने लगता है।

निर्णय का क्रम है: ग्लोबल स्विच, फिर कैफे-विशिष्ट निर्णय, फिर देश डिफ़ॉल्ट। ग्लोबल स्विच बंद होने पर हर कैफे के लिए Ödeal बंद हो जाता है। किसी कैफे को स्पष्ट रूप से बंद करने पर पेज तब भी छिपा रहता है जब उसका देश खुला हो। किसी कैफे को स्पष्ट रूप से खोलने पर पेज तब भी उपलब्ध रहता है जब उसका देश डिफ़ॉल्ट सूची में न हो। पहुँच बंद करते ही नई बास्केट बनना तुरंत रुक जाता है। मौजूदा लंबित लेन-देन फिर भी जाँचे या रद्द किए जा सकते हैं, ताकि चल रहा कोई भुगतान अधर में न रह जाए।

सर्वर उपलब्धता की जाँच HandyCafe Cloud के माध्यम से करता है और अंतिम सफलतापूर्वक सत्यापित देश/कैफे निर्णय को कैश में रखता है। क्रेडेंशियल अमान्य होने पर प्रदाता कैटलॉग संरचित error.code के साथ HTTP 200 लौटाता है। डेस्कटॉप उस उत्तर पर क्रेडेंशियल ताज़ा करके दोबारा प्रयास करता है। अस्थायी प्रमाणीकरण या नेटवर्क विफलता किसी सक्षम एडमिन निर्णय को अक्षम नहीं मान लेती, इसलिए इंटीग्रेशन मेनू स्थिर बना रहता है। बाद में मिलने वाला सफल उत्तर कैश को तुरंत अपडेट कर देता है, एडमिन के अक्षम करने के निर्णय सहित। यदि पहले से कोई सत्यापित निर्णय मौजूद न हो, तो अज्ञात कैफे देश, निष्क्रिय सदस्यता या अक्षम प्रदाता की स्थिति में पेज छिपा रहता है। कैश की गई दृश्यता उपयोग होने पर भी नए Ödeal संचालन हर बार Cloud से दोबारा अधिकृत कराए जाते हैं। जब सिंक्रनाइज़ की गई कैफे प्रोफ़ाइल में देश नहीं होता, तो लाइसेंस पर सहेजा गया देश उपयोग किया जाता है।

सुरक्षा और रिकवरी

Ödeal क्रेडेंशियल HandyCafe Cloud में डिप्लॉयमेंट वॉल्ट कुंजी से एन्क्रिप्ट किए जाते हैं। कॉलबैक अनुरोध कॉन्फ़िगर की गई अनुरोध कुंजी से या Ödeal मर्चेंट व सीक्रेट हेडर से प्रमाणित होते हैं। बास्केट संदर्भ कोड हर ऑर्डर या सत्र के लिए स्थिर रहते हैं। वही चेकआउट दोहराने से दूसरा शुल्क नहीं बनता।

Ödeal रद्दीकरण केवल Ödeal के उसी दिन वाले नियमों के अनुसार और टर्मिनल बैच बंद होने से पहले तक उपलब्ध है। भुगतान पूरा होने से पहले किसी लंबित बास्केट को अलग से हटाया जा सकता है। Ödeal D2D कोई सामान्य रिफंड संचालन उपलब्ध नहीं कराता। रद्दीकरण की अवधि बीत जाने पर Ödeal बैक ऑफ़िस और लेन-देन रिपोर्ट का उपयोग करें।

Ödeal D2D कोई प्रलेखित रिमोट Z रिपोर्ट या दिन बंद करने का संचालन उपलब्ध नहीं कराता। दिन बंद करने की प्रक्रिया टर्मिनल पर ही पूरी करें। HandyCafe मिलान के लिए लेन-देन रिपोर्ट पढ़ सकता है और Ödeal से आने वाले पेबैक कॉलबैक दर्ज करता है।