VibeFox ECPay for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: नया ताइवान डॉलर (TWD)। ECPay केवल TWD में भुगतान लेता है, इसलिए भुगतान विधि तभी दिखती है जब ग्राहक TWD में चेकआउट करे। यदि आपके स्टोर में TWD नहीं है, तो उसे System > Localisation > Currencies में कोड TWD के साथ जोड़ें। ECPay दशमलव स्वीकार नहीं करता, इसलिए राशियाँ पूर्ण TWD में भेजी जाती हैं: ऑर्डर का कुल योग निकटतम डॉलर तक पूर्णांकित होता है। पूर्णांकन से बचने के लिए TWD के लिए 0 दशमलव स्थान रखें।

ECPay खाता: लाइव भुगतान के लिए आपको अपने ECPay मर्चेंट खाते का MerchantID, HashKey और HashIV चाहिए, जो ECPay मर्चेंट बैक-ऑफिस (vendor.ecpay.com.tw) से मिलते हैं। परीक्षण के लिए ECPay खाते की आवश्यकता नहीं है।

साइट तक पहुँच: ECPay भुगतान सूचनाएँ भेज सके, इसके लिए आपका स्टोर पोर्ट 80/443 पर HTTP/HTTPS के माध्यम से इंटरनेट से पहुँच योग्य होना चाहिए। साइट के सामने का फ़ायरवॉल या बेसिक ऑथेंटिकेशन इन सूचनाओं को रोक देता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Enable/Disable चालू करें, भुगतान विधियाँ चुनें, और पहले परीक्षणों के लिए Test Mode चालू रखें। Save पर क्लिक करें।

5. लाइव भुगतान के लिए Merchant ID, Hash Key और Hash IV दर्ज करें (देखें कॉन्फ़िगरेशन), Test Mode बंद करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है। हर भुगतान के साथ सूचना URL भेजा जाता है, इसलिए ECPay में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox ECPay Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा TWD नहीं है और कोई सक्षम TWD मुद्रा नहीं है, तो पेज एक त्रुटि दिखाता है (तब ECPay चेकआउट पर नहीं दिखता); यदि TWD केवल दूसरी मुद्रा है, तो चेतावनी दिखाता है (तब ECPay केवल TWD में भुगतान करने वाले ग्राहकों को दिखता है)। लाइव मोड में MerchantID, HashKey या HashIV न होने पर यह त्रुटि दिखाता है। जब तक टेस्ट मोड चालू है, पेज चेतावनी देता है कि भुगतान सार्वजनिक टेस्ट मर्चेंट 3002607 के साथ ECPay सैंडबॉक्स में जाते हैं, कोई पैसा नहीं लिया जाता, और जो भी व्यक्ति सार्वजनिक सैंडबॉक्स कुंजियाँ जानता है, वह टेस्ट ऑर्डर की पुष्टि कर सकता है; इसलिए असली ऑर्डर स्वीकार करने से पहले टेस्ट मोड बंद होना चाहिए। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्ण संख्या होनी चाहिए और Total 0 या उससे अधिक संख्या होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता। अन्य सुधार सेटिंग्स के ऊपर एक संदेश के साथ सेव होते हैं (नीचे के फ़ील्ड देखें)।

ECPay (綠界)

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: ECPay (綠界)। आवश्यक।

Description: वह पाठ जो ग्राहक को Confirm Order चरण पर दिखता है। डिफ़ॉल्ट: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode)।

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

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

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

ECPay खाता

अपना MerchantID, HashKey और HashIV ECPay मर्चेंट बैक-ऑफिस (vendor.ecpay.com.tw) में System development management > System integration settings (系統開發管理 > 系統介接設定) के अंतर्गत खोजें।

Test Mode: भुगतान ECPay सैंडबॉक्स (payment-stage.ecpay.com.tw) पर भेजता है, सार्वजनिक ECPay टेस्ट मर्चेंट 3002607 के साथ। कोई असली पैसा नहीं लिया जाता। नीचे दिए क्रेडेंशियल केवल तभी उपयोग होते हैं जब टेस्ट मोड बंद हो। डिफ़ॉल्ट: चालू। चालू रहते हुए ग्राहक Confirm Order चरण पर TEST MODE — ECPay sandbox, no real money is charged. देखते हैं।

Merchant ID: आपका ECPay Merchant ID (प्रोडक्शन)। टेस्ट मोड में अनदेखा किया जाता है।

Hash Key: आपका ECPay Hash Key (प्रोडक्शन)। टेस्ट मोड में अनदेखा किया जाता है।

Hash IV: आपका ECPay Hash IV (प्रोडक्शन)। टेस्ट मोड में अनदेखा किया जाता है।

चिपकाए गए क्रेडेंशियल में स्पेस और लाइन ब्रेक हर हस्ताक्षर को तोड़ देते हैं, इसलिए सेव करते समय वे हटा दिए जाते हैं और पेज इसकी सूचना देता है। सेव किए गए Hash Key और Hash IV फिर कभी नहीं दिखाए जाते: फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नई वैल्यू दर्ज करें। सेव की गई वैल्यू हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save पर टिक लगाएँ और Save पर क्लिक करें।

भुगतान विकल्प

Enabled Payment Methods: ग्राहकों को दिए जाने वाले भुगतान तरीके। एक से अधिक होने पर ग्राहक Confirm Order चरण पर चुनता है। ATM, CVS और Barcode ऑर्डर तब तक प्रतीक्षारत स्थिति में रहते हैं जब तक ग्राहक भुगतान न करे। कम से कम एक तरीका चुना जाना चाहिए; यदि कोई नहीं चुना गया, तो Credit Card सक्षम हो जाता है और पेज यह बताता है। डिफ़ॉल्ट: Credit Card।

Default Payment Method: पहले से चुना हुआ तरीका। यह सक्षम तरीकों में से एक होना चाहिए; अन्यथा पहला सक्षम तरीका उपयोग होता है। डिफ़ॉल्ट: Credit Card।

Order Prefix: ECPay लेन-देन संख्या (MerchantTradeNo) का उपसर्ग, अधिकतम 5 अक्षर या अंक। सेव करते समय अन्य वर्ण एक संदेश के साथ हटा दिए जाते हैं। जब कई स्टोर एक ही ECPay खाता साझा करते हैं, तब यह उपयोगी है: हर स्टोर को अपना अलग उपसर्ग दें। डिफ़ॉल्ट: EC।

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

ECPay भुगतान के परिणाम और ATM, CVS तथा बारकोड का विवरण आपके स्टोर को भेजता है। इस सेक्शन में Notification URL दिखता है। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_ecpay_payment_gateway/notify, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_ecpay_payment_gateway/payment/wcp_ecpay_payment_gateway.notify जैसा। यह URL हर भुगतान के साथ भेजा जाता है, इसलिए ECPay में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है, लेकिन यह इंटरनेट से पोर्ट 80/443 पर पहुँच योग्य होना चाहिए, और इसके सामने कोई फ़ायरवॉल या बेसिक ऑथेंटिकेशन नहीं होना चाहिए। मेंटेनेंस मोड इसे नहीं रोकता।

हर सूचना की जाँच CheckMacValue हस्ताक्षर से होती है, उस वातावरण (टेस्ट या लाइव) की कुंजियों के साथ जिसमें भुगतान शुरू हुआ था, और उस भुगतान के MerchantID से। वैध हस्ताक्षर के बिना सूचनाएँ अस्वीकार की जाती हैं, और ECPay उन्हें फिर से भेजता है। सूचना के बिना ऑर्डर को कोई स्थिति नहीं मिलती; ऐसी स्थिति में ECPay मर्चेंट बैक-ऑफिस में भुगतान जाँचें।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के (एक गायब ऑर्डर) बनाता है। उसे स्थिति केवल हस्ताक्षरित ECPay सूचना से मिलती है। विफल या बीच में छोड़ा गया कार्ड भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।

Payment accepted: वह स्थिति जब ECPay अपेक्षित राशि के साथ भुगतान की पुष्टि करता है। डिफ़ॉल्ट: Processing।

Awaiting ECPay payment: वह स्थिति जब ग्राहक को ATM वर्चुअल खाता, CVS भुगतान कोड या बारकोड मिलते हैं और वह बाद में ATM या स्टोर पर भुगतान करता है। डिफ़ॉल्ट: Pending।

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

Payment error: वह स्थिति जब प्रतीक्षारत ऑर्डर का नवीनतम ATM, CVS या बारकोड भुगतान विफल हुआ। डिफ़ॉल्ट: Failed।

उन्नत

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

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने से उसकी सेटिंग्स और लॉग हट जाते हैं। ECPay भुगतान रिकॉर्ड हमेशा रहते हैं, इसलिए दोबारा इंस्टॉल करने के बाद भी मौजूदा ऑर्डर काम करते रहते हैं। डिफ़ॉल्ट: बंद।

इम्पोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। Hash Key और Hash IV एक्सपोर्ट नहीं होते।

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए Hash Key और Hash IV सुरक्षित रहते हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से ECPay (綠界))। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to the ECPay payment page to complete the payment. कई तरीके सक्षम होने पर ग्राहक Payment Method के अंतर्गत Credit Card, ATM (Virtual Account), CVS (Convenience Store) या Barcode भी चुनता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है; ECPay विधि का चुनाव उस बटन के ऊपर दिखता है।

जब ग्राहक Confirm Order पर क्लिक करता है, तो पेज Redirecting to ECPay for payment. Please wait... दिखाता है और ग्राहक को ECPay भुगतान पेज पर भेजता है। ऑर्डर का कुल योग उत्पादों के नाम और मात्रा के साथ पूर्ण TWD में भेजा जाता है। ECPay पेज ताइवानी और हांगकांग भाषाओं के लिए पारंपरिक चीनी में, उन भाषाओं के लिए सरलीकृत चीनी, कोरियाई या जापानी में, और अन्य सभी के लिए अंग्रेज़ी में खुलता है, जो ग्राहक की स्टोर भाषा पर निर्भर है।

ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब ECPay हस्ताक्षरित सर्वर सूचना के साथ उसकी पुष्टि कर दे। फिर ऑर्डर को सामान्य OpenCart तरीके से स्थिति मिलती है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं। जब ग्राहक ECPay पेज पर स्टोर पर वापस जाने वाले लिंक पर क्लिक करता है और ऑर्डर की कोई स्थिति पहले से है, तो OpenCart का ऑर्डर सफलता पेज खुलता है। यह भुगतान किए गए ऑर्डर के लिए Your ECPay payment has been received. दिखाता है, होल्ड पर चल रहे ऑर्डर के लिए Your ECPay payment was received and is being reviewed by the store. दिखाता है, और प्रतीक्षारत ATM, CVS या Barcode ऑर्डर के लिए भुगतान निर्देश दिखाता है। यदि सूचना अभी तक नहीं पहुँची है, तो Payment confirmation पेज दिखाता है: We have not received a payment confirmation from ECPay for this order yet. Your order will be confirmed as soon as ECPay confirms the payment. साथ में Check again और Back to checkout बटन होते हैं। यदि ECPay ने बताया कि भुगतान विफल रहा, तो ग्राहक The payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर वापस आ जाता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है।

ATM, CVS और Barcode के लिए ग्राहक को पहले भुगतान का विवरण मिलता है। ऑर्डर को Awaiting ECPay payment स्थिति मिलती है, और बैंक कोड और वर्चुअल खाता, कन्वीनियंस स्टोर भुगतान कोड या बारकोड, राशि और Pay before की अंतिम तिथि, ऑर्डर सफलता पेज पर ECPay payment instructions के अंतर्गत दिखाए जाते हैं, और लॉग इन ग्राहक के लिए उसके ग्राहक खाते की ऑर्डर जानकारी में भी दिखते हैं। जब ग्राहक भुगतान करता है, तो ECPay एक और सूचना भेजता है और ऑर्डर भुगतान किया हुआ चिह्नित हो जाता है। भुगतान निर्देश OpenCart ईमेल में नहीं जोड़े जाते।

हर प्रयास एक नई ECPay लेन-देन संख्या बनाता है, क्योंकि ECPay दोबारा उपयोग की गई संख्याएँ अस्वीकार करता है। इसलिए विफल भुगतान के बाद फिर से प्रयास काम करते हैं, और यदि ग्राहक ब्राउज़र में वापस जाकर फिर से Confirm Order पर क्लिक करता है, तो नया प्रयास शुरू होता है। एक कार्ट में अधिकतम 30 भुगतान प्रयास हो सकते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए पुनः प्रयास उसी ऑर्डर का नए लेन-देन नंबर के साथ भुगतान करता है; जब उसी कार्ट का कोई अन्य ऑर्डर पहले से भुगतान किया हुआ हो या ATM या CVS भुगतान की प्रतीक्षा में हो, तब ग्राहक सफलता पेज पर जाता है और कोई नया भुगतान शुरू नहीं होता।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका ATM या CVS भुगतान विफल हुआ, या आपने उसे रद्द किया), तो ग्राहक चेकआउट पर Your previous order was cancelled or its payment failed. Please confirm the order again. संदेश के साथ लौटता है, और अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है। यदि वह ऑर्डर पहले से भुगतान हो चुका है (या ATM या कन्वीनियंस स्टोर भुगतान की प्रतीक्षा में है), पर उसके बाद कार्ट बदल गया है (नई मात्रा सहित), तो संदेश है Your previous order is already paid (or awaits its ATM / convenience store payment). Please confirm the order again: the cart will be paid with a new order. भुगतान किया हुआ ऑर्डर कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश देखता है, जैसे पूर्णांकन के बाद कुल राशि 1 TWD से कम होने पर The order total is too small for ECPay. ECPay की अपनी हर विधि की राशि-सीमाएँ ECPay पेज पर जाँची जाती हैं, चेकआउट पर नहीं।

जो भुगतान पहले से शुरू हो चुके हैं, उनकी सूचनाएँ भुगतान विधि बंद करने के बाद भी स्वीकार की जाती हैं, और ग्राहक पहले से दिए गए ऑर्डरों के भुगतान निर्देश देखता रहता है।

यह एक्सटेंशन केवल ECPay पेज पर एकमुश्त भुगतान लेता है। इसमें OpenCart से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान (定期定額), किस्तें, Apple Pay, ई-इनवॉइस या लॉजिस्टिक्स नहीं हैं, और सर्वर-साइड स्थिति जाँच भी नहीं है: यदि आपका स्टोर सूचना प्राप्त नहीं कर पाता, तो ECPay मर्चेंट बैक-ऑफिस में भुगतान जाँचें।

ऑर्डर

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

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

Awaiting ECPay payment (default Pending): ग्राहक ने ATM, CVS या Barcode चुना और भुगतान का विवरण पाया। नोट में बैंक कोड और वर्चुअल खाता, भुगतान कोड या बारकोड, और समय-सीमा दिखती है।

Payment accepted (default Processing): भुगतान की पुष्टि हो गई। नोट में ECPay TradeNo, भुगतान का प्रकार, राशि और लेन-देन संख्या दिखती है (सैंडबॉक्स भुगतानों के लिए टेस्ट मोड का चिह्न भी)।

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

Payment error (default Failed): ECPay ने बताया कि प्रतीक्षारत ऑर्डर का नवीनतम ATM, CVS या बारकोड भुगतान विफल रहा। नोट में ECPay रिटर्न कोड और संदेश दिखता है।

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

नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox ECPay Payment Gateway टैब

Sales > Orders में ECPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox ECPay Payment Gateway टैब ऑर्डर का हर भुगतान प्रयास सूचीबद्ध करता है: सैंडबॉक्स प्रयासों के लिए Test mode लेबल के साथ MerchantTradeNo, विधि, TWD में राशि, स्थिति, ECPay TradeNo, भुगतान का प्रकार और तिथि, ECPay रिटर्न कोड और आरंभ तिथि। उसके नीचे ऑर्डर के ECPay notes होते हैं। होल्ड स्थिति वाले ऑर्डर के लिए यह टैब आपको ECPay मर्चेंट बैक-ऑफिस से मिलान करने की याद दिलाता है। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

OpenCart से रिफ़ंड उपलब्ध नहीं हैं। ECPay मर्चेंट बैक-ऑफिस में भुगतान रिफ़ंड करें, फिर OpenCart में ऑर्डर की स्थिति मैन्युअली अपडेट करें। Sales > Returns में उत्पाद वापसी ECPay के ज़रिए पैसे वापस नहीं भेजती।

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

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

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

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

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

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

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

ECPay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, ग्राहक TWD में चेकआउट करता है, और लाइव मोड में Merchant ID, Hash Key और Hash IV सेट हैं। सेटिंग्स पेज मुद्रा और लाइव क्रेडेंशियल के लिए संदेश दिखाता है। साथ ही जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: ECPay सूचना आपके स्टोर तक नहीं पहुँची (साइट बंद, फ़ायरवॉल, बेसिक ऑथेंटिकेशन)। ECPay कई बार फिर से प्रयास करता है। आप ECPay मर्चेंट बैक-ऑफिस में भी लेन-देन जाँच सकते हैं। एक्सटेंशन को मिली सूचनाएँ देखने के लिए Enable Logging चालू करें; अस्वीकृत सूचनाएँ हर हाल में त्रुटियों के रूप में दर्ज होती हैं।

सूचना 0|CheckMacValue verification failed से उत्तर देती है: Hash Key या Hash IV आपके ECPay खाते से मेल नहीं खाते, या भुगतान दूसरे वातावरण में शुरू हुआ था। उन्हें ECPay मर्चेंट बैक-ऑफिस से दोबारा कॉपी करें।

सूचना 0|MerchantID mismatch से उत्तर देती है: सूचना किसी और ECPay मर्चेंट की है, जिससे भुगतान शुरू हुआ था उससे अलग।

सूचना 0|Order not found से उत्तर देती है: लेन-देन संख्या इस स्टोर द्वारा जारी नहीं की गई, उदाहरण के लिए जब कई स्टोर एक ही ECPay खाता साझा करते हैं। हर स्टोर को अपना Order Prefix दें।

सूचना 0|Retry से उत्तर देती है: उसी समय कोई और सूचना ऑर्डर को प्रोसेस कर रही थी, या ऑर्डर की स्थिति सेट नहीं हो सकी। ECPay सूचना फिर से भेजता है। कारण देखने के लिए Enable Logging चालू करें।

सूचना URL 0|Method not allowed in the browser दिखाता है: यह सामान्य है। यह URL केवल ECPay के अनुरोध स्वीकार करता है।

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

ग्राहक को The order total is too small for ECPay. दिखता है: पूर्णांकन के बाद ऑर्डर का कुल योग 1 TWD से कम है और ECPay से भुगतान नहीं हो सकता।

ग्राहक को Too many payment attempts for this order दिखता है: कार्ट 30 भुगतान प्रयासों तक पहुँच गया। ग्राहक से नया कार्ट शुरू करने के लिए कहें।

ऑर्डर होल्ड स्थिति में है: VibeFox ECPay Payment Gateway टैब के नोट पढ़ें (ऑर्डर स्थितियाँ देखें), ECPay मर्चेंट बैक-ऑफिस से मिलान करें, फिर ऑर्डर पूरा करें या वहीं भुगतान रिफ़ंड करें।

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

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox ECPay Payment Gateway के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन के OpenCart इवेंट भी हटाए जाते हैं (OpenCart 4 पर उसका स्टार्टअप ऐक्शन भी, जो मेंटेनेंस मोड में सूचना को आगे जाने देता है)। यदि Delete Data on Uninstall चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, क्रेडेंशियल, भुगतान विकल्प, लॉगिंग) और लॉग हट जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। ECPay भुगतान रिकॉर्ड हमेशा रखे जाते हैं, इसलिए पुराने भुगतानों की देर से आने वाली सूचनाएँ दोबारा इंस्टॉल करने के बाद भी जाँची जाती हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

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

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