VibeFox Niubiz for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: पेरूवियन सोल (PEN) या US डॉलर (USD) को System > Localisation > Currencies में सक्षम होना चाहिए। भुगतान विधि केवल तभी दी जाती है जब ग्राहक इन मुद्राओं में से किसी एक में भुगतान करता है। अन्य मुद्राओं के लिए यह चेकआउट पर छिपी रहती है।
Niubiz खाता: Niubiz हर वातावरण के लिए एक मर्चेंट ID (código de comercio), एक API उपयोगकर्ता और एक API पासवर्ड जारी करता है। सैंडबॉक्स क्रेडेंशियल Niubiz की इंटीग्रेशन टीम से मिलते हैं, और प्रोडक्शन क्रेडेंशियल तब मिलते हैं जब Niubiz आपके इंटीग्रेशन को प्रमाणित कर देता है। किसी वेबहुक को सेट करने की ज़रूरत नहीं है: Niubiz प्राधिकरण का उत्तर तुरंत देता है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_niubiz_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_niubiz_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_niubiz_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Niubiz Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी पेस्ट करें और Activate पर क्लिक करें (देखें License key)।
4. Sandbox mode चालू रखें और सैंडबॉक्स मर्चेंट ID, API उपयोगकर्ता और API पासवर्ड दर्ज करें (देखें Configuration)।
5. Enable/Disable चालू करें, Save पर क्लिक करें और Niubiz के टेस्ट कार्ड से कुछ टेस्ट भुगतान करें।
6. Niubiz द्वारा आपके इंटीग्रेशन को प्रमाणित करने के बाद, प्रोडक्शन क्रेडेंशियल दर्ज करें और Sandbox mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_niubiz_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Niubiz Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और Niubiz क्रेडेंशियल दर्ज करें, और OpenCart 3 के चरण 3 से 6 की तरह भुगतान का परीक्षण करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
नई इंस्टॉलेशन में भुगतान विधि बंद और सैंडबॉक्स मोड चालू होकर शुरू होती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Niubiz Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है यदि स्टोर में कोई PEN या USD मुद्रा सक्षम नहीं है, या यदि वर्तमान मोड के क्रेडेंशियल अधूरे हैं (दोनों ही स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है)। यदि स्टोर की डिफ़ॉल्ट मुद्रा PEN या USD नहीं है, तो पेज बताता है कि Niubiz केवल तभी दिया जाता है जब ग्राहक PEN या USD में भुगतान करे। जब तक सैंडबॉक्स मोड चालू है, पेज पर Sandbox mode is on: payments go to the Niubiz sandbox and no real charges are made. दिखता है। एक्सटेंशन में संशोधन करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय गलत मान सेव नहीं होता: सेटिंग्स के ऊपर एक त्रुटि दिखती है, वह फ़ील्ड अपने पिछले मान पर लौट जाता है, और बाकी फ़ील्ड सेव हो जाते हैं। यह खाली या 128 अक्षरों से लंबे Title, केवल अंकों से न बने मर्चेंट ID, https:// से शुरू न होने वाले लोगो URL, पूर्ण संख्या न होने वाले Sort Order, और 0 या उससे बड़ी संख्या न होने वाले Total पर लागू होता है।
Niubiz
Enable/Disable: Niubiz भुगतान चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। डिफ़ॉल्ट: Credit or debit card (Niubiz)। आवश्यक, 128 अक्षरों तक।
Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Niubiz की स्थिति। खाली छोड़ें या कोई पूर्ण संख्या दर्ज करें।
Geo Zone: Niubiz केवल चुने गए geo zone के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, यदि स्टोर भुगतान पता नहीं माँगता, तो शिपिंग पता इस्तेमाल होता है।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक ऑर्डर पहुँचने पर ही Niubiz दिया जाता है। किसी भी राशि पर Niubiz देने के लिए इसे खाली छोड़ें।
Niubiz क्रेडेंशियल
Niubiz सैंडबॉक्स (QA) के लिए, और प्रमाणन के बाद प्रोडक्शन के लिए, एक मर्चेंट ID, एक API उपयोगकर्ता और एक API पासवर्ड देता है। जो भुगतान पहले से शुरू हो चुका है, वह हमेशा अपने मोड के क्रेडेंशियल से ही प्राधिकृत होता है।
Sandbox mode: Niubiz सैंडबॉक्स का उपयोग करता है, बिना किसी वास्तविक शुल्क के। यह API एंडपॉइंट और नीचे दिए गए क्रेडेंशियल सेट, दोनों को बदल देता है। डिफ़ॉल्ट: on। प्रोडक्शन क्रेडेंशियल से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण और भुगतान पेज पर SANDBOX MODE: use Niubiz test cards — no real charges are made. देखते हैं।
Sandbox merchant ID: आपके सैंडबॉक्स खाते का मर्चेंट कोड (código de comercio), केवल अंक। खाली स्थान हटा दिए जाते हैं।
Sandbox API user: सैंडबॉक्स का API उपयोगकर्ता, आमतौर पर एक ईमेल पता।
Sandbox API password: सैंडबॉक्स का API पासवर्ड।
Production merchant ID: आपके प्रोडक्शन (संबद्ध) खाते का मर्चेंट कोड, केवल अंक।
Production API user: प्रोडक्शन का API उपयोगकर्ता।
Production API password: प्रोडक्शन का API पासवर्ड।
सेव किए गए API पासवर्ड फिर कभी नहीं दिखाए जाते और न ही ब्राउज़र को भेजे जाते हैं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया गया पासवर्ड हटाने के लिए फ़ील्ड के नीचे Clear the saved password on save चेक करें और Save पर क्लिक करें।
भुगतान फ़ॉर्म
Logo URL: Niubiz भुगतान फ़ॉर्म में दिखने वाले आपके लोगो का वैकल्पिक पता। यह https:// पता होना चाहिए। स्टोर का नाम दिखाने के लिए इसे खाली छोड़ें।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति (एक लापता ऑर्डर) के बनाता है। ऑर्डर को स्थिति तभी मिलती है जब Niubiz ने प्राधिकरण का उत्तर दे दिया हो। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।
Order Status After Payment: Niubiz ने भुगतान स्वीकृत किया है, और खरीद संख्या, राशि और मुद्रा ऑर्डर से मेल खाती हैं। डिफ़ॉल्ट: Processing।
On Hold Status: Niubiz ने ऐसा भुगतान स्वीकृत किया जो ऑर्डर से मेल नहीं खाता, या कोई निश्चित उत्तर नहीं दिया, इसलिए कार्ड पर शुल्क लिया गया हो सकता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
उन्नत
Debug log: Niubiz API अनुरोध और भुगतान के चरण OpenCart के लॉग फ़ोल्डर (storage/logs) में niubiz_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB होने पर इसे niubiz_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं, भले ही यह स्विच बंद हो। पासवर्ड, टोकन, और कार्ड या ग्राहक का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: off।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर के Niubiz भुगतान विवरण (खरीद संख्याएँ, लेन-देन ID) हमेशा रखे जाते हैं। डिफ़ॉल्ट: off।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API पासवर्ड निर्यात नहीं होते।
Import: पहले निर्यात किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए API पासवर्ड बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit or debit card (Niubiz))। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will complete the payment in the secure Niubiz payment form. OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में, भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए Niubiz से एक्सेस टोकन और भुगतान सेशन माँगता है, और आपके स्टोर का Niubiz payment पेज खोलता है। यदि सेशन नहीं बन पाता, तो ग्राहक एक संक्षिप्त संदेश के साथ Confirm Order चरण पर ही रहता है, जैसे We could not connect to Niubiz. Please try again in a few minutes.
भुगतान पेज पर Niubiz भुगतान फ़ॉर्म अपने-आप खुल जाता है। पेज कहता है: Complete the payment in the secure Niubiz payment form — your card details are entered on Niubiz, not on this site. इसमें ऑर्डर कुल वाला एक Pay बटन भी है, जिससे फ़ॉर्म फिर से खुलता है, और चेकआउट पर वापस जाने के लिए Choose another payment method लिंक भी है। JavaScript आवश्यक है। यदि Niubiz फ़ॉर्म लोड नहीं हो पाता, तो पेज The Niubiz payment form could not be loaded. Please reload the page or try again later. दिखाता है।
ग्राहक Niubiz फ़ॉर्म में कार्ड दर्ज करता है। Niubiz आपके स्टोर को एक बार उपयोग होने वाला टोकन लौटाता है, और एक्सटेंशन उसे सर्वर पर सेशन की राशि, मुद्रा और खरीद संख्या के साथ प्राधिकृत करता है, उसी वातावरण में जिसमें सेशन बना था। भुगतान तुरंत लिया जाता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Niubiz उसकी पुष्टि करता है और उत्तर ऑर्डर से मेल खाता है। इसके बाद ऑर्डर OpenCart के सामान्य तरीके से अपनी स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है।
कार्ड अस्वीकृत: ऑर्डर बिना स्थिति के रहता है और उसमें एक नोट जुड़ जाता है। ग्राहक Your payment was declined: और Niubiz से मिले कारण के साथ भुगतान पेज पर लौटता है, और उसी या किसी दूसरे कार्ड से फिर कोशिश कर सकता है। फ़ॉर्म संदेश के ऊपर दोबारा नहीं खुलता; ग्राहक Pay पर क्लिक करता है।
Niubiz से कोई उत्तर नहीं: यदि Niubiz कोई निश्चित उत्तर नहीं देता (समय सीमा, सर्वर त्रुटि, न पढ़ा जा सकने वाला उत्तर), तो ऑर्डर को On Hold Status मिलता है और सफलता पेज पर We could not confirm your payment with Niubiz. Please do not pay again — the store will verify the payment and contact you. दिखता है। यदि Niubiz ने ऐसा भुगतान स्वीकृत किया जो ऑर्डर से मेल नहीं खाता, तो सफलता पेज पर Your payment was received and is being reviewed by the store. We will contact you if anything else is needed. दिखता है।
अनुरोध अस्वीकृत: यदि Niubiz स्वयं अनुरोध को अस्वीकार करता है (उदाहरण के लिए अमान्य क्रेडेंशियल या डुप्लिकेट खरीद संख्या), तो ऑर्डर बिना स्थिति के रहता है, एक नोट जुड़ता है, और ग्राहक Niubiz could not process the payment and your card was not charged. देखता है। यदि उसी समय Niubiz API तक पहुँच नहीं हो पाती, तो ग्राहक We could not connect to Niubiz and your card was not charged. Please try again in a few minutes. देखता है।
ऑर्डर बदल गया: यदि फ़ॉर्म सबमिट होने के समय ऑर्डर कुल सेशन से मेल नहीं खाता, तो भुगतान प्राधिकृत नहीं होता, और ग्राहक Your order total has changed since the payment form was opened, so your card was not charged. Please check the total and pay again. देखता है।
सेशन की समय सीमा समाप्त: Niubiz भुगतान सेशन अधिकतम 20 मिनट तक वैध रहता है। जब वह पहले ही उपयोग हो चुका हो, उसमें 5 मिनट से कम बचे हों, वह किसी दूसरे मोड या मर्चेंट ID का हो, या ऑर्डर कुल बदल गया हो, तो भुगतान पेज नया सेशन बनाता है।
हर भुगतान प्रयास को नई खरीद संख्या मिलती है: ऑर्डर संख्या के बाद तीन अंकों की प्रयास संख्या, क्योंकि Niubiz हर प्राधिकरण के लिए एक अनोखी खरीद संख्या माँगता है। हर बार Confirm Order चरण दिखने पर OpenCart 3 एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए कार्ड अस्वीकृत होने के बाद ग्राहक नई खरीद संख्या के साथ वही ऑर्डर फिर से भुगतान करता है। जो कार्ट पहले से भुगतान किया जा चुका है, उसका फिर से भुगतान नहीं होता: ग्राहक को उसके बजाय भुगतान किए गए ऑर्डर के सफलता पेज पर ले जाया जाता है।
OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज नहीं दिखाया जाता। यदि इस बीच वह ऑर्डर बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक को Your previous order was cancelled or its payment failed. Please confirm the order again. संदेश के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। यदि उस ऑर्डर को पहले से कोई स्थिति मिल चुकी है और कार्ट में अब अन्य उत्पाद या मात्राएँ हैं, तो संदेश है: Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. OpenCart 4 पर वे संदेश जो ग्राहक को चेकआउट पर वापस भेजते हैं, जैसे The Niubiz payment could not be found. Please confirm your order again., चेकआउट पेज के ऊपर दिखाए जाते हैं।
भुगतान पेज, Niubiz फ़ॉर्म का उत्तर और स्टोर पर वापसी मेंटेनेंस मोड में भी काम करते हैं: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को गुज़रने देता है, और OpenCart 4 पर एक्सटेंशन इनके लिए एक स्टार्टअप ऐक्शन जोड़ता है।
एक्सटेंशन केवल एकबारगी कार्ड भुगतान लेता है। इसमें OpenCart से रिफ़ंड या रद्दीकरण नहीं होते, सहेजे गए कार्ड, सदस्यता या आवर्ती भुगतान नहीं होते, किस्तों (cuotas) का चयन नहीं होता, और PagoEfectivo, Yape या अन्य वॉलेट और QR भुगतान नहीं होते। उत्तर खो जाने के कारण रोके गए ऑर्डरों की स्वतः दोबारा जाँच नहीं होती।
ऑर्डर
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक भुगतान पेज पर है और उसने भुगतान नहीं किया है, या कार्ड अस्वीकृत हुआ है, या अनुरोध अस्वीकृत हुआ है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। अस्वीकृतियाँ और इनकार ऑर्डर नोट्स में जोड़े जाते हैं।
OpenCart 4 पर चेकआउट का एक बिना भुगतान वाला ऑर्डर स्थिति Voided पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का भुगतान उसकी पुष्टि करता है।
Order Status After Payment (डिफ़ॉल्ट Processing): Niubiz ने भुगतान स्वीकृत किया और उत्तर ऑर्डर से मेल खाया। एक नोट में वातावरण, लेन-देन ID, प्राधिकरण कोड, खरीद संख्या और मास्क्ड कार्ड नंबर के साथ कार्ड ब्रांड दिखते हैं।
On Hold Status (डिफ़ॉल्ट Pending), स्वीकृत लेकिन मेल नहीं खाता: Niubiz ने ऐसा भुगतान स्वीकृत किया जिसकी खरीद संख्या, राशि या मुद्रा ऑर्डर से भिन्न है, या जिसके उत्तर में राशि या मुद्रा नहीं है। ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता। नोट में अंतर सूचीबद्ध होते हैं। Niubiz कंसोल में लेन-देन की जाँच करें।
On Hold Status (डिफ़ॉल्ट Pending), कोई निश्चित उत्तर नहीं: Niubiz ने स्पष्ट उत्तर नहीं दिया, इसलिए कार्ड पर शुल्क लिया गया हो सकता है। नोट में खरीद संख्या दी होती है। Niubiz कंसोल में उसे खोजें: यदि लेन-देन स्वीकृत और सही है, तो ऑर्डर को भुगतान किए गए स्थिति में सेट करें; अन्यथा उसे रद्द करें।
यदि पहले से भुगतान किए गए कार्ट के लिए दूसरे भुगतान का उत्तर आता है, तो कोई दूसरी स्थिति सेट नहीं होती। भुगतान किए गए ऑर्डर पर एक नोट खरीद संख्या, लेन-देन ID और राशि देता है, ताकि आप उसे Niubiz कंसोल में जाँच सकें और आवश्यकता होने पर रिफ़ंड या void कर सकें।
नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Niubiz Payment टैब
Sales > Orders में Niubiz से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के साथ, VibeFox Niubiz Payment टैब में खरीद संख्या, वातावरण (सैंडबॉक्स या प्रोडक्शन), Niubiz answer, लेन-देन ID, प्राधिकरण कोड, कार्ड, राशि (और Niubiz द्वारा स्वीकृत राशि), मिली समस्याएँ, प्रयासों की संख्या और ऑर्डर के Niubiz notes दिखते हैं। रोके गए (on hold) स्थिति वाले ऑर्डर के लिए यह टैब आपको Niubiz कंसोल में खरीद संख्या जाँचने की याद दिलाता है। यह टैब केवल-पढ़ने योग्य है और एक्सटेंशन तक पहुँच रखने वाले उपयोगकर्ताओं को दिखता है।
रिफ़ंड
रिफ़ंड और रद्दीकरण OpenCart से उपलब्ध नहीं हैं। Niubiz कंसोल में लेन-देन का रिफ़ंड या void करें और ऑर्डर की स्थिति को मैन्युअली अपडेट करें। Sales > Returns में उत्पाद वापसी से Niubiz के ज़रिए पैसे वापस नहीं जाते।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Niubiz Payment, Extensions > Extensions > Payments > VibeFox Niubiz Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क्ड रूप में, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-niubiz की पंक्ति और आपके 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर Niubiz ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में अब भी भुगतान विधि दिखती है, जिस पर (unlicensed — visible to admins only) का चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। एक बार Edit पेज खोलने के बाद, एडमिन के Dashboard पर एक रिमाइंडर दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हो चुके भुगतानों की पुष्टि अब भी होती है।
जब लाइसेंस की अवधि समाप्त होती है, तो एक्सटेंशन चलता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन का Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। कोई cron जॉब आवश्यक नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं।
समस्या निवारण
चेकआउट पर Niubiz दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड के मर्चेंट ID, API उपयोगकर्ता और API पासवर्ड भरे हुए हैं (सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, अन्यथा प्रोडक्शन फ़ील्ड), और ग्राहक PEN या USD में भुगतान करता है। जब क्रेडेंशियल या मुद्राएँ गलत होती हैं, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहता है: Niubiz के पास इस भुगतान फ़ॉर्म के लिए कोई वेबहुक नहीं है, इसलिए ऑर्डर को स्थिति केवल प्राधिकरण के उत्तर से मिलती है। यदि ग्राहक ने फ़ॉर्म पूरा नहीं किया, तो कुछ भी भुगतान नहीं हुआ। अन्यथा एक्सटेंशन पेज पर Log फ़ील्ड देखें और Niubiz कंसोल में खरीद संख्या खोजें। यदि Niubiz ने उत्तर दिया लेकिन स्थिति सेट नहीं हो पाई, तो ग्राहक को Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. दिखता है, और जब ग्राहक भुगतान पेज खोलता है या कार्ट फिर से पुष्टि करता है, तो एक्सटेंशन स्थिति सेट करने का फिर से प्रयास करता है।
ग्राहक को We could not connect to Niubiz दिखता है: एक्सेस टोकन प्राप्त नहीं हो सका। वर्तमान मोड का API उपयोगकर्ता और API पासवर्ड, और यह कि आपका सर्वर Niubiz API तक पहुँच सकता है या नहीं, जाँचें। विवरण के लिए Debug log चालू करें।
ग्राहक को We could not start the Niubiz payment दिखता है: Niubiz ने भुगतान सेशन नहीं बनाया। वर्तमान मोड का मर्चेंट ID और लॉग जाँचें।
ग्राहक को This payment attempt was already processed दिखता है: वही फ़ॉर्म दो बार सबमिट हुआ। ग्राहक भुगतान पेज पर भुगतान फिर से शुरू करता है; कार्ड दो बार नहीं लिया जाता।
ग्राहक को This order is already being paid दिखता है: उसी क्षण कोई दूसरा अनुरोध उसी कार्ट को प्राधिकृत कर रहा है। ग्राहक थोड़ी देर रुकता है और फिर से कोशिश करने से पहले ईमेल देखता है।
एक नोट कहता है कि Niubiz ने डुप्लिकेट प्राधिकरण की रिपोर्ट की: Niubiz इस खरीद संख्या को पहले से जानता है। Niubiz कंसोल में जाँचें; ग्राहक नई खरीद संख्या के साथ फिर से कोशिश कर सकता है।
ऑर्डर on hold स्थिति में है: VibeFox Niubiz Payment टैब के नोट पढ़ें। Niubiz ने निश्चित उत्तर नहीं दिया, या ऐसा भुगतान स्वीकृत किया जो ऑर्डर से मेल नहीं खाता। Niubiz कंसोल में खरीद संख्या खोजें और ऑर्डर को भुगतान किए गए स्थिति में सेट करें या रद्द करें।
सेटिंग्स सेव करते समय त्रुटि: मर्चेंट ID में केवल अंक होने चाहिए, लोगो URL एक मान्य https:// पता होना चाहिए, और शीर्षक खाली नहीं होना चाहिए या 128 अक्षरों से लंबा नहीं होना चाहिए। पिछला मान बना रहता है।
डेवलपर्स के लिए: यदि Niubiz मर्चेंट-विशिष्ट एंटी-फ़्रॉड फ़ील्ड (MDD) भेजने के लिए कहता है, तो कोई दूसरा एक्सटेंशन OpenCart इवेंट niubiz_p_merchant_define_data के साथ उन्हें जोड़ सकता है। भुगतान सेशन के साथ भेजा गया कार्डधारक डेटा इवेंट niubiz_p_cardholder_data से बदला जा सकता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Niubiz Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप ऐक्शन भी, जो मेंटेनेंस मोड में भुगतान पेज, Niubiz फ़ॉर्म के उत्तर और स्टोर पर वापसी को गुज़रने देता है)। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, क्रेडेंशियल, लोगो, लॉगिंग विकल्प) और लॉग हटा दिए जाते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Niubiz भुगतान प्रयास (खरीद संख्याएँ, वातावरण, लेन-देन ID) हमेशा भुगतान इतिहास के रूप में रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल की गई एक्सटेंशन की सूची में VibeFox Niubiz Payment के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Niubiz अपने संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Niubiz से संबद्ध नहीं है और Niubiz द्वारा समर्थित नहीं है।