VibeFox Moneris for OpenCart — सहायता

आवश्यकताएँ

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

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 पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. लेन-देन का प्रकार और कार्ड लोगो चुनें, फिर Enable / Disable चालू करें और Save पर क्लिक करें।

6. Moneris टेस्ट कार्ड से एक टेस्ट ऑर्डर दें, फिर Test mode बंद करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के लिए चरण 3 से 6 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Moneris Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। टेस्ट मोड चालू होने पर सेटिंग्स के ऊपर पेज Moneris gateway is in TEST MODE. No real charges will be made. दिखाता है। लाइव मोड में, पेज आपको चेतावनी देता है जब लाइव फ़ील्ड में Moneris टेस्ट क्रेडेंशियल हों (तब चेकआउट पर भुगतान विधि छिपी रहती है) और जब स्टोर के लिए SSL सक्षम न हो (OpenCart 4 पर, जब स्टोरफ़्रंट का पता http:// से शुरू हो)। यह आपको यह भी चेतावनी देता है जब भुगतान विधि चालू हो लेकिन वर्तमान मोड की Store ID या API Token खाली हो, और जब स्टोर की डिफ़ॉल्ट मुद्रा Moneris खाते की मुद्रा न हो; दोनों स्थितियों में चेकआउट पर भुगतान विधि छिपी रहती है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय, Title में 1 से 128 अक्षर होने चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए और Total 0 या उससे अधिक की संख्या होनी चाहिए। यदि कोई मान गलत है, तो पेज त्रुटि दिखाता है और कुछ भी सहेजा नहीं जाता।

Moneris

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

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

Description: Confirm Order चरण पर कार्ड फ़ील्ड के ऊपर दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card.

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

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

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

Moneris खाता

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

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

Test mode: Moneris QA गेटवे और टेस्ट क्रेडेंशियल का उपयोग करता है; कोई वास्तविक शुल्क नहीं लिया जाता। रिफ़ंड, कैप्चर और 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 (US)। डिफ़ॉल्ट: store5।

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

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

भुगतान

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

Card logos: चेकआउट पर भुगतान विधि के साथ दिखाए जाने वाले कार्ड ब्रांड: Visa, Mastercard, Discover, American Express, JCB। स्वीकृत ब्रांड आपके Moneris खाते पर निर्भर करते हैं। डिफ़ॉल्ट: Visa और Mastercard।

ऑर्डर

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

Order Status After Payment: कार्ड से शुल्क लिया गया (खरीद, या पूर्व-प्राधिकरण का कैप्चर)। डिफ़ॉल्ट: प्रोसेसिंग।

Authorized Status: पूर्व-प्राधिकरण: राशि केवल रोकी गई है, अभी तक शुल्क नहीं लिया गया। इसे ऑर्डर टैब में कैप्चर करें या भुगतान किए गए स्टेटस पर सेट करें। डिफ़ॉल्ट: लंबित।

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

Canceled Status: ऑर्डर टैब में Void pre-authorization (cancel order) से सेट होती है। किसी ऑर्डर को इस स्टेटस पर सेट करने से बिना कैप्चर की गई पूर्व-प्राधिकरण राशि मुक्त (void) हो जाती है। डिफ़ॉल्ट: रद्द।

Refunded Status: ऑर्डर टैब से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होती है। ऑर्डर को इस स्टेटस पर सेट करने से बिना कैप्चर की गई पूर्व-प्राधिकरण भी मुक्त हो जाती है। डिफ़ॉल्ट: रिफ़ंड किया गया।

उन्नत

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

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

Delete data on uninstall: चालू होने पर, एक्सटेंशन अनइंस्टॉल होने पर गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। ऑर्डर का Moneris डेटा (कैप्चर और रिफ़ंड के लिए आवश्यक) हमेशा रहता है। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card (Moneris))। Confirm Order चरण पर ग्राहक आपका विवरण, कार्ड लोगो और Card number, Expiry (MM/YY) तथा Card code (CVC) फ़ील्ड देखता है। तीनों फ़ील्ड आवश्यक हैं। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में, भुगतान विधि चुनता है; फिर कार्ड फ़ील्ड चेकआउट पेज के नीचे, Confirm Order बटन के ऊपर, ऑर्डर पुष्टि ब्लॉक में दिखते हैं। जब ग्राहक Confirm Order पर क्लिक करता है, तो आपका सर्वर ऑर्डर कुल के लिए कार्ड को Moneris को भेजता है और परिणाम तुरंत प्राप्त करता है। कोई रीडायरेक्ट या webhook नहीं है। कार्ड डेटा केवल इसी एक अनुरोध के लिए उपयोग होता है; उसे कभी सहेजा नहीं जाता, और लॉग में केवल अंतिम चार अंक दिखते हैं।

ऑर्डर को स्थिति केवल Moneris के स्वीकृत जवाब से मिलती है, OpenCart के सामान्य तरीके से, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। कार्ट खाली हो जाता है और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। पूर्व-प्राधिकरण के साथ, ऑर्डर तब तक Authorized Status में रहता है जब तक आप राशि कैप्चर नहीं करते। यदि Moneris ने ऑर्डर कुल से अलग राशि संसाधित की, तो ऑर्डर को नोट के साथ समीक्षा स्थिति मिलती है।

यदि कार्ड अस्वीकृत हो जाता है, तो ग्राहक Confirm Order चरण पर Your card was declined और Moneris का कारण देखता है, और कार्ड विवरण जाँच सकता है या कोई दूसरा कार्ड उपयोग कर सकता है। ऑर्डर को कोई स्थिति नहीं मिलती; अस्वीकृति का कारण लॉग में भी लिखा जाता है। यदि Moneris अनुरोध संसाधित नहीं कर सका (उदाहरण के लिए गलत Store ID या API Token), तो ग्राहक को The payment could not be processed. Please try again or use another payment method. दिखता है। कारण लॉग में लिखा जाता है। गलत कार्ड फ़ील्ड Please enter your card details., Invalid card number. या Invalid card expiry date. जैसे छोटे संदेश देते हैं, और Moneris को कुछ नहीं भेजा जाता।

भुगतान संसाधित होते समय दूसरी बार क्लिक करने पर A payment for this order is already being processed. Please wait a moment and check your order status before trying again. दिखता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है, और कार्ड अस्वीकृत होने के बाद ग्राहक उसी ऑर्डर का भुगतान करता है। दोनों ही स्थितियों में एक्सटेंशन एक ही कार्ट के सभी ऑर्डरों को एक भुगतान मानता है: जो कार्ट पहले ही भुगतान हो चुका है, या जिसका परिणाम अज्ञात है, उससे फिर कभी शुल्क नहीं लिया जाता, और ग्राहक को सफलता पेज पर भेजा जाता है। OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि उस ऑर्डर की पहले से कोई स्थिति है और कार्ट में फिर से उत्पाद हैं (उदाहरण के लिए भुगतान हो गया, पर सफलता पेज नहीं दिखा, और ग्राहक ने उत्पाद जोड़ लिए), या इस बीच ऑर्डर रद्द, रिफ़ंड या void किया गया हो, तो ग्राहक को Confirm Order पर चेकआउट पेज पर वापस भेजा जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। चेकआउट पेज के ऊपर ग्राहक को This order was cancelled or refunded by the store, so it cannot be paid again. Please check your cart and confirm the new order. दिखता है, जब ऑर्डर बंद किया गया हो, या This order has already been paid, and your cart now holds a new purchase. Please check your cart and confirm the new order., जब वह किसी पिछली कार्ट के लिए भुगतान हो चुका हो।

यदि Moneris जवाब नहीं देता (नेटवर्क त्रुटि या टाइमआउट), तो एक्सटेंशन उसी Moneris ऑर्डर ID के साथ Moneris को एक स्थिति जाँच भेजता है ताकि पता चल सके कि लेन-देन सफल हुआ या नहीं। यदि Moneris में ऐसा कोई लेन-देन नहीं है, तो ग्राहक फिर से भुगतान कर सकता है। यदि स्थिति जाँच को भी जवाब नहीं मिलता, तो ऑर्डर को Moneris ऑर्डर ID का उल्लेख करने वाले नोट के साथ समीक्षा स्थिति मिलती है, और ग्राहक से दूसरी बार भुगतान करने को नहीं कहा जाता। यदि भुगतान हो गया, पर ऑर्डर की स्थिति अपने-आप सेट नहीं हो सकी, तो ग्राहक को Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. दिखता है।

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

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

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

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

Order Status After Payment (डिफ़ॉल्ट प्रोसेसिंग): खरीद स्वीकृत हुई, या पूर्व-प्राधिकरण कैप्चर हुआ। एक नोट राशि, Moneris Trans ID और रसीद दिखाता है।

Authorized Status (डिफ़ॉल्ट लंबित): एक पूर्व-प्राधिकरण स्वीकृत हुआ और कैप्चर की प्रतीक्षा में है।

On Hold (Review) Status (डिफ़ॉल्ट लंबित): संसाधित राशि ऑर्डर कुल से अलग थी, या Moneris ने परिणाम की पुष्टि नहीं की। नोट इसे समझाते हैं।

Canceled Status (डिफ़ॉल्ट रद्द): पूर्व-प्राधिकरण वाले ऑर्डर के लिए, आरक्षित राशि मुक्त (void) कर दी गई।

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

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

VibeFox Moneris Gateway टैब

Sales > Orders में Moneris से भुगतान किया गया एक ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Moneris Gateway टैब Trans ID (कैप्चर के बाद पूर्व-प्राधिकरण का Trans ID भी), Moneris order ID, Receipt, Transaction type और उसकी स्थिति (कैप्चर नहीं हुआ, कैप्चर हुआ या मुक्त), परीक्षण भुगतानों के लिए Test mode लेबल वाला Account / environment, प्राधिकरण कोड सहित Card, Authorized / charged / refunded राशियाँ, कैप्चर, void और रिफ़ंड बटन, रिफ़ंड इतिहास और ऑर्डर के Moneris notes दिखाता है। पुष्टि न हुए भुगतान के लिए, टैब आपसे Merchant Resource Center में Moneris ऑर्डर ID खोजने को कहता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है; कैप्चर, void और रिफ़ंड के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर और void

पूर्व-प्राधिकरण कैप्चर करने के लिए टैब में Capture payment पर क्लिक करें और Capture the pre-authorized amount through Moneris? की पुष्टि करें; या Add History से ऑर्डर का स्टेटस Order Status After Payment जैसे भुगतान किए गए स्टेटस, या OpenCart के किसी अन्य प्रोसेसिंग या पूर्ण स्टेटस पर बदलें। रिफ़ंड घटाने के बाद ऑर्डर कुल कैप्चर होता है; यह स्वीकृत राशि से अधिक नहीं हो सकता। बटन से कैप्चर के बाद ऑर्डर को Order Status After Payment मिलता है। यदि Moneris कैप्चर अस्वीकार करता है, तो स्थिति नहीं बदलती, कोई ईमेल नहीं भेजा जाता, Add History सफलता संदेश की जगह कारण दिखाता है, और एक नोट इसे समझाता है: Moneris: status not changed — the pre-authorization could not be captured कारण सहित। Moneris के पूर्व-प्राधिकरण कुछ दिनों में समाप्त हो जाते हैं, इसलिए समय पर कैप्चर करें।

राशि मुक्त करने के लिए Void pre-authorization (cancel order) पर क्लिक करें और पुष्टि करें, या ऑर्डर को Canceled Status पर सेट करें। ऑर्डर को Refunded Status पर सेट करने से भी खुला पूर्व-प्राधिकरण मुक्त हो जाता है। यदि मुक्त करना विफल होता है, तो एक नोट आपसे इसे Merchant Resource Center में मुक्त करने को कहता है।

ये स्टेटस परिवर्तन तब भी काम करते हैं जब एक्सटेंशन बंद हो (लेकिन इंस्टॉल हो), इसलिए पहले किए गए पूर्व-प्राधिकरण अब भी कैप्चर और मुक्त किए जा सकते हैं।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी Moneris के माध्यम से पैसा वापस नहीं भेजती।

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

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

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

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

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

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

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

ग्राहक को This payment method is not available. Please reload the checkout page. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई, या वर्तमान मोड के क्रेडेंशियल गायब हैं (या लाइव मोड में Moneris टेस्ट क्रेडेंशियल इस्तेमाल हो रहे हैं)।

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

ग्राहक को भुगतान करते समय त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। त्रुटियाँ हमेशा लिखी जाती हैं; पूरे अनुरोध और जवाब देखने के लिए Debug log चालू करें।

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

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

कार्ड-टेस्टिंग हमले: सीधे कार्ड फ़ॉर्म कार्ड-टेस्टिंग का लक्ष्य होते हैं। अपने Moneris खाते में eFraud या वेलोसिटी नियमों का उपयोग करें, और अपने स्टोर के लिए CAPTCHA या रेट-लिमिटिंग एक्सटेंशन लगाएँ।

अनइंस्टॉल

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

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

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