VibeFox Montonio for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

मुद्रा: स्टोर या ऑर्डर की मुद्रा EUR या PLN होनी चाहिए। किसी और मुद्रा के लिए चेकआउट पर भुगतान विधि छिप जाती है।

Montonio खाता: आपको Montonio Partner System से अपने स्टोर की एक्सेस कुंजी और सीक्रेट कुंजी चाहिए। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं, इसलिए जिस हर वातावरण का आप उपयोग करते हैं, उसके लिए एक-एक जोड़ी चाहिए। Montonio में और कुछ सेट करने की ज़रूरत नहीं है: हर भुगतान के साथ सूचना पता भेजा जाता है।

सार्वजनिक साइट: Montonio की सूचनाएँ पाने के लिए आपकी साइट इंटरनेट से पहुँचने योग्य होनी चाहिए। अन्यथा भी, जब ग्राहक स्टोर पर लौटता है तो ऑर्डर की पुष्टि हो जाती है।

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

इंस्टॉलेशन

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

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

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

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

5. Montonio Partner System में Stores > your store > API keys खोलें और सैंडबॉक्स एक्सेस कुंजी तथा सीक्रेट कुंजी कॉपी करें। उन्हें सेटिंग्स में चिपकाएँ और Sandbox mode चालू रखें।

6. Enable/Disable चालू करें और सैंडबॉक्स में एक भुगतान का परीक्षण करें। फिर लाइव कुंजियाँ डालें और Sandbox mode का चेकमार्क हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Montonio। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब वर्तमान वातावरण की कुंजियाँ गायब हों (तब चेकआउट पर भुगतान विधि छिप जाती है) और जब स्टोर की मुद्रा EUR या PLN न हो, और सैंडबॉक्स चालू होने पर Sandbox mode is on: payments are simulated and no real money is charged. दिखाता है। भुगतान विधियों की सूची में, वर्तमान वातावरण की दोनों कुंजियाँ भरे जाने तक Montonio को सेटअप की आवश्यकता वाला दिखाया जाता है।

सामान्य

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

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Bank payment (Montonio)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

API कुंजियाँ

कुंजियाँ Montonio Partner System में Stores > your store > API keys के अंतर्गत मिलती हैं। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं। सैंडबॉक्स केवल सैंडबॉक्स कुंजियों का उपयोग करता है, और लाइव मोड केवल लाइव कुंजियों का। इस सेटिंग्स सेक्शन में सूचना URL भी दिखता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/wc_mnt_payment/। इसे कहीं दर्ज करने की ज़रूरत नहीं है: प्लगइन इसे हर भुगतान के साथ Montonio को भेजता है।

Sandbox mode: Use the Montonio sandbox (test payments, no real money)। यह Montonio API पता और कुंजी-युग्म, दोनों बदल देता है। डिफ़ॉल्ट: चालू। लाइव कुंजियाँ डालने के बाद ही इसे बंद करें।

Sandbox access key: Montonio सैंडबॉक्स में आपके स्टोर की एक्सेस कुंजी (UUID)।

Sandbox secret key: Montonio सैंडबॉक्स में आपके स्टोर की सीक्रेट कुंजी।

Live access key: Montonio के लाइव वातावरण में आपके स्टोर की एक्सेस कुंजी (UUID)।

Live secret key: Montonio के लाइव वातावरण में आपके स्टोर की सीक्रेट कुंजी।

उन्नत

Debug log: Log payment events सभी भुगतान घटनाएँ WooCommerce > Status > Logs में लिखता है, स्रोत wcp_montonio_payment। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। कुंजियाँ, टोकन और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete data: Delete the gateway settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं मिटता। ऑर्डर डेटा (Montonio UUID, नोट्स) हमेशा रहता है। डिफ़ॉल्ट: बंद।

भुगतान सूचनाएँ

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Bank payment (Montonio)) और ऑर्डर देता है। प्लगइन ऑर्डर मुद्रा में ऑर्डर कुल के लिए एक Montonio भुगतान बनाता है और ग्राहक को Montonio के भुगतान पेज पर भेजता है। वहाँ ग्राहक एक बैंक चुनता है और भुगतान करता है। ग्राहक के बिलिंग देश के बैंक पहले दिखाए जाते हैं (PLN ऑर्डर के लिए पोलैंड)। भुगतान पर Order और ऑर्डर नंबर दिखता है। Montonio पेज स्टोर की भाषा में खुलता है यदि वह जर्मन, अंग्रेज़ी, एस्टोनियाई, फ़िनिश, लिथुआनियाई, लातवियाई, पोलिश या रूसी है; अन्यथा अंग्रेज़ी में। सैंडबॉक्स मोड में, चेकआउट पर विवरण के नीचे SANDBOX MODE — test payment, no real money is charged. दिखता है।

ऑर्डर केवल तब भुगतान किया हुआ चिह्नित होता है जब Montonio PAID स्थिति और ऑर्डर की सटीक राशि व मुद्रा की पुष्टि कर दे। भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौटता है। जब तक Montonio भुगतान की पुष्टि नहीं करता, वह पेज Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. दिखाता है। यदि भुगतान रद्द या अस्वीकृत हुआ, तो ग्राहक Pay for order पेज पर लौटता है और इनमें से कोई संदेश देखता है: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. या Montonio could not complete the payment. Please try again or choose another payment method.

ग्राहक Pay for order पेज से बिना भुगतान वाला ऑर्डर फिर से भुगतान कर सकता है। नया भुगतान बनाने से पहले प्लगइन Montonio से पिछले भुगतान के बारे में पूछता है। यदि वह पहले ही भुगतान हो चुका है, तो ऑर्डर की पुष्टि हो जाती है और दूसरा भुगतान नहीं बनाया जाता।

यदि Montonio भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., और वह कोई अन्य भुगतान विधि चुन सकता है। Montonio की त्रुटि ऑर्डर नोट्स और लॉग में जुड़ जाती है।

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

यह प्लगइन केवल बैंक भुगतान (पेमेंट इनिशिएशन) स्वीकार करता है। इसमें कार्ड भुगतान, BLIK, Apple Pay या Google Pay, Pay Later या फ़ाइनेंसिंग, Montonio शिपिंग, सब्सक्रिप्शन, सेव की गई भुगतान विधियाँ और आपकी अपनी साइट पर बैंक चयन नहीं है।

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

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

भुगतान लंबित: ग्राहक को Montonio पर भेजा गया है और उसने अभी भुगतान नहीं किया है। जब Montonio भुगतान को लंबित बताता है, तब एक नोट जुड़ता है।

प्रसंस्करण में या पूर्ण: Montonio ने भुगतान की पुष्टि की है (PAID)। ऑर्डर भुगतान किए गए ऑर्डरों के लिए WooCommerce की मानक स्थिति का पालन करता है। ऑर्डर नोट में बैंक, Montonio भुगतान UUID, राशि और वातावरण दिखते हैं। लेन-देन ID Montonio भुगतान UUID है।

होल्ड पर: बैंक ने अभी भुगतान की पुष्टि नहीं की है (AUTHORIZED); Montonio के PAID बताने पर ऑर्डर भुगतान किया हुआ हो जाता है। Montonio द्वारा ऑर्डर कुल से अलग राशि या मुद्रा बताए जाने पर, स्टोर के लाइव मोड में होने पर सैंडबॉक्स भुगतान आने पर, या ऑर्डर रद्द होने के बाद भुगतान आने पर भी ऑर्डर होल्ड पर चला जाता है। ऑर्डर नोट कारण बताता है। Montonio Partner System में भुगतान की जाँच करें, फिर ऑर्डर भेजें या भुगतान रिफ़ंड करें।

विफल: ग्राहक ने भुगतान पूरा नहीं किया या बैंक ने उसे अस्वीकार कर दिया। बिना भुगतान वाले ऑर्डर का केवल नवीनतम भुगतान ही ऑर्डर को विफल कर सकता है। ग्राहक Pay for order पेज से फिर से प्रयास कर सकता है।

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Bank payment (Montonio) पर क्लिक करें (बटन पर भुगतान विधि का नाम प्रयोग होता है)। Montonio से भुगतान किए गए ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण (सैंडबॉक्स या लाइव) में भेजा जाता है जहाँ भुगतान हुआ था, इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए। यदि Montonio रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। भेजा गया रिफ़ंड अपनी स्थिति और Montonio रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ता है।

Montonio बाद में एक सूचना के माध्यम से हर रिफ़ंड की पुष्टि या अस्वीकृति करता है। पुष्टि ऑर्डर नोट्स में जुड़ती है। यदि Montonio रिफ़ंड अस्वीकार करता है, तो नोट बताता है कि पैसा ग्राहक को वापस नहीं हुआ; इसे Montonio Partner System में जाँचें और WooCommerce रिफ़ंड को ठीक करें।

Montonio Partner System में किए गए रिफ़ंड, Montonio की रिपोर्ट के बाद ऑर्डर नोट्स में जुड़ते हैं। उन्हें अपने-आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं किया जाता। ज़रूरत हो तो WooCommerce में मैनुअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

चेकआउट पर Montonio दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान वातावरण की दोनों कुंजियाँ (सैंडबॉक्स मोड में Sandbox access key और Sandbox secret key, लाइव मोड में Live access key और Live secret key) भरी हैं, और स्टोर या ऑर्डर की मुद्रा EUR या PLN है। कुंजियाँ न होने या मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित ही रहा: सूचना आपके स्टोर तक नहीं पहुँची। जाँचें कि साइट इंटरनेट से पहुँचने योग्य है और सेटिंग्स की कुंजियाँ भुगतान के वातावरण की हैं। भुगतान के बाद ग्राहक के स्टोर पर लौटने पर, और ग्राहक द्वारा उसी ऑर्डर को फिर से भुगतान करने का प्रयास करने पर भी ऑर्डर की पुष्टि होती है।

सूचना का उत्तर Invalid token है: टोकन का हस्ताक्षर, समाप्ति या एक्सेस कुंजी मेल नहीं खाई। जाँचें कि एक्सेस कुंजी और सीक्रेट कुंजी सही कॉपी हुई हैं, सही वातावरण की हैं, और सर्वर की घड़ी सही है।

सूचना का उत्तर Payment does not belong to this order या Wrong environment है: भुगतान इस स्टोर ने इस ऑर्डर के लिए नहीं बनाया था, या वह दूसरे वातावरण (सैंडबॉक्स या लाइव) में बना था। ऐसा तब होता है जब दो स्टोर एक ही Montonio खाते और एक ही ऑर्डर नंबरों का उपयोग करते हैं।

सूचना का उत्तर Gateway not configured है: कोई Montonio कुंजी सेट नहीं है। कुंजियाँ डालें; Montonio सूचना दोबारा भेजेगा।

ग्राहक को ऑर्डर देते समय त्रुटि दिखती है: ऑर्डर नोट्स खोलें या Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_montonio_payment देखें। This payment method is temporarily unavailable. Please choose another payment method. आमतौर पर गलत या गायब कुंजियों का संकेत है। Montonio could not start the payment. Please check your order details or choose another payment method. का अर्थ है कि Montonio ने भुगतान डेटा अस्वीकार किया; कारण नोट में है।

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

सैंडबॉक्स भुगतान लाइव ऑर्डर की पुष्टि नहीं करते: जब स्टोर लाइव मोड में होता है, तब सैंडबॉक्स भुगतान कभी ऑर्डर पूरा नहीं करता; इसके बजाय ऑर्डर होल्ड पर चला जाता है। Sandbox mode को उस वातावरण पर बदलें जिसे आप उपयोग करना चाहते हैं और उसी वातावरण की कुंजियाँ डालें।

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

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

अनइंस्टॉल

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

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