VibeFox Montonio for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: चेकआउट की मुद्रा EUR या PLN होनी चाहिए। किसी अन्य मुद्रा के लिए चेकआउट पर भुगतान विधि छिपा दी जाती है।
Montonio खाता: आपको Montonio Partner System से अपने स्टोर की एक्सेस कुंजी (access key) और सीक्रेट कुंजी (secret key) चाहिए। सैंडबॉक्स और लाइव कुंजियाँ अलग-अलग होती हैं, इसलिए आप जिस भी परिवेश (environment) का उपयोग करते हैं, उसके लिए एक-एक जोड़ी चाहिए। Montonio में और कुछ सेट करने की आवश्यकता नहीं है: हर भुगतान के साथ सूचना का पता भेजा जाता है।
सार्वजनिक साइट: Montonio की सूचनाएँ प्राप्त करने के लिए आपके स्टोर का इंटरनेट से पहुँच योग्य होना आवश्यक है। अन्यथा भी, जब ग्राहक स्टोर पर वापस आएगा, तब ऑर्डर को उसकी स्थिति मिल जाएगी।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी केवल एक डोमेन पर काम करती है।
इंस्टॉलेशन
इस डाउनलोड में दोनों OpenCart संस्करणों के लिए पैकेज वाली एक ज़िप फ़ाइल है। इसे अपने कंप्यूटर पर खोलें। इसमें README.txt, OpenCart 3 का पैकेज wcp_montonio_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_montonio_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में जाएँ Extensions > Installer, Upload पर क्लिक करें और फ़ाइल wcp_montonio_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की आवश्यकता नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Montonio Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी को पेज के ऊपर के लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. Montonio Partner System में Stores > your store > API keys खोलें और सैंडबॉक्स एक्सेस कुंजी तथा सीक्रेट कुंजी कॉपी करें। उन्हें सेटिंग्स में चिपकाएँ और Sandbox mode चालू रखें।
5. Enable/Disable चालू करें, Save पर क्लिक करें और EUR के ऑर्डर के साथ सैंडबॉक्स में एक भुगतान का परीक्षण करें। फिर लाइव कुंजियाँ दर्ज करें और Sandbox mode बंद करें।
OpenCart 4
1. एडमिन में जाएँ Extensions > Installer, Upload पर क्लिक करें और फ़ाइल wcp_montonio_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदली गई पैकेज फ़ाइल काम नहीं करती।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखाई देता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Montonio Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और Montonio कुंजियाँ उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें Notification URL)।
नया इंस्टॉल भुगतान विधि बंद और सैंडबॉक्स मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox Montonio Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब वर्तमान परिवेश की कुंजियाँ गायब हों (तब चेकआउट पर भुगतान विधि छिपी रहती है) और जब स्टोर की डिफ़ॉल्ट मुद्रा EUR या PLN न हो; और सैंडबॉक्स चालू रहने के दौरान यह सैंडबॉक्स मोड चालू है: भुगतान सिमुलेट किए जाते हैं और कोई वास्तविक राशि नहीं काटी जाती। दिखाता है। एक्सटेंशन में बदलाव करने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ स्वीकार्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए। यदि कोई मान गलत है, तो कुछ भी सेव नहीं होता और पेज उस फ़ील्ड का नाम बताता है।
Montonio
Enable/Disable: Enable Montonio bank payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यह वही नाम है जो ऑर्डर में सेव होता है और Montonio पेज पर दिखाया जाता है। डिफ़ॉल्ट: Bank payment (Montonio)। आवश्यक, 128 अक्षरों तक।
Description: वह पाठ जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखाया जाता है। डिफ़ॉल्ट: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Montonio की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।
Geo Zone: Montonio केवल चुने गए जियो ज़ोन में स्थित भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह कुल राशि, जिस तक पहुँचने पर ही Montonio दिखाया जाएगा। किसी भी राशि के लिए Montonio दिखाने हेतु इसे खाली छोड़ें।
API कुंजियाँ
कुंजियाँ Montonio Partner System में प्राप्त करें (पेज पर उस सिस्टम का लिंक है), Stores > your store > API keys के अंतर्गत। सैंडबॉक्स और लाइव कुंजियाँ अलग-अलग होती हैं। सैंडबॉक्स केवल सैंडबॉक्स कुंजियों का उपयोग करता है, और लाइव मोड केवल लाइव कुंजियों का।
Sandbox mode: Montonio के सैंडबॉक्स का उपयोग करता है (परीक्षण भुगतान, कोई वास्तविक राशि नहीं)। यह Montonio API का पता और कुंजी जोड़ी, दोनों बदल देता है। डिफ़ॉल्ट: चालू। इसे केवल लाइव कुंजियाँ दर्ज करने के बाद बंद करें। दूसरे परिवेश में किए गए भुगतान पुष्टि और रिफ़ंड के लिए अपने ही परिवेश की कुंजियों का उपयोग करते रहते हैं। जब यह चालू होता है, तब ग्राहकों को Confirm Order चरण पर सैंडबॉक्स मोड — परीक्षण भुगतान, कोई वास्तविक राशि नहीं काटी जाती। दिखता है।
Sandbox access key: Montonio सैंडबॉक्स में आपके स्टोर की एक्सेस कुंजी (UUID)।
Sandbox secret key: Montonio सैंडबॉक्स में आपके स्टोर की सीक्रेट कुंजी।
Live access key: Montonio के लाइव परिवेश में आपके स्टोर की एक्सेस कुंजी (UUID)।
Live secret key: Montonio के लाइव परिवेश में आपके स्टोर की सीक्रेट कुंजी।
सेव की गई सीक्रेट कुंजियाँ फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और सेव किया गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल तभी नया मान टाइप करें जब उसे बदलना हो। सेव की गई सीक्रेट कुंजी हटाने के लिए, फ़ील्ड के नीचे Clear the saved key on save को चुनें और Save पर क्लिक करें।
Notification URL: वह पता जहाँ Montonio भुगतान सूचनाएँ भेजता है। OpenCart 3 पर यह कुछ इस रूप का होता है: https://your-store/index.php?route=extension/payment/wcp_montonio_payment/notification, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_montonio_payment/payment/wcp_montonio_payment.notification जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे आपको कहीं भी दर्ज करने की आवश्यकता नहीं है: एक्सटेंशन हर भुगतान के साथ इसे Montonio को भेजता है।
ऑर्डर
OpenCart, Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (अधूरा ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Montonio भुगतान की पुष्टि कर दे। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची दिखाता है।
Order Status After Payment: सत्यापित Montonio भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रसंस्करण में।
Payment On Hold Status: भुगतान पर ध्यान देने की आवश्यकता है (देखें ऑर्डर स्थितियाँ)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्वयं की स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Payment Failed Status: तब सेट होता है जब बैंक ऐसे भुगतान को अस्वीकार कर दे जो अधिकृत के रूप में रोका गया था। डिफ़ॉल्ट: विफल।
Refunded Status: ऑर्डर पेज से भुगतान की पूरी राशि रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: रिफ़ंड किया गया।
उन्नत
Debug log: भुगतान की घटनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में wc_mnt_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे wc_mnt_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं, भले ही यह विकल्प बंद हो। कुंजियाँ, टोकन और ग्राहक का डेटा कभी दर्ज नहीं किया जाता। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और उसकी नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data: चालू होने पर एक्सटेंशन हटाने से गेटवे की सेटिंग्स और उसका लॉग हट जाते हैं। एक्सटेंशन को बंद करने से कुछ भी नहीं हटता। ऑर्डर का डेटा (Montonio UUID, नोट्स) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को एक JSON फ़ाइल के रूप में सेव करता है। एक्सेस कुंजियाँ और सीक्रेट कुंजियाँ निर्यात नहीं की जातीं।
Import: पहले से निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई एक्सेस कुंजियाँ और सीक्रेट कुंजियाँ सुरक्षित रहती हैं।
भुगतान सूचनाएँ
Montonio हर भुगतान के बारे में आपके स्टोर को हस्ताक्षरित टोकन के माध्यम से बताता है। टोकन दो तरीकों से पहुँचता है: सूचना के पते पर सर्वर-से-सर्वर सूचना द्वारा, और तब जब ग्राहक स्टोर पर वापस आता है। दोनों की जाँच होती है: उस परिवेश की सीक्रेट कुंजी से हस्ताक्षर, समाप्ति समय, आपकी एक्सेस कुंजी, और यह कि भुगतान उसी ऑर्डर के लिए आपके स्टोर द्वारा बनाया गया था। दूसरे परिवेश की कुंजी से हस्ताक्षरित टोकन अस्वीकार कर दिया जाता है। हर स्थिति केवल एक बार लागू होती है, इसलिए दोहराई गई सूचनाएँ नोट्स, ईमेल या स्टॉक में बदलाव नहीं जोड़तीं। सूचना का पता तब भी काम करता है जब स्टोर रखरखाव मोड में हो, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को गुज़रने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है, जो ग्राहक को Montonio से वापस आने भी देता है।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Bank payment (Montonio))। Confirm Order चरण पर ग्राहक को Montonio का आइकन और आपका विवरण दिखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, जो अब भी बिना स्थिति के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर राशि के लिए एक Montonio भुगतान बनाता है और ग्राहक को Montonio के भुगतान पेज पर भेजता है। वहाँ ग्राहक एक बैंक चुनता है और भुगतान करता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। ग्राहक के बिलिंग देश के बैंक पहले दिखाए जाते हैं (PLN ऑर्डर के लिए पोलैंड)। भुगतान Order और ऑर्डर नंबर के रूप में दिखता है। Montonio पेज स्टोर की भाषा में खुलता है, यदि वह जर्मन, अंग्रेज़ी, एस्टोनियाई, फ़िनिश, लिथुआनियाई, लातवियाई, पोलिश या रूसी है; अन्यथा अंग्रेज़ी में।
ऑर्डर को भुगतान पूरा तभी चिह्नित किया जाता है जब Montonio उसकी पुष्टि करे: सूचना के द्वारा या ग्राहक के लौटने पर। फिर ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart की ऑर्डर सफलता वाली पृष्ठ दिखता है, जिसमें Your Montonio bank payment has been received. लिखा होता है। यदि बैंक ने अभी भुगतान की पुष्टि नहीं की है, या ऑर्डर रोका गया है, तो पेज We are confirming your payment with Montonio. The order will be updated automatically — please do not pay again. दिखाता है। यदि बैंक बाद में किसी अधिकृत भुगतान को अस्वीकार कर दे, तो पेज Your Montonio payment was not completed. Please contact us about this order. दिखाता है।
यदि ग्राहक के लौटने पर Montonio भुगतान को अब भी लंबित बताता है, तो Payment confirmation पेज वही पाठ दिखाता है, साथ में Check again बटन और Back to checkout बटन। Check again Montonio से भुगतान की वर्तमान स्थिति माँगता है। सूचना आते ही ऑर्डर की स्थिति सेट हो जाती है।
यदि भुगतान रद्द या अस्वीकार हो गया, तो ग्राहक इनमें से किसी एक संदेश के साथ चेकआउट पर वापस आ जाता है: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method., या Montonio could not complete the payment. Please try again or choose another payment method. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर को नए Montonio भुगतान के साथ फिर से भुगतान के लिए देता है। नया भुगतान बनाने से पहले एक्सटेंशन उसी कार्ट के पिछले प्रयास के बारे में Montonio से पूछता है। यदि वह पहले से भुगतान किया हुआ है, तो उस भुगतान की पुष्टि होती है, ग्राहक सफलता पेज पर जाता है, और दूसरा भुगतान नहीं किया जाता।
OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज नहीं दिखाया जाता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद कर दिया गया हो (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक को Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस भेजा जाता है, Montonio से लौटने पर भी, और अगला Confirm Order एक नया ऑर्डर भुगतान के लिए बनाता है। OpenCart 3 पर ऐसे ऑर्डर की वापसी पर सफलता पेज दिखता है, जिसमें नोट होता है कि भुगतान पूरा नहीं हुआ। यदि चेकआउट का ऑर्डर पहले ही दिया जा चुका है और तब से कार्ट बदल गया है, तो संदेश यह होता है: Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. कार्ट में बदलाव, नई मात्रा सहित, एक नई कार्ट माना जाता है जिसे अपने भुगतान की आवश्यकता होती है। जो ऑर्डर भुगतान के बाद रद्द या रिफ़ंड हुआ, वह अब कार्ट को नहीं रोकता।
यदि Montonio भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बना रहता है, बटन के ऊपर एक छोटा संदेश होता है, जैसे Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।
यह एक्सटेंशन केवल बैंक भुगतान (भुगतान आरंभ करना) स्वीकार करता है। इसमें कार्ड भुगतान, BLIK, Apple Pay या Google Pay, Pay Later या फ़ाइनेंसिंग, Montonio शिपिंग, सब्सक्रिप्शन, सहेजी गई भुगतान विधियाँ, या आपकी अपनी साइट पर बैंक चयन नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (अधूरा ऑर्डर): ग्राहक को Montonio पर भेजा गया था और उसने भुगतान नहीं किया, या Montonio भुगतान को लंबित बताता है, या भुगतान रद्द या पूरा नहीं हुआ। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर को Missing Orders पर सेट किया गया हो।
Order Status After Payment (डिफ़ॉल्ट प्रसंस्करण में): Montonio ने ऑर्डर की सटीक राशि और मुद्रा के साथ भुगतान की पुष्टि की है (PAID)। एक नोट में बैंक, Montonio ऑर्डर UUID, राशि और परिवेश दिखाया जाता है।
Payment On Hold Status (डिफ़ॉल्ट लंबित): बैंक ने अभी भुगतान की पुष्टि नहीं की है (AUTHORIZED); जब Montonio PAID बताता है, तब ऑर्डर Order Status After Payment पर चला जाता है। कोई ऑर्डर तब भी रोका जाता है जब Montonio ने ऑर्डर के कुल से अलग राशि या मुद्रा बताई हो, जब स्टोर लाइव मोड में हो और तब सैंडबॉक्स भुगतान आया हो (कोई वास्तविक राशि नहीं मिली), या जब भुगतान तब आया हो जब ऑर्डर को कोई दूसरी स्थिति (जैसे रद्द) मिल चुकी थी। नोट इसका कारण समझाता है। Montonio Partner System में भुगतान जाँचें और फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Payment Failed Status (डिफ़ॉल्ट विफल): बैंक ने ऐसे भुगतान को अस्वीकार कर दिया जो अधिकृत के रूप में रोका गया था। केवल ऑर्डर का नवीनतम भुगतान प्रयास ही इसे बदल सकता है।
Refunded Status (डिफ़ॉल्ट रिफ़ंड किया गया): एक्सटेंशन के माध्यम से भुगतान की पूरी राशि रिफ़ंड की गई है।
भुगतान किए गए या रिफ़ंड किए गए ऑर्डर बाद की सूचनाओं से कभी दोबारा नहीं खुलते। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपको Montonio Partner System में दूसरे भुगतान को रिफ़ंड करने के लिए कहता है।
नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक नहीं देखता।
VibeFox Montonio Payment टैब
Sales > Orders में Montonio से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Montonio Payment टैब ऑर्डर के भुगतान प्रयासों की सूची दिखाता है, जिसमें तारीख, Montonio order UUID (परीक्षण भुगतानों के लिए Sandbox लेबल के साथ), राशि, बैंक, Montonio status और परिणाम शामिल हैं। नीचे Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Montonio notes हैं। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
VibeFox Montonio Payment टैब में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होगी), वैकल्पिक रूप से कारण लिखें (वह केवल ऑर्डर नोट में रखा जाता है), और Refund via Montonio पर क्लिक करें। क्या यह राशि Montonio के माध्यम से रिफ़ंड करनी है? इसे पलटा नहीं जा सकता। प्रश्न की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन में बदलाव करने का अधिकार होना चाहिए (जो System > Users > User Groups में सेट होता है)। रिफ़ंड उस राशि तक सीमित हैं जो Montonio ने काटी थी, इसलिए राशि में अंतर होने के बाद आप ऑर्डर के कुल के बजाय उतनी ही राशि रिफ़ंड कर सकते हैं जितनी ग्राहक ने वास्तव में चुकाई थी। रिफ़ंड उसी परिवेश (सैंडबॉक्स या लाइव) को भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस परिवेश की कुंजियाँ सेट होनी चाहिए। यदि Montonio रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। भेजा गया रिफ़ंड अपनी स्थिति और Montonio रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे मैनुअल स्थिति परिवर्तन होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब Montonio भुगतान को भुगतान किया गया बताए।
Montonio बाद में एक सूचना के द्वारा हर रिफ़ंड की पुष्टि या अस्वीकृति करता है। पुष्टि नोट्स में जुड़ती है। यदि Montonio रिफ़ंड अस्वीकार करता है, तो नोट बताता है कि पैसे ग्राहक को वापस नहीं हुए; इसे Montonio Partner System में जाँचें और OpenCart में रिफ़ंड सुधारें।
Sales > Returns में उत्पाद वापसी से Montonio के माध्यम से पैसे वापस नहीं जाते। Montonio Partner System में किए गए रिफ़ंड, जब Montonio उनकी सूचना देता है, तब नोट्स में जुड़ जाते हैं। ऑर्डर की स्थिति अपने-आप नहीं बदलती; आवश्यकता होने पर उसे मैन्युअल रूप से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Montonio Payment लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Montonio Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क किए हुए रूप में, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-montonio वाली पंक्ति और वह लिंक है जो आपका 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 पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।
एक कुंजी केवल एक डोमेन पर काम करती है। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना चेकआउट पर Montonio ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन किया हुआ एडमिन उपयोगकर्ता अब भी स्टोर में भुगतान विधि देखता है, जिस पर (unlicensed — visible to admins only) का निशान लगा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन के Dashboard पर एक अनुस्मारक दिखाई देता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि अब भी होती है, और रिफ़ंड काम करते हैं।
जब लाइसेंस की समय सीमा समाप्त होती है, तब एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीकरण आवश्यक है। जब आप एडमिन के Dashboard या Edit पेज को खोलते हैं, तब स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की आवश्यकता नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
Montonio चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान परिवेश की दोनों कुंजियाँ सेट हैं: सैंडबॉक्स मोड में Sandbox access key और Sandbox secret key, लाइव मोड में Live access key और Live secret key। कुंजियाँ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। ग्राहक को EUR या PLN में भुगतान करना होगा (स्टोर में चुनी गई मुद्रा)। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्थिति के रह गया: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि स्टोर इंटरनेट से पहुँच योग्य है और सेटिंग्स की कुंजियाँ भुगतान के परिवेश की हैं। भुगतान के बाद ग्राहक के स्टोर पर लौटने पर, Check again पर क्लिक करने पर, और उसी कार्ट को फिर से भुगतान करने का प्रयास करने पर भी ऑर्डर को स्थिति मिलती है।
सूचना का उत्तर Invalid token है: टोकन का हस्ताक्षर, समाप्ति या एक्सेस कुंजी मेल नहीं खाई। जाँचें कि एक्सेस कुंजी और सीक्रेट कुंजी सही कॉपी की गई हैं और सही परिवेश की हैं, और सर्वर की घड़ी सही है। दूसरे परिवेश की कुंजी से हस्ताक्षरित टोकन भी अस्वीकार होता है।
सूचना का उत्तर Payment does not belong to this order है: भुगतान इस स्टोर ने इस ऑर्डर के लिए नहीं बनाया था। यह तब होता है जब दो स्टोर एक ही Montonio खाते और एक ही ऑर्डर नंबरों का उपयोग करते हैं।
सूचना का उत्तर Gateway not configured है: कोई Montonio कुंजी सेट नहीं है, या भुगतान के परिवेश की कुंजियाँ गायब हैं। कुंजियाँ दर्ज करें; Montonio सूचना फिर से भेजेगा।
सूचना का उत्तर Temporarily unavailable है: उसी क्षण कार्ट की पुष्टि किसी दूसरे अनुरोध द्वारा हो रही थी, या ऑर्डर की स्थिति सेट नहीं हो सकी। Montonio सूचना फिर से भेजेगा। कारण के लिए Log फ़ील्ड देखें।
Confirm Order के बाद ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is not available. Please reload the checkout page. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट फिर से लोड करना होगा। This payment method is temporarily unavailable. Please choose another payment method. आम तौर पर गलत या गायब कुंजियों का संकेत है। Montonio could not start the payment. Please check your order details or choose another payment method. का अर्थ है कि Montonio ने भुगतान डेटा अस्वीकार किया; कारण लॉग में है।
भुगतान के बाद ऑर्डर रोके गए स्थिति में है: VibeFox Montonio Payment टैब के नोट्स पढ़ें (देखें ऑर्डर स्थितियाँ), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
सैंडबॉक्स भुगतान लाइव ऑर्डर की पुष्टि नहीं करते: जब स्टोर लाइव मोड में होता है, तब सैंडबॉक्स भुगतान कभी ऑर्डर की पुष्टि नहीं करता; इसके बजाय ऑर्डर रोक दिया जाता है। Sandbox mode को वांछित परिवेश पर सेट करें और उसी परिवेश की कुंजियों का उपयोग करें।
टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: भुगतान अभी तक पुष्ट नहीं हुआ है, वह पूरी तरह रिफ़ंड हो चुका है, या आपके उपयोगकर्ता समूह के पास एक्सटेंशन में बदलाव करने का अधिकार नहीं है।
परिवेश से संबंधित संदेश के साथ रिफ़ंड विफल होता है: भुगतान सैंडबॉक्स या लाइव परिवेश में हुआ था, और उस परिवेश की कुंजियाँ सेट नहीं हैं। उन्हें दर्ज करें और फिर से प्रयास करें। The order is being updated by a payment notification, try again in a moment. का अर्थ है कि उसी ऑर्डर के लिए एक सूचना प्रोसेस की जा रही है।
डेवलपर्स के लिए: एक्सटेंशन समर्थित मुद्राओं, भुगतान डेटा और Montonio पेज की भाषा बदलने के लिए OpenCart इवेंट wc_mnt_supported_currencies, wc_mnt_order_data और wc_mnt_locale ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Montonio Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर इसके इवेंट और इसका स्टार्टअप एक्शन भी, जो रखरखाव मोड में सूचनाओं को गुज़रने देता है, हटाए जाते हैं)। यदि Delete data चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, कुंजियाँ, डीबग लॉग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। Montonio के भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Montonio Payment के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Montonio अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Montonio से संबद्ध नहीं है और न ही Montonio द्वारा समर्थित है।