VibeFox Ozow for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद (4.1.0.3 पर परीक्षण किया गया)।

PHP: 8.0 या उसके बाद का संस्करण।

मुद्रा: दक्षिण अफ़्रीकी रैंड (ZAR)। आपके स्टोर में मुद्रा ZAR होनी चाहिए (System > Localisation > Currencies), और भुगतान विधि केवल तभी दिखाई देती है जब ग्राहक ZAR में चेकआउट करता है। Ozow पूरे सेंट में शुल्क लेता है, इसलिए मुद्रा में 2 दशमलव स्थान होने चाहिए।

Ozow खाता: आपकी Ozow साइट के Site Code और Private Key के साथ एक Ozow मर्चेंट खाता, जो आपके Ozow मर्चेंट डैशबोर्ड से मिलता है। API Key वैकल्पिक है, लेकिन इसे सेट करने की सलाह दी जाती है। Ozow परीक्षण और लाइव भुगतानों के लिए एक ही Site Code और कुंजियों का उपयोग करता है।

पहुँच योग्य साइट: Ozow की सूचनाएँ मिलने के लिए आपके स्टोर का इंटरनेट से पहुँच योग्य होना ज़रूरी है, बिना पासवर्ड सुरक्षा के और बिना किसी ऐसे फ़ायरवॉल के जो Ozow को रोके। सूचना तब भी काम करती है जब स्टोर मेंटेनेंस मोड में हो: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक स्टार्टअप एक्शन जोड़ता है, जो Ozow की सूचना और ग्राहक की Ozow से वापसी को जाने देता है।

VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

यह डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनपैक करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_ozow_pay-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_ozow_pay.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_ozow_pay-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं हैं, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Ozow Pay ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी पेस्ट करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. अपने Ozow मर्चेंट डैशबोर्ड से Site Code और Private Key दर्ज करें, और अगर संभव हो तो API Key भी। सूचना और रिटर्न URL हर भुगतान के साथ Ozow को भेजे जाते हैं, इसलिए Ozow डैशबोर्ड में कुछ भी सेट करने की ज़रूरत नहीं है।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखकर एक परीक्षण भुगतान करें, फिर असली भुगतान स्वीकार करने के लिए टेस्ट मोड बंद करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_ozow_pay.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Ozow Pay ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और Ozow की कुंजियाँ दर्ज करें, और OpenCart 3 के चरण 3 से 5 की तरह भुगतान का परीक्षण करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना और वापसी के URL अलग हैं (देखें भुगतान सूचनाएँ), और वे भी हर भुगतान के साथ Ozow को भेजे जाते हैं।

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।

कॉन्फ़िगरेशन

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Ozow Pay > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब Site Code या Private Key नहीं भरी है (तब Ozow चेकआउट में छिपा रहता है), जब स्टोर की डिफ़ॉल्ट मुद्रा ZAR नहीं है, जब मुद्रा के 2 से अधिक दशमलव स्थान हैं (इसे System > Localisation > Currencies में 2 पर सेट करें), और टेस्ट मोड चालू होने पर Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. दिखाता है। एक्सटेंशन को बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।

Ozow के फ़ील्ड सेव होने से कभी नहीं रोकते, सिवाय 128 अक्षरों से लंबे Title के (The title must be no longer than 128 characters.)। OpenCart के फ़ील्ड जाँचे जाते हैं: Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। इनमें से कोई गलत हो तो एक त्रुटि बताती है कि कौन-सा फ़ील्ड गलत है और कुछ भी सेव नहीं होता।

Ozow

Enable/Disable: Enable Ozow payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट में देखते हैं। यही नाम ऑर्डर में भी सेव होता है। 128 अक्षरों तक; खाली छोड़ने पर Instant EFT (Ozow) दिखता है। डिफ़ॉल्ट: Instant EFT (Ozow)।

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. टेस्ट मोड में इसके नीचे TEST MODE: no money will be charged. वाली पंक्ति जुड़ जाती है (केवल तब जब विवरण खाली न हो)।

Sort Order: चेकआउट में भुगतान विधियों के बीच Ozow की स्थिति। खाली छोड़ें या कोई पूर्ण संख्या दर्ज करें।

Geo Zone: Ozow केवल चुने गए geo zone के भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता इस्तेमाल होता है।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह राशि, जिस तक पहुँचने पर ही Ozow दिखाया जाएगा। किसी भी राशि पर Ozow दिखाने के लिए खाली छोड़ें।

Ozow क्रेडेंशियल

Site Code, Private Key और API Key को अपने Ozow मर्चेंट डैशबोर्ड (Merchant details / Sites) से कॉपी करें। इस सेक्शन में hub.ozow.com पर Ozow इंटीग्रेशन दस्तावेज़ों का लिंक है।

Site Code: उस Ozow साइट का Site Code जो भुगतान प्राप्त करती है। किसी और Site Code के उत्तर अस्वीकार कर दिए जाते हैं।

Private Key: हर भुगतान अनुरोध पर हस्ताक्षर करती है और Ozow के हर उत्तर को सत्यापित करती है। इसे गोपनीय रखें। यह ठीक वैसे ही सेव होती है जैसे आप इसे दर्ज करते हैं। इसके बिना भुगतान विधि छिप जाती है और कोई Ozow उत्तर स्वीकार नहीं होता।

API Key (recommended): वैकल्पिक। API Key के साथ, हर सफल भुगतान की पुष्टि ऑर्डर को भुगतान किया हुआ चिह्नित करने से पहले Ozow GetTransaction API से भी की जाती है। API को भुगतान को उसी राशि, मुद्रा और Site Code के साथ पूरा बताना होगा।

सेव की गई कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। बदलना हो तभी नया मान दर्ज करें। सेव की गई कुंजी हटाने के लिए, फ़ील्ड के नीचे Clear the saved Private Key on save या Clear the saved API Key on save पर टिक लगाएँ और Save पर क्लिक करें।

Test mode: Ozow परीक्षणों के लिए भी वही Site Code और कुंजियाँ इस्तेमाल करता है: भुगतान IsTest=true के साथ बनाए जाते हैं और कोई असली पैसा नहीं चलता। टेस्ट मोड में भुगतान किए गए ऑर्डरों पर एक नोट लगता है; उन्हें भेजें नहीं। असली भुगतान स्वीकार करने के लिए टेस्ट मोड बंद करें। लाइव मोड में कोई टेस्ट भुगतान किसी ऑर्डर का भुगतान नहीं करता। डिफ़ॉल्ट: चालू।

भुगतान सूचनाएँ

इस सेक्शन में चार URL दिखते हैं जिन्हें एक्सटेंशन हर भुगतान के साथ Ozow को भेजता है: Notification URL (Ozow भुगतान सूचना वहाँ भेजता है), Success URL, Cancel URL और Error URL (Ozow ग्राहक को वहाँ वापस भेजता है)। ये https://your-store/index.php?route=extension/payment/wcp_ozow_pay/notify और https://your-store/index.php?route=extension/payment/wcp_ozow_pay/back&ozow_return=success जैसे दिखते हैं, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_ozow_pay/payment/wcp_ozow_pay.notify और https://your-store/index.php?route=extension/wcp_ozow_pay/payment/wcp_ozow_pay.back&ozow_return=success जैसे दिखते हैं, और आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनते हैं। Ozow डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। अगर आपकी Ozow साइट पर निश्चित URL सेट हैं, तो उन्हें वैसे ही कॉपी करें जैसे सेटिंग्स उन्हें दिखाती हैं।

ऑर्डर

OpenCart Confirm Order चरण में बिना स्टेटस के ऑर्डर बनाता है (लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Ozow सही तरीके से हस्ताक्षरित उत्तर भेज देता है। रद्द या विफल भुगतान ऑर्डर को बिना स्टेटस के छोड़ देता है, और ग्राहक कार्ट सुरक्षित रखते हुए चेकआउट पर वापस आ जाता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस की सूची दिखाता है।

Order Status After Payment: Ozow ने भुगतान को अपेक्षित राशि और मुद्रा के साथ Complete बताया (API Key सेट होने पर GetTransaction से पुष्टि)। डिफ़ॉल्ट: प्रोसेसिंग।

Awaiting Ozow Payment Status: Ozow या बैंक भुगतान की जाँच कर रहा है (Ozow स्टेटस PendingInvestigation)। जब Ozow Complete बताता है, तो ऑर्डर को भुगतान के बाद वाला स्टेटस मिलता है। डिफ़ॉल्ट: लंबित।

On Hold (Review) Status: भुगतान को आपकी समीक्षा चाहिए (देखें ऑर्डर स्टेटस)। ऑर्डर को भुगतान किया हुआ नहीं माना जाता। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Failed Payment Status: वह भुगतान जो जाँच में था और जिसे Ozow ने बाद में Cancelled, Error या Abandoned बताया। डिफ़ॉल्ट: विफल।

Cancelled Order Status: वह स्टेटस जिसे आपका स्टोर रद्द किए गए ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए मिला भुगतान उसे भुगतान किया हुआ चिह्नित करने के बजाय समीक्षा स्टेटस में डालता है। एक्सटेंशन यह स्टेटस कभी सेट नहीं करता। डिफ़ॉल्ट: रद्द।

Refunded Order Status: वह स्टेटस जिसे आपका स्टोर रिफ़ंड किए गए ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए मिला भुगतान केवल एक नोट जोड़ता है। एक्सटेंशन यह स्टेटस कभी सेट नहीं करता। डिफ़ॉल्ट: रिफ़ंड किया गया।

उन्नत

Debug log: भुगतान अनुरोध और Ozow के उत्तर OpenCart के लॉग फ़ोल्डर (storage/logs) में ozow_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB होने पर इसे ozow_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। कुंजियाँ, हैश, टोकन और ग्राहक डेटा कभी दर्ज नहीं होते। डिफ़ॉल्ट: बंद।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों का Ozow डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

इंपोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। Private Key और API Key एक्सपोर्ट नहीं होतीं।

Import: पहले से एक्सपोर्ट किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई कुंजियाँ बनी रहती हैं।

चेकआउट

Payment Method चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Instant EFT (Ozow))। Confirm Order चरण में ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to Ozow to choose your bank and approve the payment. OpenCart इसी चरण में ऑर्डर बनाता है, अभी भी बिना स्टेटस के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन उसे ZAR में ऑर्डर कुल के लिए हस्ताक्षरित अनुरोध के साथ Ozow की होस्ट की गई भुगतान साइट पर भेजता है। बैंक स्टेटमेंट में संदर्भ Order और ऑर्डर नंबर होता है (अधिकतम 20 लैटिन अक्षर, अंक, स्पेस और डैश)। ग्राहक का नाम Ozow को भेजा जाता है। Ozow पेज पर ग्राहक एक दक्षिण अफ़्रीकी बैंक चुनता है और बैंकिंग ऐप में भुगतान स्वीकृत करता है।

इसके बाद Ozow स्टोर को सूचित करता है और ग्राहक को वापस भेजता है। दोनों में एक ही हस्ताक्षरित उत्तर होता है और दोनों एक जैसे ढंग से संसाधित होते हैं, इसलिए एक खो जाने पर भी ऑर्डर को स्टेटस मिल जाता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Ozow पुष्टि कर दे: हैश आपकी Private Key से सत्यापित होना चाहिए, Site Code आपका होना चाहिए, उत्तर इस ऑर्डर के इसी भुगतान प्रयास का होना चाहिए, और राशि तथा मुद्रा ऑर्डर से मेल खानी चाहिए। API Key होने पर भुगतान की जाँच GetTransaction API से भी होती है। फिर ऑर्डर को सामान्य OpenCart तरीके से स्टेटस मिलता है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होता है।

सफल भुगतान के बाद ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। अगर Ozow या बैंक अभी भी भुगतान की जाँच कर रहा है, तो पेज यह भी कहता है: We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. ऑर्डर समीक्षा स्टेटस में हो तो यह कहता है: Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed. जाँच में रहा भुगतान बाद में विफल हो गया या बिना भुगतान वाला ऑर्डर रद्द हो गया, तो यह कहता है: Your Ozow payment was not completed. Please contact us about this order. (OpenCart 4 पर ग्राहक इसके बजाय चेकआउट पर लौटा दिया जाता है, नीचे देखें)। अगर ग्राहक के लौटने तक Ozow ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज प्रतीक्षा का टेक्स्ट और Check again तथा Back to checkout बटन दिखाता है।

अगर ग्राहक Ozow पेज पर रद्द करता है या भुगतान विफल होता है, तो ऑर्डर बिना स्टेटस के रहता है। ग्राहक उसी कार्ट के साथ चेकआउट पर लौटता है और देखता है The Ozow payment was cancelled. You can try again or choose another payment method. या The Ozow payment was not completed. You can try again or choose another payment method. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए रद्द या विफल भुगतान के बाद ग्राहक नई कोशिश के साथ उसी ऑर्डर का भुगतान करता है। अगर उसी कार्ट का कोई और ऑर्डर पहले से भुगतान किया हुआ है या Ozow की प्रतीक्षा में है, तो ग्राहक सीधे सफलता पेज पर पहुँच जाता है, और दूसरे ऑर्डर के देर से आए भुगतान को लागू नहीं किया जाता: भुगतान किए गए ऑर्डर पर एक नोट आपसे कहता है कि अपने Ozow डैशबोर्ड में डुप्लीकेट को रिफ़ंड करें।

अगर उसी कार्ट का एक ऑर्डर भुगतान हो चुका था और फिर आपने उसे रद्द या रिफ़ंड कर दिया, तो ग्राहक चेकआउट पर लौटाया जाता है और नए ऑर्डर के साथ कार्ट का भुगतान करता है। OpenCart 3 पर संदेश यह है: This order was cancelled or refunded by the store. Please confirm the order again to pay with a new order.

OpenCart 4 ऑर्डर को सफलता पेज दिखने तक चेकआउट में रखता है। जब ग्राहक फिर से Confirm Order पर क्लिक करता है या Ozow से वापस आता है, और वह ऑर्डर बंद हो चुका हो, तो ग्राहक एक संदेश के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर चुकाता है: Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. (उदाहरण के लिए जाँच में चल रहा भुगतान विफल हुआ या आपने बिना भुगतान वाला ऑर्डर रद्द किया) या Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. (ऑर्डर का भुगतान हो चुका था और फिर उसे रद्द या रिफ़ंड किया गया)। अगर वह ऑर्डर पहले ही भुगतान किया हुआ है और कार्ट में अब दूसरे उत्पाद या मात्राएँ हैं, तो Confirm Order दिखाता है: Your previous order has already been paid. Your cart has changed since — please confirm the order again to pay for the current cart.

अगर चेकआउट ZAR में नहीं है, तो ग्राहक को Ozow accepts payments in South African rand (ZAR) only. Please choose another payment method. दिखता है।

यह एक्सटेंशन केवल ZAR में एक-बारीय भुगतान लेता है। इसमें OpenCart से रिफ़ंड, सब्सक्रिप्शन, सेव किए गए बैंक खाते या टोकनाइज़ेशन नहीं हैं, और एडमिन से भेजे जाने वाले भुगतान लिंक भी नहीं हैं।

ऑर्डर और रिफ़ंड

ऑर्डर स्टेटस

कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को Ozow पर भेजा गया था और उसने भुगतान नहीं किया, रद्द किया, या Ozow ने भुगतान की पुष्टि अभी नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

OpenCart 4 पर चेकआउट का कोई बिना भुगतान वाला ऑर्डर Voided स्टेटस पा सकता है, जो OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्टेटस वाला ऑर्डर मानता है, और बाद का भुगतान फिर भी उसकी पुष्टि करता है।

Order Status After Payment (default Processing): भुगतान की पुष्टि हो गई। एक नोट राशि, Ozow ट्रांज़ैक्शन ID, और यह दिखाता है कि भुगतान GetTransaction API से पुष्ट हुआ या नहीं। टेस्ट भुगतान को नोट मिलता है: TEST MODE — no money was received, do not ship this order.

Awaiting Ozow Payment Status (default Pending): Ozow या बैंक भुगतान की जाँच कर रहा है। जब Ozow अंतिम स्टेटस भेजता है तब ऑर्डर अपडेट होता है: सफलता पर Order Status After Payment, विफलता पर Failed Payment Status।

On Hold (Review) Status (default Pending): नोट कारण बताता है: भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है; पहले से रद्द ऑर्डर के लिए भुगतान आया; या API Key के साथ GetTransaction API अभी भुगतान की पुष्टि नहीं कर पाया या उसके विरुद्ध है। अपने Ozow डैशबोर्ड में भुगतान जाँचें और ऑर्डर स्टेटस बदलें। अगर API उत्तर नहीं दे पाया, तो अगली Ozow सूचना ऑर्डर को पूरा कर देगी।

Failed Payment Status (default Failed): जाँच में चल रहा भुगतान रद्द, छोड़ा हुआ या विफल हुआ। उस भुगतान के लिए बाद में आया सफल Ozow उत्तर फिर भी ऑर्डर को भुगतान किया हुआ चिह्नित कर देगा।

जो ऑर्डर पहले से भुगतान किया हुआ है, उसे कभी वापस नहीं बदला जाता, और रद्द या रिफ़ंड किया गया ऑर्डर कभी दोबारा नहीं खोला जाता। अगर पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो एक नोट आपसे डुप्लीकेट को अपने Ozow डैशबोर्ड में रिफ़ंड करने को कहता है। जब तक एक्सटेंशन लाइव मोड में है, कोई टेस्ट भुगतान ऑर्डर का भुगतान नहीं करता; एक नोट यह बताता है।

नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Ozow Pay टैब

Sales > Orders में Ozow से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Ozow Pay टैब Transaction reference (ऑर्डर नंबर) और प्रयास, Ozow transaction ID, Status, Requested राशि, Amount reported by Ozow, Ozow message, टेस्ट भुगतानों के लिए TEST MODE लेबल और ऑर्डर के Ozow notes दिखाता है। यह टैब उन यूज़रों को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

OpenCart से रिफ़ंड समर्थित नहीं हैं। अपने Ozow मर्चेंट डैशबोर्ड में भुगतान रिफ़ंड करें, फिर OpenCart में रिफ़ंड को मैन्युअली दर्ज करें। Sales > Returns में उत्पाद वापसी से Ozow के ज़रिए पैसे वापस नहीं जाते।

लाइसेंस कुंजी

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Ozow Pay, Extensions > Extensions > Payments > VibeFox Ozow Pay > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में पेस्ट करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-ozow वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। कुंजी केवल उन एडमिन यूज़रों द्वारा बदली जा सकती है जिनके पास एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के टेक्स्ट एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्टेटस के साथ काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना Ozow चेकआउट में ग्राहकों को नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन यूज़र को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन नहीं दिखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन के Dashboard पर एक रिमाइंडर दिखता है। इसे × से बंद करने पर यह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं।

लाइसेंस की समय-सीमा समाप्त होने पर भी एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन का Dashboard या Edit पेज खोलते हैं, तो स्टेटस अपने आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर सप्ताह एक बार। कोई cron जॉब ज़रूरी नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

समस्या निवारण

Ozow चेकआउट में दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, Site Code और Private Key भरे हुए हैं, और ग्राहक ZAR में चेकआउट कर रहा है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है। कुछ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रह गया: Ozow की सूचना स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं आया। जाँचें कि आपका स्टोर इंटरनेट से पहुँच योग्य है (कोई पासवर्ड सुरक्षा या Ozow को रोकने वाला फ़ायरवॉल नहीं)। अगर आपकी Ozow साइट पर निश्चित URL सेट हैं, तो जाँचें कि वे Payment notifications में दिखाए गए URL से बिल्कुल मेल खाते हैं। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड पढ़ें।

सूचना का उत्तर Invalid hash है: सेटिंग्स में Private Key उस Ozow साइट की नहीं है जिसने उत्तर भेजा। उसे अपने Ozow मर्चेंट डैशबोर्ड से दोबारा कॉपी करें। कुछ नहीं बदलता।

सूचना का उत्तर Unknown site है: उत्तर किसी दूसरी Ozow साइट से आया। Site Code जाँचें।

सूचना का उत्तर Order mismatch या Order not found है: उत्तर इस स्टोर में शुरू किए गए किसी भुगतान का नहीं है। कुछ नहीं बदलता।

सूचना का उत्तर Gateway not configured है: Site Code या Private Key गायब है। उसे भरें; Ozow फिर से कोशिश कर सकता है।

सूचना का उत्तर Payment not confirmed yet है: उत्तर अभी लागू नहीं किया जा सका। API Key के साथ, GetTransaction API भुगतान की पुष्टि नहीं कर पाया (ऑर्डर समीक्षा स्टेटस में है और अगली सूचना उसे पूरा करेगी; अगर वह वहीं रहता है, तो API Key और अपने Ozow डैशबोर्ड में भुगतान जाँचें)। यही उत्तर तब भी आता है जब उसी कार्ट के लिए ग्राहक की वापसी उसी समय संसाधित हो रही थी; लॉग देखें।

ग्राहक को This payment method is not available. Please reload the checkout page.: दिखता है: चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक को चेकआउट पेज रीलोड करना होगा।

टेस्ट भुगतान ने ऑर्डर का भुगतान नहीं किया: एक्सटेंशन लाइव मोड में है। टेस्ट भुगतान लाइव मोड में कभी ऑर्डर का भुगतान नहीं करते; ऑर्डर नोट या लॉग यह बताते हैं।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Ozow Pay टैब के नोट पढ़ें और अपने Ozow डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर स्टेटस सेट करें या Ozow में भुगतान रिफ़ंड करें।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Ozow Pay के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटाया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप एक्शन भी, जो रखरखाव मोड में सूचना और वापसी को जाने देता है)। अगर Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, Site Code, कुंजियाँ, टेस्ट मोड, लॉगिंग) और लॉग हटा दिए जाते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Ozow भुगतान के रिकॉर्ड हमेशा रखे जाते हैं, ताकि पुराने ऑर्डरों की देर से आई सूचनाएँ दोबारा इंस्टॉल करने के बाद भी पहचानी जाएँ। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Ozow Pay के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल बिन बटन) पर क्लिक करें।

Ozow अपने-अपने मालिक का ट्रेडमार्क है। यह एक्सटेंशन Ozow से संबद्ध नहीं है और Ozow द्वारा अनुमोदित नहीं है।