VibeFox Mollie for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: चेकआउट की मुद्रा उन मुद्राओं में से एक होनी चाहिए जिन्हें Mollie सपोर्ट करता है: AED, AUD, BGN, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, HUF, ILS, ISK, JPY, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TWD, USD, ZAR। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है। Mollie कौन-सी भुगतान विधियाँ देता है, यह मुद्रा और आपके खाते पर निर्भर करता है।

आपके स्टोर के लिए इंटरनेट एक्सेस: Mollie आपके स्टोर को webhooks भेजता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए। Webhooks के बिना, ग्राहक के Mollie से लौटने पर ऑर्डर को उसकी स्थिति मिलती है।

Mollie खाता: आपको Mollie Dashboard > Developers > API keys से API keys चाहिए। टेस्ट keys test_ से और लाइव keys live_ से शुरू होती हैं। किसी और key या secret की ज़रूरत नहीं है। भुगतान विधियाँ स्वयं आपके Mollie खाते में सक्रिय की जाती हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी टेस्ट और लाइव API keys दर्ज करें (देखें Configuration)। Mollie में कोई webhook सेट करने की ज़रूरत नहीं है।

5. Enable/Disable चालू करें और Save पर क्लिक करें। जब तक आप एक टेस्ट भुगतान न कर लें, Test Mode चालू रहने दें, फिर उसे बंद कर दें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और API keys वैसे ही दर्ज करें जैसा OpenCart 3 के चरण 3 से 5 में है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल webhook URL अलग है (देखें Webhook URL)।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Mollie Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है यदि Mollie सक्रिय है लेकिन वर्तमान मोड की API key खाली है, और यदि Mollie स्टोर की डिफ़ॉल्ट मुद्रा को सपोर्ट नहीं करता। दोनों स्थितियों में भुगतान विधि चेकआउट पर छिपी रहती है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय, Title में 1 से 128 अक्षर होने चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए और Total 0 या उससे अधिक की संख्या होनी चाहिए; अन्यथा कुछ भी सहेजा नहीं जाता। जो API key test_ या live_ से शुरू नहीं होती, जिसके बाद कम से कम 30 अक्षर और अंक न हों, वह सहेजी नहीं जाती: पेज Settings saved, except the API key shown in red. दिखाता है, त्रुटि उस key का नाम बताती है, और पहले सहेजी गई key बनी रहती है।

Checkout

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

Title: चेकआउट के दौरान ग्राहक को दिखने वाला भुगतान विधि का शीर्षक। यही वह नाम भी है जो ऑर्डर में सहेजा जाता है। डिफ़ॉल्ट: Mollie। आवश्यक।

Description: Confirm Order चरण में, पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely via Mollie।

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

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

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

API keys

अपनी API keys Mollie Dashboard में Developers > API keys के तहत मिलेंगी; यह सेक्शन उसी पेज का लिंक देता है। टेस्ट और लाइव keys अलग-अलग होती हैं।

Test Mode: नए भुगतानों के लिए टेस्ट API key का उपयोग करता है। कोई वास्तविक भुगतान संसाधित नहीं होता। Mollie के टेस्ट चेकआउट पेज पर आप भुगतान का परिणाम चुन सकते हैं। ग्राहक Confirm Order चरण पर Test mode: no real payment will be made. देखते हैं। दूसरे मोड में किए गए भुगतान स्थिति जाँच और रिफ़ंड के लिए अपने मोड की key का उपयोग करते रहते हैं। डिफ़ॉल्ट: चालू।

Test API Key: आपकी Mollie टेस्ट API key (test_ से शुरू होती है)।

Live API Key: आपकी Mollie लाइव API key (live_ से शुरू होती है)।

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

Webhook

Webhook URL: केवल संदर्भ के लिए दिखाया जाता है। कोई webhook सेटअप आवश्यक नहीं है: एक्सटेंशन हर भुगतान के साथ यह URL Mollie को भेजता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_mollie_gateway/webhook जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_mollie_gateway/payment/wcp_mollie_gateway.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे इंटरनेट से पहुँच योग्य होना चाहिए, अन्यथा ऑर्डर को उसकी स्थिति केवल तब मिलती है जब ग्राहक Mollie से लौटता है।

ऑर्डर

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

Order Status After Payment: सफल भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रोसेसिंग। भुगतान किए गए ऑर्डर को पूर्ण चिह्नित करने के लिए Complete चुनें।

Awaiting Mollie Payment Status: ग्राहक ने Mollie पेज पर बैंक ट्रांसफ़र चुना; जब Mollie को पैसा मिलता है तो ऑर्डर स्वतः भुगतान किया हुआ चिह्नित हो जाता है। डिफ़ॉल्ट: लंबित।

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

Payment Error Status: अपेक्षित बैंक ट्रांसफ़र या अधिकृत भुगतान विफल हुआ, समाप्त हो गया या रद्द हो गया। डिफ़ॉल्ट: विफल।

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

उन्नत

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

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

Delete Data on Uninstall: चालू होने पर, एक्सटेंशन अनइंस्टॉल होने पर गेटवे सेटिंग्स और उसका लॉग हटा दिए जाते हैं। ऑर्डर के साथ सहेजे गए Mollie भुगतान ID (भुगतान, रिफ़ंड) हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

आयात / निर्यात

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Mollie)। Confirm Order चरण पर ग्राहक आपका विवरण और You will be redirected to Mollie to choose a payment method and pay. वाली सूचना देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर राशि के लिए एक Mollie भुगतान बनाता है (JPY और ISK में दशमलव नहीं होते), जिसका विवरण Order # और ऑर्डर नंबर होता है, और ग्राहक को Mollie द्वारा होस्ट किए गए चेकआउट पेज पर भेजता है। वहाँ ग्राहक आपके Mollie खाते में सक्रिय भुगतान विधियों में से कोई एक चुनता है और भुगतान करता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

Mollie के webhooks में कोई हस्ताक्षर नहीं होता, केवल भुगतान ID होता है। इसलिए एक्सटेंशन कभी भी webhook पर अपने आप भरोसा नहीं करता: वह केवल वे भुगतान ID स्वीकार करता है जो उसने स्वयं बनाए हैं, भुगतान किए गए मोड की key के साथ Mollie API से भुगतान पढ़ता है, जाँचता है कि भुगतान ऑर्डर का है, और भुगतान की गई राशि तथा मुद्रा की ऑर्डर कुल से तुलना करता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Mollie इस तरह पुष्टि कर देता है। एक्सटेंशन Mollie की इन भुगतान स्थितियों को संभालता है:

जब ग्राहक लौटता है, तो एक्सटेंशन उसी तरह Mollie API से भुगतान की जाँच करता है। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को Your payment with Mollie has been received. के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। बैंक ट्रांसफ़र के लिए पेज Your order will be processed as soon as Mollie receives your bank transfer. दिखाता है। यदि ऑर्डर होल्ड पर है, तो पेज We are confirming your payment with Mollie. The order will be updated automatically — please do not pay again. दिखाता है। यदि प्रतीक्षित भुगतान विफल हुआ, तो पेज Your Mollie payment was not completed. Please contact us about this order. दिखाता है।

यदि भुगतान रद्द हुआ, विफल हुआ, समाप्त हो गया या पूरा नहीं हुआ, तो ग्राहक एक संदेश के साथ चेकआउट पर वापस आता है, उदाहरण के लिए You cancelled the Mollie payment. You can try again or choose another payment method. या The Mollie payment has expired. Please try again or choose another payment method. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है। यदि Mollie तक नहीं पहुँचा जा सकता या उसने अभी तक निर्णय नहीं लिया है, तो Payment confirmation पेज दिखता है, जो ग्राहक से दोबारा भुगतान न करने को कहता है और Check again बटन देता है; webhook आते ही ऑर्डर की स्थिति सेट कर देता है।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर का भुगतान नए Mollie भुगतान से फिर कराता है। दोनों ही स्थितियों में एक्सटेंशन एक ही कार्ट के सभी ऑर्डरों को एक भुगतान मानता है। जब ग्राहक फिर से भुगतान करता है, तो उसी राशि का अभी भी खुला Mollie भुगतान पुनः उपयोग किया जाता है, दूसरा देय भुगतान नहीं बनाया जाता। यदि कुल राशि बदल गई है, तो Mollie की अनुमति होने पर पुराना खुला भुगतान Mollie पर रद्द कर दिया जाता है। यदि इस बीच कोई पुराना भुगतान हो गया है, तो वह भुगतान पुष्ट होता है और ग्राहक बिना नए भुगतान के सफलता पेज पर जाता है।

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

यदि Mollie भुगतान शुरू नहीं कर सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे The payment provider could not be reached. Please try again in a moment., This payment method is temporarily unavailable. Please choose another payment method. (गलत API key) या Mollie cannot accept a payment of this amount or currency. Please choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।

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

ग्राहक Mollie विधि आपके चेकआउट में नहीं, बल्कि Mollie पेज पर चुनता है। एक्सटेंशन में सब्सक्रिप्शन या आवर्ती भुगतान, सहेजे गए कार्ड या मैंडेट, आपकी साइट पर कार्ड फ़ील्ड, Apple Pay या PayPal एक्सप्रेस बटन और Orders API नहीं है, इसलिए ऐसी विधियाँ जिन्हें ऑर्डर लाइनों की आवश्यकता होती है (उदाहरण के लिए कुछ Klarna, Billie या in3 वेरिएंट), इन भुगतानों के लिए Mollie द्वारा प्रस्तुत नहीं की जातीं। अधिकृत भुगतान OpenCart से नहीं, बल्कि Mollie Dashboard में कैप्चर या void किए जाते हैं।

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

ऑर्डर स्थितियाँ

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

Order Status After Payment (डिफ़ॉल्ट प्रोसेसिंग): भुगतान की पुष्टि हुई। एक नोट Mollie भुगतान (tr_...), विधि और मोड दिखाता है।

Awaiting Mollie Payment Status (डिफ़ॉल्ट लंबित): ग्राहक ने Mollie पेज पर बैंक ट्रांसफ़र चुना। जब Mollie को पैसा मिलता है, तब ऑर्डर भुगतान किए गए स्थिति में चला जाता है।

Mollie Payment On Hold Status (डिफ़ॉल्ट लंबित): अधिकृत भुगतान कैप्चर की प्रतीक्षा कर रहा है, Mollie ने चार्ज-बैक की रिपोर्ट की है, भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, स्टोर लाइव मोड में होने के दौरान टेस्ट भुगतान हुआ (कोई पैसा नहीं मिला), या ऑर्डर को कोई दूसरी स्थिति मिलने के बाद भुगतान आया (उदाहरण के लिए, उसे रद्द कर दिया गया था)। नोट इसे समझाता है। Mollie Dashboard में भुगतान की जाँच करें, फिर ऑर्डर को संसाधित करें या भुगतान रिफ़ंड करें।

Payment Error Status (डिफ़ॉल्ट विफल): किसी ऑर्डर का बैंक ट्रांसफ़र या अधिकृत भुगतान विफल हुआ, समाप्त हो गया या रद्द हो गया।

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

OpenCart इन स्थिति परिवर्तनों की सूचना सामान्य तरीके से ग्राहक को देता है। यदि उसी कार्ट का दूसरा भुगतान हो जाता है, तो ऑर्डर नहीं बदला जाता। भुगतान किए गए ऑर्डर पर एक नोट आपसे अनुरोध करता है कि आप अपने Mollie Dashboard में डुप्लिकेट भुगतान रिफ़ंड करें।

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

VibeFox Mollie Gateway टैब

Sales > Orders में Mollie से भुगतान किया गया एक ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Mollie Gateway टैब परीक्षण भुगतानों के लिए Test mode लेबल के साथ Mollie payment ID, Method, भुगतान की Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास (तारीख, रिफ़ंड ID, राशि, मोड, Mollie स्थिति, कारण) और ऑर्डर के Mollie notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Mollie Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Mollie पर क्लिक करें। Refund this amount through Mollie? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो Mollie ने चार्ज की थी, इसलिए राशि में अंतर होने के बाद आप ऑर्डर कुल तक नहीं, बल्कि ग्राहक द्वारा वास्तव में भुगतान की गई राशि तक ही रिफ़ंड कर सकते हैं। रिफ़ंड उस भुगतान के लिए भेजा जाता है जिसने ऑर्डर को वास्तव में भुगतान किया, और उसी मोड की API key के साथ भेजा जाता है जिसमें वह किया गया था, इसलिए उस मोड की key सेट होनी चाहिए। यदि Mollie रिफ़ंड अस्वीकार करता है या उसे विफल या रद्द बताता है, तो टैब संदेश दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Mollie रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोटों में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर की स्थिति Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे मैनुअल स्थिति परिवर्तन होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब Mollie भुगतान को भुगतान किया हुआ बता चुका हो।

Sales > Returns में उत्पाद वापसी Mollie के माध्यम से पैसा वापस नहीं भेजती। Mollie Dashboard में बनाए गए रिफ़ंड ऑर्डर पर नहीं दिखते; चार्ज-बैक एक नोट जोड़ता है।

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

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

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

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

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

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

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

भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहता है: webhook आपके स्टोर तक नहीं पहुँच पा रहा है। Webhook URL में दिखाया गया URL इंटरनेट से पहुँच योग्य होना चाहिए (कोई बेसिक ऑथेंटिकेशन या बीच में आने वाली फ़ायरवॉल नहीं होनी चाहिए)। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर, या जब ग्राहक Check again पर क्लिक करता है, तब भी ऑर्डर को स्थिति मिलती है।

Webhook जवाब देता है Unknown payment.: भुगतान इस स्टोर द्वारा नहीं बनाया गया, या Mollie उसे उसके मोड की API key के लिए नहीं जानता, उदाहरण के लिए किसी दूसरे Mollie खाते का भुगतान।

Webhook जवाब देता है Payment ID mismatch.: भुगतान उस ऑर्डर का नहीं है जिसके लिए वह बनाया गया था। कुछ नहीं बदला जाता।

Webhook जवाब देता है Failed to fetch payment.: Mollie API तक नहीं पहुँचा जा सका, या भुगतान के मोड की API key सेट नहीं है। Mollie बाद में webhook को फिर से प्रयास करता है।

Webhook जवाब देता है Temporarily unavailable.: उसी समय कार्ट किसी दूसरे अनुरोध द्वारा संसाधित हो रहा था, या ऑर्डर की स्थिति सेट नहीं की जा सकी। Mollie webhook को फिर से प्रयास करता है। कारण देखने के लिए Logging चालू करें।

Webhook URL ब्राउज़र में Method not allowed. दिखाता है: यह सामान्य है। यह URL केवल Mollie से आने वाले अनुरोध स्वीकार करता है।

कोई API key सहेजी नहीं जाती: key test_ या live_ से शुरू होनी चाहिए, उसके बाद कम से कम 30 अक्षर और अंक हों। उसे Mollie Dashboard से फिर से कॉपी करें।

Confirm Order के बाद ग्राहक को त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। उसमें HTTP कोड और Mollie का संदेश दिखता है। 401 का अर्थ है गलत API key; 422 अनुरोध के किसी फ़ील्ड की ओर इशारा करता है, उदाहरण के लिए ऐसी राशि या मुद्रा जिसे Mollie स्वीकार नहीं करता। This payment method is not available. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट फिर से लोड करना होगा।

ऑर्डर On hold स्थिति में है: VibeFox Mollie Gateway टैब के नोट पढ़ें (देखें Order statuses), फिर ऑर्डर संसाधित करें या भुगतान रिफ़ंड करें।

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

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट molg_supported_currencies (मुद्रा सूची) और molg_payment_data (Mollie भुगतान बनने से पहले का भुगतान अनुरोध और ऑर्डर) ट्रिगर करता है।

अनइंस्टॉल

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

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

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