VibeFox Mollie for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
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 वेबहुक आपके स्टोर को भेजता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए। वेबहुक न हों, तब भी ग्राहक के Mollie से लौटने पर ऑर्डर अपडेट होते हैं।
Mollie खाता: आपको Mollie Dashboard > Developers > API keys की API कुंजियाँ चाहिए। टेस्ट कुंजियाँ test_ से और लाइव कुंजियाँ live_ से शुरू होती हैं। भुगतान तरीके स्वयं आपके Mollie खाते में सक्रिय किए जाते हैं।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_mollie_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Mollie > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के सबसे ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. अपनी टेस्ट और लाइव API कुंजियाँ डालें (देखें कॉन्फ़िगरेशन)। Mollie में कोई वेबहुक सेट करने की ज़रूरत नहीं है।
6. Enable/Disable चालू करें। जब तक टेस्ट भुगतान न कर लें, Test Mode चालू रहने दें, फिर उसे बंद करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Mollie। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब Mollie सक्रिय हो पर मौजूदा मोड की API कुंजी खाली हो, और जब Mollie स्टोर की मुद्रा को सपोर्ट न करता हो। दोनों स्थितियों में चेकआउट पर यह भुगतान तरीका छिप जाता है। भुगतान तरीकों की सूची में, जब तक मौजूदा मोड में API कुंजी न हो, Mollie को सेटअप की ज़रूरत वाला बताया जाता है, और टेस्ट मोड चालू होने पर Test mode दिखता है।
सेव करते समय, ऐसी API कुंजी सेव नहीं होती जो test_ या live_ से शुरू न हो और जिसके बाद कम से कम 30 अक्षर और अंक न हों: एक त्रुटि दिखती है और पिछला मान बना रहता है।
चेकआउट
Enable/Disable: Enable Mollie Gateway इस भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का शीर्षक। डिफ़ॉल्ट: Mollie।
Description: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का विवरण। डिफ़ॉल्ट: Pay securely via Mollie।
API कुंजियाँ
आपकी API कुंजियाँ Mollie Dashboard > Developers > API keys में मिलती हैं। वेबहुक सेटअप की ज़रूरत नहीं है: प्लगइन हर भुगतान के साथ अपना वेबहुक URL भेजता है। यह URL इसी सेक्शन में दिखता है और ऐसा दिखता है: https://your-site/?wc-api=molg_mollie_webhook। यह इंटरनेट से पहुँच योग्य होना चाहिए, वरना ऑर्डर तभी अपडेट होते हैं जब ग्राहक Mollie से लौटता है।
Test Mode: Enable test mode नए भुगतानों के लिए टेस्ट API कुंजी का उपयोग करता है। कोई वास्तविक भुगतान संसाधित नहीं होता। Mollie के टेस्ट भुगतान पेज पर आप परिणाम चुन सकते हैं (paid, failed, cancelled, expired)। ग्राहक चेकआउट पर Test mode: no real payment will be made. देखते हैं। दूसरे मोड में किए गए भुगतान स्थिति जाँच और रिफ़ंड के लिए अपने मोड की कुंजी का उपयोग करते रहते हैं। डिफ़ॉल्ट: चालू।
Test API Key: आपकी Mollie टेस्ट API कुंजी (test_ से शुरू होती है)।
Live API Key: आपकी Mollie लाइव API कुंजी (live_ से शुरू होती है)।
ऑर्डर
Order Status After Payment: सफल भुगतान के बाद ऑर्डर का जो स्टेटस सेट होगा। स्टेटस एक ही चरण में सेट होता है, बिना दूसरे स्टेटस बदलाव के।
उन्नत
Logging: Enable debug logging API कॉल और वेबहुक को WooCommerce > Status > Logs में, स्रोत wcp_mollie_gateway के साथ लिखता है। त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजियाँ और ग्राहक का डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।
Delete Data on Uninstall: Remove the plugin settings and logs when uninstalling। चेक करने पर प्लगइन हटाते समय उसकी सेटिंग्स और लॉग फ़ाइलें भी हट जाती हैं। ऑर्डर पर सेव Mollie भुगतान ID बने रहते हैं। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Mollie) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर राशि के लिए एक Mollie भुगतान बनाता है (JPY और ISK बिना दशमलव के), विवरण में Order # और ऑर्डर नंबर डालता है, और ग्राहक को Mollie के होस्टेड चेकआउट पेज पर भेजता है। वहाँ ग्राहक आपके Mollie खाते में सक्रिय भुगतान तरीकों में से कोई एक चुनकर भुगतान करता है।
Mollie के वेबहुक में कोई हस्ताक्षर नहीं होता, केवल भुगतान ID होता है। इसलिए प्लगइन किसी वेबहुक पर अकेले भरोसा नहीं करता: वह आपकी अपनी API कुंजी से Mollie API पर भुगतान लाता है, जाँचता है कि भुगतान इसी ऑर्डर का है, और भुगतान की गई राशि व मुद्रा की ऑर्डर से तुलना करता है। इस तरह Mollie की पुष्टि के बाद ही ऑर्डर भुगतान किया हुआ चिह्नित होता है। प्लगइन ये Mollie भुगतान स्टेटस संभालता है:
ग्राहक के लौटने पर प्लगइन उसी तरह Mollie API से आखिरी भुगतान जाँचता है। भुगतान हो चुका हो तो ग्राहक ऑर्डर प्राप्ति पेज पर जाता है। भुगतान रद्द हुआ, विफल हुआ, समाप्त हुआ या अधूरा है, तो ग्राहक एक संदेश के साथ Pay for 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.
ग्राहक दोबारा भुगतान करता है, तो उसी राशि का अभी खुला Mollie भुगतान दोबारा इस्तेमाल होता है, दूसरा भुगतान योग्य भुगतान नहीं बनता। ऑर्डर राशि बदली हो, तो Mollie की अनुमति होने पर पुराना खुला भुगतान Mollie में रद्द कर दिया जाता है। अगर इस बीच पुराना भुगतान हो चुका है, तो बिना नए भुगतान के ऑर्डर भुगतान किया हुआ चिह्नित हो जाता है।
अगर Mollie भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे 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 कुंजी) या Mollie cannot accept a payment of this amount or currency. Please choose another payment method. तकनीकी कारण ऑर्डर नोट्स और लॉग में जुड़ जाता है।
यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
ग्राहक Mollie का तरीका आपके चेकआउट पर नहीं, बल्कि Mollie के पेज पर चुनता है। प्लगइन में सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड या मैंडेट, Mollie Components (आपकी साइट पर कार्ड फ़ील्ड), Apple Pay या PayPal एक्सप्रेस बटन, और Orders API नहीं हैं, इसलिए ऑर्डर लाइन चाहने वाले भुगतान तरीके (जैसे कुछ Klarna, Billie या in3 विकल्प) इन भुगतानों के लिए Mollie द्वारा नहीं दिए जाते। अधिकृत भुगतान WooCommerce से नहीं, बल्कि Mollie Dashboard में कैप्चर या void किए जाते हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
Pending payment: ग्राहक को Mollie पर भेजा गया है और उसने अभी तक भुगतान नहीं किया है।
Processing or Completed: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment के अनुसार होता है। ऑर्डर नोट में Mollie भुगतान, तरीका और मोड दिखते हैं। ट्रांज़ैक्शन ID वह Mollie भुगतान ID (tr_...) है जिसने ऑर्डर का भुगतान किया।
On hold: बैंक ट्रांसफ़र पैसे का इंतज़ार कर रहा है, अधिकृत भुगतान कैप्चर का इंतज़ार कर रहा है, या Mollie ने चार्जबैक की सूचना दी है। होल्ड तब भी लगता है जब भुगतान की गई राशि या मुद्रा ऑर्डर से अलग हो, जब स्टोर लाइव मोड में हो और टेस्ट भुगतान हुआ हो (कोई पैसा नहीं आया), या जब ऑर्डर रद्द होने के बाद भुगतान पहुँचा हो। ऑर्डर नोट कारण बताता है। Mollie Dashboard में भुगतान जाँचें, फिर ऑर्डर प्रोसेस करें या भुगतान का रिफ़ंड करें।
Failed: आखिरी भुगतान प्रयास विफल हुआ, समाप्त हुआ या रद्द हुआ। भुगतान किया हुआ ऑर्डर कभी नहीं बदलता। ग्राहक फिर से भुगतान कर सकता है।
उसी ऑर्डर का दूसरा भुगतान हो जाए, तो ऑर्डर फिर से नहीं बदलता। एक नोट आपसे Mollie Dashboard में डुप्लिकेट भुगतान का रिफ़ंड करने को कहता है।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Mollie पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी भुगतान के लिए भेजा जाता है जिसने वास्तव में ऑर्डर का भुगतान किया था, और उसी मोड की API कुंजी से, जिसमें वह भुगतान हुआ था; इसलिए वह मोड की कुंजी सेट होनी चाहिए। यह बटन केवल उन ऑर्डरों पर उपलब्ध है जिनका Mollie भुगतान हो चुका है। अगर Mollie रिफ़ंड अस्वीकार करता है, तो WooCommerce Mollie का त्रुटि संदेश दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Mollie रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ता है।
Mollie Dashboard में बनाए गए रिफ़ंड और चार्जबैक WooCommerce रिफ़ंड में नहीं बदलते। चार्जबैक केवल एक नोट जोड़ता है।
लाइसेंस कुंजी
यह प्लगइन vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Mollie के सबसे ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now का उपयोग करें, दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी न होने पर चेकआउट में ग्राहकों को Mollie नहीं दिखता। फिर भी भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए स्टोर मैनेजरों को भुगतान तरीका (unlicensed — visible to admins only) चिह्न के साथ दिखता रहता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट और टेस्ट कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान शुरू हो चुके हैं वे अब भी पक्के होते हैं, और रिफ़ंड काम करते हैं।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, पर अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्टेटस पृष्ठभूमि में अपने-आप फिर से जाँचा जाता है।
समस्या निवारण
Mollie चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड में API कुंजी है: टेस्ट मोड में Test API Key, लाइव मोड में Live API Key। जाँचें कि स्टोर की मुद्रा (या Pay for order पेज पर ऑर्डर की मुद्रा) Mollie द्वारा समर्थित है। सेटिंग्स पेज इनमें से हर समस्या के लिए चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रह गया: वेबहुक आपकी साइट तक नहीं पहुँच पा रहा। सेटिंग्स में दिखाया गया वेबहुक URL इंटरनेट से पहुँच योग्य होना चाहिए (मेंटेनेंस मोड, बेसिक ऑथेंटिकेशन या फ़ायरवॉल न हो जो रुकावट डाले)। ग्राहक भुगतान के बाद स्टोर पर लौटता है, तब भी ऑर्डर अपडेट होता है।
Webhook answers Unknown payment.: आपकी टेस्ट या लाइव API कुंजी के लिए यह भुगतान ID Mollie को पता नहीं है, जैसे किसी दूसरे Mollie खाते का भुगतान।
Webhook answers Payment ID mismatch.: भुगतान के डेटा के अनुसार वह इस ऑर्डर का नहीं है। ऑर्डर नहीं बदलता।
Webhook answers Failed to fetch payment.: Mollie API तक पहुँच नहीं हो सकी। Mollie बाद में वेबहुक फिर से भेजेगा।
API कुंजी सेव नहीं हो रही: कुंजी test_ या live_ से शुरू होनी चाहिए, और उसके बाद कम से कम 30 अक्षर और अंक हों। Mollie Dashboard से उसे फिर से कॉपी करें।
भुगतान नहीं बन रहा: ऑर्डर नोट और लॉग में HTTP कोड और Mollie का संदेश दिखता है। 401 का अर्थ है गलत API कुंजी; 422 अनुरोध के किसी फ़ील्ड की ओर इशारा करता है, जैसे कोई राशि या मुद्रा जिसे Mollie स्वीकार नहीं करता। Logging चालू करें और WooCommerce > Status > Logs देखें, स्रोत wcp_mollie_gateway।
ऑर्डर On hold है: ऑर्डर नोट पढ़ें। कारण राशि या मुद्रा का मेल न खाना, लाइव मोड में टेस्ट भुगतान, रद्द होने के बाद का भुगतान, बैंक ट्रांसफ़र, बिना कैप्चर की अधिकृति, या चार्जबैक हो सकता है।
मोड से जुड़े संदेश के साथ रिफ़ंड विफल: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की API कुंजी सेट नहीं है। उसे डालें और फिर से प्रयास करें।
अन्य मुद्राएँ: डेवलपर molg_supported_currencies फ़िल्टर से मुद्रा सूची बदल सकते हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, अगर कुंजी किसी और डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँच नहीं हो पा रही, तो प्लगइन आखिरी ज्ञात स्टेटस के साथ काम करता रहता है।
अनइंस्टॉल
प्लगइन को डिएक्टिवेट करने पर सारा डेटा रहता है। हटाने के लिए उसे Plugins पेज पर डिएक्टिवेट करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। गेटवे सेटिंग्स और लॉग फ़ाइलें केवल तब हटती हैं जब Delete Data on Uninstall चालू था। नहीं तो वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स, Mollie भुगतान ID और ट्रांज़ैक्शन ID बनाए रखते हैं।
Mollie उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Mollie से संबद्ध नहीं है और Mollie द्वारा अनुमोदित नहीं है।