VibeFox Ozow for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।

मुद्रा: South African rand (ZAR)। भुगतान का तरीका केवल ZAR वाले कार्ट के लिए दिखता है। Ozow पूरे सेंट में शुल्क लेता है, इसलिए मुद्रा में 2 दशमलव स्थान होने चाहिए।

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

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

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Ozow Pay ढूँढकर Configure पर क्लिक करें।

3. Configure पेज के सबसे ऊपर के लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Ozow मर्चेंट डैशबोर्ड से Site Code और Private Key दर्ज करें, और यदि संभव हो तो API Key भी।

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

इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting Ozow payment और Ozow payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। इन्हें आप Payment > Preferences में सीमित कर सकते हैं; वहाँ मॉड्यूल के लिए ZAR की अनुमति होनी चाहिए। बाद में सक्रिय किए गए देश को भी वहीं मॉड्यूल के लिए चिह्नित करना होगा।

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

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

Ozow

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

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

Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: 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. वाली पंक्ति जुड़ जाती है (केवल तब जब विवरण खाली न हो)।

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

Ozow मर्चेंट डैशबोर्ड (Merchant details / Sites) से Site Code, Private Key और API Key कॉपी करें। इस अनुभाग में 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 saved secrets: सहेजी गई कुंजी हटाने के लिए Private Key या API Key पर टिक करें और सहेजें। खाली फ़ील्ड सहेजे गए मान को रखता है।

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

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

सूचना, सफलता, रद्द और त्रुटि URL हर भुगतान के साथ Ozow को भेजे जाते हैं, इसलिए Ozow डैशबोर्ड में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं होती, जब तक आपकी Ozow साइट निश्चित URL पर सेट न हो। यह अनुभाग चारों URL दिखाता है: Notification URL, Success URL, Cancel URL और Error URL। ये आपके स्टोर के मॉड्यूल लिंक हैं (कंट्रोलर notify और return)। यदि आपकी Ozow साइट निश्चित URL उपयोग करती है, तो उन्हें बिल्कुल वैसे ही कॉपी करें जैसे सेटिंग्स उन्हें दिखाती हैं।

एडवांस्ड

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

Log: लॉग का मौजूदा आकार और अंत दिखाता है, साथ में Clear log बटन।

Delete data on uninstall: मॉड्यूल अनइंस्टॉल होने पर इसकी सेटिंग्स और लॉग हटा देता है (ऑर्डर में सहेजा गया Ozow डेटा रहता है)। डिफ़ॉल्ट: off।

चेकआउट

भुगतान के चरण पर ग्राहक भुगतान का तरीका चुनता है (डिफ़ॉल्ट रूप से Instant EFT (Ozow)) और ऑर्डर की पुष्टि करता है। मॉड्यूल ग्राहक को ZAR में कार्ट के कुल योग के लिए हस्ताक्षरित अनुरोध के साथ Ozow के होस्ट किए गए भुगतान पेज पर भेजता है। बैंक स्टेटमेंट में संदर्भ Cart और कार्ट नंबर होता है (अधिकतम 20 लैटिन अक्षर, अंक, स्पेस और डैश)। ग्राहक का नाम Ozow को भेजा जाता है। इस बिंदु पर कोई ऑर्डर अभी मौजूद नहीं होता। Ozow के पेज पर ग्राहक कोई South African बैंक चुनता है और बैंकिंग ऐप में भुगतान की पुष्टि करता है।

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

सफल भुगतान के बाद ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि 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. यदि ग्राहक के लौटने तक Ozow ने भुगतान की पुष्टि नहीं की है, तो पेज प्रतीक्षा वाला पाठ दिखाता है, साथ में 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.

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

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

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

ऑर्डर स्टेटस

अभी कोई ऑर्डर नहीं: ग्राहक को Ozow पर भेजा गया है और उसने भुगतान नहीं किया, रद्द किया, या Ozow ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।

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

Awaiting Ozow payment: Ozow या बैंक भुगतान की जाँच कर रहा है। जब Ozow अंतिम स्थिति भेजता है, तब ऑर्डर अपडेट होता है।

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

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

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

Ozow भुगतान ब्लॉक

ऑर्डर पेज पर एक Ozow payment ब्लॉक दिखता है, जिसमें लेन-देन संदर्भ और प्रयास, Ozow ट्रांज़ैक्शन ID, स्थिति, माँगी गई राशि, Ozow द्वारा बताई गई राशि, Ozow संदेश, और टेस्ट भुगतानों के लिए TEST MODE चिह्न होता है।

रिफ़ंड

PrestaShop से रिफ़ंड समर्थित नहीं हैं। भुगतान को अपने Ozow मर्चेंट डैशबोर्ड में रिफ़ंड करें, फिर PrestaShop में रिफ़ंड मैन्युअल रूप से दर्ज करें।

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

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

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

एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर का डोमेन, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

सक्रिय कुंजी के बिना Ozow चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि होती रहती है।

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

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

चेकआउट पर Ozow नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, Site Code और Private Key भरे हुए हैं, और कार्ट की मुद्रा ZAR है। Payment > Preferences में जाँचें कि मॉड्यूल ZAR, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है। कुछ छूटने पर सेटिंग्स पेज चेतावनी दिखाता है।

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

सूचना का उत्तर 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 डैशबोर्ड में भुगतान जाँचें)। यह उत्तर तब भी आता है जब उसी कार्ट के लिए ग्राहक की वापसी ठीक उसी समय प्रोसेस हो रही थी, या जब ऑर्डर नहीं बन सका; लॉग देखें।

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

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

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Ozow Pay के बगल का मेन्यू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। यदि Delete data on uninstall चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। Ozow भुगतान के रिकॉर्ड और ऑर्डर स्टेटस Awaiting Ozow payment तथा Ozow payment on hold हमेशा रखे जाते हैं, ताकि पुराने ऑर्डरों की देर से आने वाली सूचनाएँ फिर से इंस्टॉल करने के बाद भी पहचानी जाएँ। मौजूदा ऑर्डर अपने भुगतान संदेश और ट्रांज़ैक्शन ID रखते हैं।

Ozow उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Ozow से संबद्ध नहीं है और Ozow द्वारा समर्थित नहीं है।