VibeFox MultiSafepay for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: स्टोर या ऑर्डर की मुद्रा ऐसी होनी चाहिए जिसे MultiSafepay स्वीकार करता हो, जैसे EUR, USD, GBP, PLN, CHF, SEK, DKK या NOK। अन्य मुद्राओं के लिए चेकआउट पर भुगतान तरीका छिपा रहता है।
MultiSafepay खाता: आपको MultiSafepay Control में अपनी साइट की API कुंजी चाहिए। टेस्ट और लाइव खातों की कुंजियाँ अलग-अलग हैं। MultiSafepay में और कुछ सेट करने की ज़रूरत नहीं है: सूचना का पता हर भुगतान के साथ भेजा जाता है।
सार्वजनिक साइट: सूचनाएँ भेजने के लिए MultiSafepay को आपकी साइट तक पहुँच होनी चाहिए। अन्यथा भी, ग्राहक के MultiSafepay से लौटने पर ऑर्डर अपडेट हो जाते हैं।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_multisafepay_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > MultiSafepay > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. MultiSafepay Control की टेस्ट और/या लाइव API कुंजी पेस्ट करें (देखें कॉन्फ़िगरेशन)।
6. Enable/Disable चालू करें और सेव करें। Test mode चालू रखकर एक भुगतान की जाँच करें, फिर असली भुगतान स्वीकार करने के लिए उसका निशान हटा दें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > MultiSafepay। टेस्ट मोड चालू रहने पर पेज के शीर्षक पर Test mode बैज दिखता है। फ़ील्ड्स के ऊपर, यदि मौजूदा मोड में API कुंजी नहीं है (तब चेकआउट पर भुगतान तरीका नहीं दिखता) या MultiSafepay स्टोर की मुद्रा स्वीकार नहीं करता, तो पेज चेतावनी देता है। भुगतान तरीकों की सूची में, जब तक मौजूदा मोड में API कुंजी नहीं डाली जाती, MultiSafepay को सेटअप की ज़रूरत वाले के रूप में चिह्नित किया जाता है।
चेकआउट
Enable/Disable: Enable MultiSafepay भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का नाम। डिफ़ॉल्ट: MultiSafepay।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay।
API कुंजियाँ
API कुंजी MultiSafepay Control > Manage settings > Website settings में मिलती है। टेस्ट खाते (testmerchant.multisafepay.com) और लाइव खाते (merchant.multisafepay.com) की कुंजियाँ अलग-अलग हैं। टेस्ट मोड केवल टेस्ट कुंजी, और लाइव मोड केवल लाइव कुंजी इस्तेमाल करता है।
Test mode: Use the MultiSafepay test environment (no real payments)। यह API पता और API कुंजी दोनों बदल देता है। पहले से किए गए भुगतान स्थिति जाँच और रिफ़ंड के लिए अपने मूल वातावरण का ही उपयोग करते रहते हैं। डिफ़ॉल्ट: चालू।
Test API key: आपके MultiSafepay टेस्ट खाते की API कुंजी।
Live API key: आपके MultiSafepay लाइव खाते की API कुंजी।
सूचनाएँ
कुछ सेट करने की ज़रूरत नहीं है। इस सेक्शन में सूचना URL दिखता है, जो हर भुगतान के साथ MultiSafepay को भेजा जाता है। यह कुछ इस तरह दिखता है: https://your-site/?wc-api=mspg_webhook। MultiSafepay को आपकी साइट तक पहुँच होनी चाहिए। सूचना केवल प्लगइन को बताती है कि कौन-सा भुगतान बदला है: ऑर्डर बदलने से पहले स्टेटस, राशि और मुद्रा हमेशा आपकी API कुंजी से MultiSafepay API से पढ़े जाते हैं। आपके स्टोर के किसी ऑर्डर से संबंधित न होने वाले भुगतानों की सूचनाएँ अनदेखी की जाती हैं।
ऑर्डर
Order status after payment: भुगतान किए गए ऑर्डर का स्टेटस। स्टेटस तुरंत सेट हो जाता है, एक ही स्टेटस बदलाव और ग्राहक को एक ईमेल के साथ।
उन्नत
Debug log: Log API calls and notifications विवरण WooCommerce > Status > Logs में लिखता है, स्रोत wcp_multisafepay_gateway। त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजियाँ और ग्राहक डेटा दर्ज नहीं होते। डिफ़ॉल्ट: बंद।
Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से MultiSafepay) और ऑर्डर देता है। प्लगइन ऑर्डर की राशि के लिए ऑर्डर की मुद्रा में MultiSafepay भुगतान बनाता है और ग्राहक को MultiSafepay के भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके MultiSafepay खाते में सक्रिय कोई भी तरीका चुनकर भुगतान करता है। ग्राहक की बिलिंग जानकारी और स्टोर की भाषा MultiSafepay को भेजी जाती है, और भुगतान पर Order #, ऑर्डर नंबर और आपकी साइट का नाम दिखता है। टेस्ट मोड में चेकआउट पर Test mode: no real payment will be made. दिखता है।
ग्राहक के भुगतान करने तक स्टॉक रोका जाता है, और कार्ट ऑर्डर प्राप्ति पेज तक सुरक्षित रहता है। भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब MultiSafepay उसकी पुष्टि करे: सूचना के ज़रिए, या ग्राहक के उस पेज पर पहुँचने पर MultiSafepay API से जाँच के ज़रिए।
यदि ग्राहक चेकआउट के दौरान MultiSafepay के पेज पर रद्द करता है, तो ऑर्डर WooCommerce के मानक तरीके से रद्द होता है, स्टॉक छूट जाता है और उत्पाद कार्ट में रहते हैं। यदि ग्राहक Pay for order पेज से भुगतान कर रहा था, तो वह उसी पेज पर लौट आता है, जहाँ बताया जाता है कि क्या हुआ: 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.
ग्राहक बिना भुगतान वाले ऑर्डर का दोबारा भुगतान कर सकता है। नया भुगतान बनाने से पहले प्लगइन MultiSafepay पर पिछले भुगतान की जाँच करता है। यदि वह पहले ही भुगतान हो चुका है, तो ऑर्डर पुष्ट हो जाता है। यदि वह उसी राशि पर अब भी खुला है, तो वही भुगतान पेज दोबारा इस्तेमाल होता है। यदि राशि बदल गई है, तो पुराना भुगतान MultiSafepay पर रद्द हो जाता है, ताकि वह अब भुगतान न किया जा सके।
यदि MultiSafepay भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे 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 की त्रुटि ऑर्डर नोट्स में जोड़ी जाती है।
यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन एक ही भुगतान तरीका देता है, जो MultiSafepay पेज पर ले जाता है। हर MultiSafepay तरीके के लिए अलग WooCommerce भुगतान तरीके नहीं हैं, न एम्बेडेड कार्ड फ़ील्ड, न Apple Pay या Google Pay के एक्सप्रेस बटन, न सब्सक्रिप्शन, आवर्ती भुगतान या सेव किए गए कार्ड, और WooCommerce से capture या void नहीं किया जा सकता। कार्ट डेटा नहीं भेजा जाता, इसलिए MultiSafepay इन ऑर्डरों के लिए वे बाद में भुगतान वाले तरीके नहीं देता जिन्हें इसकी ज़रूरत होती है (जैसे Klarna, in3 या Riverty)।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
Pending payment: ग्राहक को MultiSafepay पर भेजा गया है और उसने अभी भुगतान नहीं किया है।
Processing या Completed: MultiSafepay ने भुगतान की पुष्टि की है (पूरा हुआ या भेजा गया)। स्टेटस Order status after payment का पालन करता है। ऑर्डर नोट में MultiSafepay भुगतान ID, भुगतान तरीका और वातावरण दिखता है। ट्रांज़ैक्शन ID उस भुगतान का MultiSafepay ऑर्डर ID है।
On hold before payment: भुगतान अनसेटल्ड (MultiSafepay उसकी समीक्षा कर रहा है) या रिज़र्व्ड (अधिकृत) है। पैसा पाने के लिए MultiSafepay Control में रिज़र्व्ड भुगतान को capture करें। जब MultiSafepay उसे भुगतान किया हुआ बताता है, तब ऑर्डर अपने आप पूरा हो जाता है।
On hold after payment: MultiSafepay ने ऑर्डर के कुल योग से अलग राशि या मुद्रा की पुष्टि की है, या दुकान लाइव मोड में होने पर टेस्ट भुगतान पूरा हुआ (कोई असली पैसा नहीं मिला), या ऑर्डर रद्द होने के बाद भुगतान पूरा हुआ। ऑर्डर नोट इसका कारण बताता है। MultiSafepay Control में लेन-देन की जाँच करें और ऑर्डर को मैन्युअली प्रोसेस करें या रिफ़ंड करें।
On hold after a chargeback: MultiSafepay ने भुगतान किए गए ऑर्डर पर चार्जबैक की सूचना दी है: पैसा आपके खाते से वापस ले लिया गया है।
Failed: बिना भुगतान वाले ऑर्डर का नवीनतम भुगतान अस्वीकृत, रद्द, समाप्त या void हुआ। रोका गया स्टॉक छूट जाता है। ग्राहक फिर से कोशिश कर सकता है।
भुगतान किया हुआ, रिफ़ंड किया हुआ या रद्द किया हुआ ऑर्डर देर से आई सूचना से दोबारा नहीं खुलता। यदि पहले से भुगतान किए गए ऑर्डर का दूसरा भुगतान पूरा होता है, तो ऑर्डर फिर से नहीं बदलता। एक नोट आपसे कहता है कि दोहराए गए भुगतान को MultiSafepay Control में रिफ़ंड करें।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via MultiSafepay पर क्लिक करें। MultiSafepay से भुगतान किए गए ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस वातावरण (टेस्ट या लाइव) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण की API कुंजी सेट होनी चाहिए। यदि MultiSafepay रिफ़ंड स्वीकार नहीं करता, तो WooCommerce MultiSafepay की त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल अनुरोध MultiSafepay रिफ़ंड ID के साथ ऑर्डर नोट्स में जोड़ा जाता है।
MultiSafepay Control में किए गए रिफ़ंड, MultiSafepay उन्हें बताने पर, ऑर्डर नोट्स में जोड़े जाते हैं। वे अपने आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते। ज़रूरत हो तो Refund via MultiSafepay के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से लिए गए VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > MultiSafepay पेज के ऊपर है। कुंजी License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now इस्तेमाल करें, दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को MultiSafepay नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉगिन किए हुए स्टोर मैनेजरों को भुगतान तरीका (unlicensed — visible to admins only) चिह्न के साथ दिखता रहता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर और परख सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं वे अब भी पुष्ट होते हैं, और रिफ़ंड चलते हैं।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्टेटस पृष्ठभूमि में अपने आप फिर से जाँचा जाता है।
समस्या निवारण
चेकआउट पर MultiSafepay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड में API कुंजी है (टेस्ट मोड में Test API key, लाइव मोड में Live API key), और MultiSafepay स्टोर या ऑर्डर की मुद्रा स्वीकार करता है। कुंजी न होने या मुद्रा स्वीकार न होने पर सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि साइट इंटरनेट से पहुँच योग्य है, और भुगतान के वातावरण की API कुंजी सेट है, क्योंकि प्लगइन स्टेटस MultiSafepay API से पढ़ता है। यदि API तक नहीं पहुँचा जा सकता, तो सूचना ERROR से उत्तर देती है और MultiSafepay उसे फिर से भेजता है। ग्राहक के ऑर्डर प्राप्ति पेज पर लौटने और उसी ऑर्डर को दोबारा भुगतान करने की कोशिश करने पर भी ऑर्डर अपडेट होता है।
ऑर्डर देते समय ग्राहक को त्रुटि दिखती है: ऑर्डर नोट्स खोलें या Debug log चालू करके WooCommerce > Status > Logs देखें, स्रोत wcp_multisafepay_gateway। 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 ने राशि या मुद्रा अस्वीकार की।
ऑर्डर On hold after payment पर है: ऑर्डर नोट पढ़ें। भुगतान अनसेटल्ड या रिज़र्व्ड हो सकता है, भुगतान की गई राशि या मुद्रा ऑर्डर से अलग हो सकती है, टेस्ट भुगतान लाइव मोड में आ सकता है, भुगतान ऑर्डर रद्द होने के बाद पूरा हुआ हो सकता है, या चार्जबैक हुआ हो सकता है। MultiSafepay Control में लेन-देन जाँचें।
टेस्ट भुगतान किसी लाइव ऑर्डर की पुष्टि नहीं करते: जब स्टोर लाइव मोड में होता है, तो टेस्ट भुगतान कभी ऑर्डर का भुगतान नहीं करता; इसके बजाय ऑर्डर होल्ड पर चला जाता है। लाइव पर स्विच करने के बाद भी पिछले टेस्ट भुगतान टेस्ट कुंजी से जाँचे और रिफ़ंड किए जाते रहते हैं।
वातावरण से जुड़े संदेश के साथ रिफ़ंड विफल होता है: भुगतान टेस्ट या लाइव वातावरण में हुआ था, और उस वातावरण की API कुंजी सेट नहीं है। कुंजी डालें और फिर से कोशिश करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदला है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्टेटस पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने से सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। गेटवे सेटिंग्स, ऑर्डरों में सहेजा गया MultiSafepay डेटा और लॉग केवल तभी हटते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।
MultiSafepay उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन MultiSafepay से संबद्ध नहीं है और MultiSafepay द्वारा समर्थित नहीं है।