VibeFox Hubtel for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

मुद्रा: केवल घाना सेडी (GHS)। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है। WooCommerce के दशमलव स्थानों की संख्या 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 का कोई सार्वजनिक सैंडबॉक्स नहीं है। सभी भुगतान वास्तविक हैं।

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

इंस्टॉलेशन

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

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

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

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

5. API ID, API Key और मर्चेंट खाता संख्या (POS Sales ID) दर्ज करें।

6. Transaction Status API के लिए Hubtel सहायता टीम से अपने सर्वर IP को श्वेतसूची में शामिल करने का अनुरोध करें।

7. Enable/Disable चालू करें। कॉलबैक URL प्रत्येक भुगतान के साथ Hubtel को भेजा जाता है, इसलिए Hubtel डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Hubtel। फ़ील्ड के ऊपर पेज आपको चेतावनी देता है जब API ID, API Key या मर्चेंट खाता संख्या गायब होती है, और जब स्टोर की मुद्रा GHS नहीं होती है। दोनों ही मामलों में चेकआउट पर Hubtel छिपा रहता है। यदि स्टोर 2 से अधिक दशमलव स्थानों का उपयोग करता है तो भी यह आपको चेतावनी देता है। भुगतान विधियों की सूची में, जब तक क्रेडेंशियल भरे नहीं जाते तब तक गेटवे को सेटअप की आवश्यकता के रूप में चिह्नित किया जाता है।

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। डिफ़ॉल्ट: Mobile Money or card (Hubtel)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला विवरण। डिफ़ॉल्ट: Pay with MTN MoMo, Telecel Cash, AirtelTigo Money or a Visa/Mastercard card. You will be redirected to Hubtel to complete the payment.

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। इसे निजी रखें।

Merchant account number (POS Sales ID): भुगतान इस Hubtel खाते में एकत्र किए जाते हैं और इसके अनुसार जाँचे जाते हैं।

भुगतान की पुष्टि

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

Hubtel कॉलबैक हस्ताक्षरित नहीं होते हैं। प्लगइन कॉलबैक से केवल भुगतान संदर्भ लेता है; यह संदर्भ आपके स्टोर के किसी ऑर्डर का होना चाहिए। स्थिति, राशि और लेन-देन ID हमेशा Hubtel Transaction Status API से आती है। ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब यह API भुगतान और उसकी राशि की पुष्टि कर देता है। यदि Hubtel तक नहीं पहुँचा जा सकता है, तो भुगतान की पृष्ठभूमि में स्वचालित रूप से पुनः जाँच की जाती है, और आप ऑर्डर स्क्रीन से Order actions > Check Hubtel payment status द्वारा इसकी जाँच कर सकते हैं।

उन्नत

Debug log: कुंजियों या ग्राहक डेटा के बिना WooCommerce > Status > Logs में Log API calls and callbacks रिकॉर्ड करता है, स्रोत wcp_hubtel_pay। त्रुटियाँ हमेशा लॉग की जाती हैं। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Hubtel data saved on orders is kept)। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Mobile Money or card (Hubtel)) और ऑर्डर देता है। प्लगइन GHS में ऑर्डर कुल के लिए Hubtel चेकआउट बनाता है और ग्राहक को Hubtel भुगतान पेज पर भेजता है। भुगतान वहाँ Order #, ऑर्डर संख्या और आपकी साइट के नाम के रूप में दिखाई देता है। Hubtel पेज पर ग्राहक MTN MoMo, Telecel Cash, AirtelTigo Money, Visa या Mastercard कार्ड अथवा GhQR से भुगतान करता है। Place order या Pay पर प्रत्येक क्लिक अपने स्वयं के संदर्भ के साथ एक नया भुगतान प्रयास बनाता है, और उसी ऑर्डर के पुराने Hubtel पेज भुगतान योग्य बने रहते हैं।

भुगतान के बाद, ग्राहक ऑर्डर प्राप्त पेज पर वापस आता है। ऑर्डर केवल Hubtel द्वारा Transaction Status API के माध्यम से पुष्टि करने के बाद ही भुगतान किया हुआ चिह्नित होता है: कॉलबैक द्वारा, ग्राहक की वापसी पर की गई जाँच द्वारा, पृष्ठभूमि जाँच द्वारा या ऑर्डर क्रिया द्वारा। एक ही समय में आने वाले कॉलबैक और ग्राहक की वापसी को एक के बाद एक संभाला जाता है, ताकि ऑर्डर कभी भी दो बार पूरा न हो। यदि Hubtel ने अभी तक भुगतान की पुष्टि नहीं की है, तो पेज दिखाता है: 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. यदि ऑर्डर होल्ड पर रखा गया था, तो यह दिखाता है: Your Hubtel payment was received and is being reviewed by the store. We will contact you if anything is needed.

यदि ग्राहक Hubtel पेज पर Cancel दबाता है, तो प्लगइन पहले जाँचता है कि क्या भुगतान फिर भी हो गया था। यदि नहीं, तो ग्राहक The Hubtel payment was cancelled. You can try again or choose another payment method. संदेश के साथ Pay for order पेज पर वापस जाता है।

यदि Hubtel भुगतान शुरू नहीं कर सकता है, तो ग्राहक को एक संक्षिप्त संदेश दिखाई देता है, उदाहरण के लिए 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. विवरण लॉग में दर्ज होते हैं।

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

यह प्लगइन WooCommerce से रिफ़ंड, सब्सक्रिप्शन, सेव किए गए कार्ड और WooCommerce के अंदर भुगतान चैनल चुनने का विकल्प प्रदान नहीं करता।

ऑर्डर

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

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

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

On hold: Hubtel ने भुगतान की गई राशि की सूचना दी जो ऑर्डर के कुल से भिन्न है, या ऑर्डर GHS में नहीं है (नोट Hubtel amount/currency mismatch); या किसी ऐसे ऑर्डर के लिए भुगतान आया जो रद्द कर दिया गया था। ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया गया। Hubtel डैशबोर्ड में भुगतान की जाँच करें और मैन्युअल रूप से ऑर्डर पूरा करें या रिफ़ंड करें।

Failed: Hubtel ने रिपोर्ट किया कि लंबित ऑर्डर का नवीनतम भुगतान प्रयास विफल रहा, और Transaction Status API पुष्टि करता है कि यह भुगतान नहीं किया गया है। ग्राहक ऑर्डर से पुनः प्रयास कर सकता है। केवल कॉलबैक द्वारा रिपोर्ट की गई विफलता कभी भी किसी ऑर्डर को विफल नहीं करती है।

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

भुगतान की जाँच

ग्राहक को Hubtel पर भेजे जाने के लगभग 20 मिनट बाद, एक पृष्ठभूमि जाँच (WooCommerce Action Scheduler) Hubtel से भुगतान के बारे में पूछताछ करती है, यदि कॉलबैक खो गया हो और ग्राहक वापस न आया हो। एक अवैतनिक प्रयास की एक घंटे के बाद एक बार फिर जाँच की जाती है। जब Hubtel API तक नहीं पहुँचा जा सकता है, तो जाँच को बढ़ते अंतराल के साथ 5 बार तक दोहराया जाता है।

ऑर्डर क्रिया Check Hubtel payment status ऑर्डर के नवीनतम प्रयासों (नवीनतम से शुरू करके 5 तक) की जाँच करती है, परिणाम लागू करती है और प्रत्येक प्रयास की स्थिति के साथ एक नोट जोड़ती है।

रिफ़ंड

WooCommerce से रिफ़ंड समर्थित नहीं हैं। Hubtel डैशबोर्ड में भुगतान रिफ़ंड करें, फिर WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

Hubtel चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API ID, API Key और मर्चेंट खाता संख्या भरी हुई है और मुद्रा GHS है। Pay for order पेज पर ऑर्डर की मुद्रा मान्य होती है। क्रेडेंशियल या मुद्रा गलत होने पर सेटिंग्स पेज एक चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित स्थिति में बना हुआ है: भुगतान की पुष्टि नहीं हो सकी। WooCommerce > Status > Logs खोलें, स्रोत wcp_hubtel_pay। स्थिति जाँच पर HTTP 401 या 403 का अर्थ है कि API कुंजियाँ गलत हैं या सर्वर IP Hubtel द्वारा श्वेतसूची में नहीं है। यह भी जाँचें कि कॉलबैक URL इंटरनेट से पहुँच योग्य है। इसे ठीक करने के बाद, ऑर्डर खोलें और Order actions > Check Hubtel payment status चलाएँ। Hubtel द्वारा उत्तर दिए जाने पर पृष्ठभूमि जाँचें भी ऑर्डर की पुष्टि कर देती हैं।

कॉलबैक Unknown reference उत्तर देता है: भुगतान संदर्भ इस स्टोर के किसी ऑर्डर से संबंधित नहीं है।

कॉलबैक Payment status unavailable उत्तर देता है: Transaction Status API तक नहीं पहुँचा जा सका या उसने अनुरोध अस्वीकार कर दिया। भुगतान की पृष्ठभूमि में पुनः जाँच की जाती है।

ऑर्डर राशि/मुद्रा बेमेल नोट के साथ होल्ड पर है: Hubtel ने भुगतान की गई राशि की सूचना दी जो ऑर्डर के कुल से भिन्न है, या ऑर्डर GHS में नहीं है। Hubtel डैशबोर्ड में भुगतान की जाँच करें और मैन्युअल रूप से ऑर्डर पूरा करें या रिफ़ंड करें।

ऑर्डर देते समय ग्राहक को कोई त्रुटि दिखाई देती है: Debug log चालू करें और लॉग देखें। गलत API कुंजियाँ Hubtel payments are not available at the moment. देती हैं। कनेक्शन की समस्या Could not connect to Hubtel. देती है।

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

डेवलपर्स के लिए: फ़िल्टर hubtel_p_icon भुगतान विधि का आइकन बदलता है, और hubtel_p_payment_description Hubtel पेज पर भुगतान का विवरण बदलता है (100 वर्णों तक)।

अनइंस्टॉल

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

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