VibeFox iPay88 for OpenCart — सहायता

आवश्यकताएँ

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

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

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

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

मुद्रा: मलेशिया — MYR, और यदि आपके iPay88 खाते में multi-currency विकल्प सक्षम है तो USD, SGD, AUD, CAD, EUR, GBP, HKD, CNY, TWD, INR, IDR, PHP या THB; फ़िलीपींस — PHP या USD; इंडोनेशिया — IDR; थाईलैंड — THB। यदि ग्राहक के चेकआउट की मुद्रा आपके क्षेत्र में चार्ज नहीं हो सकती, तो चेकआउट पर भुगतान विधि छिप जाती है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी iPay88 region चुनें, Merchant Code और Merchant Key दर्ज करें, Enable/Disable चालू करें और Save पर क्लिक करें।

5. सेटअप जाँचने के लिए Test mode चालू रखकर एक भुगतान करें, फिर test mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox iPay88 Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज Enter the iPay88 Merchant Code and Merchant Key — until then the payment method is not shown at checkout. दिखाता है जब तक कोई कुंजी गायब हो, स्टोर की डिफ़ॉल्ट मुद्रा चुने गए क्षेत्र में चार्ज न हो सके तो चेतावनी (तब इस मुद्रा के लिए चेकआउट पर भुगतान विधि छिप जाती है), और टेस्ट मोड चालू होने पर चेतावनी। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

iPay88

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely via iPay88 (credit card, online banking, e-wallet).

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

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

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

iPay88 खाता

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

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

Merchant Key: आपकी iPay88 Merchant Key। यह भुगतान अनुरोधों पर हस्ताक्षर करती है और iPay88 के उत्तरों की पुष्टि करती है। इसे गोपनीय रखें। सेव करते समय शुरू और अंत के खाली स्थान हटा दिए जाते हैं। सहेजी गई कुंजी फिर कभी नहीं दिखाई जाती: फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखता है। केवल बदलना हो तभी नया मान दर्ज करें। सहेजी गई कुंजी हटाने के लिए Clear the saved Merchant Key on save पर टिक करें और Save पर क्लिक करें।

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 वर्ण। सेव करते समय अन्य वर्ण हटा दिए जाते हैं, और अंक पर समाप्त होने वाले प्रीफ़िक्स के अंत में "-" जोड़ा जाता है, क्योंकि ऑर्डर नंबर RefNo के अंत से पढ़ा जाता है। तब पेज सहेजे गए मान के साथ चेतावनी देता है।

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

Response और backend URL

एक्सटेंशन हर भुगतान के साथ दोनों URL भेजता है, इसलिए कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। यदि iPay88 इन्हें माँगे, तो इस सेक्शन से कॉपी करें। OpenCart 3 पर ये इस तरह दिखते हैं: https://your-store/index.php?route=extension/payment/wcp_ipay88_payment/back (Response URL, ग्राहक की वापसी) और https://your-store/index.php?route=extension/payment/wcp_ipay88_payment/backend (Backend URL, सर्वर-से-सर्वर सूचना), OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_ipay88_payment/payment/wcp_ipay_88payment.back और https://your-store/index.php?route=extension/wcp_ipay88_payment/payment/wcp_ipay_88payment.backend। सेक्शन आपकी वेबसाइट का पता भी दिखाता है, जो iPay88 में request URL के रूप में पंजीकृत होना चाहिए।

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

ऑर्डर

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

Order Status After Payment: अपेक्षित राशि और मुद्रा के साथ सफल भुगतान (iPay88 स्थिति 1)। डिफ़ॉल्ट: Processing।

Awaiting Payment Status: प्रतीक्षारत भुगतान (स्थिति 6), उदाहरण के लिए ATM या वर्चुअल अकाउंट ट्रांसफ़र जो ग्राहक ने अभी तक नहीं किया। जब iPay88 उसे पुष्ट करता है, तब ऑर्डर भुगतान के बाद की स्थिति पर चला जाता है। डिफ़ॉल्ट: Pending।

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

Failed Payment Status: प्रतीक्षारत भुगतान (स्थिति 6) जिसे iPay88 ने बाद में विफल (स्थिति 0) रिपोर्ट किया। डिफ़ॉल्ट: Failed।

Cancelled Order Status: आपका स्टोर रद्द ऑर्डरों के लिए जो स्थिति उपयोग करता है। ऐसे ऑर्डर के लिए मिला भुगतान उसे भुगतान-पूर्ण चिह्नित करने के बजाय समीक्षा स्थिति में डालता है। एक्सटेंशन यह स्थिति स्वयं कभी नहीं लगाता। डिफ़ॉल्ट: Canceled।

उन्नत

Debug log: भुगतान अनुरोधों और iPay88 उत्तरों को OpenCart के logs फ़ोल्डर (storage/logs) में ipay88_p_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कोई व्यक्तिगत डेटा, Merchant Key या हस्ताक्षर लॉग नहीं होते। त्रुटियाँ और चेतावनियाँ स्विच बंद होने पर भी हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और iPay88 भुगतान रिकॉर्ड कभी नहीं हटते, इसलिए पुराने भुगतान का देर से आया उत्तर दोबारा इंस्टॉल करने के बाद भी प्रोसेस होता है। डिफ़ॉल्ट: बंद।

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

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

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई Merchant Key बनी रहती है।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से iPay88)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो चरण Redirecting to iPay88 payment gateway... और Please do not close this window. दिखाता है, जब तक हस्ताक्षरित फ़ॉर्म आपके क्षेत्र के iPay88 भुगतान पेज पर भेजा जा रहा हो। यदि ब्राउज़र उसे अपने-आप न भेजे, तो ग्राहक Pay Now पर क्लिक करता है। एक्सटेंशन ऑर्डर कुल को ऑर्डर की मुद्रा में (टेस्ट मोड में परीक्षण राशि), उत्पादों के नाम, और ग्राहक का नाम, ईमेल और फ़ोन भेजता है। iPay88 पेज पर ग्राहक कार्ड, FPX ऑनलाइन बैंकिंग, ई-वॉलेट या आपके खाते द्वारा दी गई किसी अन्य विधि से भुगतान करता है।

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। डिफ़ॉल्ट रूप से OpenCart 4 चेकआउट पर फ़ोन नंबर नहीं माँगता, पर iPay88 को इसकी ज़रूरत होती है: यदि ऑर्डर में फ़ोन नहीं है, तो पुष्टि चरण पर Phone फ़ील्ड दिखता है, जिसके साथ iPay88 requires the contact number of the payer. लिखा होता है। नंबर के बिना ग्राहक को iPay88 requires a phone number. Please enter your phone number and try again. दिखता है। दर्ज किया गया नंबर अगले प्रयास के लिए सुरक्षित रहता है।

ऑर्डर तभी भुगतान-पूर्ण चिह्नित होता है जब iPay88 उसे हस्ताक्षरित उत्तर से पुष्ट करे, या तो ग्राहक की वापसी पर या बैकएंड सूचना से। फिर ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। सफल भुगतान के बाद ग्राहक को Your iPay88 payment has been received. के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। प्रतीक्षारत भुगतान के लिए पेज पर Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed. दिखता है। समीक्षा में चल रहे ऑर्डर के लिए We have received a payment notification from iPay88 and are reviewing it. We will contact you if anything is needed. दिखता है। जब प्रतीक्षारत भुगतान बाद में पुष्ट या विफल होता है, तब OpenCart ग्राहक को नई स्थिति की सूचना देता है।

यदि उसी समय बैकएंड सूचना से ऑर्डर पुष्ट हो रहा हो, तो ग्राहक को We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. दिखता है, साथ में Check again और Back to checkout बटन।

यदि भुगतान विफल हुआ या रद्द हुआ, तो ऑर्डर बिना स्थिति के रहता है और कार्ट सुरक्षित रहता है। ग्राहक The payment was not completed: और iPay88 का कारण दिखाने वाले चेकआउट पर लौटता है, उसके बाद You can try again or choose another payment method. OpenCart 4 पर यह संदेश चेकआउट पेज के ऊपर दिखता है। OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, और इस तरह नया RefNo भी; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए ग्राहक वही ऑर्डर फिर से चुकाता है। उसी ऑर्डर के फिर से प्रयास में वही RefNo उपयोग होता है। यदि उत्तर सत्यापित नहीं हो सकता, तो ग्राहक को 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. और Return to the store बटन दिखता है।

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और This payment method is temporarily unavailable. Please choose another payment method. (कुंजियाँ गायब हैं या कुल शून्य है) या iPay88 cannot accept payments in ... Please choose another payment method. (क्षेत्र में मुद्रा चार्ज नहीं हो सकती) देखता है। एक कार्ट का भुगतान केवल एक बार होता है: यदि उसी कार्ट का कोई अन्य ऑर्डर पहले से भुगतान किया हुआ है या प्रतीक्षारत भुगतान की प्रतीक्षा में है, तो दूसरा भुगतान फ़ॉर्म नहीं बनता और ग्राहक ऑर्डर सफलता पेज पर भेजा जाता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया हो (उदाहरण के लिए कोई लंबित ट्रांसफ़र विफल हुआ या आपने ऑर्डर रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है। यदि ऑर्डर पहले ही दिया जा चुका है और कार्ट बदल गया है, तो संदेश है Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर भुगतान करता है।

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

ऑर्डर

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

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

Order Status After Payment (default Processing): iPay88 ने अपेक्षित राशि और मुद्रा के साथ सफल भुगतान रिपोर्ट किया। एक नोट TransID, PaymentID, राशि और मुद्रा दिखाता है। टेस्ट मोड में दूसरा नोट बताता है कि ऑर्डर कुल के बजाय परीक्षण राशि चार्ज हुई।

Awaiting Payment Status (default Pending): iPay88 ने भुगतान को प्रतीक्षारत रिपोर्ट किया। जब iPay88 उसे पुष्ट करता है तब ऑर्डर Order Status After Payment पर जाता है, या विफल होने पर Failed Payment Status पर।

Failed Payment Status (default Failed): एक प्रतीक्षारत भुगतान जो बाद में विफल हुआ। नोट में iPay88 का कारण दिखता है। ग्राहक नया ऑर्डर दे सकता है।

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

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

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

VibeFox iPay88 Payment टैब

Sales > Orders में iPay88 से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox iPay88 Payment टैब RefNo, TransId, Status, Requested राशि, Amount received, PaymentId, AuthCode, Error और Region दिखाता है, परीक्षण भुगतानों के लिए TEST MODE बैज, और ऑर्डर के iPay88 notes। यह टैब एक्सटेंशन तक पहुँच वाले उपयोगकर्ताओं को दिखता है।

रिफ़ंड

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

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

एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox iPay88 Payment, Extensions > Extensions > Payments > VibeFox iPay88 Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-ipay88 वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना iPay88 चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को 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 की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

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

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: न ग्राहक की वापसी, न बैकएंड सूचना सही हस्ताक्षर के साथ आपके स्टोर तक पहुँची। Log फ़ील्ड देखें: त्रुटियाँ हमेशा लॉग होती हैं। जाँचें कि Merchant Key बिल्कुल वही है जो iPay88 ने दी है, और आपका सर्वर सेटिंग्स में दिखाए गए Backend URL पर iPay88 के अनुरोधों को स्वीकार करता है।

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

बैकएंड सूचना BAD SIGNATURE का उत्तर देती है: हस्ताक्षर Merchant Key से मेल नहीं खाता। Merchant Key जाँचें। कुछ नहीं बदला गया।

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

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

बैकएंड सूचना RETRY का उत्तर देती है: ऑर्डर (या उसी कार्ट का कोई और ऑर्डर) उसी समय ग्राहक की वापसी या किसी अन्य सूचना से पुष्ट हो रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। iPay88 सूचना फिर से भेजता है।

Backend URL ब्राउज़र में BAD REQUEST दिखाता है: यह सामान्य है। यह URL केवल iPay88 के हस्ताक्षरित अनुरोध स्वीकार करता है।

ऑर्डर On Hold (Review) Status में है: iPay88 ने ऐसा भुगतान रिपोर्ट किया जो ऑर्डर से मेल नहीं खाता, या ऑर्डर रद्द हो चुका था। VibeFox iPay88 Payment टैब के नोट पढ़ें और iPay88 पोर्टल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

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

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

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox iPay88 Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में iPay88 के उत्तरों को आगे जाने देता है)। यदि Delete data on uninstall चालू है, तो अन्य सेटिंग्स (शीर्षक, विवरण, क्षेत्र, Merchant Code और Key, signature type, भुगतान विधि, प्रीफ़िक्स, टेस्ट मोड, debug log स्विच) और लॉग हटा दिए जाते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। ऑर्डरों के iPay88 भुगतान रिकॉर्ड हमेशा रखे जाते हैं। ऑर्डर कभी नहीं हटते और अपने भुगतान नोट बनाए रखते हैं।

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

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