VibeFox Autopay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।

Autopay सेवा: आपको अपनी Autopay सेवा का Service ID और Shared key (हैश कुंजी) चाहिए। ये Autopay मर्चेंट पोर्टल में दिखते हैं: प्रोडक्शन के लिए portal.autopay.eu, टेस्ट के लिए testportal.autopay.eu। टेस्ट सेवाओं के अपने Service ID और Shared key होते हैं; Autopay से एक खोलने का अनुरोध करें। सेवा का हैश फ़ंक्शन SHA-256 होना चाहिए।

मुद्रा: कार्ट की मुद्रा PLN, EUR, GBP, USD या CZK होनी चाहिए और आपकी Autopay सेवा द्वारा स्वीकृत होनी चाहिए।

पहुँच योग्य स्टोर: Autopay को आपके स्टोर तक सूचनाएँ भेजने में सक्षम होना चाहिए, इसलिए स्टोर इंटरनेट से बेसिक ऑथेंटिकेशन के बिना और POST अनुरोधों को रोकने वाली फ़ायरवॉल के बिना पहुँच योग्य होना चाहिए। आपके स्टोर का मेंटेनेंस मोड और देश प्रतिबंध सूचनाओं को नहीं रोकते।

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Autopay Payment खोजकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Service ID और Shared key (टेस्ट और प्रोडक्शन) दर्ज करें और अपनी सेवा की मुद्राएँ चुनें।

5. Autopay पोर्टल में अपनी सेवा के लिए ITN URL, वापसी URL और SHA-256 हैश फ़ंक्शन सेट करें (देखें कॉन्फ़िगरेशन)।

6. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर असली भुगतान के लिए Test mode बंद करें।

इंस्टॉल होने पर मॉड्यूल ऑर्डर स्थिति Autopay payment on hold बनाता है। PrestaShop नए भुगतान मॉड्यूल को सभी मुद्राओं, देशों और ग्राहक समूहों के लिए सक्षम करता है। इन्हें Payment > Preferences में सीमित किया जा सकता है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Autopay Payment > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। फ़ील्ड्स के ऊपर पेज चेतावनी देता है यदि चुने गए वातावरण का Service ID या Shared key खाली है, और यदि स्टोर की डिफ़ॉल्ट मुद्रा Currencies में चुनी नहीं गई है। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है (जिस मुद्रा के लिए वह चुनी नहीं गई है)।

Autopay

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

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: Autopay टेस्ट वातावरण (testpay.autopay.eu) और नीचे दिए गए टेस्ट क्रेडेंशियल इस्तेमाल करता है। डिफ़ॉल्ट: चालू। असली भुगतान pay.autopay.eu पर प्रोडक्शन क्रेडेंशियल से स्वीकार करने के लिए इसे बंद करें।

Service ID (production): portal.autopay.eu से मिला संख्यात्मक सेवा पहचानकर्ता।

Shared key (production): प्रोडक्शन सेवा की हैश कुंजी। इसे गोपनीय रखें।

Service ID (test): testportal.autopay.eu से मिला संख्यात्मक सेवा पहचानकर्ता।

Shared key (test): टेस्ट सेवा की हैश कुंजी।

सेव करते समय, अक्षरों, अंकों, हाइफ़न या अंडरस्कोर के अलावा अन्य वर्णों वाला Service ID त्रुटि के साथ अस्वीकार होता है, और कुछ भी सेव नहीं होता। सेव की गई Shared key दोबारा नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Clear saved keys: किसी कुंजी पर टिक करें और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

Currencies: आपकी Autopay सेवा द्वारा स्वीकृत मुद्राएँ: PLN, EUR, GBP, USD, CZK। Autopay आम तौर पर हर मुद्रा के लिए अलग सेवा खोलता है। भुगतान विधि तभी दी जाती है जब कार्ट की मुद्रा यहाँ चुनी गई हो। डिफ़ॉल्ट: PLN।

भुगतान सूचनाएँ (ITN) और वापसी पता

ये पते Autopay पोर्टल में अपनी सेवा के लिए दर्ज करें, प्रोडक्शन और टेस्ट दोनों के लिए। सटीक पते इस सेक्शन के Addresses फ़ील्ड में दिखते हैं। फ्रेंडली URL के साथ वे ऐसे दिखते हैं, संभव है किसी भाषा कोड जैसे /en/ के साथ:

पते ठीक वैसे ही कॉपी करें जैसे सेटिंग्स उन्हें दिखाती हैं। ITN URL के बिना ऑर्डर कभी नहीं बनते, क्योंकि PrestaShop ऑर्डर केवल तभी बनाता है जब Autopay भुगतान की पुष्टि करे। हर ITN की जाँच सूचना में बताई गई सेवा की Shared key से बने SHA-256 हैश से होती है। अमान्य हैश या अज्ञात Service ID वाली सूचनाएँ अस्वीकार होती हैं। कोई सूचना कार्ट पर तभी लागू होती है जब उसका भुगतान उसी Autopay सेवा से शुरू हुआ हो, इसलिए टेस्ट सूचना कभी प्रोडक्शन भुगतान की पुष्टि नहीं करती। Test mode बदलने से पहले शुरू हुए भुगतानों की सूचनाएँ तब तक सही कुंजी से जाँची जाती रहती हैं, जब तक दोनों क्रेडेंशियल सेव रहते हैं।

मॉड्यूल ITN में ये भुगतान स्थितियाँ संभालता है:

उन्नत

Logging: भुगतान घटनाएँ मॉड्यूल फ़ोल्डर में logs/wc_ap_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ और ग्राहक का डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद। जब तक यह बंद है, त्रुटियों सहित कुछ भी नहीं लिखा जाता।

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

चेकआउट

भुगतान चरण में ग्राहक अपनी विवरण सहित भुगतान विधि (डिफ़ॉल्ट रूप से Autopay) चुनता है और पुष्टि करता है। अगला पेज Thank you. You are being redirected to Autopay to complete the payment. Your order is created as soon as Autopay confirms it. दिखाता है और ग्राहक को Autopay भुगतान पेज पर भेजता है। यदि ग्राहक ब्राउज़र के बैक बटन से लौटता है, तो पेज दोबारा रीडायरेक्ट करने के बजाय Pay with Autopay बटन दिखाता है। इस बिंदु पर अभी कोई ऑर्डर मौजूद नहीं होता।

मॉड्यूल कार्ट की मुद्रा में कार्ट की कुल राशि, ऑर्डर संदर्भ के रूप में कार्ट नंबर, विवरण (Cart और नंबर) और ग्राहक का ईमेल भेजता है। Autopay पेज पर ग्राहक भुगतान विधि चुनकर भुगतान करता है।

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Autopay उसे हस्ताक्षरित ITN से पुष्टि करे और राशि तथा मुद्रा कार्ट से मेल खाएँ। फिर ऑर्डर बनता है और ग्राहक को PrestaShop के मानक ऑर्डर ईमेल मिलते हैं। भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। वापसी पता हस्ताक्षरित होता है, लेकिन वह कभी ऑर्डर नहीं बनाता या बदलता। यदि ऑर्डर पहले से मौजूद है, तो ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि ITN अभी तक नहीं आया है, तो Payment confirmation पेज Thank you. Your payment is being confirmed by Autopay — your order will be created as soon as Autopay confirms it, and you will receive an e-mail. के साथ Check again और Back to checkout बटन दिखाता है।

यदि Autopay ने विफल भुगतान की सूचना दी, तो ग्राहक The payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है। यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक चेकआउट पर एक छोटा संदेश देखता है, जैसे Autopay payments are not configured. Please choose another payment method or contact the store., या यह कि Autopay इस मुद्रा में भुगतान स्वीकार नहीं कर सकता।

मॉड्यूल में PrestaShop से रिफ़ंड, सदस्यता या आवर्ती भुगतान, सेव किए गए कार्ड, चेकआउट पेज पर BLIK कोड या कार्ड फ़ॉर्म, और चेकआउट पेज पर बैंक या भुगतान चैनल चुनने की सुविधा नहीं है, और यह प्रत्येक वातावरण के लिए एक Service ID का उपयोग करता है।

ऑर्डर

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

No order yet: ग्राहक को Autopay पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान विफल हुआ, या Autopay ने अभी भुगतान की पुष्टि नहीं की। केवल कार्ट मौजूद है।

Payment accepted: Autopay ने भुगतान की पुष्टि की और राशि तथा मुद्रा मेल खाते हैं। भुगतान को Autopay ट्रांज़ैक्शन ID (remoteID) के साथ ट्रांज़ैक्शन ID के रूप में दर्ज किया जाता है, और एक नोट में राशि, Autopay ट्रांज़ैक्शन और भुगतान की तारीख दिखती है।

Autopay payment on hold: Autopay ने कार्ट के कुल योग से भिन्न राशि या मुद्रा की सूचना दी (उदाहरण के लिए, भुगतान शुरू होने के बाद कार्ट बदला गया)। ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता। Autopay पोर्टल में ट्रांज़ैक्शन जाँचें और उसे मैन्युअली पूरा करें या रिफ़ंड करें। इस ऑर्डर के लिए बाद में आई सही सूचना इसे भुगतान किया हुआ चिह्नित करती है। यही स्थिति तब भी उपयोग होती है जब किसी रद्द किए गए ऑर्डर के लिए भुगतान आता है: भुगतान दर्ज होता है और एक नोट आपसे स्टॉक जाँचने और ऑर्डर पूरा करने, या भुगतान रिफ़ंड करने के लिए कहता है।

भुगतान किया हुआ ऑर्डर बाद की विफलता सूचना से कभी नहीं बदलता। यदि Autopay किसी भुगतान किए गए ऑर्डर के लिए एक और सफल भुगतान बताता है, तो एक नोट चेतावनी देता है कि ग्राहक ने दोबारा भुगतान किया हो सकता है। किसी दूसरी Autopay सेवा से शुरू हुए भुगतान की सूचना लागू नहीं होती, और एक नोट इसे समझाता है। नोट केवल स्टाफ़ को दिखते हैं, ऑर्डर पेज के Autopay payment ब्लॉक में।

Autopay payment ब्लॉक

ऑर्डर पेज पर Autopay payment ब्लॉक दिखता है, जिसमें Autopay OrderID, Service ID और वातावरण, राशि और मुद्रा, भुगतान स्थिति, Autopay ट्रांज़ैक्शन ID, टेस्ट भुगतानों के लिए Test mode बैज और ऑर्डर के Autopay notes होते हैं। यह ब्लॉक केवल पढ़ने के लिए है।

रिफ़ंड

Autopay के ज़रिए रिफ़ंड समर्थित नहीं हैं। Autopay पोर्टल में भुगतान रिफ़ंड करें, फिर मानक ऑर्डर टूल्स से PrestaShop में दर्ज करें।

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

मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Autopay Payment, Modules > Module Manager > VibeFox Autopay Payment > Configure पेज पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए, और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: presta-payment-autopay वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। कुंजी केवल वे कर्मचारी बदल सकते हैं जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के पाठ बैक ऑफ़िस की भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या License expired on के साथ एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल आखिरी ज्ञात स्थिति पर काम करता रहता है।

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

सक्रिय कुंजी के बिना चेकआउट पर Autopay ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपसे भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि अब भी होती है।

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

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

चेकआउट पर Autopay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुने गए वातावरण में Service ID और Shared key हैं, और कार्ट की मुद्रा Currencies में चुनी गई है। यदि इनमें से कुछ नहीं है, तो सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है।

भुगतान हो गया, पर ऑर्डर नहीं बना: Autopay ने ITN नहीं पहुँचाया, या स्टोर ने उसे अस्वीकार किया। जाँचें कि सेटिंग्स में दिखाया गया ITN URL Autopay पोर्टल में सेवा (प्रोडक्शन या टेस्ट) के लिए सेट है, हैश फ़ंक्शन SHA-256 है, और मॉड्यूल की Shared key सेवा से मेल खाती है। जाँचें कि स्टोर इंटरनेट से पहुँच योग्य है। Logging चालू करें और मॉड्यूल पेज पर Log फ़ील्ड देखें।

लॉग में ITN rejected: invalid hash दिखता है: Shared key सेवा से मेल नहीं खाती, या सेवा का हैश फ़ंक्शन SHA-256 नहीं है।

लॉग में दिखता है कि service ID कॉन्फ़िगर नहीं है: सूचना ऐसी सेवा से आई जिसका Service ID मॉड्यूल में दर्ज नहीं है, या जिसकी Shared key खाली है।

लॉग में could not lock the cart, Autopay will retry दिखता है: वही कार्ट उसी समय किसी दूसरी सूचना से प्रोसेस हो रहा था। स्टोर इस तरह उत्तर देता है कि Autopay सूचना दोबारा भेजे। यही तब होता है जब ऑर्डर नहीं बन सका, उदाहरण के लिए क्योंकि मॉड्यूल बंद है।

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

एक नोट कहता है कि सूचना लागू नहीं हुई (NOT applied): इस ऑर्डर का भुगतान इस Autopay सेवा से शुरू नहीं हुआ था, उदाहरण के लिए किसी असली ऑर्डर के लिए टेस्ट सूचना। Autopay पोर्टल में ट्रांज़ैक्शन जाँचें।

भुगतान के बाद ग्राहक होम पेज पर पहुँचता है: वापसी पते की पुष्टि नहीं हो सकी, उदाहरण के लिए क्योंकि Service ID मॉड्यूल में दर्ज नहीं है। ऑर्डर प्रभावित नहीं होता; वह ITN का अनुसरण करता है।

ग्राहक को This payment method is not available. दिखता है: इस कार्ट के लिए भुगतान विधि नहीं दी जा रही (बंद, क्रेडेंशियल गायब, मुद्रा नहीं चुनी गई, या Payment > Preferences में अनुमति नहीं)।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Autopay Payment के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। कुंजियों सहित मॉड्यूल सेटिंग्स और लॉग हटा दिए जाते हैं। मॉड्यूल में सेटिंग्स रखने का कोई विकल्प नहीं है। Autopay भुगतान रिकॉर्ड और ऑर्डर स्थिति Autopay payment on hold हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID बनाए रखते हैं।

Autopay अपने संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Autopay से संबद्ध नहीं है और Autopay द्वारा समर्थित नहीं है।