VibeFox Netopia for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, OpenSSL, DOM और SimpleXML एक्सटेंशन के साथ।

मुद्रा: ग्राहक को RON, EUR, USD या GBP में चेकआउट करना होगा। EUR, USD और GBP आपके Netopia खाते में सक्षम होने चाहिए। अन्य मुद्राओं के लिए चेकआउट पर यह भुगतान विधि छिपी रहती है। ऑर्डर का भुगतान उसकी अपनी मुद्रा में लिया जाता है।

Netopia खाता: आपको एक पॉइंट ऑफ़ सेल वाला Netopia Payments सेलर खाता चाहिए। उसकी तकनीकी सेटिंग्स से आपको खाता हस्ताक्षर और, हर उस एनवायरनमेंट के लिए जिसका आप उपयोग करते हैं (सैंडबॉक्स और लाइव), सार्वजनिक प्रमाणपत्र (.cer) व निजी कुंजी (.key) चाहिए। Netopia की ओर कुछ सेट करने की ज़रूरत नहीं है: IPN का पता हर भुगतान अनुरोध के साथ भेजा जाता है।

सार्वजनिक स्टोर: IPN (पुष्टि) URL इंटरनेट से पहुँच योग्य होना चाहिए, लॉगिन, बेसिक ऑथेंटिकेशन या फ़ायरवॉल के पीछे नहीं। ऑर्डर को अपनी स्थिति केवल Netopia IPN से मिलती है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

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

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Netopia Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर पेज चेतावनी देता है कि सक्रिय एनवायरनमेंट का खाता हस्ताक्षर, प्रमाणपत्र या निजी कुंजी गायब है (तब भुगतान विधि चेकआउट पर छिपी रहती है), और टेस्ट मोड चालू होने पर Test mode is on: payments go to the Netopia sandbox and no real money is charged. दिखाता है। एक्सटेंशन को बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title अधिकतम 128 अक्षरों का हो सकता है, Sort order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Minimum total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; इनमें से कुछ भी गलत हो, तो कुछ भी सेव नहीं होता। गलत प्रमाणपत्र या निजी कुंजी लाल त्रुटि के साथ अस्वीकार की जाती है और पिछला मान बना रहता है, जबकि अन्य फ़ील्ड सेव हो जाते हैं (Settings saved, except the values shown in red.)। यदि भुगतान विधि चालू है पर सक्रिय एनवायरनमेंट अधूरा है, तो सेव करते समय चेतावनी दिखती है।

IPN (पुष्टि) URL

पहला सेक्शन IPN (confirm) URL को केवल-पढ़ने योग्य रूप में दिखाता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_netopia_gateway/notify, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_netopia_gateway/payment/wcp_netopia_gateway.notify। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह हर भुगतान अनुरोध के साथ पुष्टि URL के रूप में भेजा जाता है, इसलिए इसे Netopia एडमिन में दर्ज करने की ज़रूरत नहीं है। Netopia IPN इसी URL पर भेजता है। एक्सटेंशन इसे उस एनवायरनमेंट की निजी कुंजी से डिक्रिप्ट करता है जिसमें भुगतान शुरू हुआ था, और आपके खाता हस्ताक्षर तथा भुगतान अनुरोध की जाँच करता है। Netopia ये कार्रवाइयाँ रिपोर्ट करता है:

Netopia त्रुटि कोड वाली सूचना (जैसे कार्ड अस्वीकृत) लंबित ऑर्डर को भुगतान त्रुटि स्टेटस पर सेट करती है; बिना स्टेटस वाला ऑर्डर बिना स्टेटस के रहता है और ग्राहक फिर से भुगतान कर सकता है। जो सूचनाएँ डिक्रिप्ट नहीं हो सकतीं, जिनमें कोई अन्य खाता हस्ताक्षर है, या जो उस एनवायरनमेंट में उस ऑर्डर के किसी भुगतान अनुरोध का जवाब नहीं देतीं, वे अस्वीकार होती हैं और कुछ नहीं बदलतीं। जिन भुगतानों की शुरुआत हो चुकी है, उनकी सूचनाएँ भुगतान विधि बंद करने पर भी स्वीकार की जाती हैं।

Checkout

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

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

Description: Confirm Order चरण पर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via Netopia.

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

Geo zone: Netopia को केवल चुने हुए geo zone के भुगतान पतों के लिए ऑफ़र करें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।

Minimum total: स्टोर की डिफ़ॉल्ट मुद्रा में वह ऑर्डर कुल राशि जिस तक पहुँचने पर ही Netopia ऑफ़र किया जाता है। कोई न्यूनतम सीमा न हो तो खाली छोड़ें।

Netopia खाता

Netopia एडमिन में Seller accounts > your point of sale > Technical settings पर जाएँ: खाता हस्ताक्षर कॉपी करें और हर एनवायरनमेंट का सार्वजनिक प्रमाणपत्र (.cer) तथा निजी कुंजी (.key) डाउनलोड करें। फ़ाइलों को टेक्स्ट एडिटर में खोलें और BEGIN/END लाइनों समेत उनकी पूरी सामग्री चिपकाएँ। यह सेक्शन Netopia v1 दस्तावेज़ीकरण से लिंक करता है।

Account signature: सेलर खाते का हस्ताक्षर (प्रारूप XXXX-XXXX-XXXX-XXXX-XXXX), सैंडबॉक्स और लाइव के लिए एक ही।

Test mode: Netopia सैंडबॉक्स (sandboxsecure.mobilpay.ro) और सैंडबॉक्स कुंजियों का उपयोग करता है। डिफ़ॉल्ट: चालू। असली भुगतान लाइव कुंजियों (secure.mobilpay.ro) से लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode (Netopia sandbox): no real money is charged. देखता है।

Sandbox public certificate (.cer): सैंडबॉक्स सार्वजनिक प्रमाणपत्र फ़ाइल की सामग्री। इसका उपयोग भुगतान अनुरोध को एन्क्रिप्ट करने के लिए होता है।

Sandbox private key (.key): सैंडबॉक्स निजी कुंजी फ़ाइल की सामग्री। इसका उपयोग IPN को डिक्रिप्ट करने के लिए होता है।

Live public certificate (.cer): लाइव सार्वजनिक प्रमाणपत्र फ़ाइल की सामग्री।

Live private key (.key): लाइव निजी कुंजी फ़ाइल की सामग्री।

सेव की गई निजी कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और उसका सहायता पाठ A private key is saved. से शुरू होता है। सेव की गई कुंजी रखने के लिए फ़ील्ड खाली छोड़ें, या उसे बदलने के लिए नई कुंजी चिपकाएँ। सेव की गई निजी कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved private key on save चेक करें और Save पर क्लिक करें। प्रमाणपत्र फ़ील्ड खाली छोड़ने पर प्रमाणपत्र हट जाता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के (एक लापता ऑर्डर) बनाता है। ऑर्डर को स्टेटस तभी मिलता है जब Netopia भुगतान की रिपोर्ट करता है। OpenCart के पास Netopia के अपने ऑर्डर स्टेटस नहीं हैं, इसलिए नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है। ऑर्डर पर नोट्स हर बदलाव समझाते हैं।

Order status after payment: भुगतान हो चुके ऑर्डर की स्थिति।

Processing status: डिफ़ॉल्ट: प्रक्रिया में।

Completed status: डिफ़ॉल्ट: पूर्ण।

Awaiting Netopia payment: Netopia एडमिन में कैप्चर का इंतज़ार कर रहा प्री-ऑथराइज़ेशन, या Netopia में समीक्षा के अधीन भुगतान। डिफ़ॉल्ट: लंबित।

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

Canceled status: Netopia ने लंबित ऑर्डर के भुगतान को रद्द किया। डिफ़ॉल्ट: रद्द।

Payment error status: लंबित ऑर्डर के लिए Netopia ने त्रुटि रिपोर्ट की, उदाहरण के लिए कार्ड अस्वीकृत। डिफ़ॉल्ट: विफल।

Refunded status: Netopia एडमिन में किए गए रिफ़ंड के बाद कुछ भी रिफ़ंड करने को नहीं बचता। डिफ़ॉल्ट: रिफ़ंड किया गया।

एडवांस्ड

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

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

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

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

Export: Download JSON सेटिंग्स को प्रमाणपत्रों सहित JSON फ़ाइल के रूप में सेव करता है। निजी कुंजियाँ एक्सपोर्ट नहीं होतीं।

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Card Payment (Netopia))। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to the Netopia secure page to pay with your card. OpenCart इस चरण पर ऑर्डर बनाता है, जो अब भी बिना स्टेटस के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन भुगतान अनुरोध बनाता है, उसे सक्रिय एनवायरनमेंट के Netopia प्रमाणपत्र से एन्क्रिप्ट करता है, और ग्राहक को सीधे Netopia के भुगतान पेज पर भेजता है। अनुरोध में ऑर्डर की मुद्रा में ऑर्डर कुल, ऑर्डर नंबर वाला Order #, और ऑर्डर के फ़ोन नंबर के साथ बिलिंग तथा शिपिंग संपर्क विवरण होते हैं। सैंडबॉक्स मोड में यह Netopia सैंडबॉक्स पर जाता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

ग्राहक Netopia पेज पर कार्ड से भुगतान करता है और आपके स्टोर पर लौट आता है। लौटना अपने आप में कभी ऑर्डर का भुगतान नहीं करता। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Netopia उसे IPN से पुष्ट करता है। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होता है, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। लंबित ऑर्डर के लिए पेज पर Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. दिखता है। होल्ड पर रखे ऑर्डर के लिए यह Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. दिखाता है। जब लंबित या होल्ड ऑर्डर को बाद में अंतिम स्टेटस (भुगतान किया हुआ, भुगतान त्रुटि या रद्द) मिलता है, तो ग्राहक को नए स्टेटस के साथ ईमेल भेजा जाता है। रद्द किए गए ऑर्डर के लिए पेज The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. दिखाता है। भुगतान त्रुटि वाले ऑर्डर के लिए The payment was declined by Netopia. दिखाता है।

यदि ग्राहक के लौटने तक IPN नहीं पहुँची है, तो Payment confirmation पेज वही "अभी पुष्ट नहीं हुआ" पाठ और Check again तथा Back to checkout बटन दिखाता है। IPN पहुँचते ही ऑर्डर को स्टेटस मिल जाता है।

यदि बिना स्टेटस वाले ऑर्डर के लिए Netopia ने रद्द होने या अस्वीकार होने की रिपोर्ट की है, तो ग्राहक The payment was cancelled at Netopia. You can try again or choose another payment method. या The payment was declined by Netopia. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। कार्ट बना रहता है। हर नया प्रयास एक नया भुगतान अनुरोध होता है; पिछले अनुरोध भी वैध रहते हैं, इसलिए पिछले प्रयास की देर से आई IPN भी दर्ज होती है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर का नए भुगतान अनुरोध के साथ फिर से भुगतान करता है; यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ, लंबित या होल्ड पर है, तो ग्राहक सफलता पेज पर जाता है और कोई नया भुगतान शुरू नहीं होता।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका प्री-ऑथराइज़ेशन रद्द हुआ, वह लंबित होने के बाद अस्वीकृत हुआ, या आपने उसे रद्द या रिफ़ंड किया), तो ग्राहक Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। जो ऑर्डर भुगतान होने के बाद रद्द या रिफ़ंड हुआ, वह अब कार्ट को नहीं रोकता।

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर संदेश दिखता है: Netopia gateway is not configured properly. Please contact the store administrator., मुद्रा के साथ Netopia cannot process payments in, This order has nothing to pay., या Payment encryption failed. Please try again or contact support. तकनीकी कारण लॉग में लिखा जाता है।

IPN तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन (startup action) जोड़ता है, जो ग्राहक को Netopia से वापस लौटने भी देता है।

एक्सटेंशन कार्ड भुगतान केवल Netopia v1 कार्ड प्रोटोकॉल के माध्यम से लेता है। OpenCart से रिफ़ंड या कैप्चर नहीं होता; सेव किए गए कार्ड या वन-क्लिक भुगतान, सब्सक्रिप्शन, किस्तें या अन्य भुगतान विधियाँ, और Netopia API v2 समर्थित नहीं हैं।

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

Order statuses

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

Processing or Completed status: Netopia ने भुगतान की पुष्टि की है। स्टेटस Order status after payment का अनुसरण करता है। एक नोट राशि, मास्क किया गया कार्ड नंबर और Netopia लेन-देन दिखाता है; सैंडबॉक्स भुगतान [sandbox] से चिह्नित होते हैं।

Awaiting Netopia payment: भुगतान एक प्री-ऑथराइज़ेशन है जो Netopia एडमिन में कैप्चर का इंतज़ार कर रहा है, या Netopia में समीक्षा के अधीन है। Netopia की पुष्टि होने पर ऑर्डर भुगतान किए हुए स्टेटस पर चला जाता है।

Netopia payment on hold: इनवॉइस की राशि या मुद्रा ऑर्डर से अलग है, भुगतान का केवल एक हिस्सा कैप्चर हुआ है, Netopia ने किसी रद्द ऑर्डर या किसी दूसरी भुगतान विधि से किए गए ऑर्डर के भुगतान की पुष्टि की है, या स्टोर के लाइव मोड में होने पर सैंडबॉक्स (टेस्ट) भुगतान की पुष्टि हुई है (कोई असली पैसा नहीं मिला)। ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया जाता; नोट इसका कारण बताता है। Netopia एडमिन में लेन-देन जाँचें, फिर ऑर्डर प्रोसेस करें या वहाँ भुगतान रिफ़ंड करें।

Payment error status: लंबित ऑर्डर के लिए Netopia ने त्रुटि रिपोर्ट की, उदाहरण के लिए कार्ड अस्वीकृत।

Canceled status: Netopia ने लंबित ऑर्डर का भुगतान रद्द किया।

Refunded status: भुगतान Netopia एडमिन में पूरी तरह रिफ़ंड किया गया।

देर से आने वाली सूचनाएँ कभी भुगतान किए हुए या बंद ऑर्डर का स्टेटस नहीं घटातीं। यदि Netopia पहले से भुगतान किए गए ऑर्डर के लिए कोई और भुगतान पुष्ट करता है, तो एक नोट आपसे डुप्लिकेट का Netopia एडमिन में रिफ़ंड करने को कहता है। यदि ग्राहक उसी कार्ट का दूसरा ऑर्डर भुगतान करता है, तो वह ऑर्डर बिना स्टेटस के रहता है और भुगतान अनुरोध को कार्ट का डुप्लिकेट भुगतान चिह्नित किया जाता है।

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

VibeFox Netopia Gateway टैब

Sales > Orders में Netopia से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Netopia Gateway टैब में Netopia Payments ब्लॉक दिखता है: Netopia लेन-देन, एनवायरनमेंट (सैंडबॉक्स या लाइव), भुगतान अनुरोध, अनुरोध का स्टेटस, अंतिम IPN क्रिया, मास्क किया गया कार्ड, भुगतान किए गए, रिफ़ंड किए गए और शेष राशियाँ, रिफ़ंड इतिहास, और ऑर्डर के Netopia notes। यह टैब केवल-पढ़ने योग्य है और एक्सटेंशन तक पहुँच वाले उपयोगकर्ताओं को दिखता है।

रिफ़ंड

रिफ़ंड और कैप्चर OpenCart से नहीं होते: Netopia v1 कार्ड प्रोटोकॉल में रिफ़ंड कॉल नहीं है। लेन-देन को Netopia एडमिन में रिफ़ंड करें। तब Netopia एक क्रेडिट IPN भेजता है, और एक्सटेंशन रिफ़ंड को Netopia refund processed: नोट और राशि के साथ अपने-आप ऑर्डर पर दर्ज कर देता है। आंशिक रिफ़ंड ऑर्डर का स्टेटस बनाए रखता है; जब रिफ़ंड करने को कुछ न बचे, तो ऑर्डर Refunded status पर सेट हो जाता है। EUR, USD और GBP ऑर्डरों के लिए, Netopia जो रिफ़ंड राशि RON में बताता है, उसे वापस ऑर्डर की मुद्रा में बदला जाता है। कोई रिफ़ंड दो बार दर्ज नहीं होता और शेष राशि से अधिक के लिए दर्ज नहीं होता। यदि Netopia रिफ़ंड के लिए त्रुटि रिपोर्ट करता है, तो केवल एक नोट जोड़ा जाता है।

Sales > Returns में उत्पाद वापसी Netopia के माध्यम से पैसे वापस नहीं भेजती।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Netopia Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Netopia Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-netopia वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

Netopia does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, सक्रिय एनवायरनमेंट पूरा है (टेस्ट मोड में सैंडबॉक्स का Account signature और प्रमाणपत्र व निजी कुंजी, या लाइव मोड में लाइव के), और ग्राहक RON, EUR, USD या GBP में चेकआउट करता है। कुछ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने हुए Geo zone में है, और ऑर्डर Minimum total तक पहुँचता है।

The payment went through, but the order stays without a status: IPN आपके स्टोर तक नहीं पहुँची या अस्वीकार हुई। सेटिंग्स में दिए IPN (पुष्टि) URL की जाँच करें कि वह इंटरनेट से पहुँच योग्य है (बेसिक ऑथेंटिकेशन या फ़ायरवॉल के बिना)। एक्सटेंशन पेज पर Log फ़ील्ड देखें: अस्वीकृत IPN हमेशा दर्ज होती हैं। हर IPN देखने के लिए Debug log चालू करें। ग्राहक के लौटने भर से कोई ऑर्डर कभी भुगतान नहीं होता।

Log shows failed decrypting data: निजी कुंजी उस प्रमाणपत्र से मेल नहीं खाती जिसका उपयोग Netopia ने किया। IPN हर एनवायरनमेंट की सेव की गई निजी कुंजी से डिक्रिप्ट होती है, इसलिए जब तक दूसरे एनवायरनमेंट के भुगतान खुले हैं, उसकी कुंजी सेव रखें। Netopia IPN को फिर से भेजता है।

Log shows signature mismatch: Account signature उस पॉइंट ऑफ़ सेल से अलग है जिसने IPN भेजी। इसे Netopia एडमिन से दोबारा कॉपी करें।

Log shows unknown payment request: IPN उस एनवायरनमेंट (सैंडबॉक्स या लाइव) में उस ऑर्डर के लिए आपके स्टोर के किसी भुगतान अनुरोध का जवाब नहीं देती। कुछ नहीं बदलता।

Log shows gateway not configured: कोई निजी कुंजी या खाता हस्ताक्षर सेव नहीं है। Netopia IPN को फिर से भेजता है, और सेटिंग्स पूरी होने पर भुगतान दर्ज हो जाता है।

Log shows busy, retry later or processing failed: उसी क्षण कार्ट को किसी दूसरे अनुरोध द्वारा प्रोसेस किया जा रहा था, या ऑर्डर का स्टेटस सेट नहीं किया जा सका। Netopia IPN को अपने-आप फिर से भेजता है।

Error on save about the certificate or private key: चिपकाया गया पाठ मान्य प्रमाणपत्र या कुंजी नहीं है। BEGIN/END लाइनों समेत फ़ाइल की पूरी सामग्री चिपकाएँ। पिछला मान रखा गया।

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

Order is in the on-hold status after payment: VibeFox Netopia Gateway टैब के नोट पढ़ें (देखें Order statuses)। राशि या मुद्रा अलग थी, केवल एक हिस्सा कैप्चर हुआ, ऑर्डर रद्द हो चुका था, या स्टोर के लाइव मोड में होने पर सैंडबॉक्स भुगतान की पुष्टि हुई। Netopia एडमिन में लेन-देन जाँचें।

A refund made in Netopia does not appear on the order: क्रेडिट IPN स्टोर तक नहीं पहुँची या अस्वीकार हुई। लॉग जाँचें।

डेवलपर्स के लिए: स्वीकृत मुद्राओं की सूची OpenCart इवेंट netopia_p_supported_currencies से बदली जा सकती है।

अनइंस्टॉल

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

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

Netopia Payments और mobilPay उनके संबंधित स्वामियों के ट्रेडमार्क हैं। यह एक्सटेंशन Netopia Payments से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।