VibeFox Autopay for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।
PHP: 8.0 या उसके बाद का संस्करण।
Autopay सेवा: आपको अपनी Autopay सेवा की Service ID और Shared key (hash key) चाहिए। ये Autopay मर्चेंट पोर्टल में दिखती हैं: प्रोडक्शन के लिए portal.autopay.eu, टेस्ट के लिए testportal.autopay.eu। टेस्ट सेवाओं की अपनी Service ID और Shared key होती है; Autopay से एक टेस्ट सेवा खोलने को कहें। सेवा का हैश फ़ंक्शन SHA-256 होना चाहिए।
मुद्रा: स्टोर मुद्रा PLN, EUR, GBP, USD या CZK होनी चाहिए और आपकी Autopay सेवा द्वारा स्वीकृत होनी चाहिए।
पहुँच योग्य स्टोर: Autopay आपके स्टोर को सूचनाएँ भेज सके, इसके लिए स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, मेंटेनेंस मोड, basic authentication या ऐसे फ़ायरवॉल के बिना जो POST अनुरोधों को रोकता हो।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP द्वारा wcp_autopay_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Autopay > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. Service ID और Shared key (टेस्ट और प्रोडक्शन) दर्ज करें और अपनी सेवा की मुद्राएँ चुनें।
6. Autopay पोर्टल में अपनी सेवा के लिए ITN URL, रिटर्न URL और SHA-256 हैश फ़ंक्शन सेट करें (देखें कॉन्फ़िगरेशन)।
7. Enable/Disable चालू करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर असली भुगतान के लिए Test mode का निशान हटाएँ।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Autopay। फ़ील्ड के ऊपर पेज चेतावनी देता है कि चुने गए वातावरण का Service ID या Shared key खाली है, और जब स्टोर मुद्रा Currencies में चुनी न गई हो। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिपी रहती है। भुगतान विधियों की सूची में Autopay को तब तक सेटअप की आवश्यकता वाला चिह्नित किया जाता है जब तक चुने गए वातावरण के क्रेडेंशियल नहीं हैं।
सामान्य
Enable/Disable: Enable Autopay payment gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: Autopay।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.
Autopay सेवा
Service ID और Shared key Autopay मर्चेंट पोर्टल (portal.autopay.eu या testportal.autopay.eu) में दिखते हैं।
Test mode: Use the Autopay test environment (testpay.autopay.eu) and the test credentials below। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए इसे बंद करें, ताकि pay.autopay.eu पर प्रोडक्शन क्रेडेंशियल से भुगतान लिए जाएँ।
Service ID (production): portal.autopay.eu से संख्यात्मक सेवा पहचानकर्ता।
Shared key (production): प्रोडक्शन सेवा की हैश कुंजी। इसे गोपनीय रखें।
Service ID (test): testportal.autopay.eu से संख्यात्मक सेवा पहचानकर्ता।
Shared key (test): टेस्ट सेवा की हैश कुंजी।
Currencies: वे मुद्राएँ जिन्हें आपकी Autopay सेवा स्वीकार करती है: PLN, EUR, GBP, USD, CZK। Autopay आमतौर पर हर मुद्रा के लिए अलग सेवा खोलता है। भुगतान विधि केवल तभी दी जाती है जब ऑर्डर की मुद्रा यहाँ चुनी गई हो। डिफ़ॉल्ट: PLN।
भुगतान सूचनाएँ (ITN) और रिटर्न पता
ये पते अपनी सेवा के लिए Autopay पोर्टल में दर्ज करें, प्रोडक्शन और टेस्ट दोनों के लिए। सटीक पते सेटिंग्स के इस सेक्शन में दिखाए गए हैं।
ITN URL के बिना ऑर्डर कभी भुगतान किए हुए चिह्नित नहीं होते। हर ITN मेल खाती सेवा की Shared key से बने SHA-256 हैश से जाँचा जाता है। बिना वैध हैश वाली या अज्ञात Service ID की सूचनाएँ अस्वीकार होती हैं। कोई सूचना तभी ऑर्डर पर लागू होती है जब उस ऑर्डर का भुगतान उसी Autopay सेवा से शुरू हुआ हो। Test mode बदलने से पहले शुरू हुए भुगतानों की सूचनाएँ अब भी सही कुंजी से सत्यापित होती हैं।
ITN में ये भुगतान स्थितियाँ संभाली जाती हैं:
उन्नत
Logging: Log payment events को WooCommerce > Status > Logs में, source wcp_autopay_payment के साथ लिखें। कुंजियाँ और ग्राहक का डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: off।
चेकआउट
ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Autopay) और ऑर्डर देता है। अगला पेज Thank you for your order. You are being redirected to Autopay to complete the payment. दिखाता है और ग्राहक को Autopay भुगतान पेज पर भेजता है। यदि ग्राहक ब्राउज़र के बैक बटन से लौटता है, तो पेज दोबारा रीडायरेक्ट करने के बजाय Pay with Autopay बटन दिखाता है।
प्लगइन ऑर्डर की कुल राशि ऑर्डर की मुद्रा में, विवरण के रूप में ऑर्डर नंबर (Order और नंबर) और ग्राहक का बिलिंग ईमेल भेजता है। Autopay पेज पर ग्राहक भुगतान विधि चुनता है और भुगतान करता है।
भुगतान के बाद ग्राहक ऑर्डर प्राप्त पेज पर लौटता है। रिटर्न पता हस्ताक्षरित है, लेकिन वह ऑर्डर की स्थिति कभी नहीं बदलता। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Autopay हस्ताक्षरित ITN से पुष्टि करे और राशि तथा मुद्रा ऑर्डर से मेल खाएँ।
यदि भुगतान विफल होता है, तो ऑर्डर विफल बनता है और ग्राहक Pay लिंक से ऑर्डर पर दोबारा भुगतान कर सकता है। यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक को एक छोटा संदेश दिखता है, उदाहरण के लिए Autopay payments are not configured. Please choose another payment method or contact the store. या यह कि Autopay इस मुद्रा में भुगतान स्वीकार नहीं कर सकता।
भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन में WooCommerce से रिफ़ंड नहीं है, कोई सदस्यता या आवर्ती भुगतान नहीं है, कोई सेव किए गए कार्ड (1-Click) नहीं हैं, चेकआउट पेज पर कोई BLIK कोड या कार्ड फ़ॉर्म नहीं है, चेकआउट पेज पर बैंक या भुगतान चैनल चुनने का विकल्प नहीं है, और हर वातावरण के लिए एक ही Service ID उपयोग होती है।
ऑर्डर
ऑर्डर की स्थितियाँ
Pending payment: ग्राहक को Autopay भेजा गया और Autopay ने अभी भुगतान की पुष्टि नहीं की।
Processing or Completed: Autopay ने भुगतान की पुष्टि की। WooCommerce प्रोसेसिंग सेट करता है, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर के लिए पूर्ण। ऑर्डर नोट में राशि, Autopay लेन-देन और भुगतान की तारीख दिखती है। लेन-देन ID Autopay लेन-देन ID (RemoteID) है।
On hold: Autopay ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई। ऑर्डर भुगतान किया हुआ चिह्नित नहीं हुआ। Autopay पोर्टल में लेन-देन जाँचें और उसे मैनुअल रूप से पूरा करें या रिफ़ंड करें।
Failed: भुगतान विफल हुआ। ग्राहक ऑर्डर से दोबारा भुगतान कर सकता है।
भुगतान किए गए ऑर्डर को बाद की विफलता सूचना से कभी नहीं बदला जाता। यदि Autopay किसी भुगतान किए गए ऑर्डर के लिए एक और सफल भुगतान बताए, तो एक नोट चेतावनी देता है कि ग्राहक ने शायद दो बार भुगतान किया है। किसी दूसरी Autopay सेवा से शुरू हुए भुगतान की सूचना लागू नहीं होती, और इसका कारण एक नोट में लिखा जाता है।
रिफ़ंड
WooCommerce से रिफ़ंड समर्थित नहीं हैं। भुगतान Autopay पोर्टल में रिफ़ंड करें, फिर उसे WooCommerce में मैनुअल रिफ़ंड के रूप में दर्ज करें।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Autopay के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। स्लॉट अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर Autopay ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन स्टोर मैनेजर भुगतान विधि अब भी देखते हैं, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर और जाँच सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।
समस्या-निवारण
Autopay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुने गए वातावरण में Service ID और Shared key हैं, और स्टोर मुद्रा Currencies में चुनी गई है। इनमें से कोई गायब हो तो सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: Autopay ने ITN नहीं भेजा, या स्टोर ने उसे अस्वीकार किया। जाँचें कि सेटिंग्स में दिखाया ITN URL Autopay पोर्टल में आपकी सेवा (प्रोडक्शन या टेस्ट) के लिए सेट है, हैश फ़ंक्शन SHA-256 है, और प्लगइन में Shared key सेवा से मेल खाती है। जाँचें कि स्टोर इंटरनेट से पहुँच योग्य है। Logging चालू करें और WooCommerce > Status > Logs में source wcp_autopay_payment देखें।
लॉग में ITN rejected: invalid hash दिखता है: Shared key सेवा से मेल नहीं खाती, या सेवा का हैश फ़ंक्शन SHA-256 नहीं है।
लॉग में दिखता है कि service ID कॉन्फ़िगर नहीं है: सूचना ऐसी सेवा से आई जिसकी Service ID प्लगइन में दर्ज नहीं है।
ऑर्डर On hold पर रखा गया, राशि या मुद्रा मेल नहीं खाती: Autopay ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई। Autopay पोर्टल में लेन-देन जाँचें और ऑर्डर को मैनुअल रूप से पूरा करें या रिफ़ंड करें।
एक नोट बताता है कि सूचना लागू नहीं हुई: इस ऑर्डर का भुगतान इस Autopay सेवा से शुरू नहीं हुआ था, उदाहरण के लिए लाइव ऑर्डर के लिए टेस्ट सूचना। Autopay पोर्टल में लेन-देन जाँचें।
भुगतान के बाद ग्राहक होम पेज पर पहुँचता है: रिटर्न पता सत्यापित नहीं हो सका, उदाहरण के लिए क्योंकि Service ID प्लगइन में दर्ज नहीं है। ऑर्डर की स्थिति प्रभावित नहीं होती; वह ITN का अनुसरण करती है।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करें और फिर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा गेटवे सेटिंग्स हटा दी जाती हैं। सेटिंग्स बनाए रखने का कोई विकल्प प्लगइन में नहीं है। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।
Autopay उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Autopay से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।