वापस

VibeFox KOMOJU for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।

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

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

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox KOMOJU Payment ढूँढकर Configure पर क्लिक करें।

3. कॉन्फ़िगरेशन पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।

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

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

इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting KOMOJU payment और KOMOJU payment on hold। PrestaShop नए भुगतान मॉड्यूल को केवल उस समय सक्रिय देशों से जोड़ता है: जो देश आप बाद में सक्रिय करें, उसके लिए Payment > Preferences में मॉड्यूल पर टिक लगाना होगा। वहीं आप मुद्राएँ और ग्राहक समूह भी सीमित कर सकते हैं।

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

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

KOMOJU भुगतान

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

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 के अंतर्गत (पहले वहाँ Webhook URL सेक्शन में दिखाया गया वेबहुक 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)। डिफ़ॉल्ट: बंद। चालू रहने पर चेकआउट विवरण के ऊपर Test mode दिखाता है।

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

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

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

सेव किए गए सीक्रेट हटाएँ: किसी कुंजी या टोकन पर टिक लगाकर उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

वेबहुक URL

वेबहुक आपकी दुकान को भुगतानों के बारे में बताता है, जिनमें देर से होने वाले konbini और बैंक ट्रांसफ़र भुगतान भी शामिल हैं। KOMOJU डैशबोर्ड में Settings > Webhooks के अंतर्गत, इस सेक्शन में दिखाया गया URL लाइव और टेस्ट मोड दोनों के लिए जोड़ें। फ़्रेंडली URL के साथ यह ऐसा दिखता है: https://your-shop/module/wcp_komoju_payment/webhook, कभी-कभी /en/ जैसे भाषा कोड के साथ। URL को ठीक वैसे ही कॉपी करें जैसे सेटिंग्स में दिखता है। फिर हर वेबहुक का सीक्रेट टोकन Live Webhook Secret Token या Sandbox Webhook Secret Token में कॉपी करें।

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

payment.authorized: भुगतान पर्ची जारी हुई (konbini, बैंक ट्रांसफ़र) या भुगतान अधिकृत हुआ। ऑर्डर Awaiting KOMOJU payment में बनता है।
payment.captured: भुगतान पूरा हुआ। राशि और मुद्रा की जाँच के बाद ऑर्डर भुगतान किया हुआ चिह्नित होता है।
payment.expired: भुगतान पर्ची की अवधि समाप्त हो गई। ऑर्डर रद्द होता है।
payment.cancelled: भुगतान रद्द हुआ। ऑर्डर रद्द होता है।
payment.failed: भुगतान विफल हुआ। मौजूदा ऑर्डर Payment error पर जाता है; बिना ऑर्डर के कुछ नहीं बनता।
payment.refund.created: रिफ़ंड किया गया, उदाहरण के लिए KOMOJU डैशबोर्ड में। यह ऑर्डर पर दर्ज होता है।
payment.refunded: भुगतान का रिफ़ंड हुआ। रिफ़ंड ऑर्डर पर दर्ज होता है।

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

उन्नत

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

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

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपकी दुकान पर लौटता है। मॉड्यूल भुगतान के मोड की कुंजी से KOMOJU API से भुगतान सेशन पढ़ता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब KOMOJU उसकी पुष्टि करे: हस्ताक्षरित वेबहुक से, या ग्राहक के लौटने पर सेशन पढ़कर। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है, जिस पर Your payment with KOMOJU has been received. लिखा होता है। यदि उसी समय 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 में बनता है, और पुष्टि पेज ग्राहक को KOMOJU के निर्देशों के अनुसार भुगतान पूरा करने के लिए कहता है (उदाहरण के लिए सुविधा स्टोर पर या बैंक ट्रांसफ़र से)। ग्राहक के भुगतान करने और KOMOJU के वेबहुक भेजने पर ऑर्डर Payment accepted हो जाता है। यदि पर्ची की अवधि बाद में समाप्त हो जाए या भुगतान बाद में विफल हो, तो पुष्टि पेज पर Your KOMOJU payment was not completed. Please contact us about this order. दिखता है।

यदि भुगतान पूरा नहीं हुआ, तो ग्राहक The payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर वापस आ जाता है। कार्ट सुरक्षित रहता है। यदि कुल राशि नहीं बदली है, तो नया प्रयास खुला KOMOJU सेशन दोबारा इस्तेमाल करता है। पुरानी राशि वाला सेशन 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.। तकनीकी कारण लॉग में लिखा जाता है।

यदि भुगतान और उसकी पुष्टि के बीच कार्ट का कोई वाउचर वैध नहीं रहता, तो PrestaShop उसे ऑर्डर से हटा देता है। तब ऑर्डर नोट के साथ KOMOJU payment on hold में चला जाता है, क्योंकि ग्राहक ने छूट वाली कीमत चुकाई है।

वेबहुक स्टोर के मेंटेनेंस मोड में होने पर भी काम करता है और आपके स्टोर के देश-प्रतिबंध से नहीं रुकता।

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

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

ऑर्डर स्टेटस

No order yet: ग्राहक को KOMOJU पर भेजा गया है और उसने भुगतान नहीं किया है, या KOMOJU ने भुगतान की पुष्टि अभी नहीं की है। केवल कार्ट मौजूद है।

Payment accepted: KOMOJU ने भुगतान की पुष्टि की है। भुगतान को KOMOJU भुगतान ID के साथ ट्रांज़ैक्शन ID के रूप में दर्ज किया जाता है, और एक नोट में भुगतान ID, भुगतान तरीका और पुष्टि का तरीका (वेबहुक या वापसी) दिखता है।

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

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

Canceled: भुगतान पर्ची की अवधि समाप्त हो गई या भुगतान रद्द हुआ।

Payment error: मौजूदा ऑर्डर का भुगतान विफल हुआ।

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

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

KOMOJU भुगतान ब्लॉक

ऑर्डर पेज पर एक KOMOJU payment ब्लॉक दिखता है, जिसमें KOMOJU भुगतान ID (KOMOJU डैशबोर्ड में भुगतान से लिंक) और भुगतान तरीका, सेशन, KOMOJU पर ऑर्डर नंबर, स्थिति, भुगतान की गई राशि और रिफ़ंड की गई राशि, टेस्ट भुगतानों के लिए Test mode बैज, रिफ़ंड इतिहास और ऑर्डर के KOMOJU notes शामिल हैं।

रिफ़ंड

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

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

मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन KOMOJU के ज़रिए पैसा वापस नहीं भेजते।

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

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

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

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

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

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को KOMOJU नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान तरीका आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट में उसकी जाँच नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, वे अब भी पुष्ट होते हैं, और रिफ़ंड काम करते हैं।

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

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

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

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

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

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

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

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

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

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

डेवलपर actionKomojuPSupportedCurrencies हुक से मुद्राओं की सूची, और actionKomojuPSessionParams हुक से भुगतान सेशन (उदाहरण के लिए भुगतान तरीके) बदल सकते हैं।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox KOMOJU Payment के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। यदि Delete data on uninstall चालू है, तो गेटवे सेटिंग्स और लॉग हट जाते हैं। यदि यह बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। KOMOJU ट्रांज़ैक्शन और रिफ़ंड तथा ऑर्डर स्टेटस Awaiting KOMOJU payment और KOMOJU payment on hold हमेशा रखे जाते हैं, ताकि दोबारा इंस्टॉल करने के बाद पुराने ऑर्डर अब भी पुष्ट और रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID बनाए रखते हैं।

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