VibeFox Omise for OpenCart — सहायता

आवश्यकताएँ

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

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

HTTPS: कार्ड फ़ील्ड आपके चेकआउट पेज पर हैं, इसलिए चेकआउट HTTPS पर दिया जाना चाहिए। फिर भी कार्ड डेटा कभी आपके सर्वर तक नहीं पहुँचता। Omise केवल HTTPS पतों पर वेबहुक भेजता है, और बैंक का 3-D Secure पेज भी HTTPS पता होना चाहिए।

मुद्रा: THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD में से कोई एक। जब ग्राहक किसी अन्य मुद्रा में भुगतान करता है, तो चेकआउट पर भुगतान विधि छिप जाती है।

Omise खाता: टेस्ट और लाइव मोड के लिए आपके Omise खाते की पब्लिक की और सीक्रेट की चाहिए, जो Omise डैशबोर्ड में Settings > Keys से मिलती हैं, और Settings > Webhooks में एक वेबहुक एंडपॉइंट चाहिए (देखें Configuration)।

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

इंस्टॉलेशन

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

OpenCart 3

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

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Omise Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

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

4. Omise की टेस्ट और लाइव कुंजियाँ दर्ज करें, और सेटिंग्स पेज पर दिखाया गया वेबहुक URL Omise डैशबोर्ड में जोड़ें (देखें Configuration)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट मोड में Omise के टेस्ट कार्ड, जैसे 4242 4242 4242 4242, से एक भुगतान आज़माएँ, फिर Test mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Omise Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज दिखाता है Test mode is on — orders are charged with the test keys, no real money is moved. जब तक टेस्ट मोड चालू है। यह चेतावनी भी देता है यदि वर्तमान मोड की पब्लिक या सीक्रेट की गायब है (तब चेकआउट पर भुगतान विधि छिप जाती है), और यदि Omise स्टोर की डिफ़ॉल्ट मुद्रा स्वीकार नहीं करता। एक्सटेंशन में संशोधन करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

Omise

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

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

Description: Confirm Order चरण पर कार्ड फ़ॉर्म के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via Omise.

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

Geo Zone: कार्ड फ़ॉर्म केवल चुने गए geo zone के भुगतान पतों के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता उपयोग होता है।

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

API कुंजियाँ

अपनी कुंजियाँ Omise डैशबोर्ड में Settings > Keys के अंतर्गत खोजें (पेज वहाँ का लिंक देता है)। टेस्ट कुंजियाँ pkey_test_ और skey_test_ से शुरू होती हैं, लाइव कुंजियाँ pkey_ और skey_ से।

Test mode: टेस्ट कुंजियों का उपयोग करता है, कोई वास्तविक शुल्क नहीं। यह दोनों कुंजियों को एक साथ बदलता है। किसी ऑर्डर के कैप्चर, रिफ़ंड और स्थिति जाँच हमेशा उसी मोड की कुंजियों से होते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: on।

Test public key: टेस्ट मोड की पब्लिक की, pkey_test_..., जिसका उपयोग ब्राउज़र में Omise.js करता है।

Test secret key: टेस्ट मोड की सीक्रेट की, skey_test_...

Live public key: लाइव मोड की पब्लिक की, pkey_..., जिसका उपयोग ब्राउज़र में Omise.js करता है।

Live secret key: लाइव मोड की सीक्रेट की, skey_...

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

भुगतान और वेबहुक

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

Omise वेबहुक पर हस्ताक्षर नहीं करता, इसलिए वेबहुक का मुख्य भाग कभी भरोसेमंद नहीं माना जाता: चार्ज इस स्टोर द्वारा उस ऑर्डर के लिए बनाया गया होना चाहिए, और उसकी स्थिति भुगतान के मोड की सीक्रेट की से Omise API से फिर से पढ़ी जाती है। वेबहुक के बिना, जिस ऑर्डर का ग्राहक 3-D Secure के दौरान ब्राउज़र बंद कर देता है, वह अपने-आप अपडेट नहीं होता, और Omise डैशबोर्ड में किए गए कैप्चर तब तक नहीं पकड़े जाते जब तक आप Sync payment status पर क्लिक नहीं करते।

Payment action: कार्ड की राशि के साथ क्या होता है।

Per-charge webhook: हर चार्ज के साथ वेबहुक URL भेजता है। तब उपयोगी है जब कई स्टोर एक Omise खाता साझा करते हैं। केवल तभी काम करता है जब स्टोर HTTPS का उपयोग करता है; अन्यथा डैशबोर्ड वाला वेबहुक उपयोग होता है। डिफ़ॉल्ट: off।

ऑर्डर

ऑर्डर Confirm Order चरण पर बिना स्थिति (एक लापता ऑर्डर) के बनता है और केवल तभी स्थिति पाता है जब Omise कार्ड के लिए उत्तर दे देता है। OpenCart में On hold स्थिति नहीं है: डिफ़ॉल्ट रूप से अधिकृत, समीक्षा और प्रतीक्षा की स्थितियाँ सभी Pending होती हैं, और ऑर्डर टैब व नोट्स उन्हें अलग दिखाते हैं। आप System > Localisation > Order Statuses में अपनी स्थितियाँ बना सकते हैं और यहाँ चुन सकते हैं।

Order Status After Payment: कार्ड पर शुल्क लिया गया (Capture immediately, या बाद में कैप्चर)। डिफ़ॉल्ट: Processing।

Authorized Status: Authorize only: राशि रोकी गई है, अभी कैप्चर नहीं हुई। डिफ़ॉल्ट: Pending।

On Hold (Review) Status: चार्ज की गई राशि या मुद्रा ऑर्डर से भिन्न है। डिफ़ॉल्ट: Pending।

Awaiting Payment Status: ग्राहक ने प्रक्रिया पूरी कर ली है, पर Omise ने चार्ज की पुष्टि अभी नहीं की है। डिफ़ॉल्ट: Pending।

Failed Status: किसी स्थिति वाले ऑर्डर का लंबित चार्ज बाद में विफल हो गया। डिफ़ॉल्ट: Failed।

Canceled Status: चार्ज की समय सीमा समाप्त हो गई या प्राधिकरण void हो गया; कोई पैसा नहीं लिया गया। डिफ़ॉल्ट: Canceled।

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

उन्नत

Debug log: API अनुरोध और भुगतान इवेंट को OpenCart के लॉग फ़ोल्डर (storage/logs) में omise_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB होने पर इसे omise_p_debug.old.log.php में ले जाया जाता है। कुंजियाँ, टोकन और कार्ड डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: off। यह बंद रहने पर त्रुटियों सहित कुछ भी नहीं लिखा जाता, इसलिए किसी समस्या की जाँच करते समय इसे चालू करें।

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / Debit Card)। Confirm Order चरण पर ग्राहक को आपका विवरण और कार्ड फ़ॉर्म दिखता है: Name on card, Card number, Expiry month (MM), Expiry year (YYYY) और Security code (CVV)। टेस्ट मोड में फ़ॉर्म पर TEST MODE — use Omise test cards (e.g. 4242 4242 4242 4242), no real charges are made. दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है; कार्ड फ़ॉर्म चेकआउट पेज के नीचे पुष्टि अनुभाग में, Confirm Order के ऊपर होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो Omise.js ऑर्डर के भुगतान पते का उपयोग करते हुए (OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तो शिपिंग पता) ब्राउज़र में कार्ड को एक बार उपयोग होने वाले टोकन में बदल देता है। कार्ड फ़ील्ड कभी आपके स्टोर पर नहीं भेजे जाते। लापता या अमान्य फ़ील्ड फ़ॉर्म के ऊपर दिखते हैं, जैसे Please enter a valid card number.

आपका स्टोर फिर सीक्रेट कुंजी से ऑर्डर कुल की राशि के लिए, ऑर्डर की मुद्रा में चार्ज बनाता है। चार्ज का विवरण स्टोर का नाम और ऑर्डर नंबर होता है, और ऑर्डर ID चार्ज के मेटाडेटा में सेव होती है। यदि बैंक 3-D Secure माँगता है, तो ग्राहक को बैंक के पेज पर भेजा जाता है और फिर आपके स्टोर पर वापस लाया जाता है, और परिणाम Omise API से फिर से पढ़ा जाता है।

ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Omise उसकी पुष्टि करे: चार्ज कैप्चर होना चाहिए और उसकी राशि व मुद्रा ऑर्डर से मेल खानी चाहिए। फिर ऑर्डर OpenCart के सामान्य तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक Your card payment has been received. के साथ OpenCart का ऑर्डर सफलता पेज देखता है। Authorize only के साथ पेज कहता है Your card payment has been authorized. The amount will be charged when your order is processed. यदि Omise अब भी भुगतान को लंबित बताता है, तो ऑर्डर Awaiting Payment Status पाता है और पेज कहता है Your payment is being confirmed by Omise. You will receive an e-mail as soon as it is confirmed — please do not pay again. बाद में जब Omise भुगतान की पुष्टि या अस्वीकृति करता है (वेबहुक या ग्राहक की वापसी के माध्यम से), तो नई ऑर्डर स्थिति ग्राहक को सूचना के साथ भेजी जाती है, इसलिए OpenCart ग्राहक को ईमेल भेजता है। यदि 3-D Secure के तुरंत बाद भुगतान की पुष्टि नहीं हो पाती, तो एक Payment confirmation पेज We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. और एक Check again बटन दिखाता है।

यदि कार्ड अस्वीकृत हो जाता है, तो ऑर्डर बिना स्थिति के रहता है। ग्राहक Confirm Order चरण पर Payment failed: और कारण के साथ रहता है, जैसे अपर्याप्त शेष, गलत सुरक्षा कोड, या कार्ड जारीकर्ता द्वारा अस्वीकृति, और वह उसी कार्ट के साथ फिर से कोशिश कर सकता है। यदि 3-D Secure विफल होता है, तो ग्राहक कारण के साथ चेकआउट पर लौट आता है; यदि इस बीच चार्ज की समय सीमा समाप्त हो गई या वह उलट दिया गया, तो संदेश है The payment was not completed. Please try again. OpenCart 4 पर 3-D Secure के बाद ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

पुनः प्रयास से कभी दोहरा चार्ज नहीं होता। OpenCart 3 में हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनता है; OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता और अपडेट करता है, इसलिए कार्ड अस्वीकृत होने या 3-D Secure विफल होने के बाद ग्राहक उसी ऑर्डर का नए चार्ज से भुगतान करता है। यदि उस कार्ट का पिछला चार्ज पहले ही भुगतान या प्राधिकृत हो चुका है, तो वह ऑर्डर अपनी स्थिति पाता है और कोई नया चार्ज नहीं किया जाता। अधूरा 3-D Secure प्रयास नया चार्ज होने से पहले समाप्त हो जाता है। यदि पहले से भुगतान किए गए कार्ट के लिए दूसरा चार्ज अब भी भुगतान किया हुआ है (उदाहरण के लिए किसी दूसरे ब्राउज़र टैब में), तो कोई ऑर्डर नहीं बदला जाता, और भुगतान किए गए ऑर्डर पर एक नोट आपसे Omise डैशबोर्ड में रिफ़ंड या void करने को कहता है।

OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए उसका चार्ज विफल या समाप्त हो गया, या आपने उसे रद्द या रिफ़ंड किया), तो ग्राहक Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। यदि वह ऑर्डर पहले ही भुगतान हो चुका है और कार्ट में अब अन्य उत्पाद या मात्राएँ हैं, तो ग्राहक भी चेकआउट पर लौटा दिया जाता है, और नए कार्ट को नया ऑर्डर मिलता है।

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

एक्सटेंशन केवल कार्ड लेता है। इसमें Omise के अन्य भुगतान विकल्प (PromptPay, TrueMoney, मोबाइल बैंकिंग, किस्तें) नहीं हैं, न सहेजे गए कार्ड या Omise ग्राहक, न सदस्यता, और न आंशिक कैप्चर।

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

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

कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक 3-D Secure पर है, या कार्ड अस्वीकृत हुआ है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

OpenCart 4 पर चेकआउट का कोई अभुगतान ऑर्डर Voided स्थिति पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का भुगतान फिर भी उसकी पुष्टि करता है।

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हुई। एक नोट राशि, Omise चार्ज (chrg_...) और पुष्टि का तरीका दिखाता है (चेकआउट, 3-D Secure से वापसी, वेबहुक, भुगतान पुनः प्रयास, मैन्युअल कैप्चर या मैन्युअल सिंक)।

Authorized Status (डिफ़ॉल्ट Pending): कार्ड Authorize only से अधिकृत हुआ था। Capture payment या Void authorization का उपयोग करें।

Awaiting Payment Status (डिफ़ॉल्ट Pending): Omise ने अभी तक भुगतान की पुष्टि नहीं की है। वेबहुक या Sync payment status ऑर्डर को अपडेट करता है।

On Hold (Review) Status (डिफ़ॉल्ट Pending): चार्ज की राशि या मुद्रा ऑर्डर से भिन्न है, उदाहरण के लिए 3-D Secure के दौरान ऑर्डर बदला गया था। नोट दोनों मान दिखाता है। ऑर्डर की जाँच करें और उसे पूरा करें या भुगतान रिफ़ंड करें।

Failed Status (डिफ़ॉल्ट Failed): एक लंबित भुगतान बाद में विफल हो गया। भुगतान किया हुआ ऑर्डर बाद की विफलता इवेंट से कभी डाउनग्रेड नहीं होता।

Canceled Status (डिफ़ॉल्ट Canceled): चार्ज की समय सीमा समाप्त हो गई या प्राधिकरण void हो गया।

Refunded Status (डिफ़ॉल्ट Refunded): एक्सटेंशन के माध्यम से भुगतान का पूरा रिफ़ंड हो गया।

यदि पहले से canceled या refunded स्थिति वाले ऑर्डर के लिए भुगतान या प्राधिकृत चार्ज आता है, तो ऑर्डर फिर से नहीं खुलता। एक नोट आपसे Omise डैशबोर्ड जाँचने और ऑर्डर को मैन्युअली रिफ़ंड या फिर से खोलने को कहता है।

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

VibeFox Omise Payment टैब

Sales > Orders में Omise से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के साथ, VibeFox Omise Payment टैब में चार्ज ID (परीक्षण भुगतानों के लिए Test लेबल के साथ), भुगतान कार्रवाई, चार्ज की स्थिति, कार्ड ब्रांड और अंतिम अंक, Charged / order / refunded राशियाँ, बटन, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Omise notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है। बटनों के लिए एक्सटेंशन में संशोधन करने का अधिकार (जो System > Users > User Groups में सेट होता है) और उस मोड की सीक्रेट कुंजी चाहिए जिसमें भुगतान हुआ था। हर कार्रवाई का परिणाम टैब में दिखता है।

Capture payment: पूरी अधिकृत राशि कैप्चर करता है और ऑर्डर को Order Status After Payment पर सेट करता है। केवल अधिकृत ऑर्डरों के लिए दिखता है।

Void authorization: प्राधिकरण को void करता है; कोई पैसा कैप्चर नहीं होता और ऑर्डर Canceled Status पर सेट हो जाता है। केवल अधिकृत ऑर्डरों के लिए दिखता है।

Sync payment status: Omise से चार्ज को फिर से पढ़ता है, उदाहरण के लिए Omise डैशबोर्ड में कैप्चर या रिफ़ंड के बाद, ऑर्डर को अपडेट करता है, और चार्ज की स्थिति व Omise पर कुल रिफ़ंड की गई राशि वाला एक नोट जोड़ता है।

टैब से की गई स्थिति परिवर्तन ग्राहक को सूचित नहीं करते और स्टॉक नहीं हिलाते, मैन्युअल स्थिति परिवर्तन की तरह।

रिफ़ंड

टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह भरी जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Omise पर क्लिक करें। प्रश्न Refund this amount through Omise? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो Omise ने चार्ज की थी, इसलिए राशि या मुद्रा के बेमेल होने के बाद आप ऑर्डर कुल तक नहीं, बल्कि ग्राहक द्वारा वास्तव में भुगतान की गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उसी मोड में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस मोड की सीक्रेट कुंजी सेट होनी चाहिए। कारण Omise पर रिफ़ंड के साथ सेव होता है। सफल रिफ़ंड, Omise रिफ़ंड ID के साथ, रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है; आंशिक रिफ़ंड स्थिति नहीं बदलता। जो प्राधिकरण अभी कैप्चर नहीं हुआ है, उसके लिए केवल पूर्ण रिफ़ंड संभव है, और वह प्राधिकरण को void करता है। यदि Omise रिफ़ंड अस्वीकार करता है, तो टैब Omise संदेश के साथ Refund failed. दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता।

Sales > Returns में उत्पाद वापसी से Omise के माध्यम से पैसे वापस नहीं जाते। Omise डैशबोर्ड में किए गए रिफ़ंड OpenCart में दर्ज नहीं होते; Sync payment status रिफ़ंड की गई कुल राशि दिखाता है।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Omise Payment, Extensions > Extensions > Payments > VibeFox Omise Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क्ड रूप में, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-omise की पंक्ति और आपके 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 खाते में स्लॉट खाली करें।

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

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

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

चेकआउट पर Omise दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की दोनों कुंजियाँ दर्ज हैं (टेस्ट मोड में टेस्ट कुंजियाँ, अन्यथा लाइव कुंजियाँ), और ग्राहक समर्थित मुद्राओं में से किसी एक में भुगतान करता है। कुंजियाँ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के या Awaiting Payment Status में है: वेबहुक काम नहीं कर रहा। Omise डैशबोर्ड में जाँचें कि वेबहुक URL ठीक वही है जो Webhook URL में दिखाया गया है और HTTPS का उपयोग करता है। मौजूदा ऑर्डर पर Sync payment status पर क्लिक करें। वेबहुक के उत्तर देखने के लिए Debug log चालू करें।

वेबहुक उत्तर देता है Charge ID does not match order या Order not found: इवेंट का चार्ज इस स्टोर ने उस ऑर्डर के लिए नहीं बनाया था। कुछ नहीं बदला जाता।

वेबहुक उत्तर देता है Order is being processed, retry later या Failed to verify charge: उसी क्षण किसी दूसरे अनुरोध ने कार्ट को लॉक कर दिया था, Omise API तक पहुँच नहीं हो पाई, या भुगतान मोड की सीक्रेट कुंजी गायब है। Omise वेबहुक को फिर से भेजता है।

वेबहुक उत्तर देता है The order status could not be set, retry later: उस समय ऑर्डर स्थिति सेट नहीं हो सकी। Omise वेबहुक को फिर से भेजता है। कारण देखने के लिए Debug log चालू करें।

वेबहुक URL ब्राउज़र में Method not allowed दिखाता है: यह सामान्य है। यह URL केवल Omise से आने वाले अनुरोध स्वीकार करता है।

सेव करते समय चेतावनी: key must start with ... या must be a live key: कोई कुंजी गलत फ़ील्ड में पेस्ट की गई और सेव नहीं हुई। टेस्ट कुंजियाँ pkey_test_ / skey_test_ से शुरू होती हैं, लाइव कुंजियाँ pkey_ / skey_ से।

ग्राहक को Card payments are temporarily unavailable दिखता है: कुंजियाँ गलत हैं, या कार्ड टोकन दूसरे मोड का है (लाइव मोड में टेस्ट टोकन, या उल्टा)। कुंजियाँ और Test mode जाँचें।

ग्राहक को We could not reach the payment provider दिखता है: चार्ज बनाते समय Omise से कोई मान्य उत्तर नहीं आया। फिर भी चार्ज बना हो सकता है; ग्राहक दोबारा भुगतान करे, उससे पहले Omise डैशबोर्ड जाँचें।

ग्राहक को This order is already being paid दिखता है: चेकआउट दो बार एक ही क्षण में सबमिट हुआ। ग्राहक थोड़ी देर रुकता है और फिर से कोशिश करने से पहले ईमेल देखता है।

भुगतान के बाद ऑर्डर समीक्षा स्थिति में है: VibeFox Omise Payment टैब के नोट पढ़ें (देखें Order statuses), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

मोड से जुड़े संदेश के साथ रिफ़ंड विफल: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की सीक्रेट कुंजी सेट नहीं है। उसे दर्ज करें और फिर कोशिश करें।

प्राधिकृत ऑर्डर का आंशिक रिफ़ंड विफल: भुगतान केवल अधिकृत है। पहले उसे कैप्चर करें, या void करने के लिए पूरी राशि रिफ़ंड करें।

अनइंस्टॉल

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

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

Omise अपने संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Omise से संबद्ध नहीं है और Omise द्वारा समर्थित नहीं है।