VibeFox ECPay for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्षम होना चाहिए।

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

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

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

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

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

इंस्टॉलेशन

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

2. Activate पर क्लिक करें। WooCommerce सक्षम होना चाहिए।

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

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

5. Enable/Disable चालू करें, भुगतान तरीके चुनें और अपने पहले टेस्ट के लिए Test Mode चालू रहने दें। सैंडबॉक्स में आप ECPay टेस्ट कार्ड 4311-9522-2222-2222 (कोई भी भविष्य की एक्सपायरी तारीख, CVV 222, सैंडबॉक्स पेज से 3-D Secure कोड) से भुगतान कर सकते हैं।

6. लाइव भुगतान के लिए MerchantID, HashKey और HashIV डालें (देखें कॉन्फ़िगरेशन) और Test Mode अनचेक करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > ECPay (綠界)। फ़ील्ड्स के ऊपर, जब स्टोर की मुद्रा TWD नहीं है (ऐसे में ECPay चेकआउट पर नहीं दिखता) और जब लाइव मोड में MerchantID, HashKey और HashIV नहीं हैं, तो पेज एक एरर दिखाता है। टेस्ट मोड चालू रहने पर, पेज चेतावनी देता है कि भुगतान पब्लिक टेस्ट मर्चेंट 3002607 के साथ ECPay सैंडबॉक्स में जाते हैं, कोई पैसा नहीं लिया जाता, और पब्लिक सैंडबॉक्स कुंजियाँ जानने वाला कोई भी टेस्ट ऑर्डर कन्फ़र्म कर सकता है, इसलिए असली ऑर्डर स्वीकार करने से पहले टेस्ट मोड बंद करना ज़रूरी है।

सामान्य

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

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

Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला टेक्स्ट है। डिफ़ॉल्ट: Pay securely via ECPay (Credit Card, ATM, CVS, Barcode)।

ECPay खाता

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

Test Mode: Enable sandbox/test mode भुगतान को पब्लिक ECPay टेस्ट मर्चेंट 3002607 के साथ ECPay सैंडबॉक्स (payment-stage.ecpay.com.tw) में भेजता है। कोई असली पैसा नहीं। नीचे दिए क्रेडेंशियल्स का उपयोग केवल टेस्ट मोड बंद होने पर होता है। डिफ़ॉल्ट: चालू।

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

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

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

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

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

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

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

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

भुगतान नोटिफ़िकेशन

ECPay भुगतान के नतीजे आपके स्टोर को भेजता है। यह सेक्शन नोटिफ़िकेशन URL दिखाता है। यह ऐसा दिखता है: https://your-site/wc-api/ecpay_p_callback/। यह URL हर भुगतान के साथ भेजा जाता है, इसलिए ECPay में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है, लेकिन इसे मेंटेनेंस मोड, फ़ायरवॉल या बेसिक ऑथेंटिकेशन के बिना इंटरनेट से पोर्ट 80/443 पर पहुँच योग्य होना चाहिए।

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

उन्नत

Enable Logging: Log payment events and API calls ऑर्डर ID, ट्रेड नंबर, राशियाँ और ECPay रिटर्न कोड को WooCommerce > Status > Logs में लिखता है, सोर्स wcp_ecpay_payment_gateway। कोई कुंजी या ग्राहक डेटा लॉग नहीं होता। डिफ़ॉल्ट: बंद।

Delete Data on Uninstall: Delete all plugin data when uninstalling। इस प्लगइन की सभी सेटिंग्स, लॉग और ऑर्डर मेटाडेटा हटा देता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से ECPay (綠界))। कई तरीके सक्षम होने पर ग्राहक Credit Card, ATM (Virtual Account), CVS (Convenience Store) या Barcode भी चुनता है। टेस्ट मोड चालू रहने के दौरान भुगतान तरीका TEST MODE — ECPay sandbox, no real money is charged. दिखाता है।

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

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब ECPay उसे एक साइन किए गए सर्वर नोटिफ़िकेशन से कन्फ़र्म करता है। अगर कन्फ़र्मेशन आने से पहले ग्राहक ऑर्डर रिसीव्ड पेज पर वापस आता है, तो पेज We have not received a payment confirmation from ECPay for this order yet. If you did not complete the payment, you can try again: दिखाता है, साथ में एक Pay बटन।

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

भुगतान पेज पर हर विज़िट एक नया ECPay ट्रेड नंबर बनाती है, क्योंकि ECPay दोबारा उपयोग किए गए नंबरों को अस्वीकार कर देता है। इससे Pay for order पेज और असफल भुगतान के बाद के पुनर्प्रयास काम करते हैं, और इन नंबरों में से किसी के लिए नोटिफ़िकेशन उस ऑर्डर से मैच हो जाते हैं। एक ऑर्डर में अधिकतम 30 भुगतान प्रयास हो सकते हैं।

ECPay की अपनी तरीका-वार राशि सीमाएँ, जैसे कन्वीनिएंस स्टोर भुगतान के लिए, ECPay पेज पर जाँची जाती हैं, चेकआउट पर नहीं।

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

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

ऑर्डर

ऑर्डर स्टेटस

Pending payment: ग्राहक को ECPay पर भेजा गया था और उसने अभी तक भुगतान नहीं किया है, या नोटिफ़िकेशन अभी तक नहीं आया है।

On hold, waiting for payment: ग्राहक ने ATM, CVS या Barcode चुना और भुगतान की जानकारी प्राप्त की। ऑर्डर नोट में बैंक कोड और वर्चुअल अकाउंट, भुगतान कोड या बारकोड और अंतिम तारीख दिखती है।

Processing: भुगतान की पुष्टि हो गई (WooCommerce का डिफ़ॉल्ट; केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर पूर्ण हो जाते हैं)। ऑर्डर नोट में ECPay TradeNo, भुगतान का प्रकार, राशि और ट्रेड नंबर दिखता है। ट्रांज़ैक्शन ID ही ECPay TradeNo है।

On hold after payment: ECPay ने ऑर्डर से अलग राशि या मुद्रा बताई, लाइव मोड में बदलने के बाद एक सैंडबॉक्स भुगतान आया (कोई असली पैसा नहीं लिया गया), या ऑर्डर कैंसल होने के बाद भुगतान आया। ऑर्डर नोट इसकी वजह बताता है। ECPay बैक-ऑफिस से तुलना करें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें।

Failed: ECPay ने बताया कि हाल का भुगतान प्रयास असफल रहा। नोट में ECPay रिटर्न कोड और मैसेज दिखता है। ग्राहक फिर से कोशिश कर सकता है।

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

रिफ़ंड

WooCommerce से रिफ़ंड उपलब्ध नहीं है। ECPay बैक-ऑफिस में भुगतान रिफ़ंड करें, फिर WooCommerce में रिफ़ंड को मैन्युअली दर्ज करें।

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

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

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

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

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

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

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

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित स्थिति में बना रहता है: 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 दें।

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

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

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

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

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

अनइंस्टॉल

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

ECPay अपने संबंधित मालिक का ट्रेडमार्क है। यह प्लगइन ECPay से संबद्ध नहीं है और न ही ECPay द्वारा अनुमोदित है।