Windcave Terminal गेटवे
Windcave Terminal गेटवे, Windcave HIT के माध्यम से Windcave टर्मिनल पर व्यक्तिगत रूप से कार्ड भुगतान स्वीकार करने देता है। भुगतान WCPOS से शुरू होते हैं और टर्मिनल पर पूरे किए जाते हैं; पुष्टि WooCommerce ऑर्डर में दर्ज हो जाती है।
0.1.0 पहली रिलीज़ है। Windcave के अनुसार किसी एकीकरण को प्रोडक्शन में उपयोग करने से पहले QA प्रमाणन आवश्यक है, और इस एकीकरण को अभी प्रमाणन नहीं मिला है। प्रमाणन पूरा होने तक Windcave UAT (टेस्ट) क्रेडेंशियल के साथ इसका उपयोग करें। Vendor ID प्रमाणन के दौरान Windcave जारी करता है।
सुविधाएँ
क्लाउड HIT कनेक्शन
हर टर्मिनल के लिए एक Station ID के साथ Windcave की क्लाउड HIT सेवा से कनेक्ट करें; स्थानीय पेयरिंग की आवश्यकता नहीं
स्क्रीन पर टर्मिनल के निर्देश
भुगतान पैनल से टर्मिनल के निर्देशों और बटनों का पालन करें, जिनमें हस्ताक्षर सत्यापन के लिए YES/NO और CANCEL शामिल हैं
सत्यापित पूर्णता
भुगतान संदर्भ, राशि, वातावरण, ऑर्डर की कुल राशि और मुद्रा की जाँच के बाद ही ऑर्डर पूरे होते हैं
भुगतान को अलग रखें
समय समाप्त होने के बाद लंबित भुगतान को अलग रखकर आगे काम जारी रखें; पृष्ठभूमि जाँच बाद में इसकी स्थिति देखेगी
परिणाम सूचनाएँ
वैकल्पिक परिणाम सूचनाएँ (FPRN) चालू करें, ताकि Windcave पोलिंग के अतिरिक्त आपकी साइट को सूचित कर सके
यह कैसे काम करता है
यह गेटवे HTTPS पर Windcave HIT (Host Initiated Transaction) का उपयोग करता है। Environment से UAT या प्रोडक्शन एंडपॉइंट चुना जाता है, और प्रत्येक टर्मिनल को Windcave द्वारा जारी Station ID से संबोधित किया जाता है।
भुगतान शुरू करने पर ऑर्डर की पूरी राशि और मुद्रा टर्मिनल को भेजी जाती हैं। भुगतान पृष्ठ हर 1.5 सेकंड में Windcave से स्थिति पूछता है और टर्मिनल के निर्देशों तथा उपलब्ध बटनों को दिखाता है। वैकल्पिक Result notifications (FPRN) पोलिंग के बैकअप के रूप में Windcave को साइट पर सूचना भेजने देती हैं।
सेटअप
WooCommerce के लिए Windcave Terminal इंस्टॉल करें
GitHub रिलीज़ पृष्ठ से प्लगइन zip एसेट (GitHub सोर्स-कोड zip नहीं) डाउनलोड करें। इसे प्लगइन्स > नया जोड़ें > Upload Plugin के माध्यम से अपलोड करें और WooCommerce इंस्टॉल तथा सक्रिय होने पर सक्रिय करें।
सक्रिय करने के लिए PHP 7.4+ और PHP DOM एक्सटेंशन (php-xml) आवश्यक हैं। इनमें से कोई भी उपलब्ध न होने पर संदेश के साथ सक्रियण अस्वीकार कर दिया जाता है।
Windcave से HIT क्रेडेंशियल प्राप्त करें
Windcave से HIT username, HIT key, और हर टर्मिनल के लिए एक Station ID माँगें। Windcave के Integration Requirements फ़ॉर्म के माध्यम से डेवलपमेंट खाता माँगें।
UAT और प्रोडक्शन क्रेडेंशियल अलग-अलग हैं। इस एकीकरण का प्रमाणन लंबित रहने तक UAT क्रेडेंशियल का उपयोग करें।
गेटवे कॉन्फ़िगर करें
WP Admin > WooCommerce > सेटिंग्स > भुगतानपर जाएँ और Windcave Terminal खोलें- Environment को
UAT (testing)(डिफ़ॉल्ट) पर सेट करें। Windcave प्रमाणन के बाद, प्रोडक्शन क्रेडेंशियल के साथProductionका उपयोग करें - Windcave द्वारा जारी HIT username और HIT key दर्ज करें
- अपने Station IDs दर्ज करें, हर पंक्ति में एक
- (वैकल्पिक) Default Station ID सेट करें। हमेशा उसी डिफ़ॉल्ट का उपयोग करने और कैशियर को इसे बदलने से रोकने के लिए Lock terminal selection चालू करें
- प्रमाणन के दौरान Windcave द्वारा Vendor ID जारी किए जाने तक इसे खाली छोड़ें
- अपनी सेटिंग सहेजें
परिणाम सूचनाएँ चालू करें (वैकल्पिक)
लेनदेन का परिणाम तैयार होने पर Windcave से अपनी साइट को सूचना भेजने के लिए कहने हेतु Result notifications (FPRN) चालू करें और सहेजें। यह पोलिंग का बैकअप है।
WCPOS में सक्षम करें
WP Admin > POS > सेटिंग्स > Checkoutपर जाएँ- Windcave Terminal गेटवे ढूँढ़ें और इसे POS के लिए सक्षम करें
- अपनी सेटिंग सहेजें
WooCommerce सेटिंग स्क्रीन पर मौजूद Enable/Disable चेकबॉक्स केवल ऑनलाइन स्टोर चेकआउट को नियंत्रित करता है। कॉन्फ़िगर होने के बाद WCPOS इस गेटवे का उपयोग करता है, चाहे वह बॉक्स चुना गया हो या नहीं।
सेटिंग संदर्भ
| सेटिंग | इसका काम |
|---|---|
| Enable/Disable | ऑनलाइन स्टोर चेकआउट के लिए गेटवे सक्षम करता है। POS सक्षम करने की सेटिंग POS > सेटिंग्स > Checkout में है |
| Title | चेकआउट लेबल; डिफ़ॉल्ट Windcave Terminal है |
| Description | चेकआउट विवरण; डिफ़ॉल्ट Pay in person on the Windcave terminal. है |
| Environment | UAT (testing) (डिफ़ॉल्ट) या Production। दोनों के HIT क्रेडेंशियल अलग हैं; प्रोडक्शन के लिए Windcave प्रमाणन आवश्यक है |
| HIT username | चुने गए वातावरण के लिए Windcave द्वारा जारी HIT username |
| HIT key | चुने गए वातावरण के लिए Windcave द्वारा जारी HIT key |
| Station IDs | हर पंक्ति में Windcave द्वारा जारी एक Station ID, प्रत्येक टर्मिनल के लिए एक |
| Default Station ID | पहले से चुना हुआ Station; कोई Station न चुने जाने पर भी इसका उपयोग होता है |
| Lock terminal selection | हमेशा डिफ़ॉल्ट Station का उपयोग करता है, ताकि कैशियर इसे बदल न सकें। यह तभी लागू होता है जब डिफ़ॉल्ट सेट हो |
| Vendor ID | प्रमाणन के दौरान Windcave जारी करता है। Windcave द्वारा दिए जाने तक खाली छोड़ें |
| POS name | POS की पहचान के लिए Windcave को भेजा जाने वाला नाम; डिफ़ॉल्ट WCPOS है |
| Result notifications (FPRN) | लेनदेन का परिणाम तैयार होने पर पोलिंग के बैकअप के रूप में Windcave से साइट को सूचना भेजने के लिए कहता है। डिफ़ॉल्ट रूप से बंद |
| Checkout logs | भुगतान पैनल पर लॉग टूल दिखाता है। डिफ़ॉल्ट रूप से बंद |
| Log level | Off, Errors only, या Debug। डिफ़ॉल्ट Debug है; अनुरोध और प्रतिक्रियाएँ दर्ज होती हैं, जिनमें कुंजियों और कार्ड डेटा को छिपाया जाता है |
| Support | Download support bundle और WooCommerce > Status > Logs में लॉग देखने का लिंक देता है |
कनेक्शन जाँचने का कोई बटन नहीं है: पहली बार भुगतान चलने पर क्रेडेंशियल और Station IDs जाँचे जाते हैं।
उपयोग
भुगतान संसाधित करना
- Add Items: POS में अपने कार्ट में उत्पाद जोड़ें
- Select Gateway: भुगतान विधि के रूप में Windcave Terminal चुनें
- Choose Terminal: कोई Station चुनें या लॉक किए गए डिफ़ॉल्ट का उपयोग करें। दो या अधिक Stations होने और डिफ़ॉल्ट न होने पर चयन आवश्यक है
- Start Payment: ऑर्डर की कुल राशि टर्मिनल पर भेजने के लिए Start Terminal Payment पर क्लिक करें
- Follow Prompts: हस्ताक्षर सत्यापन के लिए YES/NO और उपलब्ध होने पर CANCEL सहित, टर्मिनल के निर्देश और उपलब्ध बटन स्क्रीन पर दिखाई देते हैं
- Automatic Completion: स्वीकृति और सत्यापन के बाद ऑर्डर पूरा हो जाता है और POS रसीद पर चला जाता है
भुगतान नियंत्रण
- Start Terminal Payment: चुने गए Station को भुगतान का नया अनुरोध भेजें
- Cancel Terminal Payment: टर्मिनल द्वारा विकल्प दिए जाने पर उसका CANCEL बटन दबाता है। अन्यथा टर्मिनल पर रद्द करें या विकल्प दिखने पर भुगतान अलग रखें
- Set payment aside: 5-मिनट की समय-सीमा के बाद दिखाई देता है। यह प्रयास को 10-मिनट की पृष्ठभूमि जाँच के लिए छोड़ देता है, ताकि आप किसी अन्य तरीके से भुगतान ले सकें; इससे Windcave पर भुगतान रद्द नहीं होता
- पृष्ठ पुनः लोड करना: पहले से जारी भुगतान फिर से शुरू करता है
रसीदें
Windcave से प्राप्त होने पर टर्मिनल की रसीद का पाठ WooCommerce में निजी ऑर्डर नोट के रूप में सहेजा जाता है।
रिफ़ंड
WooCommerce से रिफ़ंड 0.1.0 में समर्थित नहीं हैं। Windcave पोर्टल (Payline) या टर्मिनल पर रिफ़ंड करें, फिर WooCommerce में रिफ़ंड को मैन्युअल रूप से दर्ज करें।
लॉग और सहायता बंडल
लॉग WooCommerce > Status > Logs में windcave-terminal स्रोत के अंतर्गत देखें। लॉग स्तर डिफ़ॉल्ट रूप से Debug है; इसमें Windcave के अनुरोध और प्रतिक्रियाएँ दर्ज होती हैं और कुंजियों तथा कार्ड डेटा को छिपाया जाता है।
गेटवे सेटिंग स्क्रीन पर Download support bundle पर क्लिक करके .json फ़ाइल डाउनलोड करें और उसे ऑर्डर नंबर के साथ भेजें। इसमें वातावरण का विवरण, HIT key और username छिपाकर रखी गई सेटिंग, हाल के अधिकतम 20 ऑर्डर के भुगतान प्रयास (रसीदें हटाकर), और दो सबसे नई लॉग फ़ाइलों की आखिरी 1,000 पंक्तियाँ शामिल होती हैं; लॉग पंक्तियों में टर्मिनल रसीद का पाठ हो सकता है, जिसमें कार्ड नंबर छिपाए गए होते हैं।
यदि WooCommerce database log handler का उपयोग करता है, तो बंडल में कोई लॉग पंक्तियाँ नहीं होंगी। इसके बजाय WooCommerce > Status > Logs से लॉग एक्सपोर्ट करें।
भुगतान पैनल पर लॉग टूल दिखाने के लिए Checkout logs सक्षम करें।
आवश्यकताएँ
दायरा और सीमाएँ
इस एकीकरण को अभी Windcave का प्रमाणन नहीं मिला है। Windcave QA प्रमाणन पूरा होने तक UAT क्रेडेंशियल का उपयोग करें; प्रमाणन से पहले इसे प्रोडक्शन में उपयोग न करें।
- WooCommerce से रिफ़ंड 0.1.0 में समर्थित नहीं हैं
- टिप, अतिरिक्त शुल्क और कैश-आउट समर्थित नहीं हैं
- केवल दो दशमलव स्थानों वाली मुद्राएँ समर्थित हैं
- टर्मिनल पर ऑर्डर की पूरी राशि चार्ज की जाती है; टर्मिनल पर ऑर्डर के केवल एक हिस्से का भुगतान समर्थित नहीं है
- Station IDs हाथ से दर्ज किए जाते हैं; टर्मिनलों का अपने-आप पता नहीं लगाया जाता
- यह गेटवे POS के लिए बनाया गया है। ऑनलाइन स्टोर में यह केवल order-pay पृष्ठ पर काम करता है
समस्या निवारण
आम समस्याएँ
सक्रियण अस्वीकार: PHP DOM एक्सटेंशन (php-xml) आवश्यक है
- सर्वर पर PHP DOM एक्सटेंशन मौजूद नहीं है
- अपने होस्ट से php-xml सक्षम करने को कहें। सक्रियण के लिए PHP 7.4+ भी आवश्यक है
कोई Station ID कॉन्फ़िगर नहीं है
- Station IDs सेटिंग खाली है
- Windcave द्वारा जारी Station IDs को गेटवे सेटिंग में, हर पंक्ति में एक, जोड़ें और सहेजें
Windcave HIT क्रेडेंशियल कॉन्फ़िगर नहीं हैं
- HIT username या HIT key खाली है
- दोनों गेटवे सेटिंग में दर्ज करके सहेजें। सुनिश्चित करें कि Environment इन क्रेडेंशियल से मेल खाता है
टर्मिनल अभी पिछला लेनदेन पूरा कर रहा है
- उस Station पर पिछला लेनदेन अभी जारी है
- टर्मिनल पर उसे पूरा करें या रद्द करें, फिर दोबारा प्रयास करें
Windcave के पास इस लेनदेन का कोई रिकॉर्ड नहीं है
- शुरुआती 30-सेकंड की प्रतीक्षा अवधि के बाद भी Windcave के पास कोई रिकॉर्ड नहीं है
- भुगतान फिर से शुरू करें
Windcave ने भुगतान स्वीकृत किया, लेकिन उसे लागू नहीं किया जा सका
- स्वीकृत परिणाम इस ऑर्डर को पूरा करने के लिए आवश्यक जाँचों में सफल नहीं हुआ
- Windcave पोर्टल और ऑर्डर नोट जाँचकर ही दोबारा शुल्क लें
यह भुगतान किसी दूसरे वातावरण में शुरू किया गया था
- भुगतान जारी रहने के दौरान Environment बदल दिया गया
- उस वातावरण पर वापस जाएँ जहाँ भुगतान शुरू किया गया था, या Windcave पोर्टल देखें
सहायता प्राप्त करें
- गेटवे सेटिंग स्क्रीन से support bundle को ऑर्डर नंबर के साथ भेजें
- समस्याओं की रिपोर्ट करने के लिए GitHub repository पर जाएँ
- खाते, क्रेडेंशियल और हार्डवेयर से जुड़े प्रश्नों के लिए Windcave सहायता से संपर्क करें