VibeFox Moneris for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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

स्टोर मुद्रा: कनाडाई Moneris खाते के लिए CAD, पुराने Moneris USA खाते के लिए USD। भुगतान गेटवे तभी दिखता है जब ऑर्डर की मुद्रा खाते से मेल खाती हो।

HTTPS और PCI DSS: कार्ड नंबर आपके चेकआउट पेज पर दर्ज होते हैं और आपके सर्वर से होकर गुज़रते हैं। लाइव भुगतान के लिए HTTPS और PCI DSS SAQ D का पालन आवश्यक है। यदि आप यह पूरा नहीं कर सकते, तो इसके बजाय होस्टेड भुगतान पेज समाधान का उपयोग करें।

Moneris खाता: आपको Moneris Merchant Resource Center > Admin > Store Settings से अपने Moneris Gateway स्टोर का Store ID और API Token चाहिए। परीक्षण के लिए सार्वजनिक Moneris टेस्ट स्टोर डिफ़ॉल्ट रूप से भरा होता है। टेस्ट क्रेडेंशियल और टेस्ट कार्ड Moneris डेवलपर पोर्टल पर हैं।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_moneris_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Moneris > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।

5. खाते का देश चुनें और Live Store ID तथा Live API Token डालें। टेस्ट मोड डिफ़ॉल्ट रूप से चालू है और सार्वजनिक टेस्ट स्टोर का उपयोग करता है (कनाडा के लिए store5 / yesguy, अमेरिका के लिए monusqa002 / qatoken)।

6. Purchase या Pre-Authorization और कार्ड लोगो चुनें, फिर Enable / Disable चालू करें।

7. Moneris टेस्ट कार्ड से एक टेस्ट ऑर्डर दें, फिर Test mode का चेकमार्क हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Moneris। जब टेस्ट मोड चालू होता है, तो फ़ील्ड्स के ऊपर पेज Moneris gateway is in TEST MODE. No real charges will be made. दिखाता है। लाइव मोड में, यदि लाइव फ़ील्ड्स में Moneris के टेस्ट क्रेडेंशियल हों (तब चेकआउट पर भुगतान गेटवे छिप जाता है) या साइट HTTPS का उपयोग न करे, तो यह चेतावनी देता है। यदि स्टोर की मुद्रा Moneris खाते की मुद्रा से अलग हो, तब भी यह चेतावनी देता है; तब भी चेकआउट पर गेटवे छिप जाता है।

सामान्य

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

Title: ग्राहक को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Credit card (Moneris)। टेस्ट मोड में चेकआउट पर शीर्षक में (Test Mode) जोड़ दिया जाता है।

Description: चेकआउट पर कार्ड फ़ील्ड्स के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card.

Moneris खाता

आपका Store ID और API Token Moneris Merchant Resource Center में Admin > Store Settings के अंतर्गत है। टेस्ट क्रेडेंशियल और टेस्ट कार्ड Moneris डेवलपर पोर्टल पर हैं। इस सेक्शन में दोनों के लिंक हैं।

Moneris account country: कनाडाई खाते CAD में और अमेरिकी खाते USD में शुल्क लेते हैं। भुगतान गेटवे तभी दिखता है जब ऑर्डर की मुद्रा मेल खाती हो। डिफ़ॉल्ट: Canada (CAD)।

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). रिफ़ंड, कैप्चर और void हमेशा उसी वातावरण में भेजे जाते हैं जहाँ भुगतान हुआ था। ग्राहकों को कार्ड फ़ील्ड्स के ऊपर TEST MODE: use a Moneris test card, no real charges are made. दिखता है। डिफ़ॉल्ट: चालू।

Live Store ID: लाइव Store ID, उदाहरण के लिए monca01234।

Live API Token: लाइव API Token।

Test Store ID: सार्वजनिक Moneris टेस्ट स्टोर: store5 (कनाडा) या monusqa002 (अमेरिका)। डिफ़ॉल्ट: store5।

Test API Token: सार्वजनिक टेस्ट टोकन: yesguy (कनाडा) या qatoken (अमेरिका)। डिफ़ॉल्ट: yesguy।

भुगतान

Transaction type: कार्ड से शुल्क कैसे लिया जाता है। डिफ़ॉल्ट: Purchase।

Card logos: भुगतान विधि के शीर्षक के बगल में दिखने वाले कार्ड ब्रांड लोगो: Visa, Mastercard, Discover, American Express, JCB। स्वीकृत ब्रांड आपके Moneris खाते पर निर्भर करते हैं। डिफ़ॉल्ट: Visa and Mastercard।

उन्नत

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked)। त्रुटियाँ हमेशा लॉग होती हैं। लॉग WooCommerce > Status > Logs में, स्रोत wcp_moneris_gateway के रूप में देखा जा सकता है। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card (Moneris)) और आपके चेकआउट पेज के WooCommerce कार्ड फ़ॉर्म में कार्ड नंबर, समाप्ति तिथि और सुरक्षा कोड डालता है। ऑर्डर देने पर आपका सर्वर ऑर्डर कुल राशि के लिए कार्ड को Moneris को भेजता है और तुरंत परिणाम प्राप्त करता है। कोई रीडायरेक्ट या webhook नहीं है। सुरक्षा कोड (CVD) हमेशा भेजा जाता है, इसलिए आपके Moneris स्टोर के eFraud नियम अब भी लागू रहते हैं।

स्वीकृत भुगतान तभी भुगतान किया हुआ माना जाता है जब Moneris लेन-देन पूरा होने की रिपोर्ट करे और संसाधित राशि ऑर्डर के कुल योग के बराबर हो। इसके बाद ग्राहक ऑर्डर प्राप्ति पेज पर जाता है। Pre-Authorization के साथ, जब तक आप राशि कैप्चर नहीं करते, ऑर्डर होल्ड पर रहता है।

यदि कार्ड अस्वीकार हो जाता है, तो ग्राहक को Moneris से मिला कारण के साथ Your card was declined दिखता है, और वह कार्ड का विवरण जाँच सकता है या दूसरा कार्ड उपयोग कर सकता है। यदि Moneris अनुरोध संसाधित नहीं कर सका (उदाहरण के लिए गलत Store ID या API Token), तो ग्राहक को The payment could not be processed. Please try again or use another payment method. दिखता है। यह कारण ऑर्डर नोट्स और लॉग में जोड़ा जाता है। भुगतान संसाधित होते समय दोबारा क्लिक करने पर A payment for this order is already being processed. Please wait a moment and check your order status before trying again. दिखता है। भुगतान किए गए या पूर्व-अधिकृत ऑर्डर से दोबारा शुल्क नहीं लिया जाता।

यदि Moneris उत्तर नहीं देता (नेटवर्क त्रुटि या टाइमआउट), तो प्लगइन यह जानने के लिए Moneris को Status Check भेजता है कि लेन-देन सफल हुआ या नहीं। यदि वह भी संभव न हो, तो ऑर्डर Moneris ऑर्डर ID के साथ होल्ड पर चला जाता है, और ग्राहक से दूसरी बार भुगतान करने का आग्रह नहीं किया जाता।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

इस प्लगइन में सेव किए गए कार्ड और Moneris Vault, WooCommerce Subscriptions, Apple Pay, Google Pay या Interac Online, Moneris Checkout या Hosted Tokenization, 3-D Secure, AVS या Kount, और मल्टी-करेंसी मूल्य निर्धारण नहीं हैं।

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

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

भुगतान लंबित: ऑर्डर बना है, लेकिन कार्ड से अभी शुल्क नहीं लिया गया है, उदाहरण के लिए किसी अस्वीकृत प्रयास के बाद। ऑर्डर नोट में Moneris कोड और संदेश दिखता है। ग्राहक दोबारा भुगतान कर सकता है।

प्रसंस्करण में: खरीद स्वीकृत हो गई है। केवल डाउनलोड योग्य वर्चुअल उत्पादों वाले ऑर्डर पूर्ण में बदल जाते हैं, जो WooCommerce का डिफ़ॉल्ट है। ऑर्डर नोट में राशि, Moneris लेन-देन ID और रसीद दिखती है। लेन-देन ID Moneris लेन-देन संख्या है।

होल्ड पर: पूर्व-अधिकृत भुगतान स्वीकृत हो गया है और कैप्चर की प्रतीक्षा में है, संसाधित राशि ऑर्डर कुल योग से अलग थी, या Moneris ने परिणाम की पुष्टि नहीं की। ऑर्डर नोट इसका कारण बताता है।

रद्द: पूर्व-अधिकृत ऑर्डर के लिए, रद्द करने पर आरक्षित राशि मुक्त हो जाती है (void)।

कैप्चर और void

पूर्व-अधिकृत भुगतान को कैप्चर करने के लिए, ऑर्डर की स्थिति को प्रसंस्करण में या पूर्ण पर बदलें, या ऑर्डर एक्शन में Capture Moneris pre-authorization चुनें। ऑर्डर का वर्तमान कुल योग, रिफ़ंड घटाकर, कैप्चर होता है; यह अधिकृत राशि से अधिक नहीं हो सकता। यदि Moneris कैप्चर को अस्वीकार करता है, तो स्थिति नोट के साथ होल्ड पर वापस चली जाती है और प्रसंस्करण या पूर्ण होने का ईमेल नहीं भेजा जाता। Moneris पूर्व-अधिकृत भुगतान कुछ दिनों में समाप्त हो जाते हैं, इसलिए उन्हें समय पर कैप्चर करें।

राशि मुक्त करने के लिए, ऑर्डर रद्द करें या ऑर्डर एक्शन में Void Moneris pre-authorization (cancel order) चुनें। ऑर्डर को रिफ़ंडेड पर सेट करने से भी खुला पूर्व-अधिकृत भुगतान मुक्त हो जाता है। यदि मुक्त करना विफल हो, तो एक नोट आपको Merchant Resource Center में उसे मुक्त करने के लिए कहता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Credit card (Moneris) पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। पूर्व-अधिकृत भुगतान का रिफ़ंड तभी हो सकता है जब उसे कैप्चर किया जा चुका हो; उससे पहले, राशि मुक्त करने के लिए ऑर्डर रद्द करें। रिफ़ंड उसी वातावरण और खाते में भेजा जाता है जहाँ भुगतान हुआ था, इसलिए उस मोड के क्रेडेंशियल भरे होने चाहिए। यदि Moneris रिफ़ंड स्वीकार नहीं करता, तो WooCommerce कारण के साथ Refund failed दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Moneris लेन-देन ID के साथ ऑर्डर नोट्स में जुड़ता है।

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

यह प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Moneris के ऊपर है। कुंजी License key में डालें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तिथि तक सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

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

जब लाइसेंस की अवधि समाप्त होती है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण आवश्यक है। स्थिति पृष्ठभूमि में स्वतः दोबारा जाँची जाती है।

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

चेकआउट पर Moneris दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और वर्तमान मोड में Store ID और API Token भरे हैं। लाइव मोड में लाइव फ़ील्ड्स में आपके लाइव क्रेडेंशियल होने चाहिए, न कि Moneris के टेस्ट क्रेडेंशियल। जाँचें कि स्टोर मुद्रा (या Pay for order पेज पर ऑर्डर मुद्रा) खाते की मुद्रा है: कनाडा के लिए CAD, अमेरिकी खाते के लिए USD। मुद्रा मेल न खाने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित या होल्ड पर बना है: प्लगइन में webhook नहीं है; परिणाम केवल Moneris के उत्तर से आता है। यदि ऑर्डर होल्ड पर है और नोट कहता है कि Moneris ने परिणाम की पुष्टि नहीं की, तो Moneris ने उत्तर नहीं दिया और Status Check भी विफल रहा। नोट में दिए Moneris ऑर्डर ID को Merchant Resource Center में खोजें: यदि लेन-देन वहाँ है, तो ऑर्डर भेजें (और ज़रूरत हो तो वहीं रिफ़ंड करें); यदि नहीं है, तो ऑर्डर रद्द करें या ग्राहक से दोबारा भुगतान करने को कहें।

ग्राहक को Payment gateway is misconfigured. Please contact the store administrator. दिखता है: वर्तमान मोड के क्रेडेंशियल गायब हैं, या लाइव मोड चालू है और लाइव फ़ील्ड्स में Moneris के टेस्ट क्रेडेंशियल हैं। अपने लाइव Store ID और API Token डालें।

ग्राहक को This payment method does not support the order currency. दिखता है: ऑर्डर की मुद्रा Moneris खाते की मुद्रा नहीं है।

ग्राहक को भुगतान के समय त्रुटि दिखती है: ऑर्डर नोट्स खोलें या Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_moneris_gateway देखें।

कैप्चर विफल होता है: ऑर्डर के पास कैप्चर की प्रतीक्षा करता कोई पूर्व-अधिकृत भुगतान नहीं है, ऑर्डर का कुल योग शून्य है, या राशि अधिकृत राशि से अधिक है। Moneris पूर्व-अधिकृत भुगतान भी कुछ दिनों में समाप्त हो जाते हैं।

मोड या खाते से संबंधित संदेश के साथ रिफ़ंड, कैप्चर या void विफल होता है: भुगतान टेस्ट या लाइव मोड में हुआ था और उस मोड के क्रेडेंशियल सेट नहीं हैं, या भुगतान दूसरे देश के Moneris खाते से हुआ था। क्रेडेंशियल डालें, या भुगतान Merchant Resource Center में संसाधित करें।

कार्ड टेस्टिंग हमले: सीधे कार्ड फ़ॉर्म कार्ड टेस्टिंग का लक्ष्य होते हैं। WooCommerce चेकआउट की रेट लिमिटिंग और एक CAPTCHA प्लगइन सक्षम करें, और अपने Moneris खाते में eFraud या velocity नियम लागू करें।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। भुगतान गेटवे की सेटिंग्स और लॉग तभी हटाए जाते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और लेन-देन ID रखते हैं।

Moneris उसके स्वामी का ट्रेडमार्क है। यह प्लगइन Moneris से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।