VibeFox Nets Nexi for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
Nets खाता: आपको अपने Nets Easy खाते की गोपनीय कुंजियों (टेस्ट और लाइव) की ज़रूरत है। केवल गोपनीय कुंजियाँ उपयोग होती हैं। चेकआउट कुंजियों की ज़रूरत नहीं है, क्योंकि ग्राहक Nets के होस्ट किए गए भुगतान पेज पर भुगतान करते हैं।
मुद्राएँ और भुगतान विधियाँ: एक्सटेंशन स्वयं मुद्राओं को सीमित नहीं करता। अपने Nets खाते में सक्षम मुद्राओं का उपयोग करें; असमर्थित मुद्रा की सूचना भुगतान बनने पर Nets देता है। ग्राहक को कौन-सी भुगतान विधियाँ दिखती हैं, यह आपके Nets अनुबंध, देश और मुद्रा पर निर्भर करता है।
वेबहुक के लिए HTTPS: Nets केवल 256 अक्षरों से कम के, "&" रहित सार्वजनिक HTTPS पते कॉल करता है, इसलिए वेबहुक प्राप्त करने के लिए आपके स्टोर को HTTPS चाहिए। HTTPS न होने पर भी, जब ग्राहक स्टोर पर लौटता है या ऑर्डर पेज पर स्थिति जाँच होती है, तब भुगतान की पुष्टि हो जाती है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_nets_nexi_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_nets_nexi_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_nets_nexi_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर की जगह आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Nets Nexi Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के ऊपर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी अनुभाग)।
4. Nets Easy टेस्ट पोर्टल से टेस्ट गोपनीय कुंजी कॉपी करें और Test Secret Key में चिपकाएँ (देखें कॉन्फ़िगरेशन)। Nets पोर्टल में कुछ भी सेट करने की ज़रूरत नहीं है।
5. Enable/Disable चालू करें, Test Mode चालू रखें, Save पर क्लिक करें और एक टेस्ट ऑर्डर दें। फिर लाइव गोपनीय कुंजी डालें और Test Mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_nets_nexi_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Nets Nexi Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और गोपनीय कुंजियाँ OpenCart 3 के चरण 3 से 5 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल वेबहुक का पता अलग है (देखें Webhooks)।
नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Nets Nexi Gateway > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर, चुने गए मोड की गोपनीय कुंजी न होने पर पेज आपको चेतावनी देता है, उदाहरण के लिए Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set., और टेस्ट मोड चालू होने पर Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।
सहेजते समय Title खाली नहीं हो सकता (128 अक्षरों तक), Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्टेटस मौजूद होने चाहिए; कोई भी फ़ील्ड गलत हो तो कुछ भी सहेजा नहीं जाता।
Nets Nexi (नॉर्डिक देश)
Enable/Disable: Enable Nets Nexi Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट के दौरान ग्राहकों को दिखाया गया भुगतान विधि का शीर्षक। यह ऑर्डर में सहेजा गया भुगतान विधि का नाम भी है। डिफ़ॉल्ट: Nets Easy। आवश्यक।
Description: Confirm Order चरण पर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with Nets Easy।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Nets की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें।
Geo Zone: Nets केवल चुने हुए जियो ज़ोन के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक पहुँचने पर ही Nets दिया जाता है। किसी भी राशि के लिए Nets देने हेतु खाली छोड़ें।
API कुंजियाँ
Nets Easy पोर्टल में Company > Integration के अंतर्गत गोपनीय कुंजियाँ कॉपी करें: टेस्ट कुंजी के लिए टेस्ट पोर्टल (test.portal.dibspayment.eu) और लाइव कुंजी के लिए लाइव पोर्टल (portal.dibspayment.eu)। इस अनुभाग में दोनों पोर्टलों के लिंक हैं। चेकआउट कुंजियों की ज़रूरत नहीं है।
Test Mode: टेस्ट मोड टेस्ट गोपनीय कुंजी के साथ test.api.dibspayment.eu का उपयोग करता है; लाइव मोड लाइव गोपनीय कुंजी के साथ api.dibspayment.eu का उपयोग करता है। किसी ऑर्डर के रिफ़ंड और कैप्चर हमेशा उस वातावरण का उपयोग करते हैं जिसमें भुगतान हुआ था। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहकों को Confirm Order चरण पर Test mode: no real money will be charged. दिखता है।
Test Secret Key: आपकी Nets टेस्ट वातावरण की गोपनीय API कुंजी।
Live Secret Key: आपकी Nets लाइव वातावरण की गोपनीय API कुंजी।
सहेजी गई कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान लिखें जब उसे बदलना हो। सहेजी गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved key on save पर टिक करें और Save पर क्लिक करें।
भुगतान
Webhooks: Nets सूचनाएँ (वेबहुक) हर भुगतान के साथ अपने-आप पंजीकृत होती हैं। Nets पोर्टल में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। फ़ील्ड वह पता दिखाता है जिस पर ये भेजी जाती हैं। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_nets_nexi_gateway/webhook जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_nets_nexi_gateway/payment/wcp_nets_nexi_gateway.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यदि यह सार्वजनिक HTTPS पता नहीं है, तो फ़ील्ड चेतावनी देता है कि स्टोर वेबहुक प्राप्त नहीं करता; तब भुगतान की पुष्टि तब होती है जब ग्राहक स्टोर पर लौटता है, या ऑर्डर पेज पर Nets: check payment status and capture से। ये इवेंट पंजीकृत होते हैं:
हर वेबहुक में वह यादृच्छिक गोपनीय मान होना चाहिए जिसे एक्सटेंशन ने उस भुगतान के लिए बनाया था। सही गोपनीय मान के बिना आने वाले वेबहुक अस्वीकार कर दिए जाते हैं। वेबहुक केवल यह बताता है कि एक्सटेंशन को किस भुगतान में बदलाव हुआ है: भुगतान स्वयं हमेशा उस वातावरण की गोपनीय कुंजी से Nets API से पढ़ा जाता है जिसमें वह बना था।
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (गायब ऑर्डर, missing order)। ऑर्डर को स्टेटस तभी मिलता है जब भुगतान Nets API से वापस पढ़ा जा चुका हो (वेबहुक, ग्राहक की वापसी या ऑर्डर पेज पर Nets: check payment status and capture) और मेल खाता रिज़र्वेशन चार्ज हो चुका हो। नीचे का हर स्टेटस फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order Status After Payment: Nets द्वारा भुगतान की पुष्टि और चार्ज हो जाने के बाद ऑर्डर का स्टेटस। डिफ़ॉल्ट: Processing। भुगतान किए गए ऑर्डरों को पूर्ण के रूप में चिह्नित करने के लिए Complete चुनें।
Nets Payment On Hold Status: राशि या मुद्रा ऑर्डर से अलग है, कैप्चर विफल हुआ है, या ग्राहक ने ऑर्डर रद्द होने के बाद भुगतान किया है। कुछ भी अपने-आप कैप्चर नहीं होता, और एक नोट कारण समझाता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Status: Nets पोर्टल में ऑर्डर का रिज़र्वेशन रद्द होने पर सेट होता है। डिफ़ॉल्ट: Canceled।
Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।
उन्नत
Debug log: API कॉल और भुगतान स्टेटस परिवर्तन OpenCart के लॉग फ़ोल्डर (storage/logs) में nng_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ और ग्राहक का डेटा दर्ज नहीं होते। त्रुटियाँ और चेतावनियाँ बंद होने पर भी हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन को अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के Nets भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।
इंपोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। गोपनीय कुंजियाँ एक्सपोर्ट नहीं होतीं।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई गोपनीय कुंजियाँ बनी रहती हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Nets Easy)। Confirm Order चरण पर ग्राहक आपका विवरण और You will be redirected to the Nets payment page to pay securely. नोट देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल के लिए एक Nets भुगतान बनाता है, उत्पाद, शिपिंग और अन्य ऑर्डर कुल (कूपन, वाउचर, शुल्क) को ऑर्डर लाइनों के रूप में भेजता है, और ग्राहक को Nets के होस्ट किए गए भुगतान पेज पर भेजता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में, भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। Nets पर भुगतान संदर्भ OpenCart ऑर्डर नंबर है। ग्राहक का ईमेल, नाम, शिपिंग पता और फ़ोन नंबर Nets को तब भेजे जाते हैं जब Nets उनका प्रारूप स्वीकार करता है। Nets पेज पर आपके स्टोर के चेकआउट शर्तों वाले पेज का लिंक होता है (यदि सेट न हो तो स्टोर का होम पेज)।
भुगतान करने के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Nets उसकी पुष्टि कर दे: एक्सटेंशन Nets API से भुगतान पढ़ता है, आरक्षित राशि और मुद्रा की ऑर्डर से तुलना करता है, रिज़र्वेशन चार्ज करता है और तभी ऑर्डर स्टेटस सेट करता है। यह वेबहुक या ग्राहक की वापसी, जो भी पहले हो, उस पर होता है। इसके बाद ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। यदि भुगतान की पुष्टि अभी नहीं हो सकी (Nets तक पहुँच नहीं हो सकी, या उसी समय कोई दूसरा अनुरोध उसकी पुष्टि कर रहा था), तो एक Payment confirmation पेज Your Nets payment is being confirmed. Your order will be updated as soon as it is confirmed — please do not pay again. दिखाता है, साथ में Check again और Back to checkout बटन।
यदि ग्राहक Nets पेज पर रद्द करता है, तो वह The Nets payment was cancelled. You can try again or choose another payment method. के साथ चेकआउट पर लौटता है। यदि कुछ भी भुगतान नहीं हुआ, तो संदेश The payment was not completed. You can try again or choose another payment method. होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। कार्ट सुरक्षित रहता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, जबकि OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर के लिए एक नया Nets भुगतान बनाता है। नए प्रयास पर एक्सटेंशन पहले कार्ट के पिछले भुगतान जाँचता है; यदि उनमें से कोई पहले ही भुगतान हो चुका है, तो नया भुगतान शुरू करने के बजाय वही ऑर्डर पक्का किया जाता है। अन्यथा नया Nets सत्र शुरू होने से पहले पिछले Nets सत्र बंद किए जाते हैं। यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ या होल्ड पर है, तो ग्राहक सफलता पेज पर जाता है।
OpenCart 4 सफलता पेज दिखाए जाने तक चेकआउट में ऑर्डर रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया, या Nets पोर्टल में रिज़र्वेशन रद्द करने के बाद), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है, ग्राहक के Nets से लौटने पर भी, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। कार्ट का वह ऑर्डर जो भुगतान होने के बाद रद्द या रिफ़ंड हुआ, अब कार्ट को नहीं रोकता।
यदि Nets भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर एक छोटे संदेश के साथ रहता है, उदाहरण के लिए Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method., This payment method is temporarily unavailable. Please choose another payment method., या The payment service could not be reached. Please try again in a moment. ऑर्डर कुल शून्य होने पर The order total must be greater than zero to pay with Nets. दिखता है। विवरण लॉग में लिखे जाते हैं।
वेबहुक तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है, जो ग्राहक के Nets से लौटने को भी संभव बनाता है।
एक्सटेंशन केवल होस्ट किए गए भुगतान पेज का उपयोग करता है। इसमें पेज पर एम्बेडेड Nets चेकआउट, सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, इनवॉइस शुल्क, केवल-ऑथराइज़ मोड और प्रति शिपमेंट आंशिक कैप्चर नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
No status (missing order): ग्राहक को Nets पर भेजा गया और उसने भुगतान नहीं किया, या भुगतान की अभी पुष्टि नहीं हुई है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो।
Order Status After Payment (default Processing): Nets ने भुगतान की पुष्टि करके उसे चार्ज कर दिया है। एक नोट भुगतान ID, चार्ज ID और भुगतान विधि दिखाता है।
Nets Payment On Hold Status (default Pending): Nets पर राशि या मुद्रा ऑर्डर से अलग है (कैप्चर नहीं हुआ), कैप्चर अस्वीकार हुआ, या ग्राहक ने ऑर्डर रद्द होने के बाद भुगतान किया (रिज़र्व हुआ, कैप्चर नहीं हुआ)। नोट इसे समझाता है। कुछ भी अपने-आप कैप्चर नहीं होता। ऑर्डर की समीक्षा के बाद Nets: check payment status and capture से कैप्चर करें, या Nets पोर्टल में रिज़र्वेशन रद्द करें।
Cancelled Status (default Canceled): ऑर्डर का रिज़र्वेशन रद्द हो गया है, उदाहरण के लिए Nets पोर्टल में।
Refunded Status (default Refunded): एक्सटेंशन के माध्यम से भुगतान पूरी तरह रिफ़ंड हो गया है।
जब कोई वेबहुक या ग्राहक की वापसी किसी ऑर्डर को होल्ड स्टेटस से भुगतान किए गए स्टेटस में ले जाती है या उसे रद्द करती है, तो OpenCart ग्राहक को सूचित करता है। बार-बार आने वाले वेबहुक और पेज रीलोड कभी दोबारा चार्ज नहीं करते और डुप्लिकेट नोट नहीं जोड़ते, और भुगतान किया हुआ ऑर्डर Nets इवेंट्स से दोबारा कभी नहीं बदला जाता। यदि पहले से भुगतान किए गए ऑर्डर के लिए, या उसी कार्ट के किसी दूसरे ऑर्डर के लिए, कोई पुराना भुगतान लिंक पूरा होता है, तो दूसरा रिज़र्वेशन अपने-आप छोड़ दिया जाता है; यदि वह पहले ही चार्ज हो चुका था, तो एक नोट आपसे Nets पोर्टल में उसे रिफ़ंड करने के लिए कहता है। यदि ऑर्डर किसी और तरीके से भुगतान किया हुआ चिह्नित किया गया था, तो रिज़र्व किया गया Nets भुगतान कैप्चर नहीं होता और एक नोट यह बताता है।
नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Nets Nexi Gateway टैब
Sales > Orders में Nets से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Nets Nexi Gateway टैब Nets Easy payment ब्लॉक दिखाता है: भुगतान ID, चार्ज ID, वातावरण (टेस्ट भुगतानों के लिए Test environment लेबल के साथ), स्टेटस और भुगतान विधि, Nets पर रिज़र्व और चार्ज की गई राशियाँ, ऑर्डर कुल और रिफ़ंड की गई राशि, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Nets notes। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन तक पहुँच है; इसके बटनों के लिए एक्सटेंशन बदलने का अधिकार चाहिए (जो System > Users > User Groups में सेट होता है)।
Nets: check payment status and capture: उन ऑर्डरों के लिए दिखता है जो अभी भुगतान नहीं हुए हैं। यह Nets से भुगतान पढ़ता है और ऑर्डर से मेल खाता रिज़र्वेशन कैप्चर करता है, कैप्चर विफल होने के बाद या होल्ड पर किसी ऑर्डर की समीक्षा के बाद भी। यदि कुछ नहीं बदलता, तो एक नोट कारण समझाता है, उदाहरण के लिए कि ग्राहक ने अभी भुगतान पूरा नहीं किया है। इस बटन द्वारा सेट किया गया स्टेटस, जैसे रिफ़ंड द्वारा सेट किया गया स्टेटस, सीधे मैन्युअल स्टेटस बदलाव के रूप में बदला जाता है, बिना ईमेल और स्टॉक गतिविधि के।
रिफ़ंड
टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भरी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Nets पर क्लिक करें। प्रश्न Refund this amount through Nets? This cannot be undone. की पुष्टि करें। भुगतान चार्ज होने के बाद ऑर्डर कुल तक पूर्ण और आंशिक रिफ़ंड समर्थित हैं; केवल रिज़र्व किए गए भुगतान को Nets पोर्टल में रद्द किया जा सकता है। रिफ़ंड उस वातावरण में ऑर्डर के चार्ज पर जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण की गोपनीय कुंजी सेट होनी चाहिए। यदि Nets रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड, Nets रिफ़ंड ID के साथ, रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है; आंशिक रिफ़ंड स्टेटस नहीं बदलता।
Sales > Returns में उत्पाद वापसी Nets के माध्यम से पैसा वापस नहीं भेजती। Nets पोर्टल में किए गए रिफ़ंड सिंक्रोनाइज़ नहीं होते; ज़रूरत हो तो ऑर्डर को मैन्युअल रूप से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Nets Nexi Gateway, Extensions > Extensions > Payments > VibeFox Nets Nexi Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्टेटस (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन: स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-nets-nexi वाली पंक्ति और वह लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Nets नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक This payment method is not available. Please choose another one. देखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को भुगतान विधि स्टोर में (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट कर सकें और परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पक्के होते हैं, और रिफ़ंड काम करते हैं।
लाइसेंस की समाप्ति पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन को अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर Nets Nexi दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए मोड में गोपनीय कुंजी है: टेस्ट मोड में Test Secret Key, लाइव मोड में Live Secret Key। कुंजी न होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्टेटस के रहता है: वेबहुक आपके स्टोर तक नहीं पहुँचा। जाँचें कि स्टोर HTTPS का उपयोग करता है, ताकि Webhooks का पता सार्वजनिक HTTPS पता हो, और भुगतान के वातावरण की गोपनीय कुंजी सेट है। भुगतान के बाद ग्राहक स्टोर पर लौटने पर, या ऑर्डर टैब में Nets: check payment status and capture से भी ऑर्डर को स्टेटस मिलता है।
वेबहुक Unauthorized उत्तर देता है: वेबहुक में उस भुगतान का गोपनीय मान नहीं था। वेबहुक केवल उस गोपनीय मान के साथ स्वीकार होते हैं जो भुगतान के साथ पंजीकृत हुआ था।
वेबहुक Unknown payment उत्तर देता है: वह भुगतान इस स्टोर द्वारा नहीं बनाया गया था।
वेबहुक Busy, retry later, Payment lookup failed या Payment not reserved yet उत्तर देता है: कोई दूसरा अनुरोध उसी कार्ट की पुष्टि कर रहा था, Nets API तक पहुँच नहीं हो सकी, या रिज़र्वेशन अभी दिख नहीं रहा था। Nets वेबहुक को अपने-आप दोबारा भेजता है।
वेबहुक Order could not be updated, retry later उत्तर देता है: ऑर्डर स्टेटस सेट नहीं हो सका। Nets वेबहुक को दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।
ब्राउज़र में वेबहुक URL Method not allowed दिखाता है: यह सामान्य है। यह पता केवल Nets के अनुरोध स्वीकार करता है।
ग्राहक Confirm Order के बाद त्रुटि देखता है: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is temporarily unavailable. Please choose another payment method. आमतौर पर गलत या गायब गोपनीय कुंजी का संकेत देता है। अस्वीकृत मुद्रा की सूचना Nets लॉग में देता है। This payment method is not available. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई: ग्राहक चेकआउट को रीलोड करता है।
ग्राहक को We could not match this payment to an order दिखता है: वापसी का लिंक अधूरा है या किसी दूसरे ऑर्डर का है। यदि ग्राहक से शुल्क लिया गया है, तो Nets पोर्टल में भुगतान खोजें और ऑर्डर जाँचें।
भुगतान के बाद ऑर्डर होल्ड स्टेटस में है: टैब में Nets notes पढ़ें। यदि कैप्चर अस्वीकार हुआ, तो Nets: check payment status and capture से फिर कोशिश करें या Nets पोर्टल में चार्ज करें। यदि राशि या मुद्रा अलग है, तो Nets पोर्टल में भुगतान जाँचें। यदि ग्राहक ने रद्द होने के बाद भुगतान किया है, तो ऑर्डर की समीक्षा करें और रिज़र्वेशन कैप्चर या रद्द करें।
Refund via Nets गायब है या विफल होता है: रिफ़ंड केवल भुगतान चार्ज होने के बाद संभव हैं; तब टैब एक चार्ज ID दिखाता है। रिफ़ंड उस वातावरण की गोपनीय कुंजी का उपयोग करता है जिसमें ऑर्डर का भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए; अन्यथा टैब बताता है कि किस वातावरण की कुंजी गायब है।
डेवलपर्स के लिए: भुगतान बनने से पहले एक्सटेंशन अनुरोध बॉडी और ऑर्डर के साथ OpenCart इवेंट nng_create_payment_payload चलाता है; nng_currency_decimals किसी मुद्रा के दशमलव स्थान बदलता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Nets Nexi Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Payment अनुभाग के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। OpenCart 4 पर एक्सटेंशन के इवेंट और उसका स्टार्टअप एक्शन, जो मेंटेनेंस मोड में वेबहुक को गुजरने देता है, भी हटा दिए जाते हैं। यदि Delete Data on Uninstall चालू है, तो गेटवे की बाकी सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, गोपनीय कुंजियाँ, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। ऑर्डरों का Nets भुगतान डेटा (भुगतान, चार्ज और रिफ़ंड) हमेशा रखा जाता है, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल की गई एक्सटेंशन की सूची में VibeFox Nets Nexi Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल कूड़ेदान बटन) पर क्लिक करें।
Nets, Nets Easy और Nexi अपने-अपने स्वामियों के ट्रेडमार्क हैं। यह एक्सटेंशन Nets या Nexi से संबद्ध नहीं है और उनके द्वारा समर्थित नहीं है।