VibeFox KOMOJU for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: साइट पर HTTPS चाहिए और KOMOJU को वेबहुक URL तक पहुँच होनी चाहिए।

KOMOJU account: सीक्रेट कुंजी (sk_live_... और टेस्ट मोड में sk_test_...) तथा KOMOJU डैशबोर्ड में बनाए वेबहुक का सीक्रेट टोकन चाहिए (कॉन्फ़िगरेशन देखें)। पब्लिश करने योग्य कुंजी आवश्यक नहीं है।

Store currency: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD या VND। अन्य मुद्राओं में तरीका छिपा रहता है।

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

इंस्टॉलेशन

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

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

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

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

5. KOMOJU डैशबोर्ड में सेटिंग पेज के URL और सूचीबद्ध इवेंट के साथ वेबहुक जोड़ें और उसका सीक्रेट टोकन कॉपी करें (कॉन्फ़िगरेशन देखें)।

6. लाइव सीक्रेट कुंजी और लाइव वेबहुक सीक्रेट टोकन तथा सैंडबॉक्स के लिए टेस्ट वाले दर्ज करें। Enable/Disable चालू करें और सेव करें।

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

सभी सेटिंग एक पेज पर हैं: WooCommerce > Settings > Payments > KOMOJU Payment। टेस्ट मोड में फ़ील्ड के ऊपर KOMOJU Sandbox Mode is enabled. दिखता है। वर्तमान मोड में सीक्रेट कुंजी न होने पर चेतावनी आती है (तरीका चेकआउट से छिप जाता है), वेबहुक सीक्रेट टोकन न होने पर भी (KOMOJU सूचनाएँ अस्वीकृत होती हैं, इसलिए konbini और बैंक ट्रांसफ़र की कभी पुष्टि नहीं होती), और स्टोर की मुद्रा असमर्थित होने पर भी। भुगतान तरीकों की सूची में वर्तमान मोड की सीक्रेट कुंजी मिलने तक KOMOJU को सेटअप आवश्यक दिखाया जाता है; सैंडबॉक्स में टेस्ट बैज दिखता है।

सामान्य

Enable/Disable: Enable KOMOJU Payment Gateway भुगतान तरीका चालू या बंद करता है। डिफ़ॉल्ट: off।

Title: चेकआउट पर ग्राहकों को दिखने वाला नाम। डिफ़ॉल्ट: KOMOJU Payment।

Description: चेकआउट पर तरीके के नीचे का पाठ। डिफ़ॉल्ट: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

लाइव API कुंजियाँ

KOMOJU डैशबोर्ड में कुंजियाँ खोजें: सीक्रेट कुंजी Settings > API keys में, वेबहुक सीक्रेट टोकन Settings > Webhooks में (पहले नीचे दिखाया वेबहुक URL वहाँ जोड़ें)।

Live Secret Key: आपकी KOMOJU लाइव सीक्रेट कुंजी। sk_live_ से शुरू होती है।

Live Webhook Secret Token: लाइव वेबहुक का सीक्रेट टोकन। हर सूचना के हस्ताक्षर की जाँच करता है।

टेस्ट मोड

KOMOJU टेस्ट और लाइव भुगतान के लिए एक ही API पता इस्तेमाल करता है; कुंजी मोड तय करती है। ऑर्डर अपना भुगतान मोड रखते हैं, इसलिए रिफ़ंड और स्थिति की जाँच हमेशा उसी मोड की कुंजी लेते हैं।

Sandbox Mode: Enable test mode (use the test keys below, no real payments)। डिफ़ॉल्ट: off। चालू होने पर चेकआउट में विवरण के ऊपर Test mode दिखता है।

Sandbox Secret Key: आपकी KOMOJU टेस्ट सीक्रेट कुंजी। sk_test_ से शुरू होती है।

Sandbox Webhook Secret Token: टेस्ट मोड वेबहुक का सीक्रेट टोकन।

वेबहुक URL

वेबहुक स्टोर को भुगतानों की सूचना देता है, जिनमें विलंबित konbini और बैंक ट्रांसफ़र शामिल हैं। KOMOJU डैशबोर्ड में Settings > Webhooks के अंतर्गत इस सेटिंग अनुभाग का URL लाइव और टेस्ट के लिए जोड़ें। यह https://your-site/wc-api/komoju_p_webhook/ जैसा होता है। URL में भाषा प्रीफ़िक्स हो तो सेटिंग में दिखा पता हूबहू कॉपी करें। फिर हर वेबहुक का सीक्रेट टोकन Live Webhook Secret Token या Sandbox Webhook Secret Token में कॉपी करें।

ये इवेंट चुनें:

समाप्ति, रद्दीकरण और विफलता के इवेंट केवल वर्तमान भुगतान के लिए ऑर्डर बदलते हैं; पिछली कोशिश का भुगतान दूसरे तरीके से भुगतान किए जा रहे ऑर्डर को रद्द नहीं कर सकता। मान्य हस्ताक्षर के बिना वेबहुक अस्वीकृत होते हैं। दोनों में से किसी सीक्रेट टोकन से हस्ताक्षरित वेबहुक स्वीकार होते हैं, लेकिन उसी मोड के ऑर्डर के लिए। वेबहुक के बिना कार्ड भुगतान ग्राहक के लौटने पर पुष्टि हो जाते हैं, पर konbini और बैंक ट्रांसफ़र कभी नहीं।

उन्नत

Invoice Prefix: KOMOJU को भेजे ऑर्डर नंबर का प्रीफ़िक्स। एक खाते से कई स्टोर चलें तो हर स्टोर के लिए अनूठा रखें। डिफ़ॉल्ट: WC-।

Enable Logging: Log KOMOJU events and API calls, WooCommerce > Status > Logs में, स्रोत wcp_komoju_payment; कुंजियाँ या ग्राहक डेटा नहीं। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: off।

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

चेकआउट

ग्राहक तरीका चुनता है (डिफ़ॉल्ट KOMOJU Payment) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में कुल राशि का KOMOJU भुगतान सेशन बनाकर ग्राहक को KOMOJU भुगतान पेज भेजता है। बिलिंग ईमेल, नाम, बिलिंग व शिपिंग पते और मँगाए गए उत्पाद KOMOJU को दिए जाते हैं। पेज साइट की भाषा के अनुसार जापानी, अंग्रेज़ी या कोरियाई में आता है (अन्य भाषाओं के लिए अंग्रेज़ी)। वहाँ ग्राहक तरीका चुनता है। उपलब्ध तरीके आपके KOMOJU खाते और ऑर्डर की मुद्रा पर निर्भर हैं।

भुगतान के बाद ग्राहक स्टोर लौटता है। प्लगइन ऑर्डर के मोड की कुंजी से KOMOJU API में सेशन पढ़ता है। KOMOJU के हस्ताक्षरित वेबहुक या वापसी पर सेशन पढ़ने से पुष्टि के बाद ही भुगतान चिह्नित होता है। यदि उस समय KOMOJU से संपर्क नहीं होता, ग्राहक ऑर्डर प्राप्त पेज पर जाता है जहाँ We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. दिखता है।

Konbini और बैंक ट्रांसफ़र में ग्राहक को भुगतान पर्ची मिलती है। ऑर्डर होल्ड पर जाता है और ग्राहक के भुगतान तथा KOMOJU के वेबहुक भेजने पर पूरा होता है। पर्ची की अवधि समाप्त हो तो ऑर्डर रद्द होता है।

भुगतान अधूरा हो तो ग्राहक Pay for order पेज पर लौटता है और The payment was not completed. You can try again or choose another payment method. दिखता है। कुल राशि न बदले तो नई कोशिश खुले सेशन को दोबारा लेती है। पुरानी राशि वाला सेशन KOMOJU में रद्द होता है; इस बीच भुगतान हुआ सेशन ऑर्डर की पुष्टि करता है। बिना भुगतान का ऑर्डर रद्द होने पर (आप, ग्राहक या WooCommerce स्टॉक रोकने के टाइमर से), खुला KOMOJU सेशन भी रद्द होता है ताकि उसका भुगतान न हो सके।

KOMOJU भुगतान शुरू न कर पाए तो ग्राहक को छोटा संदेश दिखता है, जैसे कारण सहित KOMOJU could not accept this payment:, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. या Payment error: Could not connect to KOMOJU. Please try again in a moment.। विवरण ऑर्डर नोट और लॉग में जुड़ते हैं।

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

साइट पर कार्ड फ़ॉर्म, सेव किए कार्ड या सब्सक्रिप्शन नहीं हैं। प्लगइन तरीकों को सीमित नहीं करता; वे KOMOJU पेज पर चुने जाते हैं। मैन्युअल कैप्चर नहीं है: इसके लिए अधिकृत भुगतान KOMOJU डैशबोर्ड में कैप्चर करने होंगे और तब तक ऑर्डर होल्ड पर रहेगा।

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

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

Pending payment: ग्राहक KOMOJU भेजा गया है और अभी भुगतान नहीं हुआ, या KOMOJU ने अभी पुष्टि नहीं की।

Processing or Completed: KOMOJU ने भुगतान की पुष्टि की। WooCommerce भुगतान किए ऑर्डर की सामान्य स्थिति देता है। नोट में KOMOJU भुगतान ID, तरीका और पुष्टि का माध्यम (वेबहुक या वापसी) है। ट्रांज़ैक्शन ID, KOMOJU भुगतान ID है और ऑर्डर स्क्रीन से डैशबोर्ड के भुगतान का लिंक देता है।

On hold: konbini या बैंक ट्रांसफ़र पर्ची जारी है और भुगतान की प्रतीक्षा है, या भुगतान डैशबोर्ड में कैप्चर की प्रतीक्षा में है। राशि/मुद्रा न मिलने या रद्दीकरण के बाद कैप्चर होने पर भी होल्ड होता है। नोट कारण बताता है। ऑर्डर पूरा करें या रिफ़ंड दें।

Failed: भुगतान विफल। ग्राहक फिर कोशिश कर सकता है।

Cancelled: पर्ची की अवधि समाप्त या भुगतान रद्द।

Refunded: WooCommerce या KOMOJU डैशबोर्ड से पूर्ण रिफ़ंड हुआ।

पहले से भुगतान किए ऑर्डर के लिए दूसरा भुगतान कैप्चर होने पर ऑर्डर फिर नहीं बदलता। नोट कहता है कि दोहरा भुगतान हो तो डैशबोर्ड में रिफ़ंड करें। रिफ़ंड किए ऑर्डर कभी फिर नहीं खुलते।

रिफ़ंड

ऑर्डर खोलें, Refund क्लिक करें, राशि दें और Refund via KOMOJU Payment क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। मूल भुगतान के मोड की कुंजी ली जाती है, इसलिए उसकी सीक्रेट कुंजी सेट होनी चाहिए। प्लगइन पहले KOMOJU में भुगतान जाँचता है और बची रिफ़ंड योग्य राशि से अधिक को मना करता है। स्वतः रिफ़ंड संभव न हो (konbini जैसे तरीकों में ग्राहक के बैंक विवरण चाहिए), तो KOMOJU की त्रुटि दिखती है और कुछ दर्ज नहीं होता: ऐसे रिफ़ंड डैशबोर्ड में करें। KOMOJU पुष्टि के बाद ही रिफ़ंड पूरा माना जाता है। सफल रिफ़ंड ऑर्डर नोट में जुड़ता है।

दूसरी मुद्रा में बदले भुगतान (जैसे EUR ऑर्डर के लिए JPY konbini) पर WooCommerce से केवल पूर्ण रिफ़ंड संभव है। आंशिक रिफ़ंड डैशबोर्ड में करें।

डैशबोर्ड के रिफ़ंड वेबहुक से आते हैं और WooCommerce रिफ़ंड के रूप में स्वतः दर्ज होते हैं। पूर्ण रिफ़ंड ऑर्डर को रिफ़ंड किया गया करता है। बदली मुद्रा के भुगतान पर डैशबोर्ड का आंशिक रिफ़ंड केवल नोट होता है: WooCommerce में "Refund manually" से संबंधित राशि दर्ज करें।

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

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

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

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

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

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

चेकआउट पर KOMOJU नहीं दिखता: सक्रिय लाइसेंस, Enable/Disable चालू होना और वर्तमान मोड की कुंजी जाँचें: सैंडबॉक्स में Sandbox Secret Key, लाइव में Live Secret Key। मुद्रा समर्थित होनी चाहिए। सेटिंग पेज कमी की चेतावनी देता है।

भुगतान हुआ, पर ऑर्डर Pending payment है: वेबहुक नहीं चल रहा। डैशबोर्ड में सही मोड का वेबहुक, सेटिंग से हूबहू URL और चुने इवेंट जाँचें। सही फ़ील्ड (Live Webhook Secret Token या Sandbox Webhook Secret Token) में टोकन जाँचें और WooCommerce > Status > Logs, स्रोत wcp_komoju_payment देखें। कार्ड वापसी पर भी पुष्टि होते हैं, konbini और ट्रांसफ़र केवल वेबहुक से।

वेबहुक का उत्तर Failed to verify KOMOJU webhook signature: टोकन नहीं है या दूसरे वेबहुक का है। KOMOJU सूचना फिर भेजता है।

वेबहुक का उत्तर Mode mismatch, ignored: ऑर्डर के भुगतान से अलग मोड के टोकन से हस्ताक्षर हुआ। लाइव और टेस्ट के लिए अलग वेबहुक व टोकन रखें।

वेबहुक का उत्तर Order is busy, retry later या Temporary error, retry later: दूसरा अनुरोध ऑर्डर बदल रहा था या उस समय भुगतान की जाँच नहीं हुई। KOMOJU सूचना फिर भेजता है।

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

रिफ़ंड विफल: संदेश पढ़ें। मूल मोड की कुंजी नहीं हो सकती, स्वतः रिफ़ंड संभव नहीं (डैशबोर्ड इस्तेमाल करें), या बदली मुद्रा में केवल पूर्ण रिफ़ंड हो सकता है।

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

डेवलपर komoju_p_supported_currencies फ़िल्टर से मुद्राएँ और komoju_p_session_params फ़िल्टर से भुगतान सेशन, जैसे भुगतान तरीके, बदल सकते हैं।

अनइंस्टॉल

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

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