VibeFox Ozow for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.2 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, स्थापित और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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

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

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

पहुँच योग्य साइट: आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए, बिना maintenance mode, पासवर्ड सुरक्षा या ऐसे firewall के, जो Ozow को रोके, ताकि Ozow की सूचनाएँ पहुँच सकें।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_ozow_pay फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Ozow > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।

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

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

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

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

सामान्य

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

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 के साथ, भुगतान पूरा होने की सूचना देनी चाहिए।

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

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

सूचना, सफलता, रद्द और त्रुटि के URL हर भुगतान पर Ozow को भेजे जाते हैं, इसलिए Ozow डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है, जब तक आपकी Ozow साइट फ़िक्स्ड URL पर सेट न हो। इस सेक्शन में सूचना URL दिखता है। वह ऐसा दिखता है: https://your-site/wc-api/ozow_pay/?ozow_notify=1। यदि आपकी Ozow साइट फ़िक्स्ड URL इस्तेमाल करती है, तो उसे सेटिंग्स में दिखाए गए रूप में ठीक-ठीक कॉपी करें।

उन्नत

Debug log: Log payment requests and Ozow responses विवरण WooCommerce > Status > Logs में, स्रोत wcp_ozow_pay के रूप में लिखता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। कुंजियाँ, हैश और ग्राहक डेटा कभी दर्ज नहीं होते। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept)। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Instant EFT (Ozow)) और ऑर्डर देता है। प्लगइन ग्राहक को ZAR में ऑर्डर कुल के लिए एक साइन किए गए अनुरोध के साथ Ozow के होस्ट किए गए भुगतान पेज पर भेजता है। बैंक स्टेटमेंट का संदर्भ Order और ऑर्डर नंबर है (अधिकतम 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. दिखता है।

यदि ग्राहक Ozow पेज पर रद्द करता है या भुगतान विफल होता है, तो ऑर्डर Failed हो जाता है और ग्राहक Pay for order पेज पर लौट जाता है, जहाँ 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. संदेश होता है। ग्राहक उसी ऑर्डर का भुगतान फिर से कर सकता है।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है (केवल ZAR ऑर्डर के लिए)। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

ऑर्डर

ऑर्डर स्थितियाँ

Pending payment: ग्राहक को Ozow पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Ozow ने भुगतान की पुष्टि अभी नहीं की है।

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

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

Failed: ग्राहक ने भुगतान रद्द किया, भुगतान छोड़ दिया गया, या Ozow ने त्रुटि बताई। ग्राहक ऑर्डर से दोबारा भुगतान कर सकता है।

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

रिफ़ंड

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

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Ozow के ऊपर होता है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key इस्तेमाल करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

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

लाइसेंस की समय-सीमा खत्म होने पर प्लगइन चलता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

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

भुगतान हो गया, पर ऑर्डर Pending payment पर अटका है: Ozow की सूचना स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं आया। जाँचें कि आपकी साइट इंटरनेट से पहुँच योग्य है (कोई maintenance mode, पासवर्ड सुरक्षा या Ozow को रोकने वाला firewall नहीं)। यदि आपकी Ozow साइट फ़िक्स्ड URL पर है, तो जाँचें कि सूचना URL बिल्कुल वही है जो सेटिंग्स में दिखता है। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_ozow_pay देखें।

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

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

सूचना Order mismatch या Order not found का उत्तर देती है: उत्तर इस स्टोर के किसी ऑर्डर का नहीं है। कुछ नहीं बदला जाता।

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

सूचना Order busy का उत्तर देती है: उसी ऑर्डर के लिए कोई दूसरा Ozow उत्तर उसी समय प्रोसेस हो रहा था। यह उत्तर लागू नहीं होता; अगली सूचना या ग्राहक की वापसी उसे लागू करेगी।

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

ग्राहक को Ozow accepts payments in South African rand (ZAR) only दिखता है: ऑर्डर किसी दूसरी मुद्रा में है। इस ऑर्डर के लिए Ozow उपयोग नहीं हो सकता।

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

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

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन आखिरी ज्ञात स्थिति पर चलता रहता है।

अनइंस्टॉल

प्लगइन निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। गेटवे सेटिंग्स, प्लगइन के अन्य विकल्प और उसके लॉग केवल तभी हटते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।

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