VibeFox EveryPay for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या बाद का संस्करण, इंस्टॉल और सक्रिय।

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

EveryPay खाता: आपको अपने स्टोर का API यूज़रनेम, API secret और प्रोसेसिंग खाते का नाम चाहिए। ये EveryPay Merchant Portal में, आपके स्टोर की सेटिंग्स में मिलेंगे: टेस्ट मोड के लिए डेमो पोर्टल (mwt-demo.every-pay.com) और लाइव भुगतान के लिए लाइव पोर्टल (portal.every-pay.eu)। टेस्ट और लाइव वातावरण के क्रेडेंशियल अलग-अलग होते हैं। आप दोनों पोर्टलों में अपने स्टोर का कॉलबैक URL भी सेट करते हैं (देखें कॉन्फ़िगरेशन)।

स्टोर की मुद्रा: प्रोसेसिंग खाता चार्ज होने वाली मुद्रा तय करता है, उदाहरण के लिए EUR3D1 EUR में चार्ज करता है। भुगतान विधि केवल उसी मुद्रा के ऑर्डरों के लिए दी जाती है।

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

इंस्टॉलेशन

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

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

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

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

5. डेमो Merchant Portal से टेस्ट API यूज़रनेम, टेस्ट API secret और प्रोसेसिंग खाते का नाम डालें। Test Mode को चालू रखें।

6. सेटिंग्स पेज पर दिखाया गया कॉलबैक URL कॉपी करें और Merchant Portal में अपने स्टोर के Callback notification URL में डालें।

7. Enable/Disable चालू करें और एक टेस्ट ऑर्डर दें। सब कुछ ठीक चलने पर लाइव क्रेडेंशियल डालें, लाइव पोर्टल में भी कॉलबैक URL सेट करें और Test Mode का टिक हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > EveryPay। जब टेस्ट मोड चालू हो, तब फ़ील्ड्स के ऊपर पेज यह संदेश दिखाता है: Test mode is on: payments go to the EveryPay demo environment, no real money is charged. यदि गेटवे चालू है पर वर्तमान मोड का API यूज़रनेम, API secret या प्रोसेसिंग खाता नहीं है, तो चेतावनी देता है (तब चेकआउट पर भुगतान विधि छिपी रहती है), और जब प्रोसेसिंग खाता स्टोर की मुद्रा से अलग मुद्रा में चार्ज करता है, तब भी। भुगतान विधियों की सूची में EveryPay तब तक "सेटअप आवश्यक" के रूप में चिह्नित रहता है जब तक वर्तमान मोड कॉन्फ़िगर न हो। क्रेडेंशियल्स के साथ चिपकाए गए स्पेस और लाइन ब्रेक सेव करते समय हटा दिए जाते हैं।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card or bank link on the EveryPay payment page.

EveryPay खाता

API यूज़रनेम, API secret और प्रोसेसिंग खाते का नाम EveryPay Merchant Portal (स्टोर सेटिंग्स) में दिखते हैं: टेस्ट मोड के लिए डेमो पोर्टल, लाइव भुगतान के लिए लाइव पोर्टल।

Test Mode: Enable test mode भुगतान को टेस्ट क्रेडेंशियल के साथ EveryPay डेमो वातावरण में भेजता है। कोई वास्तविक पैसा चार्ज नहीं होता। डिफ़ॉल्ट: चालू।

Test API Username: डेमो वातावरण का API यूज़रनेम।

Test API Secret: डेमो वातावरण का API secret।

Live API Username: लाइव वातावरण का API यूज़रनेम।

Live API Secret: लाइव वातावरण का API secret।

Processing Account Name: EveryPay प्रोसेसिंग खाता, उदाहरण के लिए EUR3D1। यह खाता चार्ज होने वाली मुद्रा तय करता है: गेटवे केवल उसी मुद्रा के ऑर्डरों के लिए दिया जाता है। दोनों मोड में एक ही खाता नाम इस्तेमाल होता है।

भुगतान सूचनाएँ (कॉलबैक)

कॉलबैक आपके स्टोर को बताता है कि भुगतान पूरा हो गया है, ताकि ग्राहक ब्राउज़र बंद कर दे तब भी ऑर्डर अपडेट हो जाएँ। इस सेक्शन में दिखाया गया URL डेमो और लाइव दोनों के लिए EveryPay Merchant Portal में अपने स्टोर के Callback notification URL में कॉपी करें। URL इस तरह दिखता है: https://your-site/wc-api/wc_evp_payment/। भुगतान अनुरोध में कॉलबैक URL नहीं होता, इसलिए इसे पोर्टल में सेट करना होगा।

कॉलबैक में केवल भुगतान के संदर्भ होते हैं। आने पर प्लगइन उस वातावरण में, जहाँ भुगतान बनाया गया था, EveryPay API से भुगतान की स्थिति माँगता है और जाँचता है कि उत्तर इसी ऑर्डर का है। जो भुगतान ऑर्डर ने नहीं बनाया, उसके कॉलबैक अस्वीकार किए जाते हैं। कॉलबैक के बिना, ग्राहक के भुगतान के बाद स्टोर पर लौटने पर, या आप ऑर्डर पर Check EveryPay payment status चलाते हैं तब ऑर्डर की पुष्टि होती है।

उन्नत

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

Uninstall: Delete the gateway settings and logs when the plugin is deleted। डिफ़ॉल्ट: बंद।

चेकआउट

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

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

यदि भुगतान विफल हो जाए, तो ग्राहक चेकआउट पर (या Pay for order पेज पर) लौट जाता है, और उसे Your EveryPay payment was not successful. Please try again or choose another payment method. संदेश दिखता है। यदि ग्राहक बिना भुगतान किए भुगतान पेज छोड़ दे, तो संदेश होता है The EveryPay payment was not completed. You can try again or choose another payment method. हर नए प्रयास पर नया EveryPay भुगतान बनता है; पिछले प्रयास भी दर्ज रहते हैं, इसलिए पुराने लिंक से किया गया भुगतान भी पहचाना जाता है।

यदि EveryPay भुगतान शुरू न कर सके, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. विवरण लॉग में होते हैं।

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

प्लगइन केवल एक-बारी भुगतान लेता है। WooCommerce से रिफ़ंड या कैप्चर नहीं होते, सेव किए गए कार्ड या वन-क्लिक भुगतान नहीं होते, सब्सक्रिप्शन या आवर्ती भुगतान नहीं होते, एम्बेडेड कार्ड फ़ील्ड नहीं होते और मल्टी-करेंसी नहीं होती।

ऑर्डर

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

Pending payment: ग्राहक को EveryPay पर भेज दिया गया है और उसने अभी तक भुगतान नहीं किया है, या भुगतान अभी प्रोसेस हो रहा है।

Processing: EveryPay ने भुगतान को सेटल या अधिकृत बताया है (केवल वर्चुअल डाउनलोडेबल उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार पूर्ण हो जाते हैं)। ऑर्डर नोट में राशि, मुद्रा और भुगतान संदर्भ दिखता है। ऑर्डर का ट्रांज़ैक्शन ID EveryPay भुगतान संदर्भ है। अधिकृत भुगतान के लिए नोट बताता है कि राशि रोक ली गई है: यदि आपका खाता अपने-आप कैप्चर नहीं करता, तो EveryPay Merchant Portal में भुगतान कैप्चर करें। बाद में सेटल होने पर एक नोट यह बताता है।

On hold after payment: भुगतान की मैन्युअल समीक्षा ज़रूरी है। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है, भुगतान आने से पहले ऑर्डर रद्द हो चुका था, या ऑर्डर अब कोई दूसरी भुगतान विधि इस्तेमाल कर रहा है। नोट इसे समझाता है और बताता है कि ऑर्डर को भुगतान किया हुआ नहीं माना गया। Merchant Portal में भुगतान की जाँच करें और उसे मैन्युअल रूप से पूरा करें या रिफ़ंड करें। इस भुगतान के बाद आने वाले कॉलबैक ऑर्डर को अपने-आप पूरा नहीं करते।

Failed: बिना भुगतान वाले ऑर्डर का आखिरी भुगतान प्रयास विफल हुआ, छोड़ दिया गया या void हो गया। नोट EveryPay से मिला कारण दिखाता है। ग्राहक फिर से प्रयास कर सकता है।

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

Check EveryPay payment status

ऑर्डर स्क्रीन पर ऑर्डर क्रिया Check EveryPay payment status चुनें। प्लगइन API से ऑर्डर के हर EveryPay भुगतान की जाँच करता है, ऊपर बताए अनुसार परिणाम लागू करता है और हर भुगतान की स्थिति वाला एक नोट जोड़ता है। उन ऑर्डरों के लिए उपयोग करें जिनका कॉलबैक कभी नहीं आया।

रिफ़ंड

WooCommerce से रिफ़ंड समर्थित नहीं हैं। EveryPay Merchant Portal में रिफ़ंड करें, फिर WooCommerce में ऑर्डर की स्थिति सेट करें। जब EveryPay किसी भुगतान को रिफ़ंड या chargeback के रूप में बताता है, तो प्लगइन केवल एक ऑर्डर नोट जोड़ता है; ऑर्डर की स्थिति नहीं बदलती।

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

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

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

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

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

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

EveryPay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का API यूज़रनेम, API secret और Processing Account Name भरे हुए हैं, और स्टोर की मुद्रा (Pay for order पेज पर ऑर्डर की मुद्रा) प्रोसेसिंग खाते की मुद्रा है। इन मामलों में सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: कॉलबैक काम नहीं कर रहा। जाँचें कि सेटिंग्स का कॉलबैक URL उस मोड (डेमो या लाइव) के Merchant Portal में Callback notification URL के रूप में सेट है। आप ऑर्डर खोलकर Check EveryPay payment status भी चला सकते हैं। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_everypay_payment देखें।

कॉलबैक का उत्तर Unknown payment reference या Payment does not belong to this order है: भुगतान इस ऑर्डर ने नहीं बनाया था, या EveryPay का उत्तर उससे मेल नहीं खाता। ऑर्डर नहीं बदलता।

कॉलबैक का उत्तर Not configured है: जिस वातावरण में भुगतान बना था, उसके क्रेडेंशियल गायब हैं, उदाहरण के लिए टेस्ट क्रेडेंशियल हटाने के बाद का टेस्ट भुगतान। उन्हें फिर से डालें; EveryPay कॉलबैक दोबारा भेजेगा।

कॉलबैक का उत्तर Payment status unavailable या Busy, please retry है: EveryPay API तक नहीं पहुँचा जा सका, या उसी समय कोई दूसरा अनुरोध ऑर्डर अपडेट कर रहा था। EveryPay कॉलबैक दोबारा भेजेगा।

ग्राहक को EveryPay is temporarily unavailable दिखता है: EveryPay ने क्रेडेंशियल अस्वीकार किए या पहुँच से बाहर था। वर्तमान मोड का API यूज़रनेम और API secret जाँचें।

ग्राहक को This payment method does not support the order currency दिखता है: ऑर्डर की मुद्रा प्रोसेसिंग खाते की मुद्रा से अलग है।

ऑर्डर On hold after payment है: ऑर्डर नोट पढ़ें। राशि या मुद्रा अलग थी, या भुगतान आने से पहले ऑर्डर रद्द हो चुका था। Merchant Portal में भुगतान की जाँच करें और उसे मैन्युअल रूप से पूरा करें या रिफ़ंड करें।

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

डेवलपर्स के लिए, प्लगइन दस्तावेज़ में ये फ़िल्टर सूचीबद्ध हैं: wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals और wc_evp_oneoff_request।

अनइंस्टॉल

प्लगइन निष्क्रिय करने से सारा डेटा बना रहता है। हटाने के लिए, प्लगइन निष्क्रिय करें और Plugins पेज पर उसे हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। गेटवे सेटिंग्स और लॉग केवल तभी हटते हैं जब Uninstall (Delete the gateway settings and logs when the plugin is deleted) चालू था। नहीं तो वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। ऑर्डरों में सेव EveryPay भुगतान संदर्भ हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।

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