VibeFox Omise for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 8.0 या बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता; यदि WooCommerce बाद में बंद किया जाए, तो गेटवे लोड नहीं होता और एडमिन सूचना दिखाई जाती है।

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Omise। जब तक टेस्ट मोड चालू है, फ़ील्ड्स के ऊपर पेज Test mode is on — orders are charged with the test keys, no real money is moved. दिखाता है, और यदि वर्तमान मोड की सार्वजनिक या गुप्त कुंजी गायब हो, या स्टोर की मुद्रा Omise द्वारा समर्थित न हो, तो चेतावनी देता है। दोनों ही स्थितियों में चेकआउट पर भुगतान विधि छिपा दी जाती है। भुगतान विधियों की सूची में, जब तक वर्तमान मोड की दोनों कुंजियाँ नहीं डाली जातीं, Omise को सेटअप की ज़रूरत वाला दिखाया जाता है।

सामान्य

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

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

Description: चेकआउट पर कार्ड फ़ॉर्म के ऊपर दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via Omise।

API कुंजियाँ

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

Test mode: Use the test keys (no real charges)। दोनों कुंजियों को एक साथ बदलता है। किसी ऑर्डर के रिफ़ंड, कैप्चर और स्थिति जाँच हमेशा उसी मोड की कुंजियों का उपयोग करते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: चालू।

Test public key: टेस्ट मोड की सार्वजनिक कुंजी, pkey_test_...

Test secret key: टेस्ट मोड की गुप्त कुंजी, skey_test_...

Live public key: लाइव मोड की सार्वजनिक कुंजी, pkey_...

Live secret key: लाइव मोड की गुप्त कुंजी, skey_...

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

इस अनुभाग में आपके स्टोर का वेबहुक URL दिखता है। यह कुछ ऐसा दिखता है: https://your-site/wp-json/omise-payment/v1/webhook। इसे ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं, और Omise डैशबोर्ड में Settings > Webhooks के अंतर्गत जोड़ें (केवल HTTPS)। प्लगइन इन इवेंट्स को संभालता है:

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

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

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

उन्नत

Debug log: Log API requests and payment events भुगतान के चरणों को WooCommerce > Status > Logs में, स्रोत wcp_omise_payment के साथ लिखता है। कुंजियाँ, टोकन और कार्ड डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the settings and debug logs when the plugin is deleted। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / Debit Card) और कार्ड फ़ॉर्म भरता है: 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. दिखाता है। ऑर्डर सबमिट होने पर Omise.js ब्राउज़र में कार्ड को एक बार उपयोग होने वाले टोकन में बदल देता है। कार्ड फ़ील्ड कभी आपके सर्वर पर नहीं भेजे जाते।

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

ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Omise उसकी पुष्टि करता है: चार्ज कैप्चर होना चाहिए, और उसकी राशि व मुद्रा ऑर्डर से बिल्कुल मेल खानी चाहिए। Authorize only के साथ, सफल ऑथराइज़ेशन के बाद ऑर्डर होल्ड पर रखा जाता है। ग्राहक को ऑर्डर प्राप्ति पेज दिखता है।

यदि कार्ड अस्वीकार हो जाता है, तो ग्राहक चेकआउट पर रहता है और Payment failed: के साथ एक कारण देखता है, जैसे अपर्याप्त शेष, गलत सुरक्षा कोड, या कार्ड जारीकर्ता द्वारा अस्वीकृति, और वह फिर से प्रयास कर सकता है। विफल 3-D Secure के बाद ग्राहक Pay for order पेज पर पहुँच जाता है। यदि 3-D Secure के तुरंत बाद भुगतान की पुष्टि नहीं हो पाती, तो ग्राहक को We could not confirm your payment yet. If your card was charged, the order will be updated automatically — please do not pay again. दिखता है।

पुनः प्रयास से कभी दोहरा चार्ज नहीं होता: यदि ऑर्डर का पिछला चार्ज पहले ही भुगतान या ऑथराइज़ हो चुका है, तो नया चार्ज किए बिना ऑर्डर पूरा हो जाता है। अधूरा 3-D Secure प्रयास नया चार्ज बनने से पहले समाप्त हो जाता है।

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

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

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

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

भुगतान लंबित: ग्राहक 3-D Secure पर है या उसने अभी भुगतान पूरा नहीं किया है।

प्रोसेसिंग: भुगतान की पुष्टि हो गई है। केवल वर्चुअल, डाउनलोड योग्य उत्पादों वाले ऑर्डर WooCommerce की सामान्य प्रक्रिया के अनुसार पूर्ण हो जाते हैं। ऑर्डर नोट में राशि, चार्ज ID और पुष्टि का तरीका दिखता है (चेकआउट, 3-D Secure से वापसी, वेबहुक, मैन्युअल कैप्चर या मैन्युअल सिंक)। ट्रांज़ैक्शन ID Omise चार्ज ID (chrg_...) है।

होल्ड पर, कैप्चर की प्रतीक्षा: कार्ड Authorize only से ऑथराइज़ किया गया था। Omise: Capture payment या Omise: Void authorization का उपयोग करें।

होल्ड पर, लंबित: Omise ने अभी भुगतान की पुष्टि नहीं की है, उदाहरण के लिए ग्राहक ने 3-D Secure के दौरान ब्राउज़र बंद कर दिया। वेबहुक या Omise: Sync payment status ऑर्डर को अपडेट करता है।

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

विफल: भुगतान अस्वीकार हुआ। भुगतान किया हुआ ऑर्डर बाद के किसी विफलता इवेंट से कभी नीचे नहीं किया जाता।

रद्द: चार्ज की समय-सीमा समाप्त हो गई या ऑथराइज़ेशन void कर दिया गया।

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

ऑर्डर क्रियाएँ

Omise: Capture payment: पूरी ऑथराइज़्ड राशि कैप्चर करता है। केवल ऑथराइज़्ड ऑर्डरों के लिए दिखता है।

Omise: Void authorization: ऑथराइज़ेशन void करता है; कोई पैसा कैप्चर नहीं होता और ऑर्डर रद्द हो जाता है। केवल ऑथराइज़्ड ऑर्डरों के लिए दिखता है।

Omise: Sync payment status: Omise से चार्ज पढ़ता है और ऑर्डर अपडेट करता है। नोट में Omise पर कुल रिफ़ंड की गई राशि भी दिखती है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Omise पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी मोड में भेजा जाता है जिसमें भुगतान किया गया था, इसलिए उस मोड की गुप्त कुंजी भरी होनी चाहिए। सफल रिफ़ंड Omise रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ जाता है। जो ऑथराइज़ेशन अभी कैप्चर नहीं हुआ है, उसके लिए केवल पूर्ण रिफ़ंड संभव है, और वह ऑथराइज़ेशन को void कर देता है। यदि Omise रिफ़ंड अस्वीकार करता है, तो WooCommerce Omise के संदेश के साथ Refund failed. दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता।

Omise डैशबोर्ड में किए गए रिफ़ंड WooCommerce रिफ़ंड के रूप में आयात नहीं होते। Omise: Sync payment status रिफ़ंड की गई कुल राशि दिखाता है; ज़रूरत हो तो WooCommerce में मेल खाते मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

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

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

वेबहुक का जवाब Earlier charge of the order, order not changed है: इवेंट ऑर्डर के किसी पिछले प्रयास से जुड़ा है, जिसे पुनः प्रयास से बदल दिया गया था। ऑर्डर में कुछ नहीं बदला जाता। यदि वह पिछला चार्ज Omise पर अब भी भुगतान किया हुआ या ऑथराइज़्ड है, तो एक ऑर्डर नोट एक बार यह बताता है: Omise डैशबोर्ड में दोहरे भुगतान की जाँच करें और वहीं उसे रिफ़ंड या void करें।

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

वेबहुक का जवाब Order is being processed, retry later या Failed to verify charge है: ऑर्डर किसी दूसरे अनुरोध द्वारा लॉक था, या Omise API तक पहुँचा नहीं जा सका। 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 दिखता है: चेकआउट एक ही समय पर दो बार सबमिट हुआ। ग्राहक को इंतज़ार करके ईमेल जाँचना चाहिए, फिर दोबारा प्रयास करना चाहिए।

भुगतान के बाद ऑर्डर होल्ड पर है: ऑर्डर नोट पढ़ें। ऑर्डर कैप्चर का इंतज़ार कर रहा है, Omise ने अभी भुगतान की पुष्टि नहीं की है, या राशि या मुद्रा ऑर्डर से अलग है।

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

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

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

अनइंस्टॉल

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

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