VibeFox MakeCommerce for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण।

आपके स्टोर तक इंटरनेट पहुँच: MakeCommerce भुगतान सूचनाएँ आपके स्टोर को भेजता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए। फ़ायरवॉल या बेसिक ऑथेंटिकेशन इन्हें रोक सकते हैं। मेंटेनेंस मोड इन्हें नहीं रोकता: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इनके लिए एक startup action जोड़ता है।

MakeCommerce खाता: आपको MakeCommerce Merchant Portal (Settings > API) से Shop ID और Secret key चाहिए। टेस्ट और लाइव वातावरण के अलग-अलग खाते और कुंजियाँ होती हैं। कौन से भुगतान तरीके और मुद्राएँ उपलब्ध हैं, यह आपके MakeCommerce अनुबंध से तय होता है। KWD या BHD जैसी तीन दशमलव वाली मुद्राएँ नहीं दी जातीं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. टेस्ट वातावरण का Shop ID और Secret key दर्ज करें, और असली भुगतान के लिए लाइव कुंजियाँ (कॉन्फ़िगरेशन देखें)। Merchant Portal में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखकर एक भुगतान टेस्ट करें, फिर असली भुगतान स्वीकार करने के लिए उसे बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox MakeCommerce Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर, टेस्ट मोड चालू होने पर पेज Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. दिखाता है। यदि भुगतान का तरीका चालू है, लेकिन मौजूदा वातावरण का Shop ID या Secret key खाली है (तब भुगतान का तरीका चेकआउट पर छिपा रहता है), और जब स्टोर की डिफ़ॉल्ट मुद्रा को MakeCommerce चार्ज नहीं कर सकता (तब उस मुद्रा के ऑर्डर के लिए भुगतान का तरीका छिपा रहता है), तो पेज चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं हो सकता, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और हर ऑर्डर स्टेटस मौजूद होना चाहिए। अगर कोई फ़ील्ड गलत है, तो कुछ भी सेव नहीं होता और पेज वह फ़ील्ड बताता है। सेव करते समय Shop ID और कुंजियों के स्पेस हटा दिए जाते हैं।

MakeCommerce

Enable/Disable: Enable MakeCommerce payments भुगतान का तरीका चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Title: वह भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: Bank link or card (MakeCommerce)। आवश्यक, 128 अक्षर तक।

Description: वह टेक्स्ट जो Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखता है। डिफ़ॉल्ट: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

Sort Order: चेकआउट पर भुगतान के तरीकों के बीच MakeCommerce की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

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

Total: चेकआउट की वह राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक ऑर्डर पहुँचना चाहिए, उसके बाद ही MakeCommerce दिया जाता है। किसी भी राशि पर MakeCommerce देने के लिए खाली छोड़ें।

MakeCommerce खाता

Shop ID और Secret key MakeCommerce Merchant Portal में Settings > API के अंतर्गत हैं। टेस्ट पोर्टल और लाइव पोर्टल के अलग-अलग खाते और कुंजियाँ हैं। इस सेक्शन में दोनों पोर्टल और MakeCommerce की साइन-अप पेज के लिंक हैं।

Test mode: MakeCommerce टेस्ट वातावरण का उपयोग करता है (कोई असली पैसा नहीं काटा जाता)। नए भुगतान चुने हुए वातावरण में उसकी कुंजियों के साथ बनते हैं। हर ऑर्डर यह याद रखता है कि वह किस वातावरण में भुगतान हुआ था: स्टेटस जाँच और रिफ़ंड हमेशा वहीं जाते हैं। चालू होने पर ग्राहक Confirm Order चरण पर TEST MODE — MakeCommerce test environment, no real money is charged. देखते हैं। डिफ़ॉल्ट: चालू।

Test Shop ID: आपके टेस्ट खाते का Shop ID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx के रूप में।

Test Secret key: आपके टेस्ट खाते की Secret key। यह भुगतान संदेशों पर साइन करती है और उन्हें सत्यापित करती है।

Live Shop ID: आपके लाइव खाते का Shop ID, उसी रूप में।

Live Secret key: आपके लाइव खाते की Secret key।

सेव की गई Secret key फिर कभी नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। मान बदलने के लिए ही नया मान दर्ज करें। सेव की गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved key on save पर टिक करें और Save पर क्लिक करें।

भुगतान सूचनाएँ

Merchant Portal में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। Callback URLs संदर्भ के लिए ग्राहक के लौटने या रद्द करने का पता और भुगतान सूचनाओं का पता दिखाता है। ये आपके OpenCart इंस्टॉलेशन के स्टोर पते से बनते हैं, उदाहरण के लिए OpenCart 3 पर https://your-store/index.php?route=extension/payment/wcp_makecommerce_payment/notification और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_makecommerce_payment/payment/wcp_makecommerce_payment.notification। हर लेन-देन में इन पतों पर ऑर्डर नंबर और एक कुंजी जोड़कर बने अपने वापसी, रद्द और सूचना URL होते हैं। MakeCommerce एक साइन किया हुआ संदेश सूचना URL पर (सर्वर से सर्वर) भेजता है, और ग्राहक के ब्राउज़र के ज़रिए वापसी या रद्द URL पर भी। साइनेचर उस वातावरण की Secret key से जाँचा जाता है जिसमें लेन-देन बना था। वैध साइनेचर के बिना संदेश अस्वीकार किए जाते हैं।

यह एक्सटेंशन ये MakeCommerce लेन-देन स्थितियाँ संभालता है:

जब ग्राहक स्टोर पर लौटता है, तब भी भुगतान की पुष्टि होती है। यदि ग्राहक बिना साइन किए संदेश के लौटता है, तो एक्सटेंशन MakeCommerce API से स्टेटस माँगता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक गायब ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब MakeCommerce भुगतान की पुष्टि कर दे (साइन किया हुआ नोटिफ़िकेशन, या ग्राहक की साइन की हुई वापसी, MakeCommerce API से जाँचकर)। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस दिखाता है।

Order Status After Payment: सत्यापित MakeCommerce भुगतान के बाद का स्टेटस। डिफ़ॉल्ट: Processing (प्रोसेसिंग)।

Payment On Hold Status: भुगतान को मैन्युअल समीक्षा चाहिए: भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है, लेन-देन MakeCommerce पर अभी अंतिम नहीं है, या पैसा रद्द किए गए ऑर्डर के लिए आया है। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending (भुगतान लंबित), क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Cancelled Order Status: वह स्टेटस जो आपके स्टोर में "रद्द" का अर्थ रखता है। ऐसे ऑर्डर के लिए आने वाला MakeCommerce भुगतान ऑर्डर को on hold कर देता है। एक्सटेंशन यह स्टेटस स्वयं कभी नहीं सेट करता। डिफ़ॉल्ट: Canceled (रद्द)।

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded (रिफ़ंड किया गया)।

उन्नत

Debug log: API कॉल और भुगतान सूचनाएँ OpenCart लॉग फ़ोल्डर (storage/logs) में wc_mkc_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ और ग्राहक का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

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

Delete data: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से एक्सटेंशन की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनका MakeCommerce भुगतान डेटा हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

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

Export: Download JSON सेटिंग्स को JSON फ़ाइल में सहेजता है। Shop ID और Secret key एक्सपोर्ट नहीं होते।

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान का तरीका चुनता है (डिफ़ॉल्ट रूप से Bank link or card (MakeCommerce))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल के लिए एक MakeCommerce लेन-देन बनाता है और ग्राहक को MakeCommerce भुगतान पेज पर भेजता है। वहाँ ग्राहक बैंक लिंक या कार्ड चुनता है। OpenCart 4 पर ग्राहक Payment method options विंडो में भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। ग्राहक का ईमेल और देश MakeCommerce को भेजे जाते हैं, और यदि MakeCommerce समर्थन करता है तो पेज स्टोर की भाषा में खुलता है (एस्टोनियाई, अंग्रेज़ी, लाटवियाई, लिथुआनियाई, फ़िनिश, रूसी, जर्मन, पोलिश), अन्यथा अंग्रेज़ी में।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ माना जाता है जब MakeCommerce उसकी पुष्टि करे: साइन किए गए नोटिफ़िकेशन से या ग्राहक की साइन की हुई वापसी से, और MakeCommerce API के माध्यम से लेन-देन की जाँच के साथ। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart ऑर्डर सफलता पेज देखता है, जिस पर Your MakeCommerce payment has been received. लिखा होता है। यदि ऑर्डर रिव्यू स्टेटस में चला गया हो, तो पेज Your MakeCommerce payment was received and is being reviewed by the store. दिखाता है।

यदि भुगतान मंज़ूर हो गया है लेकिन अभी पूरा नहीं हुआ, या उसी समय कोई और अनुरोध ऑर्डर की पुष्टि कर रहा है, या MakeCommerce तक पहुँच नहीं हो पा रही है, तो एक Payment confirmation पेज We could not confirm your payment yet. If you completed it, your order will be updated automatically — please do not pay again. संदेश के साथ दिखाता है, और Check again तथा Back to checkout बटन। Check again MakeCommerce से ऑर्डर के नवीनतम लेन-देन का स्टेटस माँगता है। भुगतान पूरा होते ही नोटिफ़िकेशन ऑर्डर स्टेटस सेट कर देता है।

यदि ग्राहक MakeCommerce पेज पर रद्द करता है, या भुगतान की समय-सीमा समाप्त हो जाती है या विफल हो जाता है, तो ग्राहक एक संदेश के साथ चेकआउट पर लौट आता है, जैसे The payment was cancelled. You can try again or choose another payment method., The payment session expired. Please try again., या The payment was not completed. Please try again or choose another payment method. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। कार्ट बना रहता है और ग्राहक फिर से भुगतान कर सकता है। हर प्रयास एक नया MakeCommerce लेन-देन है (OpenCart 3 भी हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखकर उसे फिर से चुकाता है)। नया लेन-देन बनाने से पहले, उसी कार्ट के खुले प्रयास MakeCommerce पर जाँचे जाते हैं: यदि उनमें से कोई पहले से भुगतान हो चुका है, तो ग्राहक सीधे सफलता पेज पर जाता है। उसी कार्ट का पुराना भुगतान लिंक अब भी काम करता है, लेकिन कार्ट कभी दो ऑर्डरों के लिए भुगतान नहीं होता: पहले से भुगतान हो चुके कार्ट के किसी पुराने ऑर्डर पर देर से आया भुगतान केवल भुगतान किए गए ऑर्डर में एक नोट जोड़ता है।

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

यदि MakeCommerce भुगतान शुरू नहीं कर सकता, तो ग्राहक Confirm Order चरण पर रहता है, MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. या MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. के साथ। तकनीकी कारण लॉग में लिखा जाता है।

बैंक या कार्ड MakeCommerce पेज पर चुना जाता है, आपके स्टोर के चेकआउट पर नहीं। इस एक्सटेंशन में सेव किए गए कार्ड, आवर्ती भुगतान या सब्सक्रिप्शन नहीं हैं, और MakeCommerce के ज़रिए शिपिंग (पार्सल मशीनें, लेबल) भी नहीं है।

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

ऑर्डर स्टेटस

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

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई। एक नोट राशि, लेन-देन, वातावरण और इसकी जाँच का तरीका (MakeCommerce API या साइन किया हुआ नोटिफ़िकेशन) दिखाता है।

Payment On Hold Status (डिफ़ॉल्ट Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, राशि गायब थी, MakeCommerce पर लेन-देन पूरा होने की सूचना के बावजूद अभी अंतिम नहीं था, या भुगतान ऑर्डर रद्द होने के बाद आया। नोट इसे समझाता है। जिस लेन-देन में अंतर है, वह बाद में ऑर्डर का भुगतान कभी नहीं करता; जो लेन-देन अभी अंतिम नहीं था, वह MakeCommerce द्वारा पूरा होने की सूचना देने पर ऑर्डर पूरा करता है। Merchant Portal में लेन-देन जाँचें और ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे MakeCommerce Merchant Portal में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। रिफ़ंड किए गए ऑर्डर या किसी दूसरे भुगतान तरीके पर बदले गए ऑर्डर के लिए भुगतान केवल एक नोट जोड़ता है।

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

VibeFox MakeCommerce Payment टैब

Sales > Orders में MakeCommerce से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox MakeCommerce Payment टैब ऑर्डर के सभी MakeCommerce लेन-देन दिखाता है (तारीख, लेन-देन ID, टेस्ट भुगतानों के लिए Test लेबल, राशि, MakeCommerce स्टेटस और परिणाम), Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के MakeCommerce notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है; इसके बटनों के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

Check MakeCommerce payment status: MakeCommerce API से ऑर्डर के लेन-देन का स्टेटस माँगता है (सबसे नए से शुरू करके), उसे लागू करता है और परिणाम के साथ एक नोट जोड़ता है। इसका उपयोग तब करें जब कोई ग्राहक कहे कि उसने भुगतान कर दिया है, लेकिन ऑर्डर का कोई स्टेटस नहीं है।

रिफ़ंड

VibeFox MakeCommerce Payment टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह पहले से भरी होती है), वैकल्पिक रूप से Reason (optional) दर्ज करें, और Refund via MakeCommerce पर क्लिक करें। प्रश्न Refund this amount via MakeCommerce? की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। रिफ़ंड MakeCommerce लेन-देन की राशि और मुद्रा तक सीमित है, इसलिए राशि में अंतर होने पर आप ऑर्डर के कुल योग के बजाय उतना ही रिफ़ंड कर सकते हैं जितना ग्राहक ने वास्तव में भुगतान किया था। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें भुगतान हुआ था (टेस्ट या लाइव), इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए। कारण MakeCommerce को रिफ़ंड टिप्पणी के रूप में भेजा जाता है; कारण न होने पर टिप्पणी Refund for order और ऑर्डर नंबर होती है। यदि MakeCommerce रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है, एक नोट जुड़ता है और कोई रिफ़ंड दर्ज नहीं होता। यदि MakeCommerce अभी भी भुगतान प्रोसेस कर रहा है, तो संदेश है MakeCommerce is still processing this payment — try the refund again later. सफल रिफ़ंड MakeCommerce रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर ले जाता है, ग्राहक को सूचित किए बिना और मैन्युअल स्टेटस बदलने की तरह उत्पादों को स्टॉक में लौटाए बिना। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब MakeCommerce भुगतान की पुष्टि कर चुका हो।

Sales > Returns में उत्पाद रिटर्न MakeCommerce के ज़रिए पैसे वापस नहीं भेजते।

Merchant Portal में किए गए रिफ़ंड लेन-देन स्टेटस के साथ आते हैं और नोट्स में जोड़े जाते हैं। ऑर्डर स्टेटस अपने-आप नहीं बदलता।

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

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

एक कुंजी एक ही डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

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

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

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

MakeCommerce चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा वातावरण की कुंजियाँ हैं: टेस्ट मोड में Test Shop ID और Test Secret key, लाइव मोड में Live Shop ID और Live Secret key। जाँचें कि ऑर्डर की मुद्रा में अधिकतम दो दशमलव स्थान हैं, कि भुगतान पता चुने हुए Geo Zone में है, और कि ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रहता है: नोटिफ़िकेशन स्टोर तक नहीं पहुँच सके, उदाहरण के लिए फ़ायरवॉल या बेसिक ऑथेंटिकेशन के कारण। जब ग्राहक स्टोर पर लौटता है या Check again पर क्लिक करता है, और जब आप ऑर्डर टैब में Check MakeCommerce payment status पर क्लिक करते हैं, तब भी ऑर्डर को स्टेटस मिल जाता है। जाँचें कि जिस वातावरण में भुगतान हुआ था, उसकी कुंजियाँ सेट हैं: नोटिफ़िकेशन उस वातावरण की Secret key से जाँचा जाता है, और उसके बिना MakeCommerce को त्रुटि मिलती है और वह फिर से कोशिश करता है। नोटिफ़िकेशन देखने के लिए Debug log चालू करें।

ऑर्डर रिव्यू स्टेटस में है: ऑर्डर टैब में MakeCommerce notes पढ़ें (ऑर्डर स्टेटस देखें), Merchant Portal में लेन-देन जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

नोटिफ़िकेशन अस्वीकार किए जाते हैं: गलत साइनेचर वाला, किसी दूसरे ऑर्डर, दूसरे स्टोर, या ऑर्डर के लिए न बने लेन-देन वाला संदेश अस्वीकार किया जाता है और कुछ नहीं बदलता। जाँचें कि Shop ID और Secret key एक ही MakeCommerce खाते और वातावरण के हैं।

ग्राहक Confirm Order के बाद त्रुटि देखता है: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is not available. Please reload the checkout page. का मतलब है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान का तरीका बंद कर दिया गया: ग्राहक को चेकआउट रीलोड करना होगा। जो मुद्रा MakeCommerce चार्ज नहीं कर सकता, उसके लिए MakeCommerce cannot process payments in और मुद्रा कोड दिखता है।

वातावरण से जुड़े संदेश के साथ रिफ़ंड विफल होता है: ऑर्डर टेस्ट या लाइव वातावरण में भुगतान हुआ था, और उस वातावरण की कुंजियाँ कॉन्फ़िगर नहीं हैं। उन्हें दर्ज करें और फिर कोशिश करें।

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

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wc_mkc_transaction_data, wc_mkc_customer_data, wc_mkc_supported_locales और wc_mkc_is_available को ट्रिगर करता है, ताकि लेन-देन डेटा, ग्राहक डेटा, भुगतान पेज की भाषाएँ और भुगतान तरीके की उपलब्धता बदली जा सके।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox MakeCommerce Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में सूचनाओं को आगे जाने देता है)। यदि Delete data चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, Shop ID, Secret key, डीबग लॉग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे जाते हैं। MakeCommerce लेन-देन और रिफ़ंड हमेशा रखे जाते हैं, ताकि पहले से भुगतान हुए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

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

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