VibeFox iPay88 for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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

iPay88 मर्चेंट खाता: Merchant Code और Merchant Key आपका मर्चेंट खाता सक्रिय होने पर iPay88 द्वारा जारी किए जाते हैं। ये iPay88 मर्चेंट पोर्टल में भी दिखाई देते हैं। यदि आप अभी मर्चेंट नहीं हैं, तो iPay88 की वेबसाइट पर आवेदन करें। Merchant Key को गोपनीय रखें: यह भुगतानों पर हस्ताक्षर करती है।

Request URL: आपके वेबसाइट पते को iPay88 में Request URL के रूप में पंजीकृत होना चाहिए। अन्यथा iPay88 पेज पर "Permission not allow" दिखता है।

स्टोर मुद्रा: Malaysia — MYR, और यदि आपके iPay88 खाते पर मल्टी-करेंसी विकल्प सक्षम है तो USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP या THB; Philippines — PHP या USD; Indonesia — IDR; Thailand — THB।

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

इंस्टॉलेशन

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

2. Activate पर क्लिक करें।

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

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

5. अपना iPay88 region चुनें और Merchant Code तथा Merchant Key दर्ज करें (देखें Configuration)।

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > iPay88। फ़ील्ड्स के ऊपर पेज आपको चेतावनी देता है जब Merchant Code या Merchant Key नहीं भरी हो (तब भुगतान विधि चेकआउट पर नहीं दिखती), जब स्टोर मुद्रा चुने गए क्षेत्र में चार्ज नहीं की जा सकती, और जब तक टेस्ट मोड चालू है। भुगतान विधियों की सूची में, जब तक दोनों कुंजियाँ नहीं भरी जातीं, iPay88 को सेटअप की आवश्यकता वाला चिह्नित किया जाता है, और टेस्ट मोड चालू रहने तक टेस्ट मोड बैज दिखाया जाता है।

सामान्य

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

Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: iPay88।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via iPay88 (credit card, online banking, e-wallet)।

iPay88 खाता

iPay88 region: आपके iPay88 मर्चेंट खाते का देश। यह iPay88 भुगतान पेज और उन मुद्राओं को तय करता है जो चार्ज की जा सकती हैं। ऑर्डर हमेशा अपनी मुद्रा में चार्ज होता है। डिफ़ॉल्ट: Malaysia।

Merchant Code: आपका iPay88 Merchant Code, उदाहरण के लिए M01234।

Merchant Key: आपकी iPay88 Merchant Key। यह भुगतान अनुरोधों पर हस्ताक्षर करती है और iPay88 के उत्तरों की पुष्टि करती है। इसे गोपनीय रखें।

Signature type: भुगतान अनुरोधों पर हस्ताक्षर कैसे किए जाएँ। उत्तरों की दोनों प्रारूपों में पुष्टि की जाती है।

भुगतान

Payment method: मलेशियाई PaymentId सूची से एक iPay88 भुगतान विधि पहले से चुनें, या Let the customer choose on the iPay88 page (डिफ़ॉल्ट) छोड़ दें। सूची में Credit Card (MYR), FPX (Online Banking), Maybank2U, Alliance Online, AmBank, RHB Bank, Hong Leong Bank, CIMB Clicks, Web Cash, PayPal (MYR), Credit Card (PHP), Boost, Touch n Go eWallet, GrabPay और ShopeePay शामिल हैं।

Reference prefix: वैकल्पिक। यह iPay88 संदर्भ (RefNo) में ऑर्डर नंबर से पहले जोड़ा जाता है, उदाहरण के लिए SHOP1-। एक ही iPay88 खाते का उपयोग करने वाले हर स्टोर में अलग उपसर्ग सेट करें, ताकि एक स्टोर का उत्तर कभी दूसरे स्टोर के ऑर्डर पर लागू न हो। अक्षर, अंक, "-" और "_" उपयोग किए जा सकते हैं, अधिकतम 10 वर्ण। जो उपसर्ग अंक पर समाप्त होता है, वह सेव करते समय ठीक किया जाता है, क्योंकि ऑर्डर नंबर संदर्भ के अंत से पढ़ा जाता है।

Test mode: Charge a fixed test amount instead of the order total। iPay88 में अलग सैंडबॉक्स नहीं है: टेस्ट भुगतान लाइव iPay88 भुगतान पेज पर छोटी राशि (1.00; IDR 10,000) के साथ किए गए वास्तविक लेन-देन होते हैं। टेस्ट राशि प्राप्त होने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है, और ऑर्डर नोट में यह लिखा जाता है। टेस्ट मोड चालू रहने पर चेकआउट में TEST MODE: only a test amount of ... will be charged. दिखता है। लाइव स्टोर में टेस्ट मोड कभी चालू न छोड़ें। डिफ़ॉल्ट: बंद।

रिस्पॉन्स और बैकएंड URL

प्लगइन हर भुगतान के साथ दोनों URL भेजता है, इसलिए कुछ कॉन्फ़िगर करने की आवश्यकता नहीं है। यदि iPay88 उन्हें माँगे, तो सेटिंग्स के इस भाग से कॉपी करें। वे इस रूप में होते हैं: https://your-site/wc-api/ipay88_p_response/ (Response URL, ग्राहक की वापसी) और https://your-site/wc-api/ipay88_p_backend/ (Backend URL, सर्वर-से-सर्वर सूचना)। इस भाग में आपका वेबसाइट पता भी दिखता है, जिसे iPay88 में Request URL के रूप में पंजीकृत होना चाहिए।

iPay88 के दोनों उत्तरों की जाँच एक ही तरीके से होती है: आपकी Merchant Key से बना हस्ताक्षर, इस स्टोर द्वारा इस ऑर्डर के लिए शुरू किए गए भुगतान का संदर्भ, राशि और मुद्रा। वैध हस्ताक्षर के बिना आए अनुरोध अस्वीकार हो जाते हैं और कभी ऑर्डर नहीं बदलते। backend सूचना को केवल संसाधित होने के बाद ही RECEIVEOK का उत्तर मिलता है; अन्यथा iPay88 उसे दोबारा भेजता है। iPay88 ये भुगतान स्थितियाँ रिपोर्ट करता है:

उन्नत

Debug log: WooCommerce > Status > Logs में, स्रोत wcp_ipay88_payment के साथ Log payment requests and iPay88 responses, बिना व्यक्तिगत डेटा या हस्ताक्षर के। त्रुटियाँ हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted। ऑर्डर स्वयं कभी नहीं हटाए जाते। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से iPay88) और ऑर्डर देता है। ऑर्डर Pending payment में रहता है, और जब आपके क्षेत्र के iPay88 भुगतान पेज पर फ़ॉर्म भेजा जा रहा होता है, तब ग्राहक को Redirecting to iPay88 payment gateway... दिखता है। JavaScript न होने पर ग्राहक Pay Now पर क्लिक करता है। ऑर्डर के आइटम, ग्राहक का नाम, ईमेल और फ़ोन iPay88 को भेजे जाते हैं। iPay88 पेज पर ग्राहक कार्ड, FPX ऑनलाइन बैंकिंग, ई-वॉलेट या आपके खाते द्वारा दी गई किसी अन्य विधि से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब iPay88 हस्ताक्षरित उत्तर से भुगतान की पुष्टि कर दे, चाहे ग्राहक की वापसी पर या backend सूचना से। यदि पुष्टि अभी तक नहीं आई है, तो पेज We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. दिखाता है। लंबित भुगतान के लिए यह Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. दिखाता है।

यदि भुगतान विफल हुआ या रद्द हुआ, तो ग्राहक Pay for order पेज पर पहुँचता है, जहाँ The payment was not completed: और iPay88 का कारण दिखता है, और वह दोबारा भुगतान कर सकता है या कोई दूसरी भुगतान विधि चुन सकता है। यदि उत्तर की पुष्टि नहीं हो सकी, तो ग्राहक को The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. और स्टोर पर वापस जाने का लिंक दिखता है।

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

प्लगइन केवल एकल भुगतान लेता है। इसमें WooCommerce से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन, प्री-ऑथराइज़ेशन और कैप्चर, या आपकी साइट पर कार्ड फ़ील्ड की सुविधा नहीं है। यह भुगतान स्थिति के लिए iPay88 से दोबारा पूछताछ नहीं करता: ऑर्डर केवल iPay88 उत्तर और backend सूचना से अपडेट होते हैं। iPay88 Indonesia API 2.0 (JSON / भुगतान लिंक) का उपयोग नहीं होता।

ऑर्डर

Order statuses

Pending payment: ग्राहक को iPay88 पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या iPay88 ने अभी भुगतान की पुष्टि नहीं की है।

Processing or Completed: भुगतान की पुष्टि हो गई है। WooCommerce भुगतान किए गए ऑर्डर के लिए सामान्य स्थिति सेट करता है। ऑर्डर नोट में iPay88 का TransID, PaymentID, राशि और मुद्रा दिखते हैं। लेन-देन ID iPay88 का TransID है। टेस्ट मोड में दूसरा नोट बताता है कि ऑर्डर कुल की जगह टेस्ट राशि चार्ज हुई।

On hold, pending at iPay88: iPay88 ने भुगतान को लंबित बताया है। जब iPay88 भुगतान की पुष्टि करेगा या विफल घोषित करेगा, तब ऑर्डर अपडेट होगा।

On hold, for review: iPay88 ने ऑर्डर से अलग राशि या मुद्रा वाला सफल भुगतान बताया है, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया गया। ऑर्डर नोट इसका कारण बताता है। iPay88 पोर्टल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Failed: भुगतान विफल हुआ या रद्द हुआ। नोट में iPay88 का कारण दिखता है। ग्राहक दोबारा भुगतान कर सकता है।

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

रिफ़ंड

WooCommerce से रिफ़ंड iPay88 को नहीं भेजे जाते। iPay88 मर्चेंट पोर्टल में भुगतान रिफ़ंड करें और WooCommerce में रिफ़ंड मैन्युअली दर्ज करें।

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

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

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

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

जब लाइसेंस समाप्त होता है, तब भी प्लगइन काम करता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।

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

चेकआउट पर iPay88 नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, Merchant Code और Merchant Key भरे हैं, और स्टोर मुद्रा चुने गए iPay88 region में चार्ज की जा सकती है। कुछ छूटने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment में रहता है: न ग्राहक की वापसी और न backend सूचना वैध हस्ताक्षर के साथ आपके स्टोर तक पहुँची। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_ipay88_payment देखें। जाँचें कि Merchant Key वही है जो iPay88 ने दी थी, और आपकी साइट सेटिंग्स में दिखाए गए Backend URL पर iPay88 के अनुरोध प्राप्त कर सकती है।

iPay88 पेज पर "Permission not allow" दिखता है: आपका वेबसाइट पता iPay88 में Request URL के रूप में पंजीकृत नहीं है। iPay88 से Response and backend URLs भाग में दिखाया गया पता पंजीकृत करने को कहें।

Backend सूचना BAD SIGNATURE का उत्तर देती है: हस्ताक्षर Merchant Key से मेल नहीं खाता। Merchant Key जाँचें।

Backend सूचना NOT CONFIGURED का उत्तर देती है: Merchant Code या Merchant Key सेट नहीं है, इसलिए उत्तर की पुष्टि नहीं हो सकती। iPay88 सूचना दोबारा भेजता है।

Backend सूचना UNKNOWN ORDER का उत्तर देती है: इस स्टोर में इस संदर्भ के लिए कोई iPay88 भुगतान शुरू नहीं हुआ। उदाहरण के लिए, उसी खाते का उपयोग करने वाला कोई दूसरा स्टोर Reference prefix का उपयोग नहीं करता या वही उपसर्ग रखता है।

ऑर्डर On hold में है और राशि या मुद्रा के बारे में नोट है: iPay88 ने ऐसा भुगतान बताया जो ऑर्डर से मेल नहीं खाता, या ऑर्डर रद्द हो चुका था। ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया गया। iPay88 पोर्टल में भुगतान जाँचें और उसे पूरा करें या रिफ़ंड करें।

ग्राहक को "iPay88 cannot accept payments in" और एक मुद्रा दिखती है: ऑर्डर की मुद्रा चुने गए क्षेत्र में चार्ज नहीं की जा सकती। iPay88 Malaysia पर MYR के अलावा अन्य मुद्राओं के लिए आपके iPay88 खाते पर मल्टी-करेंसी विकल्प भी चाहिए।

असली ग्राहकों से केवल 1.00 चार्ज होता है: Test mode चालू है। इसे बंद करें।

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

डेवलपर ipay88_p_payment_url, ipay88_p_supported_currencies, ipay88_p_currency_decimals, ipay88_p_test_amount और ipay88_p_icon फ़िल्टर से भुगतान पेज URL, मुद्राएँ, दशमलव, टेस्ट राशि और आइकन बदल सकते हैं।

अनइंस्टॉल

प्लगइन निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। गेटवे सेटिंग्स, लॉग और ऑर्डर पर सहेजा गया iPay88 डेटा केवल तभी हटाया जाता है जब Delete data on uninstall चालू था। अन्यथा वह बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। ऑर्डर स्वयं कभी नहीं हटाए जाते और अपने भुगतान नोट व लेन-देन ID बनाए रखते हैं।

iPay88 उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन iPay88 से संबद्ध नहीं है और इसे iPay88 द्वारा समर्थित नहीं किया गया है।