VibeFox GMO for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर की मुद्रा: जापानी येन (JPY)। स्टोर की मुद्रा अलग होने पर चेकआउट पर भुगतान विधि छिप जाती है। Pay for order पेज पर ऑर्डर की मुद्रा मायने रखती है।

GMO Payment Gateway खाता: Link Type Plus वाला GMO-PG मर्चेंट अनुबंध। आपको परीक्षण और/या लाइव वातावरण के Shop ID, Shop password और Link Type Plus Config ID (設定ID) चाहिए, और GMO-PG शॉप कंसोल में परिणाम सूचना (結果通知) चालू होनी चाहिए (कॉन्फ़िगरेशन देखें)। Site ID और Site password उपयोग नहीं होते।

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

इंस्टॉलेशन

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

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

3. सेटिंग खोलें: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage, या प्लगइन पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

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

5. परीक्षण और/या लाइव वातावरण के Shop ID, Shop password और Config ID दर्ज करें और Environment चुनें।

6. GMO-PG शॉप कंसोल में 結果通知 (परिणाम सूचना) चालू करें और सेटिंग में दिखाया गया सूचना URL सेट करें (कॉन्फ़िगरेशन देखें)।

7. Enable/Disable चालू करें। परीक्षण वातावरण में परीक्षण भुगतान करें, फिर Environment को लाइव पर बदलें।

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

सभी सेटिंग एक पेज पर हैं: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card। पेज के शीर्षक में मौजूदा वातावरण के लिए TEST या PRODUCTION बैज दिखता है। स्टोर की मुद्रा JPY न होने या मौजूदा वातावरण के Shop ID, Shop password या Config ID के गायब होने पर पेज फ़ील्ड के ऊपर चेतावनी देता है। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है। मौजूदा वातावरण के क्रेडेंशियल भरने तक भुगतान विधियों की सूची में गेटवे को सेटअप की आवश्यकता वाला दिखाया जाता है। सहेजने पर क्रेडेंशियल के शुरू और अंत के स्पेस हट जाते हैं।

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

Title: चेकआउट पर दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Credit card।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

GMO-PG खाता

Shop ID और Shop password, GMO-PG शॉप कंसोल में Shop management > Shop information के अंतर्गत मिलते हैं, और Config ID, Link Type Plus > Settings (設定ID) के अंतर्गत मिलता है। परीक्षण और लाइव वातावरण के क्रेडेंशियल अलग हैं।

Environment: भुगतान लेने वाला GMO-PG वातावरण।

लाइव क्रेडेंशियल (p01.mul-pay.jp)

Production Shop ID: लाइव वातावरण का Shop ID।

Production Shop password: लाइव वातावरण का Shop password।

Production Config ID: GMO-PG कंसोल में पंजीकृत Link Type Plus कॉन्फ़िगरेशन ID (設定ID)।

परीक्षण क्रेडेंशियल (pt01.mul-pay.jp)

Test Shop ID: परीक्षण वातावरण का Shop ID।

Test Shop password: परीक्षण वातावरण का Shop password।

Test Config ID: परीक्षण वातावरण का Link Type Plus कॉन्फ़िगरेशन ID (設定ID)।

भुगतान

Capture: कार्ड से शुल्क कब लिया जाता है।

Order status after payment: भुगतान किए गए ऑर्डर की स्थिति। स्थिति तुरंत सेट होती है, केवल एक स्थिति परिवर्तन और ग्राहक को एक ईमेल के साथ।

भुगतान सूचनाएँ (結果通知)

परिणाम सूचना आपके स्टोर को बताती है कि भुगतान हो गया है। यह आवश्यक है। GMO-PG शॉप कंसोल में 結果通知 (परिणाम सूचना) चालू करें और सेटिंग के इस भाग में दिखाया गया सूचना URL सेट करें। यह https://your-site/wc-api/gmo_pg_webhook/ जैसा होता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग में दिखता है।

GMO-PG की सूचनाएँ हस्ताक्षरित नहीं होतीं, इसलिए प्लगइन उनकी सामग्री पर कभी सीधे भरोसा नहीं करता। सूचना आपके कॉन्फ़िगर किए गए Shop ID में से किसी एक से आनी चाहिए और उसी वातावरण में इस स्टोर द्वारा बनाए गए भुगतान की होनी चाहिए जिसमें ऑर्डर का भुगतान हुआ था। इसके बाद प्लगइन आपके Shop password से GMO-PG से लेन-देन पूछता है (SearchTrade) और केवल उस उत्तर के आधार पर ऑर्डर बदलता है। वास्तविक लेन-देन से मेल न खाने वाली सूचना कुछ नहीं बदलती। स्टोर के बाहर बनाए गए लेन-देन, जैसे GMO-PG कंसोल में किए गए लेन-देन, की सूचना मिलने की पुष्टि की जाती है और उन्हें अनदेखा किया जाता है। जब प्लगइन किसी सूचना की जाँच नहीं कर पाता, तो ऐसा उत्तर देता है कि GMO-PG उसे फिर भेजे (GMO-PG अधिकतम 5 बार पुनः प्रयास करता है)।

सूचना के बिना ऑर्डर की पुष्टि तभी होती है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

उन्नत

Debug log: Log API requests and notifications इन्हें WooCommerce > Status > Logs में लिखता है, स्रोत wcp_gmo_payment। त्रुटियाँ हमेशा लॉग की जाती हैं। पासवर्ड और ग्राहक का डेटा छिपाया जाता है। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted। निष्क्रिय करने से कभी कुछ नहीं मिटता। ऑर्डर का डेटा (लेन-देन ID) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि को पूर्ण येन में पूर्णांकित करके GMO-PG Link Type Plus भुगतान बनाता है और ग्राहक को GMO-PG भुगतान पेज पर भेजता है। वहाँ ग्राहक क्रेडिट कार्ड से भुगतान करता है। GMO-PG, 3-D Secure 2.0 संभालता है और 3-D Secure के लिए ग्राहक का बिलिंग ईमेल उसे दिया जाता है। भुगतान पेज आपकी साइट की भाषा के अनुसार जापानी, चीनी या अंग्रेज़ी में खुलता है। GMO-PG में भुगतान WC- और ऑर्डर नंबर के साथ दिखता है। ग्राहक का कोई अन्य डेटा नहीं भेजा जाता।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। हस्ताक्षरित परिणाम की जाँच आपके Shop password से होती है और GMO-PG की पुष्टि के बाद ही ऑर्डर भुगतान किया हुआ चिह्नित होता है: ग्राहक के लौटने पर सर्वर-साइड SearchTrade अनुरोध से या परिणाम सूचना से। दोनों में समान तर्क उपयोग होता है, इसलिए ऑर्डर कभी दो बार प्रोसेस नहीं होता। भुगतान की अभी पुष्टि न हुई हो तो ऑर्डर प्राप्ति पेज पर Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed. दिखता है।

कार्ड अस्वीकार होने या GMO-PG पेज पर भुगतान विफल होने पर ऑर्डर विफल हो जाता है और ग्राहक Pay for order पेज पर 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. दिखाता है। हर नया प्रयास पिछला बिना भुगतान वाला भुगतान लिंक रद्द करता है। यदि इस बीच पिछले लिंक का भुगतान हो चुका हो, तो वही भुगतान लागू होता है और नया लिंक नहीं बनता।

1 से 9,999,999 JPY तक की कुल राशि वाले ऑर्डर का भुगतान किया जा सकता है। अधिक राशि होने पर भुगतान विधि छिप जाती है। भुगतान शुरू न हो सके तो ग्राहक को छोटा संदेश दिखता है, जैसे Card payment could not be started. Please try again or choose another payment method., और कारण ऑर्डर नोट में जोड़ दिया जाता है।

भुगतान विधि क्लासिक चेकआउट, कार्ट और चेकआउट ब्लॉक और Pay for order पेज पर काम करती है। चेकआउट ब्लॉक में कार्ड का आइकन और विवरण दिखते हैं। परीक्षण वातावरण में क्लासिक चेकआउट और चेकआउट ब्लॉक, दोनों में Test mode — no real charge बैज दिखता है। यह WooCommerce के High-Performance Order Storage (HPOS) के अनुकूल है।

प्लगइन केवल JPY में क्रेडिट कार्ड से भुगतान लेता है, हमेशा GMO-PG पेज पर। इसमें अन्य GMO-PG भुगतान विधियाँ, कई मुद्राएँ, सेव किए गए कार्ड या GMO-PG सदस्य पंजीकरण, सदस्यताएँ या आवर्ती बिलिंग और साइट पर कार्ड फ़ॉर्म नहीं हैं।

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

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

Pending payment: ग्राहक GMO-PG पर गया है और उसने अभी भुगतान नहीं किया, या GMO-PG ने अभी भुगतान की पुष्टि नहीं की है।

Processing or Completed: भुगतान की पुष्टि हो गई है। स्थिति Order status after payment के अनुसार होती है। ऑर्डर नोट में राशि, GMO-PG स्थिति, लेन-देन और पुष्टि का तरीका (सूचना या वापसी) दिखता है। लेन-देन ID, GMO-PG TranID होता है।

On hold (authorized): Authorize only (仮売上) के साथ राशि अधिकृत हुई है। प्राधिकरण समाप्त होने से पहले ऑर्डर कार्रवाई Capture payment (GMO-PG) से या GMO-PG कंसोल में इसे कैप्चर करें। कैप्चर के बाद ऑर्डर प्रसंस्करण में या पूर्ण हो जाता है। GMO-PG में प्राधिकरण रद्द होने पर ऑर्डर रद्द हो जाता है।

On hold after payment: GMO-PG ने ऑर्डर की कुल राशि से अलग राशि बताई है या ऑर्डर रद्द होने के बाद भुगतान आया है। ऑर्डर नोट में कारण दिया जाता है। ऑर्डर जाँचें और उसे पूरा करें या भुगतान रिफ़ंड करें।

Failed: कार्ड अस्वीकार हुआ या GMO-PG पेज पर भुगतान पूरा नहीं हुआ।

पहले से भुगतान किए गए या बंद ऑर्डर का दूसरा भुगतान आने पर ऑर्डर नहीं बदलता। नोट आपको GMO-PG कंसोल में दोहरे भुगतान को रिफ़ंड करने के लिए कहता है।

कैप्चर

ऑर्डर कार्रवाई Capture payment (GMO-PG) होल्ड पर मौजूद उन ऑर्डर में दिखती है जिन्हें केवल अधिकृत किया गया है। यह अधिकृत राशि का शुल्क लेती है। लेन-देन अब अधिकृत न हो, जैसे GMO-PG कंसोल में पहले ही कैप्चर हो चुका हो, तो कार्रवाई वर्तमान स्थिति का नोट जोड़ती है और उसी के अनुसार काम करती है।

रिफ़ंड

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

GMO-PG कंसोल में किए गए रिफ़ंड और रद्दीकरण परिणाम सूचना से आते हैं और ऑर्डर नोट में जुड़ते हैं। वे अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते। आवश्यकता हो तो GMO-PG बटन के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

चेकआउट पर क्रेडिट कार्ड नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, स्टोर की मुद्रा JPY है और मौजूदा वातावरण के Shop ID, Shop password और Config ID भरे हैं। 9,999,999 JPY से अधिक के ऑर्डर का कार्ड से भुगतान नहीं हो सकता। मुद्रा या क्रेडेंशियल गलत होने पर सेटिंग पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment ही है: परिणाम सूचना काम नहीं कर रही। उपयोग किए जा रहे वातावरण के GMO-PG शॉप कंसोल में जाँचें कि 結果通知 चालू है और URL ठीक वही है जो सेटिंग में दिखता है। उस वातावरण के Shop ID और Shop password भरे होने चाहिए, क्योंकि प्लगइन उनसे हर सूचना की जाँच करता है। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_gmo_payment देखें। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर की पुष्टि होती है।

लॉग में Notification rejected: unknown ShopID दिखता है: सूचना ऐसे शॉप से आई है जिसका Shop ID सेटिंग में नहीं है। उस वातावरण का Shop ID दर्ज करें।

लॉग में Notification ignored ... is not a payment of this store दिखता है: लेन-देन इस स्टोर ने नहीं बनाया, जैसे वह GMO-PG कंसोल में किया गया हो। कुछ करने की आवश्यकता नहीं है।

लॉग बताता है कि ऑर्डर का भुगतान दूसरे वातावरण में हुआ: परीक्षण और लाइव भुगतान अलग रखे जाते हैं। परीक्षण सूचना कभी लाइव ऑर्डर की पुष्टि नहीं करती, और इसका उलटा भी नहीं होता।

ऑर्डर देते समय ग्राहक को त्रुटि दिखती है: ऑर्डर नोट खोलें या Debug log चालू करें। नोट में GMO-PG त्रुटि कोड (ErrCode, ErrInfo) दिखता है। सामान्य कारण गलत Shop ID, Shop password या Config ID होता है। GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. का अर्थ है कि ऑर्डर JPY में नहीं है।

भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। ऑर्डर केवल अधिकृत है और कैप्चर की प्रतीक्षा में है, भुगतान की राशि ऑर्डर से अलग थी या ऑर्डर रद्द होने के बाद भुगतान आया था।

रिफ़ंड विफल होता है: संदेश पढ़ें। ऑर्डर का भुगतान दूसरे वातावरण में हुआ हो सकता है जिसके Shop ID और पासवर्ड सेट नहीं हैं, लेन-देन GMO-PG में पहले से रद्द हो सकता है या राशि लेन-देन की बची राशि से अधिक हो सकती है।

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

अनइंस्टॉल

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

GMO Payment Gateway अपने संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन GMO Payment Gateway से संबद्ध नहीं है और न ही GMO Payment Gateway द्वारा अनुमोदित है।