VibeFox KOMOJU for OpenCart — सहायता

आवश्यकताएँ

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

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

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

ऑर्डर मुद्रा: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD या VND। अन्य मुद्राओं के ऑर्डर के लिए भुगतान विधि छिपा दी जाती है।

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

इंस्टॉलेशन

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

OpenCart 3

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

2. Extensions > Extensions पर जाएँ, टाइप Payments चुनें, VibeFox KOMOJU Payment ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास पेमेंट एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

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

4. KOMOJU डैशबोर्ड में Webhook URL सेक्शन में दिखाए गए URL और इवेंट के साथ एक webhook जोड़ें, और उसका सीक्रेट टोकन कॉपी करें (कॉन्फ़िगरेशन देखें)।

5. लाइव सीक्रेट कुंजी और लाइव webhook सीक्रेट टोकन डालें, और सैंडबॉक्स मोड के लिए टेस्ट कुंजियाँ डालें। Enable/Disable चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

3. Extensions > Extensions पर जाएँ और टाइप Payments चुनें। VibeFox KOMOJU Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. लाइसेंस कुंजी, वेबहुक और कुंजियाँ उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Webhook URL अलग है (देखें Webhook URL)।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, जब टेस्ट मोड चालू होता है, पेज KOMOJU Sandbox Mode is enabled. दिखाता है। यदि मौजूदा मोड में सीक्रेट कुंजी नहीं है (तब चेकआउट में भुगतान विधि छिपी रहती है), या webhook सीक्रेट टोकन नहीं है (तब KOMOJU की सूचनाएँ अस्वीकार होती हैं और कॉन्विनियंस स्टोर और बैंक ट्रांसफ़र भुगतान कभी पुष्ट नहीं होते), तो यह चेतावनी देता है। और जब KOMOJU स्टोर की डिफ़ॉल्ट मुद्रा का समर्थन नहीं करता (तब उस मुद्रा के ऑर्डर के लिए भुगतान विधि छिपी रहती है), तब भी चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title 128 अक्षरों से अधिक नहीं होना चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन व ऑर्डर स्टेटस मौजूद होने चाहिए। अन्यथा कुछ भी सेव नहीं होता और पेज वह फ़ील्ड बताता है। गायब कुंजियाँ सेव होने से नहीं रोकतीं।

KOMOJU भुगतान

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

Title: चेकआउट में ग्राहकों को दिखने वाला भुगतान विधि का नाम। ऑर्डर में भी यही भुगतान विधि नाम सेव होता है। डिफ़ॉल्ट: KOMOJU Payment। यदि खाली छोड़ा गया, तो डिफ़ॉल्ट नाम उपयोग होता है। अधिकतम 128 अक्षर।

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

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

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

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

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

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

Live Webhook Secret Token: लाइव webhook का सीक्रेट टोकन। हर सूचना के हस्ताक्षर की पुष्टि के लिए इसका उपयोग होता है।

टेस्ट मोड

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

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

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

Sandbox Webhook Secret Token: टेस्ट मोड के webhook का सीक्रेट टोकन।

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

Webhook URL

webhook आपके स्टोर को भुगतानों के बारे में बताता है, जिसमें देर से होने वाले कॉन्विनियंस स्टोर (konbini) और बैंक ट्रांसफ़र भुगतान भी शामिल हैं। KOMOJU डैशबोर्ड में Settings > Webhooks के अंतर्गत, इस सेक्शन में दिखाया गया URL लाइव और टेस्ट मोड दोनों के लिए जोड़ें। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को सेटिंग्स में दिखाए गए रूप में ही हूबहू कॉपी करें। फिर हर webhook का सीक्रेट टोकन Live Webhook Secret Token या Sandbox Webhook Secret Token में कॉपी करें।

ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):

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

ऑर्डर

OpenCart Confirm Order चरण में ऑर्डर बिना स्टेटस के बनाता है (एक गायब ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब KOMOJU भुगतान की पुष्टि कर दे। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: भुगतान कैप्चर हुआ, और राशि व मुद्रा सत्यापित हुईं। डिफ़ॉल्ट: Processing।

Awaiting KOMOJU Payment Status: भुगतान प्राधिकृत है: konbini पर्ची या बैंक ट्रांसफ़र जारी हुआ, या भुगतान KOMOJU डैशबोर्ड में कैप्चर होने की प्रतीक्षा में है। डिफ़ॉल्ट: Pending।

KOMOJU Payment On Hold Status: चुकाई गई राशि या मुद्रा ऑर्डर से अलग है, या भुगतान ऑर्डर रद्द होने के बाद आया। एक नोट कारण बताता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है।

Cancelled Payment Status: प्रतीक्षारत ऑर्डर के भुगतान की अवधि समाप्त हो गई या वह रद्द हुआ, उदाहरण के लिए konbini पर्ची समय पर नहीं चुकाई गई। डिफ़ॉल्ट: Canceled।

Failed Payment Status: प्रतीक्षारत ऑर्डर का भुगतान विफल हुआ। डिफ़ॉल्ट: Failed।

Refunded Status: भुगतान पूरी तरह रिफ़ंड होने के बाद ऑर्डर पेज से या KOMOJU डैशबोर्ड से सेट होता है। डिफ़ॉल्ट: Refunded।

आप अपने स्टेटस बना सकते हैं, जैसे Awaiting KOMOJU payment या On hold, System > Localisation > Order Statuses में, और उन्हें यहाँ चुन सकते हैं।

उन्नत

Invoice Prefix: KOMOJU को भेजे जाने वाले ऑर्डर नंबरों का उपसर्ग। KOMOJU पर नंबर उपसर्ग, OpenCart ऑर्डर नंबर और एक छोटे यादृच्छिक प्रत्यय से बनता है, उदाहरण के लिए OC-123-A1B2C3। यदि आप एक ही KOMOJU खाते के साथ कई स्टोर चलाते हैं, तो हर स्टोर के लिए इसे अनोखा रखें। डिफ़ॉल्ट: OC-।

Enable Logging: KOMOJU इवेंट और API कॉल को OpenCart लॉग फ़ोल्डर (storage/logs) की komoju_p_debug.log.php फ़ाइल में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ और ग्राहक डेटा दर्ज नहीं होते। त्रुटियाँ और चेतावनियाँ हमेशा लिखी जाती हैं। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और KOMOJU लेन-देन व रिफ़ंड हमेशा बने रहते हैं, ताकि पुराने ऑर्डर दोबारा इंस्टॉल के बाद भी पुष्ट और रिफ़ंड किए जा सकें। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से KOMOJU Payment)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to the KOMOJU payment page to complete the payment. OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल के लिए KOMOJU भुगतान सत्र बनाता है और ग्राहक को KOMOJU भुगतान पेज पर भेजता है। ईमेल, नाम, भुगतान और शिपिंग पते तथा ऑर्डर किए गए सामान KOMOJU को दिए जाते हैं। पेज ग्राहक की भाषा के अनुसार जापानी, अंग्रेज़ी या कोरियाई में दिखता है (अन्य भाषाओं के लिए अंग्रेज़ी)। वहाँ ग्राहक एक भुगतान विधि चुनता है। कौन-सी विधियाँ मिलेंगी, यह आपके KOMOJU खाते और ऑर्डर मुद्रा पर निर्भर करता है।

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं माँगता; तब एक्सटेंशन शिपिंग पते को भुगतान पते के रूप में भेजता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। एक्सटेंशन भुगतान के मोड की कुंजी से KOMOJU API के ज़रिए भुगतान सत्र पढ़ता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब KOMOJU उसकी पुष्टि करे: हस्ताक्षरित webhook से, या ग्राहक के लौटने पर सत्र पढ़ने से। इसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है, और ग्राहक को Your payment with KOMOJU has been received. के साथ OpenCart ऑर्डर सफलता पेज दिखता है। यदि उस समय KOMOJU तक नहीं पहुँचा जा सकता, या भुगतान की पुष्टि हो गई है पर अभी लागू नहीं हुआ है, तो Payment confirmation पेज दिखता है, जिसमें 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. और एक Check again बटन होता है।

konbini और बैंक ट्रांसफ़र भुगतानों में ग्राहक को एक भुगतान पर्ची मिलती है। ऑर्डर को Awaiting KOMOJU Payment Status मिलता है, और सफलता पेज ग्राहक को बताता है कि भुगतान प्राधिकृत है और KOMOJU के निर्देशों के अनुसार (जैसे किसी कन्वीनियंस स्टोर पर या बैंक ट्रांसफ़र से) पूरा करना होगा। जब ग्राहक भुगतान करता है और KOMOJU webhook भेजता है, तब ऑर्डर Order Status After Payment पर चला जाता है। यदि पर्ची की अवधि समाप्त हो जाती है, तो ऑर्डर Cancelled Payment Status पर चला जाता है।

यदि भुगतान पूरा नहीं हुआ, तो ग्राहक The payment was not completed. You can try again or choose another payment method. संदेश के साथ चेकआउट पर लौट आता है। यदि ऑर्डर पहले ही रद्द हो चुका था, तो संदेश The KOMOJU payment was not completed and the order has been cancelled. होता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। हर नए प्रयास पर (OpenCart 3 हर बार जब Confirm Order चरण दिखाया जाता है, नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है और उसी ऑर्डर को फिर से चुकाता है) इस ऑर्डर और इसी कार्ट के दूसरे ऑर्डरों के खुले KOMOJU सत्र जाँचे जाते हैं: इस ऑर्डर का खुला सत्र, जिसकी राशि नहीं बदली, दोबारा उपयोग होता है; दूसरे खुले सत्र KOMOJU पर रद्द कर दिए जाते हैं; और जो सत्र इस बीच चुकाया जा चुका है, वह नया भुगतान बनाने के बजाय अपने ऑर्डर की पुष्टि करता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद हो गया हो (उदाहरण के लिए konbini पर्ची की अवधि समाप्त हो गई, भुगतान विफल हुआ या आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled or its payment failed. Please confirm the order again. के साथ चेकआउट पर लौटा दिया जाता है। यदि ऑर्डर पहले ही दिया जा चुका है और कार्ट में अब दूसरे उत्पाद हैं, तो संदेश है Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर भुगतान करता है।

यदि KOMOJU भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे 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.। तकनीकी कारण लॉग में लिखा जाता है।

स्टोर के मेंटेनेंस मोड में भी webhook काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है जो webhook और ग्राहक की वापसी को आगे जाने देता है।

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

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक को KOMOJU पर भेजा गया और उसने भुगतान नहीं किया, या KOMOJU ने अभी तक भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Order Status After Payment (default Processing): KOMOJU ने भुगतान की पुष्टि की है। एक नोट में KOMOJU भुगतान ID, भुगतान विधि और पुष्टि का तरीका (webhook या वापसी) दिखता है।

Awaiting KOMOJU Payment Status (default Pending): konbini या बैंक ट्रांसफ़र की पर्ची जारी हुई है और भुगतान की प्रतीक्षा है, या भुगतान KOMOJU डैशबोर्ड में कैप्चर होने की प्रतीक्षा में है।

KOMOJU Payment On Hold Status (default Pending): KOMOJU ने ऑर्डर कुल से अलग राशि या मुद्रा बताई, या ऑर्डर रद्द होने के बाद भुगतान कैप्चर हुआ। नोट इसे समझाता है। ऑर्डर जाँचें और उसे पूरा करें या भुगतान रिफ़ंड करें।

Cancelled Payment Status (default Canceled): भुगतान पर्ची की अवधि समाप्त हो गई या भुगतान रद्द हो गया।

Failed Payment Status (default Failed): प्रतीक्षारत ऑर्डर का भुगतान विफल हुआ।

Refunded Status (default Refunded): भुगतान पूरी तरह रिफ़ंड हुआ, ऑर्डर पेज से या KOMOJU डैशबोर्ड से।

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

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

VibeFox KOMOJU Payment टैब

Sales > Orders में KOMOJU से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox KOMOJU Payment टैब में KOMOJU भुगतान ID (KOMOJU डैशबोर्ड में भुगतान से लिंक), टेस्ट भुगतानों के लिए Test mode लेबल, भुगतान विधि, सत्र, KOMOJU पर ऑर्डर नंबर, स्टेटस, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास (OpenCart या KOMOJU डैशबोर्ड से), और ऑर्डर के KOMOJU notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox KOMOJU Payment टैब में Amount डालें (जो राशि अभी रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via KOMOJU पर क्लिक करें। प्रश्न Refund this amount through KOMOJU? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उस राशि तक सीमित है जो KOMOJU ने वास्तव में चार्ज की है, इसलिए राशि में अंतर होने के बाद आप ऑर्डर कुल के बजाय ग्राहक द्वारा चुकाई गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उस मोड की कुंजी से भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस मोड की सीक्रेट कुंजी सेट होनी चाहिए। एक्सटेंशन पहले KOMOJU में भुगतान जाँचता है और उस राशि से ऊपर के रिफ़ंड अस्वीकार करता है जो अभी भी रिफ़ंड योग्य है। यदि KOMOJU किसी भुगतान को अपने-आप रिफ़ंड नहीं कर सकता (कुछ तरीकों, जैसे konbini, के लिए ग्राहक के बैंक विवरण चाहिए), तो KOMOJU का त्रुटि संदेश दिखता है और कुछ भी दर्ज नहीं होता: ऐसे रिफ़ंड KOMOJU डैशबोर्ड में करें। रिफ़ंड तभी पूरा माना जाता है जब KOMOJU उसकी पुष्टि करे। सफल रिफ़ंड रिफ़ंड इतिहास और नोट में जुड़ता है। पूर्ण रिफ़ंड उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैन्युअल स्टेटस बदलना। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब KOMOJU भुगतान कैप्चर कर चुका हो।

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

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

KOMOJU डैशबोर्ड में किए गए रिफ़ंड webhook से आते हैं और नोट के साथ रिफ़ंड इतिहास में जुड़ते हैं। पूरा भुगतान रिफ़ंड होने पर ऑर्डर Refunded Status पर सेट हो जाता है। जिन भुगतानों को दूसरी मुद्रा में बदला गया है, उनके लिए डैशबोर्ड से किए गए आंशिक रिफ़ंड केवल ऑर्डर पर नोट होते हैं: मेल खाती राशि OpenCart में मैन्युअल रूप से दर्ज करें।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox KOMOJU Payment, Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क किए हुए, स्टेटस (जैसे लाइसेंस की समाप्ति तिथि और आपका डोमेन), और ये बटन दिखाता है: स्टेटस फिर से जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-komoju वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल उन एडमिन उपयोगकर्ताओं को कुंजी बदलने की अनुमति है जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया गया स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

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

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

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

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

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के रहता है: webhook काम नहीं कर रहा। KOMOJU डैशबोर्ड में जाँचें कि जिस मोड का आप उपयोग करते हैं, उसके लिए webhook मौजूद है, उसका URL बिल्कुल वही है जो Webhook URL सेक्शन में दिखाया गया है, और इवेंट चुने गए हैं। जाँचें कि उसका सीक्रेट टोकन सही फ़ील्ड में है (Live Webhook Secret Token या Sandbox Webhook Secret Token), और एक्सटेंशन पेज पर Log फ़ील्ड देखें। कार्ड भुगतान तब भी पुष्ट होते हैं जब ग्राहक स्टोर पर लौटता है, पर konbini और बैंक ट्रांसफ़र भुगतान केवल webhook से पुष्ट होते हैं।

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

Webhook का उत्तर Mode mismatch, ignored.: webhook उस मोड से अलग मोड के सीक्रेट टोकन से हस्ताक्षरित है जिसमें भुगतान किया गया था। लाइव और टेस्ट मोड के लिए अलग-अलग webhook और टोकन रखें, और जाँचें कि वे आपस में बदल तो नहीं गए।

Webhook का उत्तर Order not found.: भुगतान इस स्टोर के किसी ऑर्डर का नहीं है, उदाहरण के लिए उसे उसी KOMOJU खाते वाले किसी दूसरे स्टोर ने किया। इवेंट अनदेखा किया जाता है।

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

ब्राउज़र में webhook URL त्रुटि दिखाता है: यह सामान्य है। यह URL केवल KOMOJU के हस्ताक्षरित अनुरोध स्वीकार करता है।

ऑर्डर on hold या प्रतीक्षा स्टेटस में है: ऑर्डर टैब में KOMOJU notes पढ़ें। पर्ची भुगतान की प्रतीक्षा में है, भुगतान KOMOJU डैशबोर्ड में कैप्चर होने की प्रतीक्षा में है, राशि या मुद्रा मेल नहीं खाई, या ऑर्डर रद्द होने के बाद भुगतान आया।

टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: KOMOJU ने भुगतान अभी कैप्चर नहीं किया, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या भुगतान मोड की सीक्रेट कुंजी सेट नहीं है।

रिफ़ंड विफल होता है: संदेश पढ़ें। भुगतान जिस मोड में हुआ था उसकी सीक्रेट कुंजी गायब हो सकती है, भुगतान अपने-आप रिफ़ंड योग्य न हो (इसे KOMOJU डैशबोर्ड में रिफ़ंड करें), KOMOJU सेट की गई कुंजी के साथ भुगतान को न पहचाने, या किसी बदले गए भुगतान के लिए केवल पूर्ण रिफ़ंड संभव हो।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट komoju_p_supported_currencies (मुद्रा सूची बदलने के लिए) और komoju_p_session_params (भुगतान सत्र बदलने के लिए, जैसे भुगतान विधियाँ) ट्रिगर करता है।

अनइंस्टॉल

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

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

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