VibeFox Hubtel for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या OpenCart 4.0.2 और उसके बाद के संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: cURL एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण।
मुद्रा: केवल घाना सेडी (GHS)। जब ऑर्डर की मुद्रा GHS न हो, तब चेकआउट पर भुगतान विधि छिपी रहती है। GHS मुद्रा के दशमलव स्थान 2 पर रखें, क्योंकि Hubtel पूर्ण पेसेवा में शुल्क लेता है।
Hubtel खाता: API कुंजियों (API ID और API Key) और मर्चेंट खाता नंबर (POS Sales ID) वाला एक Hubtel बिज़नेस खाता। कुंजियाँ bo.hubtel.com पर Hubtel बिज़नेस डैशबोर्ड में Programmable keys के अंतर्गत हैं।
IP व्हाइटलिस्टिंग: Hubtel अपना Transaction Status API केवल व्हाइटलिस्टेड सर्वर IP पतों से उत्तर देता है। Hubtel (अपने खाता प्रबंधक या support@hubtel.com) से अनुरोध करें कि वे आपके वेब सर्वर का सार्वजनिक IP पता व्हाइटलिस्ट करें। तब तक भुगतान की पुष्टि नहीं हो सकती और ऑर्डर बिना स्टेटस के रहते हैं।
कोई टेस्ट वातावरण नहीं: Hubtel के पास कोई सार्वजनिक सैंडबॉक्स नहीं है। सभी भुगतान वास्तविक होते हैं।
Cron: पृष्ठभूमि भुगतान जाँच के लिए, अपने सर्वर पर एक cron जॉब की सिफ़ारिश की जाती है जो हर 5 मिनट में एक्सटेंशन का cron URL कॉल करे (देखें Configuration)।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
यह डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_hubtel_pay-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_hubtel_pay.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_hubtel_pay-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर की जगह आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Hubtel Pay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. API ID, API Key और मर्चेंट खाता नंबर (POS Sales ID) दर्ज करें।
5. Hubtel सपोर्ट से अनुरोध करें कि Transaction Status API के लिए आपके सर्वर का IP व्हाइटलिस्ट करें।
6. Payment confirmation सेक्शन में दिखाया गया cron URL अपने सर्वर के cron में जोड़ें।
7. Enable/Disable चालू करें और Save पर क्लिक करें। कॉलबैक URL हर भुगतान के साथ Hubtel को भेजा जाता है, इसलिए Hubtel डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_hubtel_pay.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 फ़ाइल के नाम से एक्सटेंशन कोड लेता है, और नाम बदला गया पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में इसी पेज पर पैकेज दिखाई देता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Hubtel Pay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी, Hubtel क्रेडेंशियल और cron को OpenCart 3 के चरण 3 से 7 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल callback URL और cron URL अलग हैं (देखें Payment confirmation)।
नया इंस्टॉल भुगतान विधि बंद होने के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर, यदि API ID, API Key या मर्चेंट खाता नंबर नहीं भरा है, या स्टोर की डिफ़ॉल्ट मुद्रा GHS नहीं है, तो पेज आपको चेतावनी देता है। दोनों ही स्थितियों में चेकआउट पर Hubtel छिपा दिया जाता है। यदि GHS मुद्रा 2 से अधिक दशमलव का उपयोग करती है, तो भी पेज चेतावनी देता है (इसे System > Localisation > Currencies में सेट करें)। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं होना चाहिए (Enter a title for the payment method (1 to 128 characters).), Sort Order एक पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और ज़ोन (Geo Zone) तथा ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा कुछ भी सेव नहीं होता। यदि क्रेडेंशियल के बिना भुगतान विधि चालू की जाती है, तो सेटिंग्स चेतावनी के साथ सेव होती हैं।
Hubtel
Enable/Disable: Enable Hubtel payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। यही ऑर्डर में सेव होने वाला भुगतान विधि का नाम भी है। डिफ़ॉल्ट: Mobile Money or card (Hubtel)। अनिवार्य।
Description: Confirm Order चरण पर पुष्टि बटन के ऊपर, Mobile Money और कार्ड आइकन के साथ ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay with MTN MoMo, Telecel Cash, AirtelTigo Money or a Visa/Mastercard card. You will be redirected to Hubtel to complete the payment.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Hubtel की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या डालें।
Geo Zone: Hubtel केवल चयनित ज़ोन (Geo Zone) में स्थित भुगतान पतों के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo Zones System > Localisation > Geo Zones में सेट होते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की राशि, जिस तक पहुँचने के बाद ही Hubtel की पेशकश होगी। कोई न्यूनतम राशि न चाहिए तो खाली छोड़ें।
Hubtel API क्रेडेंशियल
अपने Hubtel बिज़नेस डैशबोर्ड से API ID और API Key कॉपी करें: bo.hubtel.com > Programmable keys (इस सेक्शन में वहाँ का लिंक है)। मर्चेंट खाता नंबर आपके Hubtel खाते का POS Sales ID है। इस सेक्शन में IP व्हाइटलिस्टिंग की सूचना भी दोबारा दी गई है।
API ID (Client ID): आपकी Hubtel प्रोग्रामेबल कुंजियों का API ID।
API Key (Client Secret): आपकी Hubtel प्रोग्रामेबल कुंजियों की API Key। इसे गोपनीय रखें। सेव की गई कुंजी फिर कभी नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। बदलना हो तभी नया मान लिखें। सेव की गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear saved API Key पर टिक करें और Save पर क्लिक करें।
मर्चेंट खाता नंबर (POS Sales ID): भुगतान इसी Hubtel खाते में जमा होते हैं और इसी से मिलाए जाते हैं।
भुगतान पुष्टि
Callback URL: कॉलबैक आपके स्टोर को बताता है कि भुगतान हो गया है। यह URL हर भुगतान के साथ Hubtel को भेजा जाता है, इसलिए Hubtel डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_hubtel_pay/callback, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.callback। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह इंटरनेट से पहुँच योग्य होना चाहिए: कोई पासवर्ड सुरक्षा या फ़ायरवॉल नहीं होना चाहिए जो Hubtel को रोके। स्टोर मेंटेनेंस मोड में होने पर भी कॉलबैक काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन एक स्टार्टअप एक्शन जोड़ता है, जो कॉलबैक, cron URL और Hubtel से ग्राहक की वापसी को जाने देता है।
Hubtel के कॉलबैक साइन नहीं किए जाते। एक्सटेंशन कॉलबैक से केवल भुगतान संदर्भ (reference) लेता है; यह संदर्भ आपके स्टोर के किसी भुगतान का होना चाहिए। स्टेटस, राशि और ट्रांज़ैक्शन ID हमेशा Hubtel Transaction Status API से आते हैं। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब यह API भुगतान और उसकी राशि की पुष्टि कर दे।
पृष्ठभूमि भुगतान जाँच (cron): एक गुप्त टोकन वाला cron URL, जो एक्सटेंशन इंस्टॉल होने पर बनता है। इसे अपने सर्वर के cron से हर 5 मिनट में कॉल करें, उदाहरण के लिए curl से। बिना पुष्टि वाले भुगतान तब अपने-आप Hubtel के साथ दोबारा जाँचे जाते हैं: ग्राहक को Hubtel भेजे जाने के 20 मिनट बाद, यदि भुगतान अब भी बकाया है तो एक घंटे बाद एक बार और, और जब Hubtel तक पहुँच नहीं हुई हो तो बढ़ते अंतराल के साथ अधिकतम 5 बार। OpenCart 4 पर cron URL का रूट extension/wcp_hubtel_pay/payment/wcp_hubtel_pay.cron है, न कि extension/payment/wcp_hubtel_pay/cron; उसे ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। URL को निजी रखें। यह URL OK checked=0 जैसी एक छोटी पंक्ति से उत्तर देता है।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Hubtel भुगतान की पुष्टि कर दे। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order status after payment: GHS में ठीक ऑर्डर राशि के भुगतान की पुष्टि होने के बाद सेट होने वाला स्टेटस। डिफ़ॉल्ट: Processing।
Hubtel payment on hold status: वह स्टेटस जो तब सेट होता है जब Hubtel ऑर्डर कुल से अलग भुगतान राशि की रिपोर्ट करता है, या ऑर्डर GHS में नहीं है। ऑर्डर इतिहास का एक नोट इसे समझाता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
उन्नत
Debug log: API कॉल और कॉलबैक को OpenCart लॉग फ़ोल्डर (storage/logs) में hubtel_p_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB होने पर इसे hubtel_p_debug.old.log.php में ले जाया जाता है। कुंजियाँ और ग्राहक डेटा लॉग नहीं होते। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं, भले ही यह विकल्प बंद हो। डिफ़ॉल्ट: बंद।
Log: लॉग का वर्तमान आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से इस एक्सटेंशन की सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के लिए सेव किए गए Hubtel भुगतान प्रयास हमेशा बने रहते हैं। डिफ़ॉल्ट: बंद।
इम्पोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API Key एक्सपोर्ट नहीं होती।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई API Key बनी रहती है।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Mobile Money or card (Hubtel))। Confirm Order चरण पर ग्राहक को आइकन और आपका विवरण दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, पर अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन GHS में ऑर्डर कुल के लिए Hubtel चेकआउट बनाता है और ग्राहक को Hubtel के भुगतान पेज पर भेज देता है। वहाँ भुगतान Order #, ऑर्डर नंबर और आपके स्टोर के नाम के साथ दिखता है। Hubtel पेज पर ग्राहक MTN MoMo, Telecel Cash, AirtelTigo Money, Visa या Mastercard कार्ड, या GhQR से भुगतान करता है। Confirm Order पर हर क्लिक अपने संदर्भ के साथ एक नया भुगतान प्रयास बनाता है, और पुराने Hubtel पेज भी भुगतान योग्य रहते हैं।
OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Hubtel इसकी Transaction Status API के माध्यम से पुष्टि कर दे: कॉलबैक से, ग्राहक के लौटने पर की गई जाँच से, पृष्ठभूमि जाँच से, या ऑर्डर पेज के बटन से। एक साथ आए कॉलबैक और वापसी को एक-एक करके संभाला जाता है, इसलिए भुगतान कभी दो बार लागू नहीं होता। इसके बाद ऑर्डर OpenCart के मानक तरीके से स्टेटस प्राप्त करता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर होल्ड पर रखा गया हो, तो पेज Your Hubtel payment was received and is being reviewed by the store. We will contact you if anything is needed. दिखाता है।
यदि ग्राहक के लौटने तक Hubtel ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज We are waiting for Hubtel to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. दिखाता है, साथ में Check again और Back to checkout बटन। Hubtel के पुष्टि करते ही ऑर्डर को स्टेटस मिल जाता है। यदि Hubtel ने इस भुगतान प्रयास को पहले ही विफल बताया है, तो ग्राहक The Hubtel payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट जाता है। कार्ट सुरक्षित रहता है, और ऑर्डर बिना स्टेटस के रहता है।
यदि ग्राहक Hubtel पेज पर Cancel दबाता है, तो एक्सटेंशन पहले जाँचता है कि क्या भुगतान फिर भी हो गया है। यदि नहीं हुआ, तो ग्राहक The Hubtel payment was cancelled. You can try again or choose another payment method. के साथ चेकआउट पर लौट जाता है। कार्ट सुरक्षित रहता है। रद्द किए गए Hubtel पेज के ज़रिए बाद में किया गया भुगतान अब भी स्वीकार होता है।
OpenCart 4 पर रद्द या विफल भुगतान के संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए रद्द करने या भुगतान विफल होने के बाद ग्राहक नए भुगतान प्रयास के साथ वही ऑर्डर चुकाता है। किसी नए प्रयास से पहले एक्सटेंशन इस ऑर्डर और उसी कार्ट के पिछले ऑर्डरों (पिछले 24 घंटे) के अपुष्ट प्रयासों के बारे में Hubtel से पूछता है। यदि उनमें से कोई भुगतान किया हुआ निकलता है, तो वह भुगतान लागू होता है और ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर जाता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नई कार्ट माना जाता है जिसे अपने भुगतान की ज़रूरत है।
OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद कर दिया गया हो (उदाहरण के लिए आपने उसे रद्द किया हो), तो ग्राहक The Hubtel payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट जाता है, और अगला Confirm Order नए ऑर्डर का भुगतान करता है। यदि ऑर्डर पहले से भुगतान किया हुआ है और कार्ट में अब नई खरीद है, तो Confirm Order चेकआउट पेज को फिर से लोड करता है, और उसके बाद का Confirm Order नए ऑर्डर का भुगतान करता है। भुगतान किए गए ऑर्डर को कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।
यदि Hubtel भुगतान शुरू नहीं कर पाता, तो ग्राहक बटन के ऊपर एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, जैसे Could not connect to Hubtel. Please try again in a moment., Hubtel could not start the payment. Please try again or choose another payment method. या गलत क्रेडेंशियल होने पर Hubtel payments are not available at the moment. Please choose another payment method. विवरण लॉग में जाते हैं।
इस एक्सटेंशन में OpenCart से रिफ़ंड, सब्सक्रिप्शन, सेव किए गए कार्ड और स्टोर के भीतर भुगतान चैनल चुनने का विकल्प नहीं है।
ऑर्डर
ऑर्डर स्टेटस
कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को Hubtel भेजा गया और उसने भुगतान नहीं किया, या Hubtel ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order status after payment (डिफ़ॉल्ट Processing): GHS में ठीक ऑर्डर राशि के भुगतान की पुष्टि हुई। एक नोट राशि, Hubtel ट्रांज़ैक्शन, भुगतान विधि और संदर्भ दिखाता है।
Hubtel payment on hold status (डिफ़ॉल्ट Pending): Hubtel ने ऑर्डर कुल से अलग भुगतान राशि की रिपोर्ट की, या ऑर्डर GHS में नहीं है। ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया गया, और एक नोट अंतर को समझाता है। Hubtel डैशबोर्ड में भुगतान जाँचें और ऑर्डर पूरा करें या मैन्युअली रिफ़ंड करें। यदि उसी ऑर्डर का कोई और प्रयास बाद में सही राशि के लिए भुगतान होता है, तो ऑर्डर Order status after payment पर चला जाता है।
यदि पहले से भुगतान किए गए ऑर्डर का कोई और प्रयास भी भुगतान होता है, या पहले से भुगतान किए गए कार्ट का कोई अन्य ऑर्डर भुगतान होता है, तो भुगतान किया हुआ ऑर्डर नहीं बदला जाता। एक नोट आपसे Hubtel डैशबोर्ड में डुप्लिकेट को रिफ़ंड करने के लिए कहता है। जिस ऑर्डर को आपने किसी और स्टेटस (जैसे रद्द) में ले जाया है, उसके लिए भुगतान आने पर एक नोट जुड़ता है, और ऑर्डर कभी अपने-आप दोबारा नहीं खुलता। जब Hubtel किसी भुगतान को रिफ़ंड किया हुआ बताता है, तो ऑर्डर में एक नोट जोड़ा जाता है।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Hubtel Pay Gateway टैब
Sales > Orders में Hubtel से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Hubtel Pay Gateway टैब ऑर्डर के Hubtel payment attempts सूचीबद्ध करता है: तारीख, संदर्भ और Hubtel चेकआउट, राशि, Hubtel स्टेटस, ट्रांज़ैक्शन और परिणाम। प्रयासों के नीचे ऑर्डर के Hubtel notes नवीनतम पहले सूचीबद्ध होते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।
Check Hubtel payment status बटन ऑर्डर के नवीनतम प्रयासों (अधिकतम 5, नवीनतम पहले, ऑर्डर भुगतान होते ही रुककर) की जाँच करता है, परिणाम लागू करता है और हर प्रयास के स्टेटस के साथ एक नोट जोड़ता है। परिणाम टैब में दिखता है। आपके पास ऑर्डर बदलने का अधिकार होना चाहिए (Sales > Orders, System > Users > User Groups में सेट)। यह बटन बिना स्टेटस वाले ऑर्डर के लिए भी काम करता है। इस बटन से सेट किया गया स्टेटस सीधे लिखा जाता है, बिना ऑर्डर ईमेल या स्टॉक अपडेट के; कॉलबैक, ग्राहक की वापसी और cron उसे मानक तरीके से सेट करते हैं।
रिफ़ंड
OpenCart से रिफ़ंड समर्थित नहीं हैं। Hubtel डैशबोर्ड में भुगतान रिफ़ंड करें, फिर OpenCart में रिफ़ंड दर्ज करें। Sales > Returns में उत्पाद रिटर्न Hubtel के ज़रिए पैसे वापस नहीं भेजते।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Hubtel Pay Gateway, Extensions > Extensions > Payments > VibeFox Hubtel Pay Gateway > Edit पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी डालने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। इनके नीचे Product: opencart-payment-hubtel वाली पंक्ति और 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Hubtel नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग-इन किया हुआ एडमिन उपयोगकर्ता स्टोर में भुगतान विधि को (unlicensed — visible to admins only) चिह्न के साथ अब भी देखता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉग-इन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन के Dashboard पर एक अनुस्मारक दिखता है। 7 दिनों के लिए छिपाने के लिए उसे × से बंद करें। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान शुरू हो चुके हैं, वे पृष्ठभूमि जाँच सहित अब भी पुष्ट होते रहते हैं।
लाइसेंस की समय-सीमा समाप्त होने पर एक्सटेंशन काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन का Dashboard या Edit पेज खोलते हैं, तब स्थिति अपने-आप फिर से जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। लाइसेंस जाँच के लिए cron जॉब नहीं चाहिए। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
Hubtel चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API ID, API Key और मर्चेंट खाता नंबर भरे हुए हैं, और ऑर्डर की मुद्रा GHS है। यह भी जाँचें कि भुगतान पता चयनित Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है। क्रेडेंशियल या मुद्रा गलत होने पर सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: भुगतान की पुष्टि नहीं हो सकी। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। स्टेटस जाँच पर HTTP 401 या 403 का मतलब है कि API कुंजियाँ गलत हैं, या सर्वर का IP Hubtel द्वारा व्हाइटलिस्ट नहीं किया गया है। यह भी जाँचें कि कॉलबैक URL इंटरनेट से पहुँच योग्य है और cron URL कॉल हो रहा है। जैसे ही Hubtel उत्तर देता है, अगला कॉलबैक, पृष्ठभूमि जाँच, ग्राहक की वापसी या Check Hubtel payment status ऑर्डर स्टेटस सेट कर देता है।
कॉलबैक Unknown reference का उत्तर देता है: भुगतान संदर्भ इस स्टोर के किसी भुगतान का नहीं है।
कॉलबैक Payment status unavailable का उत्तर देता है: Transaction Status API तक पहुँच नहीं हो सकी या अनुरोध अस्वीकार हुआ, या उसी समय कोई और अनुरोध कार्ट की पुष्टि कर रहा था। 5 मिनट बाद भुगतान की पृष्ठभूमि में दोबारा जाँच होगी।
कॉलबैक Gateway not configured का उत्तर देता है: API ID, API Key या मर्चेंट खाता नंबर गायब है। उन्हें भरें; भुगतान की पृष्ठभूमि में दोबारा जाँच होगी।
कॉलबैक Invalid request या Invalid ClientReference का उत्तर देता है: अनुरोध में वैध Hubtel कॉलबैक नहीं था।
ब्राउज़र में कॉलबैक URL Method not allowed दिखाता है: यह सामान्य है। यह URL केवल Hubtel के अनुरोध स्वीकार करता है।
Cron URL Forbidden का उत्तर देता है: URL में टोकन गलत है। सेटिंग्स में दिखाए गए cron URL को हूबहू कॉपी करें। Delete data on uninstall चालू रहते हुए दोबारा इंस्टॉल करने पर टोकन नया होता है।
ऑर्डर होल्ड स्टेटस में है: VibeFox Hubtel Pay Gateway टैब के नोट पढ़ें (ऑर्डर स्टेटस देखें), Hubtel डैशबोर्ड में भुगतान जाँचें और ऑर्डर पूरा करें या मैन्युअली रिफ़ंड करें।
ग्राहक Confirm Order के बाद त्रुटि देखता है: Debug log चालू करें और लॉग देखें। गलत API कुंजियों पर Hubtel payments are not available at the moment. आता है। कनेक्शन की समस्या पर Could not connect to Hubtel. आता है। किसी अन्य मुद्रा के ऑर्डर पर Hubtel accepts payments in Ghana cedis (GHS) only. Please choose another payment method. आता है। This payment method is not available. Please reload the checkout page. का मतलब है कि चेकआउट अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई है।
डेवलपर्स के लिए: OpenCart इवेंट wcp_hubtel_pay_icon भुगतान विधि का आइकन बदलता है, और wcp_hubtel_pay_payment_description Hubtel पेज पर भुगतान का विवरण बदलता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Hubtel Pay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर अपनी डिफ़ॉल्ट स्थिति में लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप एक्शन भी, जो मेंटेनेंस मोड में कॉलबैक, cron URL और ग्राहक की वापसी को जाने देता है)। यदि Delete data on uninstall चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, API क्रेडेंशियल, cron टोकन, डीबग लॉग स्विच) और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे जाते हैं। ऑर्डरों के Hubtel भुगतान प्रयास हमेशा बने रहते हैं, इसलिए दोबारा इंस्टॉल करने के बाद भी देर से आने वाले कॉलबैक और जाँचें काम करती रहती हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Hubtel Pay Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Hubtel उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Hubtel से संबद्ध नहीं है और Hubtel द्वारा समर्थित नहीं है।