VibeFox MultiSafepay for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: चेकआउट की मुद्रा वह होनी चाहिए जिसे MultiSafepay स्वीकार करता है, उदाहरण के लिए EUR, USD, GBP, PLN, CHF, SEK, DKK या NOK। अन्य मुद्राओं के लिए चेकआउट पर यह भुगतान विधि छिपी रहती है।
MultiSafepay खाता: आपको MultiSafepay Control में अपनी वेबसाइट की API कुंजी चाहिए। टेस्ट और लाइव खातों की कुंजियाँ अलग-अलग होती हैं। MultiSafepay में और कुछ सेट करने की ज़रूरत नहीं है: हर भुगतान के साथ सूचना का पता भेजा जाता है।
सार्वजनिक साइट: सूचनाएँ भेजने के लिए MultiSafepay को आपके स्टोर तक पहुँच पाना ज़रूरी है। ऐसा न होने पर भी ग्राहक के MultiSafepay से लौटने पर ऑर्डर को उसकी स्थिति मिल जाती है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ज़िप फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_multisafepay_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_multisafepay_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_multisafepay_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ, प्रकार Payments चुनें, VibeFox MultiSafepay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. MultiSafepay Control से टेस्ट और/या लाइव API कुंजी चिपकाएँ (देखें Configuration)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू होने पर एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए उसे बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_multisafepay_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज इंस्टॉल किए गए एक्सटेंशनों की उसी पेज की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox MultiSafepay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. OpenCart 3 के चरण 3 से 5 की तरह लाइसेंस कुंजी और API कुंजियाँ डालें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें Notification URL)।
नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox MultiSafepay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर, टेस्ट मोड चालू रहने पर पेज Test mode: new payments use the MultiSafepay test environment (no real payments). दिखाता है; जब भुगतान विधि चालू हो लेकिन वर्तमान मोड में API कुंजी न हो, तब चेतावनी देता है (ऐसी स्थिति में भुगतान विधि चेकआउट पर नहीं दिखती), और जब MultiSafepay आपके स्टोर की डिफ़ॉल्ट मुद्रा स्वीकार न करे तब भी चेतावनी देता है। एक्सटेंशन को बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता और पेज समस्या बताता है। यदि भुगतान विधि वर्तमान मोड की API कुंजी के बिना चालू है, तो सेटिंग्स चेतावनी के साथ सेव होती हैं।
Checkout
Enable/Disable: Enable MultiSafepay भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी यही भुगतान विधि नाम सेव होता है। डिफ़ॉल्ट: MultiSafepay। अनिवार्य, अधिकतम 128 अक्षर।
Description: वह पाठ जो Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया जाता है। डिफ़ॉल्ट: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.
Sort Order: चेकआउट पर भुगतान विधियों के बीच MultiSafepay की स्थिति। खाली छोड़ें या कोई पूर्ण संख्या लिखें।
Geo Zone: MultiSafepay को केवल चुने हुए geo zone के भुगतान पतों के लिए ऑफ़र करें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में वह कुल राशि जिस तक पहुँचने पर ही MultiSafepay ऑफ़र किया जाता है। किसी भी राशि पर MultiSafepay ऑफ़र करने के लिए खाली छोड़ें।
API कुंजियाँ
API कुंजी MultiSafepay Control > Manage settings > Website settings में मिलती है। इस सेक्शन में टेस्ट खाते (testmerchant.multisafepay.com) और लाइव खाते (merchant.multisafepay.com) के लिंक हैं। दोनों की कुंजियाँ अलग हैं। टेस्ट मोड केवल टेस्ट कुंजी का उपयोग करता है, लाइव मोड केवल लाइव कुंजी का।
Test mode: MultiSafepay के टेस्ट एनवायरनमेंट का उपयोग करता है (कोई असली भुगतान नहीं)। यह API पता और API कुंजी दोनों बदल देता है। जो भुगतान पहले ही हो चुके हैं, वे स्थिति जाँच और रिफ़ंड के लिए उसी एनवायरनमेंट का उपयोग करते रहते हैं जिसमें वे किए गए थे। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode: no real payment will be made. देखता है।
Test API key: आपके MultiSafepay टेस्ट खाते की API कुंजी।
Live API key: आपके MultiSafepay लाइव खाते की API कुंजी।
सेव की गई कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान लिखें जब उसे बदलना हो। सेव की गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved key on save चेक करें और Save पर क्लिक करें।
सूचनाएँ
कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। Notification URL फ़ील्ड वह पता दिखाता है जो हर भुगतान के साथ MultiSafepay को भेजा जाता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_multisafepay_gateway/webhook, OpenCart 4 पर कुछ इस तरह: https://your-store/index.php?route=extension/wcp_multisafepay_gateway/payment/wcp_multisafepay_gateway.webhook, और यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। सूचना केवल एक्सटेंशन को बताती है कि कौन-सा भुगतान बदला है: स्थिति, राशि और मुद्रा हमेशा ऑर्डर बदलने से पहले, भुगतान के एनवायरनमेंट की API कुंजी के साथ MultiSafepay API से पढ़ी जाती है। आपके स्टोर में शुरू न किए गए भुगतानों की सूचनाएँ अनदेखी की जाती हैं। स्टोर के मेंटेनेंस मोड में होने पर भी सूचना काम करती है, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है, जो ग्राहक को MultiSafepay से लौटने भी देता है।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के (एक लापता ऑर्डर) बनाता है। ऑर्डर को स्थिति तभी मिलती है जब MultiSafepay भुगतान की रिपोर्ट कर देता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।
Order status after payment: भुगतान हो चुके ऑर्डर की स्थिति। डिफ़ॉल्ट: प्रक्रिया में। भुगतान हो चुके ऑर्डर को तुरंत पूरा करने के लिए Complete चुनें।
MultiSafepay payment on hold status: भुगतान पर आपका ध्यान चाहिए (देखें Order statuses)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Payment error status: जो भुगतान अभी तय (सेटल) नहीं हुआ या आरक्षित था, वह बाद में अस्वीकृत, समाप्त या रद्द हुआ। डिफ़ॉल्ट: विफल।
Refunded status: ऑर्डर पेज से भुगतान का पूरा रिफ़ंड होने के बाद सेट होती है। डिफ़ॉल्ट: रिफ़ंड किया गया।
एडवांस्ड
Debug log: API कॉल और सूचनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में mspg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। API कुंजियाँ और ग्राहक का डेटा कभी दर्ज नहीं होता। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों का MultiSafepay भुगतान डेटा हमेशा रहता है, ताकि पुराने ऑर्डरों के रिफ़ंड संभव बने रहें। एक्सटेंशन को बंद करने से कुछ नहीं हटता। डिफ़ॉल्ट: बंद।
इंपोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API कुंजियाँ एक्सपोर्ट नहीं होतीं।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई API कुंजियाँ बनी रहती हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से MultiSafepay)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to MultiSafepay to choose a payment method and pay. OpenCart इस चरण पर ऑर्डर बनाता है, जो अब भी बिना स्थिति के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल राशि के लिए MultiSafepay भुगतान बनाता है और ग्राहक को MultiSafepay के भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके MultiSafepay खाते में सक्षम कोई भी भुगतान विधि चुनकर भुगतान करता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। ग्राहक का बिलिंग पता, ईमेल, फ़ोन और भाषा MultiSafepay को भेजे जाते हैं, और भुगतान Order #, ऑर्डर नंबर और आपके स्टोर के नाम के साथ दिखता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब MultiSafepay उसकी पुष्टि करता है: सूचना के द्वारा, या ग्राहक के लौटने पर MultiSafepay API से जाँच के द्वारा। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट भी होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है, जिस पर Your payment with MultiSafepay has been received. लिखा होता है। होल्ड पर रखे ऑर्डर के लिए पेज पर We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. दिखता है। यदि बाद में भुगतान विफल होता है, तो पेज पर Your MultiSafepay payment was not completed. Please contact us about this order. दिखता है। यदि ग्राहक के लौटने तक MultiSafepay ने भुगतान की पुष्टि नहीं की है (उदाहरण के लिए बैंक ट्रांसफ़र का इंतज़ार है), तो Payment confirmation पेज वही "पुष्टि हो रही है" पाठ और Check again बटन दिखाता है; MultiSafepay के भुगतान की रिपोर्ट करते ही सूचना ऑर्डर की स्थिति सेट कर देती है।
यदि ग्राहक MultiSafepay पेज पर रद्द करता है, या भुगतान अस्वीकृत होता है या समाप्त हो जाता है, तो ग्राहक कार्ट सुरक्षित रहते हुए चेकआउट पर लौट आता है और इनमें से कोई एक संदेश देखता है: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. या The payment session has expired. Please try again. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।
OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, जबकि OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर का दोबारा भुगतान करता है। नया भुगतान बनाने से पहले एक्सटेंशन उसी कार्ट के पिछले भुगतानों को MultiSafepay पर जाँचता है। यदि उनमें से कोई पहले ही भुगतान हो चुका है या संसाधित हो रहा है, तो वह भुगतान पुष्ट कर दिया जाता है और ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर जाता है। यदि इस ऑर्डर का भुगतान उसी एनवायरनमेंट, राशि और मुद्रा के साथ अब भी खुला है, तो वही भुगतान पेज दोबारा उपयोग होता है। अन्यथा पुराना भुगतान MultiSafepay पर रद्द कर दिया जाता है, ताकि उसे अब भुगतान न किया जा सके।
OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए होल्ड पर रहने के बाद उसका भुगतान अस्वीकृत या समाप्त हो गया, या आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है, और अगले Confirm Order पर एक नया ऑर्डर भुगतान होता है। यदि ऑर्डर का भुगतान हो चुका था और फिर स्टोर ने उसे बंद कर दिया (उदाहरण के लिए रिफ़ंड किया गया), तो संदेश है Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. यदि चेकआउट का ऑर्डर पहले ही दर्ज हो चुका है और उसके बाद कार्ट बदल गया है, तो संदेश है Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत होती है। जो कार्ट भुगतान के बाद रद्द या रिफ़ंड हुआ, उसका ऑर्डर अब उस कार्ट को नहीं रोकता।
यदि MultiSafepay भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बना रहता है और बटन के ऊपर एक छोटा संदेश देखता है, जैसे Could not connect to MultiSafepay. Please try again in a moment. या MultiSafepay cannot accept this order amount or currency. Please choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।
एक्सटेंशन एक ही भुगतान विधि देता है जो MultiSafepay पेज पर ले जाती है। हर MultiSafepay भुगतान विधि के लिए अलग OpenCart भुगतान विधियाँ नहीं हैं, कोई एम्बेडेड कार्ड फ़ील्ड नहीं हैं, कोई Apple Pay या Google Pay एक्सप्रेस बटन नहीं हैं, कोई सब्सक्रिप्शन, आवर्ती भुगतान या सेव्ड कार्ड नहीं हैं, और OpenCart से कैप्चर या void भी नहीं होता। कार्ट का डेटा नहीं भेजा जाता, इसलिए वे पे-लेटर भुगतान विधियाँ जिन्हें इसकी ज़रूरत होती है (उदाहरण के लिए Klarna, in3 या Riverty), इन ऑर्डरों के लिए MultiSafepay द्वारा ऑफ़र नहीं की जातीं।
ऑर्डर और रिफ़ंड
Order statuses
No status (missing order): ग्राहक को MultiSafepay पर भेजा गया था और उसने भुगतान नहीं किया, MultiSafepay ने अभी भुगतान की पुष्टि नहीं की है, या भुगतान रद्द, अस्वीकृत या समाप्त हो गया। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order status after payment (default Processing): MultiSafepay ने ऑर्डर की सटीक राशि और मुद्रा के साथ भुगतान की पुष्टि की है (पूरा हुआ या भेजा गया)। एक नोट भुगतान, भुगतान विधि और एनवायरनमेंट दिखाता है।
MultiSafepay payment on hold status (default Pending), before payment: भुगतान अभी सेटल नहीं हुआ है (MultiSafepay द्वारा समीक्षा हो रही है) या आरक्षित (ऑथराइज़्ड) है। पैसा पाने के लिए MultiSafepay Control में आरक्षित भुगतान को कैप्चर करें। जब MultiSafepay भुगतान को पूरा बताता है तो ऑर्डर अपने-आप Order status after payment पर चला जाता है, या जब वह अस्वीकृत, रद्द, समाप्त या void होता है तो Payment error status पर चला जाता है।
MultiSafepay payment on hold status, after payment: MultiSafepay ने ऑर्डर कुल से अलग राशि या मुद्रा की पुष्टि की, एक्सटेंशन के लाइव मोड में होने पर टेस्ट भुगतान पूरा हुआ (कोई असली पैसा नहीं मिला), या ऑर्डर को किसी दूसरी स्थिति (जैसे रद्द) मिलने के बाद भुगतान पूरा हुआ। नोट इसका कारण बताता है। MultiSafepay Control में लेन-देन जाँचें, फिर ऑर्डर को पूरा करें या रिफ़ंड करें।
MultiSafepay payment on hold status, after a chargeback: भुगतान हो चुके ऑर्डर के भुगतान के लिए MultiSafepay ने चार्जबैक की रिपोर्ट की: पैसा आपके खाते से वापस ले लिया गया।
Payment error status (default Failed): जो भुगतान अभी सेटल नहीं हुआ या आरक्षित था, वह बाद में अस्वीकृत, रद्द, समाप्त या void हुआ।
Refunded status (default Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।
भुगतान हो चुका या रिफ़ंड किया गया ऑर्डर देर से आई सूचना से दोबारा नहीं खुलता। यदि पहले से भुगतान हो चुके कार्ट के लिए दूसरा भुगतान पूरा होता है, तो भुगतान हो चुका ऑर्डर नहीं बदला जाता। एक नोट आपसे MultiSafepay Control में डुप्लिकेट भुगतान का रिफ़ंड करने को कहता है।
नोट ऑर्डर की History में वे प्रविष्टियाँ हैं जो ग्राहक को नहीं दिखतीं।
VibeFox MultiSafepay Gateway टैब
Sales > Orders में MultiSafepay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox MultiSafepay Gateway टैब में MultiSafepay order (टेस्ट भुगतानों के लिए Test environment लेबल के साथ), Method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के MultiSafepay notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिन्हें एक्सटेंशन तक पहुँच है।
रिफ़ंड
VibeFox MultiSafepay Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via MultiSafepay पर क्लिक करें। प्रश्न Refund this amount through MultiSafepay? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड दोनों समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (यह System > Users > User Groups में सेट होता है)। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो MultiSafepay ने वसूली थी, इसलिए राशि में अंतर होने के बाद आप ऑर्डर कुल के बजाय ग्राहक द्वारा वास्तव में चुकाई गई राशि तक ही रिफ़ंड कर सकते हैं। रिफ़ंड उस एनवायरनमेंट (टेस्ट या लाइव) को भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस एनवायरनमेंट की API कुंजी सेट होनी चाहिए। यदि MultiSafepay रिफ़ंड स्वीकार नहीं करता, तो टैब MultiSafepay की त्रुटि के साथ MultiSafepay refund failed: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड MultiSafepay रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूरा रिफ़ंड ऑर्डर को Refunded status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे कोई मैनुअल स्थिति बदलाव। आंशिक रिफ़ंड स्थिति नहीं बदलता। MultiSafepay के भुगतान की रिपोर्ट करने के बाद ही रिफ़ंड उपलब्ध होते हैं।
Sales > Returns में उत्पाद वापसी MultiSafepay के ज़रिए पैसे वापस नहीं भेजती।
MultiSafepay Control में किए गए रिफ़ंड, MultiSafepay के उन्हें रिपोर्ट करने पर, नोट्स में जोड़े जाते हैं। ऑर्डर की स्थिति अपने-आप नहीं बदलती। ज़रूरत हो तो उसे मैन्युअली अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox MultiSafepay Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox MultiSafepay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-multisafepay वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना MultiSafepay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी कोई भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन के Dashboard पर एक याद दिलाने वाला संदेश दिखता है। इसे × से बंद करने पर यह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, वे अब भी पुष्ट होते हैं, और रिफ़ंड काम करते हैं।
जब लाइसेंस समाप्त होता है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। जब आप एडमिन का Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़, उसके बाद हर सप्ताह। किसी cron job की ज़रूरत नहीं है। एक्सटेंशन को अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं।
समस्या निवारण
MultiSafepay does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में API कुंजी है: टेस्ट मोड में Test API key, लाइव मोड में Live API key। कुंजी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। ग्राहक को ऐसी मुद्रा में भुगतान करना होगा जिसे MultiSafepay स्वीकार करता है (स्टोर में चुनी गई मुद्रा)। यह भी जाँचें कि भुगतान का पता चुने हुए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
The payment went through, but the order stays without a status: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि स्टोर इंटरनेट से पहुँच योग्य है और भुगतान के एनवायरनमेंट की API कुंजी सेट है, क्योंकि एक्सटेंशन स्थिति MultiSafepay API से पढ़ता है। यदि API तक पहुँच नहीं हो पाती या कुंजी नहीं है, तो सूचना ERROR का उत्तर देती है और MultiSafepay उसे दोबारा भेजता है। ग्राहक के स्टोर पर लौटने पर और उसी कार्ट को दोबारा भुगतान करने की कोशिश करने पर भी ऑर्डर को स्थिति मिल जाती है।
Notification answers Invalid request: अनुरोध में कोई वैध लेन-देन ID नहीं थी। MultiSafepay की सूचनाओं में हमेशा एक होती है।
The customer sees an error after Confirm Order: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is not available. का अर्थ है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट रीलोड करना होगा। This payment method is temporarily unavailable. Please choose another payment method. आमतौर पर गलत या गायब API कुंजी का संकेत है। MultiSafepay cannot accept this order amount or currency. Please choose another payment method. का अर्थ है कि MultiSafepay ने राशि या मुद्रा अस्वीकार की।
The customer comes back and sees Payment verification failed.: वापसी का पता इस स्टोर के किसी भुगतान से मेल नहीं खाया, जैसे कोई पुराना या संपादित लिंक। ग्राहक चेकआउट से दोबारा भुगतान कर सकता है।
Order is in the on hold status: VibeFox MultiSafepay Gateway टैब के नोट पढ़ें। भुगतान अभी सेटल नहीं हुआ या आरक्षित हो सकता है, भुगतान की गई राशि या मुद्रा ऑर्डर से अलग हो सकती है, लाइव मोड में टेस्ट भुगतान आ सकता है, ऑर्डर रद्द होने के बाद भुगतान आया हो सकता है, या चार्जबैक हुआ हो सकता है। MultiSafepay Control में लेन-देन जाँचें।
Test payments do not confirm a live order: एक्सटेंशन के लाइव मोड में रहने के दौरान टेस्ट भुगतान कभी ऑर्डर का भुगतान नहीं करता; इसके बजाय ऑर्डर होल्ड पर डाल दिया जाता है। लाइव पर स्विच करने के बाद भी पहले के टेस्ट भुगतान टेस्ट कुंजी से जाँचे और रिफ़ंड किए जाते रहते हैं।
No refund form in the tab: टैब कारण बताता है: भुगतान अभी रिपोर्ट नहीं हुआ है, वह पूरी तरह रिफ़ंड हो चुका है, या आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है।
Refund fails with a message about the environment: भुगतान टेस्ट या लाइव एनवायरनमेंट में हुआ था, और उस एनवायरनमेंट की API कुंजी सेट नहीं है। उसे दर्ज करें और फिर से प्रयास करें।
डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट mspg_supported_currencies और mspg_order_request चलाता है, ताकि समर्थित मुद्राएँ और MultiSafepay को भेजे गए भुगतान डेटा बदले जा सकें।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox MultiSafepay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और स्टार्टअप एक्शन भी, जो मेंटेनेंस मोड में सूचनाओं को गुज़रने देता है)। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, API कुंजियाँ, डीबग लॉग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। MultiSafepay के भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं, ताकि पहले चुकाए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox MultiSafepay Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
MultiSafepay उनके संबंधित स्वामियों का ट्रेडमार्क है। यह एक्सटेंशन MultiSafepay से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।