VibeFox GMO for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद के संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: जापानी येन (JPY)। GMO-PG केवल येन में शुल्क लेता है, इसलिए भुगतान विधि केवल तभी दिखती है जब ग्राहक के चेकआउट की मुद्रा JPY हो। यदि आपके स्टोर में JPY अभी नहीं है, तो उसे System > Localisation > Currencies में जोड़ें। राशि ऑर्डर के कुल योग को स्टोर की JPY दर से बदलकर पूर्ण येन में पूर्णांकित की जाती है।
GMO Payment Gateway खाता: Link Type Plus वाला GMO-PG मर्चेंट अनुबंध। आपको परीक्षण और/या लाइव वातावरण का Shop ID, Shop password और Link Type Plus Config ID (設定ID) चाहिए, तथा GMO-PG शॉप कंसोल में result notification (結果通知) चालू होना चाहिए (देखें Configuration)। Site ID और Site password का उपयोग नहीं होता।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ज़िप फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_gmo_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_gmo_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_gmo_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox GMO Payment Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. परीक्षण और/या लाइव वातावरण का Shop ID, Shop password और Config ID दर्ज करें और Environment चुनें।
5. GMO-PG शॉप कंसोल में 結果通知 (result notification) चालू करें और सेटिंग्स में दिखाया गया notification URL सेट करें (देखें Configuration)।
6. Enable/Disable चालू करें और Save पर क्लिक करें। परीक्षण वातावरण में एक परीक्षण भुगतान करें, फिर Environment को production पर बदलें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_gmo_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox GMO Payment Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी, GMO-PG क्रेडेंशियल और notification URL उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 6 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल notification URL अलग है (देखें भुगतान सूचनाएँ (結果通知))।
नई इंस्टॉलेशन में भुगतान विधि बंद रहती है और परीक्षण वातावरण चुना होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर पेज चेतावनी देता है यदि स्टोर की डिफ़ॉल्ट मुद्रा JPY नहीं है, और यदि वर्तमान वातावरण का Shop ID, Shop password या Config ID गायब है (तब चेकआउट पर भुगतान विधि छिपी रहती है)। यह यह भी दिखाता है कि कौन-सा वातावरण सक्रिय है: TEST — payments go to pt01.mul-pay.jp with the test credentials, no real money is charged. या PRODUCTION — payments go to p01.mul-pay.jp. एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।
सहेजते समय Title में 1 से 128 अक्षर होने चाहिए, Sort Order खाली या पूर्ण संख्या होना चाहिए, Total खाली या 0 या अधिक की संख्या होना चाहिए, और हर ऑर्डर स्टेटस मौजूद होना चाहिए। कुछ गलत होने पर कुछ भी सहेजा नहीं जाता और पेज त्रुटियों की सूची दिखाता है। क्रेडेंशियल के आसपास के स्पेस हटा दिए जाते हैं।
GMO Payment Gateway — क्रेडिट कार्ड
Enable/Disable: Enable GMO Payment Gateway — Credit Card भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी यही भुगतान विधि का नाम सहेजा जाता है। डिफ़ॉल्ट: Credit card। अनिवार्य, 128 अक्षरों तक।
Description: Confirm Order चरण में, पुष्टि बटन के ऊपर दिखाया जाने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
Sort Order: चेकआउट पर भुगतान विधि की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें।
Geo Zone: भुगतान विधि केवल चुने गए geo zone में स्थित भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: चेकआउट का वह कुल योग, स्टोर की डिफ़ॉल्ट मुद्रा में, जो ऑर्डर को पहुँचना चाहिए, तभी भुगतान विधि दी जाए। किसी भी राशि पर देने के लिए खाली छोड़ें।
GMO-PG खाता
Shop ID और Shop password GMO-PG शॉप कंसोल में Shop management > Shop information के तहत हैं, और Config ID Link Type Plus > Settings के तहत (設定ID)। परीक्षण और production वातावरणों के क्रेडेंशियल अलग-अलग होते हैं।
Environment: कौन-सा GMO-PG वातावरण नए भुगतान स्वीकार करता है।
Production Shop ID: production वातावरण का Shop ID।
Production Shop password: production वातावरण का Shop password।
Production Config ID: GMO-PG कंसोल में पंजीकृत Link Type Plus config ID (設定ID)।
Test Shop ID: परीक्षण वातावरण का Shop ID।
Test Shop password: परीक्षण वातावरण का Shop password।
Test Config ID: परीक्षण वातावरण का Link Type Plus config ID (設定ID)।
सहेजे गए पासवर्ड दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजा गया पासवर्ड हटाने के लिए फ़ील्ड के नीचे Clear the saved password on save पर टिक करें और Save पर क्लिक करें।
भुगतान
Capture: कार्ड से शुल्क कब लिया जाए।
Order status after payment: भुगतान किए गए ऑर्डर को कौन-सा स्टेटस मिलता है।
भुगतान सूचनाएँ (結果通知)
परिणाम सूचना (result notification) आपके स्टोर को बताती है कि भुगतान हो गया है। यह आवश्यक है। GMO-PG शॉप कंसोल में 結果通知 (result notification) चालू करें और इस सेक्शन में Notification URL पर दिखाया गया URL सेट करें। OpenCart 3 में यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_gmo_payment/notify, OpenCart 4 में https://your-store/index.php?route=extension/wcp_gmo_payment/payment/wcp_gmo_payment.notify जैसा, और यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है। यह इंटरनेट से पहुँच योग्य होना चाहिए; maintenance mode इसे नहीं रोकता।
GMO-PG सूचनाएँ साइन नहीं होतीं, इसलिए एक्सटेंशन उनकी सामग्री पर कभी भरोसा नहीं करता। सूचना आपके कॉन्फ़िगर किए गए Shop ID में से किसी एक से आनी चाहिए और उस भुगतान से संबंधित होनी चाहिए जो इस स्टोर ने उसी वातावरण में बनाया था जिसमें भुगतान हुआ। फिर एक्सटेंशन आपके Shop password के साथ GMO-PG से लेन-देन (SearchTrade) माँगता है, और ऑर्डर केवल उसी उत्तर के आधार पर बदलता है। ऐसी सूचना जो किसी असली लेन-देन से मेल नहीं खाती, कुछ नहीं बदलती। वे लेन-देन जो स्टोर ने नहीं बनाए, जैसे GMO-PG कंसोल में बनाए गए, स्वीकार किए जाते हैं और अनदेखे कर दिए जाते हैं। जब एक्सटेंशन किसी सूचना की जाँच नहीं कर पाता, तो वह ऐसा उत्तर देता है कि GMO-PG उसे दोबारा भेजे।
सूचना के बिना, ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक भुगतान के बाद स्टोर पर वापस आता है।
ऑर्डर स्टेटस
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (missing order)। ऑर्डर को स्टेटस तभी मिलता है जब GMO-PG भुगतान की पुष्टि कर दे। हर फ़ील्ड आपके OpenCart के ऑर्डर स्टेटस सूचीबद्ध करता है। OpenCart में On hold स्टेटस नहीं है, इसलिए केवल प्राधिकृत या अलग राशि वाला भुगतान नीचे दिया गया होल्ड स्टेटस और ऑर्डर नोट पाता है।
Processing: जब Order status after payment प्रक्रियाधीन हो, तो भुगतान किया हुआ ऑर्डर। डिफ़ॉल्ट: प्रक्रियाधीन।
Completed: जब Order status after payment पूर्ण हो, तो भुगतान किया हुआ ऑर्डर। डिफ़ॉल्ट: पूर्ण।
GMO-PG payment on hold: केवल प्राधिकृत (कैप्चर की प्रतीक्षा में) या राशि ऑर्डर से मेल नहीं खाती। डिफ़ॉल्ट: लंबित। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled: GMO-PG पर रद्द किया गया प्राधिकरण या होल्ड पर रखा गया भुगतान, या पूरी तरह रिफ़ंड किया गया प्राधिकरण। डिफ़ॉल्ट: रद्द।
Refunded: ऑर्डर पेज से पूर्ण रिफ़ंड के बाद। डिफ़ॉल्ट: रिफ़ंड किया गया।
उन्नत
Debug log: API अनुरोध और सूचनाएँ OpenCart लॉग फ़ोल्डर (storage/logs) में gmo_pg_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर वह बदल दी जाती है। त्रुटियाँ और चेतावनियाँ स्विच बंद होने पर भी हमेशा लॉग होती हैं। पासवर्ड और ग्राहक डेटा मास्क किए जाते हैं। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। लॉग खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (GMO OrderID, ट्रांज़ैक्शन ID) हमेशा सुरक्षित रहता है। डिफ़ॉल्ट: बंद।
इम्पोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। स्टोर पासवर्ड एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए स्टोर पासवर्ड बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card)। Confirm Order चरण पर ग्राहक को आपका विवरण दिखता है; परीक्षण वातावरण में उसके ऊपर बैज TEST — GMO-PG test environment, no real charges. दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्टेटस के। OpenCart 4 में ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर के कुल योग के लिए पूर्ण येन में GMO-PG Link Type Plus भुगतान बनाता है और ग्राहक को GMO-PG भुगतान पेज पर भेजता है। वहाँ ग्राहक क्रेडिट कार्ड से भुगतान करता है। 3-D Secure 2.0 GMO-PG संभालता है, और 3-D Secure के लिए ग्राहक का ईमेल उसे दिया जाता है। भुगतान पेज ऑर्डर की भाषा के अनुसार जापानी, चीनी या अंग्रेज़ी में खुलता है। भुगतान GMO-PG पर OC- और ऑर्डर नंबर के साथ दिखता है। कोई अन्य ग्राहक डेटा नहीं भेजा जाता।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। हस्ताक्षरित परिणाम भुगतान वाले वातावरण के Shop password से जाँचा जाता है, और ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब GMO-PG उसकी पुष्टि कर दे: ग्राहक के लौटने पर सर्वर-साइड SearchTrade अनुरोध से, या परिणाम सूचना से। दोनों तरीके एक ही तर्क का उपयोग करते हैं, इसलिए भुगतान कभी दो बार लागू नहीं होता। फिर ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि GMO-PG ने भुगतान की पुष्टि अभी नहीं की है, तो एक Payment confirmation पेज दिखता है जिसमें Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. लिखा होता है, साथ में Check again और Back to checkout बटन होते हैं; सूचना आते ही ऑर्डर स्टेटस सेट हो जाता है।
यदि GMO-PG पेज पर कार्ड अस्वीकार हो जाए या भुगतान विफल हो, तो ग्राहक The card payment was declined or could not be completed. Please try again or use another card. के साथ चेकआउट पर लौट आता है। यदि ग्राहक बिना भुगतान किए GMO-PG पेज छोड़ देता है, तो संदेश होता है The payment was not completed. You can try again or choose another payment method. कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। हर नया प्रयास (OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है) कार्ट के पिछले बिना भुगतान वाले भुगतान लिंक रद्द कर देता है। यदि इस बीच कोई पिछला लिंक भुगतान हो चुका है, तो वह भुगतान पक्का किया जाता है और कोई नया लिंक नहीं बनता।
OpenCart 4 सफलता पेज दिखने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर बिना भुगतान के इस बीच बंद हो गया (उदाहरण के लिए GMO-PG पर या आपके द्वारा रद्द किया गया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order कार्ट के लिए एक नए ऑर्डर का भुगतान करता है। यदि वह ऑर्डर पहले ही भुगतान हो चुका है, पर उसके बाद कार्ट बदल गया है, जिसमें नई मात्रा भी शामिल है, तो संदेश होता है Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. भुगतान किया गया ऑर्डर किसी अलग कार्ट के लिए कभी भुगतान किया हुआ नहीं दिखाया जाता।
1 से 9,999,999 JPY तक के ऑर्डर कुल योग का भुगतान हो सकता है; इससे बड़े कुल योग पर भुगतान विधि छिप जाती है। यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, उदाहरण के लिए Card payment could not be started. Please try again or choose another payment method., और कारण लॉग में लिखा जाता है।
सूचना और वापसी तब भी काम करते हैं जब स्टोर maintenance mode में हो, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और एक्सटेंशन OpenCart 4 पर उनके लिए एक स्टार्टअप एक्शन जोड़ता है।
यह एक्सटेंशन क्रेडिट कार्ड भुगतान केवल JPY में, और हमेशा GMO-PG पेज पर लेता है। इसमें कोई अन्य GMO-PG भुगतान विधि, मल्टी-करेंसी, सेव किए गए कार्ड या GMO-PG सदस्य पंजीकरण, सब्सक्रिप्शन या आवर्ती बिलिंग, और साइट पर कार्ड फ़ॉर्म नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
No status (missing order): ग्राहक को GMO-PG पर भेजा गया था और उसने भुगतान नहीं किया, या GMO-PG ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Processing or Completed status: भुगतान की पुष्टि हो गई है; स्टेटस Order status after payment के अनुसार होता है। एक नोट में राशि, GMO-PG स्टेटस, लेन-देन और पुष्टि का तरीका (सूचना या वापसी) दिखता है।
GMO-PG payment on hold (authorized): Authorize only (仮売上) के साथ राशि प्राधिकृत हुई है। प्राधिकरण की अवधि समाप्त होने से पहले Capture payment (GMO-PG) से या GMO-PG कंसोल में उसे कैप्चर करें। कैप्चर के बाद ऑर्डर को भुगतान किया हुआ स्टेटस मिलता है। यदि प्राधिकरण GMO-PG पर रद्द होता है, तो ऑर्डर को Cancelled स्टेटस मिलता है।
GMO-PG payment on hold after payment: GMO-PG ने ऑर्डर के कुल योग से अलग राशि बताई है। नोट इसे समझाता है। ऑर्डर जाँचें और उसे पूरा करें, या भुगतान रिफ़ंड करें।
Refunded: भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड हो गया था। जो प्राधिकरण कभी कैप्चर नहीं हुआ, उसका पूर्ण रिफ़ंड Cancelled स्टेटस सेट करता है।
यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आए, या उसी कार्ट के किसी दूसरे ऑर्डर का भुगतान हो, तो भुगतान किया हुआ ऑर्डर नहीं बदला जाता। एक नोट आपसे डुप्लिकेट भुगतान को GMO-PG कंसोल में रिफ़ंड करने को कहता है। यदि किसी ऐसे ऑर्डर के लिए भुगतान आए जिसका स्टेटस GMO-PG भुगतान के बिना पहले से है, तो केवल एक नोट जोड़ा जाता है।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता।
VibeFox GMO Payment Gateway टैब
Sales > Orders में GMO-PG से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox GMO Payment Gateway टैब में GMO OrderID (परीक्षण भुगतानों पर TEST लेबल के साथ), Transaction ID, GMO-PG स्टेटस के साथ Status, Paid / refunded, कैप्चर बटन और रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के GMO-PG notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है; कैप्चर और रिफ़ंड के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।
कैप्चर
Capture payment (GMO-PG) उस होल्ड ऑर्डर के टैब में दिखता है जिसे केवल प्राधिकृत किया गया था। Capture the authorized GMO-PG payment? की पुष्टि करें। एक्सटेंशन GMO-PG पर लेन-देन जाँचता है और प्राधिकृत राशि चार्ज करता है; उसके बाद ऑर्डर को भुगतान किया हुआ स्टेटस मिलता है। यदि लेन-देन अब प्राधिकृत नहीं है, उदाहरण के लिए क्योंकि वह GMO-PG कंसोल में पहले ही कैप्चर हो चुका है, तो संदेश में वर्तमान स्टेटस दिखता है। GMO-PG कंसोल में किया गया कैप्चर परिणाम सूचना के माध्यम से आता है।
रिफ़ंड
टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via GMO-PG पर क्लिक करें। Refund this amount through GMO-PG? की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं, पूर्ण येन में। सीमा वह राशि है जो GMO-PG ने वास्तव में ली है और अब भी रखे हुए है, न कि ऑर्डर का कुल योग। शेष पूरी राशि का रिफ़ंड GMO-PG लेन-देन को रद्द कर देता है, और यह GMO-PG तय करता है कि यह void है या return। आंशिक रिफ़ंड लेन-देन की राशि घटाता है। रिफ़ंड उस वातावरण में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण का Shop ID और Shop password सेट होना चाहिए। यदि GMO-PG रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस लौटाए बिना ऑर्डर को Refunded स्टेटस देता है, जैसे मैन्युअल स्टेटस बदलाव। आंशिक रिफ़ंड स्टेटस नहीं बदलता।
Sales > Returns में उत्पाद की वापसी GMO-PG के माध्यम से पैसे वापस नहीं भेजती।
GMO-PG कंसोल में किए गए रिफ़ंड और रद्दीकरण परिणाम सूचना से आते हैं और नोट्स में जुड़ते हैं। GMO-PG पर रद्द हुए प्राधिकरण या होल्ड भुगतान के अलावा ऑर्डर स्टेटस अपने-आप नहीं बदलता। ज़रूरत हो तो उसे मैन्युअल रूप से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox GMO Payment Gateway, Extensions > Extensions > Payments > VibeFox GMO Payment Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-gmo की पंक्ति और आपके 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, GMO-PG क्रेडिट कार्ड भुगतान चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है, और कैप्चर तथा रिफ़ंड काम करते हैं।
जब लाइसेंस की अवधि समाप्त हो जाती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं तो स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
Credit card does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चेकआउट मुद्रा JPY है, और वर्तमान वातावरण में Shop ID, Shop password और Config ID हैं। 9,999,999 JPY से ऊपर के कुल योग कार्ड से नहीं दिए जा सकते। यदि मुद्रा या क्रेडेंशियल गलत हैं, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।
The payment went through, but the order stays without a status: परिणाम सूचना काम नहीं कर रही। जिस वातावरण का आप उपयोग करते हैं, उसके GMO-PG शॉप कंसोल में जाँचें कि 結果通知 चालू है और URL Notification URL में दिखाए गए URL के बिल्कुल समान है। जाँचें कि उस वातावरण के Shop ID और Shop password भरे हुए हैं, क्योंकि एक्सटेंशन हर सूचना को उन्हीं से सत्यापित करता है। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर को स्टेटस मिलता है।
Log shows Notification rejected: unknown ShopID.: सूचना ऐसी दुकान से आई है जिसका Shop ID सेटिंग्स में नहीं है। उस वातावरण का Shop ID दर्ज करें।
Log shows Notification ignored: OrderID is not a payment of this store.: लेन-देन इस स्टोर ने नहीं बनाया, उदाहरण के लिए वह GMO-PG कंसोल में हुआ। कुछ करने की ज़रूरत नहीं है।
Log shows that the order was paid in another environment: परीक्षण और production भुगतान अलग रखे जाते हैं। परीक्षण सूचना कभी production भुगतान की पुष्टि नहीं करती, और इसका उलटा भी सही है।
The customer sees an error after Confirm Order: Debug log चालू करें और Log फ़ील्ड देखें। लॉग में GMO-PG त्रुटि कोड (ErrCode, ErrInfo) दिखता है। गलत Shop ID, Shop password या Config ID आम कारण है। This payment method is not available at the moment. Please choose another payment method. का अर्थ है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट दोबारा लोड करना होगा।
Order is in the GMO-PG payment on hold status: VibeFox GMO Payment Gateway टैब के नोट पढ़ें। ऑर्डर केवल प्राधिकृत है और कैप्चर की प्रतीक्षा में है, या भुगतान की गई राशि ऑर्डर से अलग थी।
Refund or capture fails: टैब का संदेश पढ़ें। ऑर्डर उस दूसरे वातावरण में भुगतान किया गया हो सकता है जिसका Shop ID और password सेट नहीं हैं; लेन-देन GMO-PG पर पहले ही रद्द हो सकता है; या राशि लेन-देन में बची राशि से अधिक हो सकती है। The order is being updated by GMO-PG right now. Try again in a moment. का अर्थ है कि उसी समय एक सूचना संसाधित हो रही थी।
The tab shows You do not have permission to refund orders.: आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है। किसी एडमिन से System > Users > User Groups में यह अधिकार देने को कहें।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox GMO Payment Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Order statuses सेक्शन के फ़ील्ड, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। OpenCart 4 पर एक्सटेंशन की इवेंट (चेकआउट संदेश) और उसका स्टार्टअप एक्शन, जो maintenance mode में सूचना और वापसी को आगे जाने देता है, भी हटा दिए जाते हैं। यदि Delete data on uninstall चालू है, तो अन्य गेटवे सेटिंग्स (शीर्षक, विवरण, वातावरण, क्रेडेंशियल, कैप्चर, भुगतान के बाद ऑर्डर स्टेटस, डीबग लॉग स्विच) और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे रहते हैं। GMO-PG लेन-देन और रिफ़ंड हमेशा रखे जाते हैं, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी कैप्चर और रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपनी भुगतान टिप्पणियाँ रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox GMO Payment Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
GMO Payment Gateway उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन GMO Payment Gateway से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।