वापस

VibeFox Autopay for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

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

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

पहुँच योग्य स्टोर: Autopay को आपके स्टोर को सूचनाएँ भेजने में सक्षम होना चाहिए, इसलिए स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, बिना basic authentication के और ऐसे firewall के बिना जो POST अनुरोधों को रोकता हो। Maintenance mode सूचनाओं को नहीं रोकता, क्योंकि OpenCart भुगतान extension के अनुरोधों को जाने देता है।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_autopay_payment-oc3-(संस्करण).ocmod.zip और OpenCart 4 का पैकेज wcp_autopay_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_autopay_payment-oc3-(संस्करण).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप आर्काइव के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Autopay Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के ऊपर लाइसेंस ब्लॉक में License key में पेस्ट करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

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

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

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_autopay_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज इंस्टॉल किए गए एक्सटेंशन की सूची में उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन का प्रकार Payments चुनें। VibeFox Autopay Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 6 में है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल ITN और return पते अलग हैं (देखें ITN और return पता)।

नई इंस्टॉलेशन भुगतान विधि बंद, test mode चालू और केवल PLN मुद्रा के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Autopay Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब चुने गए environment का Service ID या Shared key खाली हो (तब चेकआउट पर भुगतान विधि छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा Currencies में चुनी न गई हो (तब उस मुद्रा में भुगतान विधि छिपी रहती है)। जब test mode चालू है, तब यह Test mode is on: payments go to the Autopay test environment (testpay.autopay.eu), no real money is taken. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title में 1 से 128 अक्षर होने चाहिए, Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और Service ID में केवल अक्षर, अंक, हाइफ़न और अंडरस्कोर हो सकते हैं। यदि किसी फ़ील्ड में त्रुटि है, तो कुछ भी सेव नहीं होता और पेज उस फ़ील्ड का नाम बताता है।

Autopay

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सहेजा जाता है। डिफ़ॉल्ट: Autopay। आवश्यक, 128 अक्षरों तक।

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण पर पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Sort Order: चेकआउट पर भुगतान विधियों के बीच Autopay का स्थान। खाली छोड़ें या कोई पूर्ण संख्या दर्ज करें।

Geo Zone: Autopay केवल चुने गए geo zone के भुगतान पतों के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।

Total: चेकआउट का वह कुल योग, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Autopay की पेशकश की जाती है। किसी भी राशि के लिए Autopay देने हेतु खाली छोड़ें।

Autopay सेवा

Service ID और Shared key Autopay merchant portal (portal.autopay.eu या testportal.autopay.eu, जो इस सेक्शन में लिंक हैं) में दिखाए जाते हैं।

Test mode: Autopay test environment (testpay.autopay.eu) और नीचे दिए गए test credentials का उपयोग करता है। डिफ़ॉल्ट: चालू। प्रोडक्शन credentials के साथ pay.autopay.eu पर वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode: no real payment is taken. देखते हैं।

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

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

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

Shared key (test): टेस्ट सेवा की hash key।

सहेजी गई Shared keys फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलाव करने के लिए नया मान दर्ज करें। सहेजी कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved key on save पर टिक लगाएँ और Save पर क्लिक करें।

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

ITN और return पता

ये पते अपनी सेवा के लिए Autopay portal में दर्ज करें, प्रोडक्शन और टेस्ट दोनों के लिए। सटीक पते इस सेक्शन के Addresses फ़ील्ड में दिखाए जाते हैं और आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनते हैं:

ITN (transaction notification) URL: https://your-store/index.php?route=extension/payment/wcp_autopay_payment/itn
Return URL (after payment): https://your-store/index.php?route=extension/payment/wcp_autopay_payment/back

ये OpenCart 3 के पते हैं। OpenCart 4 पर ये इस प्रकार हैं:

ITN (transaction notification) URL: https://your-store/index.php?route=extension/wcp_autopay_payment/payment/wcp_autopay_payment.itn
Return URL (after payment): https://your-store/index.php?route=extension/wcp_autopay_payment/payment/wcp_autopay_payment.back

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

एक्सटेंशन ITN में ये भुगतान स्थितियाँ संभालता है:

SUCCESS: भुगतान हो गया; राशि और मुद्रा की जाँच के बाद ऑर्डर को स्थिति मिलती है।
PENDING: भुगतान शुरू हुआ; ऑर्डर बिना स्थिति के रहता है।
FAILURE: भुगतान विफल हुआ; ऑर्डर बिना स्थिति के रहता है, और ग्राहक फिर से भुगतान कर सकता है।

Orders

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को तभी स्थिति मिलती है जब Autopay भुगतान की पुष्टि करता है (ITN SUCCESS)। विफल या छोड़ा गया भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है। OpenCart 4 पर चेकआउट का एक बिना भुगतान वाला ऑर्डर Voided स्थिति पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है; एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का ITN SUCCESS उसे फिर भी भुगतान किया हुआ चिह्नित करता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची दिखाता है।

Order Status After Payment: जब Autopay अपेक्षित राशि और मुद्रा के साथ भुगतान की पुष्टि करता है, तब सेट होने वाली स्थिति। डिफ़ॉल्ट: Processing।

On Hold Status: भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या भुगतान तब आया जब ऑर्डर की स्थिति पहले ही बदली जा चुकी थी (उदाहरण के लिए रद्द)। ऑर्डर को भुगतान किया हुआ नहीं माना जाता; एक नोट कारण बताता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Advanced

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

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

Import / Export

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। Shared keys एक्सपोर्ट नहीं होतीं।

Import: पहले एक्सपोर्ट किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई Shared keys सुरक्षित रहती हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Autopay)। Confirm Order चरण पर ग्राहक आपका विवरण और You will be redirected to the secure Autopay payment page to complete the payment. की सूचना देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, पर अभी भी उसकी कोई स्थिति नहीं होती। जब ग्राहक Confirm Order पर क्लिक करता है, तब ब्राउज़र Autopay को एक हस्ताक्षरित भुगतान फ़ॉर्म भेजता है, जिसमें ऑर्डर मुद्रा में ऑर्डर कुल, OrderID के रूप में OpenCart ऑर्डर नंबर, नंबर सहित विवरण Order, और ग्राहक का ईमेल होता है। Autopay पेज पर ग्राहक भुगतान विधि चुनता है और भुगतान करता है।

ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Autopay उसे एक हस्ताक्षरित ITN से पुष्ट करता है और राशि व मुद्रा ऑर्डर से मेल खाती हैं। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है। भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। return पता हस्ताक्षरित होता है, पर वह कभी ऑर्डर नहीं बदलता। यदि ऑर्डर में पहले से स्थिति है, तो ग्राहक को OpenCart ऑर्डर सफलता पेज दिखता है। यदि ITN अभी तक नहीं आया है, तो Payment confirmation पेज पर Thank you. Your payment is being confirmed by Autopay — your order is confirmed as soon as Autopay reports the payment, 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. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है। हर नया प्रयास एक नया OpenCart ऑर्डर बनाता है (OpenCart 4 पर ग्राहक उसी ऑर्डर का भुगतान फिर से करता है, उसी OrderID के अंतर्गत एक नए प्रयास के साथ)। यदि उसी कार्ट (उसी विज़िट के समान उत्पाद) का कोई अन्य ऑर्डर पहले ही भुगतान हो चुका है, तो ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर जाता है। पूरी हुई खरीदारी के बाद की नई खरीदारी एक नया कार्ट है और सामान्य रूप से भुगतान किया जाता है। यदि भुगतान शुरू ही नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश देखता है, जैसे Autopay payments are not configured. Please choose another payment method or contact the store. या यह कि Autopay इस मुद्रा में भुगतान स्वीकार नहीं कर सकता।

OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। भुगतान पूरा न होने का संदेश चेकआउट पेज के ऊपर दिखाया जाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है। यदि वह ऑर्डर इस बीच स्टोर द्वारा बंद कर दिया गया था (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक The payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर वापस भेजा जाता है, या, यदि ऑर्डर Autopay से भुगतान किया जा चुका था, तो Your previous order was closed by the store. Please confirm the order again: the cart will be paid with a new order. के साथ। यदि चेकआउट का ऑर्डर किसी दूसरी कार्ट के लिए पहले ही भुगतान किया जा चुका है, तो संदेश है Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नई कार्ट माना जाता है जिसके लिए अपना भुगतान ज़रूरी है। ITN भी maintenance mode में काम करता है: OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है।

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

ऑर्डर

Order statuses

No status (missing order): ग्राहक को Autopay पर भेजा गया और उसने भुगतान नहीं किया, भुगतान विफल हुआ, या Autopay ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Order Status After Payment (default Processing): Autopay ने भुगतान की पुष्टि की और राशि व मुद्रा मेल खाती हैं। एक नोट राशि, Autopay लेन-देन ID (remoteID) और भुगतान की तारीख दिखाता है।

On Hold Status (default Pending): Autopay ने ऑर्डर कुल से अलग राशि या मुद्रा बताई। ऑर्डर को भुगतान किया हुआ नहीं माना जाता। Autopay portal में लेन-देन की जाँच करें और उसे मैनुअली पूरा करें या रिफ़ंड करें। इस ऑर्डर के लिए बाद में आई सही सूचना इसे भुगतान किया हुआ चिह्नित कर देती है। वही स्थिति तब भी उपयोग होती है जब किसी ऐसे ऑर्डर के लिए भुगतान आता है जिसकी स्थिति इस बीच आपने बदल दी हो, जैसे रद्द करना: एक नोट आपसे स्टॉक जाँचने और ऑर्डर पूरा करने, या भुगतान रिफ़ंड करने के लिए कहता है।

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

VibeFox Autopay Payment tab

Sales > Orders में Autopay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Autopay Payment टैब में OrderID at Autopay, Service ID, और टेस्ट भुगतानों के लिए Test mode लेबल वाला environment, Amount, Payment attempt की स्थिति, Autopay transaction ID और ऑर्डर के Autopay notes दिखते हैं। यह टैब केवल पढ़ने के लिए है और उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

Refunds

Autopay के माध्यम से रिफ़ंड समर्थित नहीं हैं। Autopay portal में भुगतान रिफ़ंड करें, फिर OpenCart में ऑर्डर को मैनुअली अपडेट करें।

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

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

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

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

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

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

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

Autopay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुने गए environment में Service ID और Shared key हैं, और चेकआउट की मुद्रा Currencies में चुनी गई है। इनमें से कुछ न होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

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

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

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

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

ब्राउज़र में ITN URL METHOD_NOT_ALLOWED दिखाता है: यह सामान्य है। यह URL केवल Autopay से POST अनुरोध स्वीकार करता है।

ऑर्डर एक mismatch नोट के साथ on-hold स्थिति में है: Autopay ने ऑर्डर कुल से अलग राशि या मुद्रा बताई। Autopay portal में लेन-देन जाँचें और ऑर्डर को मैनुअली पूरा करें या रिफ़ंड करें।

एक नोट कहता है कि सूचना लागू नहीं हुई: इस ऑर्डर का भुगतान इस Autopay सेवा से शुरू नहीं हुआ था, जैसे किसी प्रोडक्शन ऑर्डर के लिए टेस्ट सूचना। Autopay portal में लेन-देन जाँचें।

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

ग्राहक को This payment method is not available. Please reload the checkout page. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई या उसके credentials चले गए। ग्राहक चेकआउट को फिर से लोड करता है।

डेवलपर्स के लिए: भुगतान फ़ॉर्म पर हस्ताक्षर करने से पहले, एक्सटेंशन फ़ॉर्म पैरामीटर और ऑर्डर के साथ OpenCart इवेंट wc_ap_payment_params ट्रिगर करता है; इसके द्वारा सेवा, ऑर्डर नंबर, राशि और मुद्रा नहीं बदली जा सकतीं।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Autopay Payment के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ। एक्सटेंशन हमेशा बाकी गेटवे सेटिंग्स को हटा देता है, जिनमें Service IDs और Shared keys शामिल हैं, और लॉग भी। सेटिंग्स रखने का कोई विकल्प नहीं है। OpenCart 4 पर एक्सटेंशन के इवेंट्स और उसका startup action, जो maintenance mode में ITN को गुज़रने देता है, भी हटा दिए जाते हैं। Autopay भुगतान रिकॉर्ड हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Autopay Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

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