VibeFox IntaSend for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, cURL एक्सटेंशन के साथ।

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

IntaSend खाता: आपको अपने IntaSend खाते की publishable key (ISPubKey_...) और secret key (ISSecretKey_...) चाहिए, सैंडबॉक्स के लिए, लाइव के लिए या दोनों के लिए, और IntaSend डैशबोर्ड में challenge phrase वाला एक वेबहुक चाहिए (देखें कॉन्फ़िगरेशन)। Publishable key चेकआउट पर भुगतान बनाती है। Secret key केवल आपके सर्वर पर भुगतान की स्थिति पूछने के लिए इस्तेमाल होती है।

मुद्रा: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF या XOF। जब ग्राहक के चेकआउट की मुद्रा इनमें से न हो, तब भुगतान विधि छिपा दी जाती है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी IntaSend सैंडबॉक्स और/या लाइव कुंजियाँ चिपकाएँ, IntaSend डैशबोर्ड में वेबहुक जोड़ें और वही challenge एक्सटेंशन में दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रखकर एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए Test mode बंद करें।

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox IntaSend Pay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर एक स्टेटस बॉक्स Test mode: IntaSend sandbox, no real money is charged. या Live mode: real payments are accepted. दिखाता है। यह तब भी चेतावनी देता है जब वर्तमान मोड की कुंजियाँ गायब या गलत हों (तब चेकआउट पर भुगतान विधि छिप जाती है), स्टोर की डिफ़ॉल्ट मुद्रा समर्थित न हो, वेबहुक challenge सेट न हो, और HTTPS के बिना लाइव मोड इस्तेमाल हो रहा हो। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

IntaSend

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी भुगतान विधि का यही नाम सहेजा जाता है। डिफ़ॉल्ट: IntaSend (M-Pesa, card)। अनिवार्य, 1 से 128 अक्षर।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

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

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

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

API कुंजियाँ

कुंजियाँ IntaSend डैशबोर्ड में Settings > API Keys के अंतर्गत लें, सैंडबॉक्स डैशबोर्ड और लाइव डैशबोर्ड से अलग-अलग (इस सेक्शन में दोनों के लिंक हैं)। टेस्ट मोड सैंडबॉक्स कुंजियों और सैंडबॉक्स API का उपयोग करता है, लाइव मोड लाइव कुंजियों और लाइव API का। एक्सटेंशन जाँचता है कि publishable key ISPubKey_ से शुरू होती है, secret key ISSecretKey_ से, और कुंजियाँ वर्तमान मोड की हैं: सैंडबॉक्स कुंजियों में _test होता है, लाइव कुंजियों में _live। अन्यथा भुगतान विधि छिप जाती है और स्टेटस बॉक्स कारण बताता है।

Test mode: IntaSend सैंडबॉक्स का उपयोग करता है, कोई असली पैसा नहीं लिया जाता। डिफ़ॉल्ट: चालू। लाइव कुंजियों से असली भुगतान स्वीकार करने के लिए इसे बंद करें। जब तक टेस्ट मोड चालू है, ग्राहक Confirm Order चरण में TEST MODE - IntaSend sandbox, no real money is charged. देखते हैं।

Sandbox publishable key: ISPubKey_test से शुरू होती है। चेकआउट बनने पर यह आपके व्यवसाय की पहचान करती है।

Sandbox secret key: ISSecretKey_test से शुरू होती है। केवल आपके सर्वर पर Payment Status API से भुगतान की पुष्टि के लिए उपयोग होती है।

Live publishable key: ISPubKey_live से शुरू होती है।

Live secret key: ISSecretKey_live से शुरू होती है। केवल आपके सर्वर पर भुगतान की पुष्टि के लिए उपयोग होती है।

सहेजी गई secret keys और वेबहुक challenge फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तभी नया मान दर्ज करें। सहेजा गया मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value पर टिक करें और Save पर क्लिक करें।

Webhook

वेबहुक आपके स्टोर को बताता है कि भुगतान हो गया है, भले ही ग्राहक स्टोर पर वापस न आए हों (ब्राउज़र बंद, M-Pesa बाद में पुष्ट हुआ)। IntaSend डैशबोर्ड में, सैंडबॉक्स और लाइव दोनों में, Webhooks खोलें और इस सेक्शन के Webhook URL में दिखाया गया URL जोड़ें। OpenCart 3 पर यह इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_intasend_pay/webhook, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_intasend_pay/payment/wcp_intasend_pay.webhook। यह आपके OpenCart इंस्टॉलेशन के storefront पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है। वहाँ एक challenge phrase दर्ज करें और वही phrase एक्सटेंशन में भी। सैंडबॉक्स और लाइव के लिए एक ही challenge का उपयोग करें।

Webhook challenge: वही challenge जो IntaSend डैशबोर्ड में है। किसी अन्य challenge वाले वेबहुक अस्वीकार किए जाते हैं। जब तक यह फ़ील्ड खाली है, वेबहुक प्रोसेस नहीं होते और भुगतान केवल तब पुष्ट होते हैं जब ग्राहक स्टोर पर लौटते हैं। ऐसे वेबहुक का उत्तर Ignored के रूप में दिया जाता है, त्रुटि के रूप में नहीं, ताकि आपके challenge दर्ज करने से पहले IntaSend वेबहुक बंद न करे।

एक्सटेंशन IntaSend द्वारा रिपोर्ट की गई इन भुगतान स्थितियों पर प्रतिक्रिया देता है। हर बार कुछ भी बदलने से पहले यह Payment Status API से वास्तविक स्थिति पूछता है:

जो सूचनाएँ इस स्टोर के चेकआउट भुगतान नहीं हैं, जैसे उसी IntaSend खाते के भुगतान लिंक या धन-प्रेषण (send-money) की घटनाएँ, उनका उत्तर Ignored के रूप में दिया जाता है, ताकि IntaSend वेबहुक बंद न करे।

ऑर्डर

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

Paid Order Status: IntaSend द्वारा पुष्ट भुगतान के बाद लगाई जाने वाली स्थिति। डिफ़ॉल्ट: Processing।

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

Refunded Status: इस स्थिति वाले ऑर्डर पर आया भुगतान केवल एक नोट जोड़ता है; ऑर्डर फिर से नहीं खुलता। डिफ़ॉल्ट: Refunded। एक्सटेंशन स्वयं रिफ़ंड नहीं करता।

उन्नत

Debug log: चेकआउट, वापसी और वेबहुक की घटनाएँ OpenCart के logs फ़ोल्डर (storage/logs) में intasend_p_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे intasend_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं। API कुंजियाँ, challenge और ग्राहक का डेटा कभी लॉग नहीं होता। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से IntaSend (M-Pesa, card))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल राशि के लिए एक IntaSend चेकआउट बनाता है और ग्राहक को IntaSend द्वारा होस्ट किए गए चेकआउट पेज पर भेजता है। वहाँ ग्राहक M-Pesa, कार्ड या आपके IntaSend खाते में सक्षम किसी अन्य तरीके से भुगतान करता है। ग्राहक का ईमेल और फ़ोन, तथा भुगतान पते का नाम, पता और देश, IntaSend के फ़ील्ड नियमों से मेल खाने पर IntaSend को भेजे जाते हैं। खाली या अनुपयुक्त फ़ील्ड छोड़ दिए जाते हैं। हर प्रयास को अपना IntaSend संदर्भ मिलता है।

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं माँगता; तब एक्सटेंशन IntaSend को शिपिंग पते का पता, शहर, पोस्टकोड और देश भेजता है।

भुगतान के बाद ग्राहक आपके स्टोर के होमपेज पते के ज़रिए वापस आता है, क्योंकि IntaSend वापसी पते में कुछ वर्ण स्वीकार नहीं करता; फिर एक्सटेंशन ग्राहक को अपने वापसी पेज पर भेजता है। ऑर्डर तभी भुगतान-पूर्ण चिह्नित होता है जब IntaSend उसे पुष्ट करे: एक्सटेंशन ग्राहक के लौटने पर और वेबहुक आने पर Payment Status API से पूछता है। फिर ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर होल्ड पर रखा गया हो, तो पेज पर Your payment was received and your order is being reviewed. We will contact you if anything is needed. भी दिखता है। यदि भुगतान अभी पुष्ट नहीं हुआ या उस समय IntaSend तक नहीं पहुँचा जा सकता, तो Payment confirmation पेज पर Your payment is being confirmed by IntaSend (M-Pesa confirmations can take a minute). You will receive an e-mail as soon as it is confirmed. दिखता है, साथ में Check again और Back to checkout बटन। IntaSend के पुष्टि करते ही वेबहुक ऑर्डर की स्थिति सेट कर देता है।

यदि भुगतान विफल हुआ, तो ग्राहक The payment was not successful. Please try again or choose another payment method. (यदि IntaSend ने कारण दिया हो तो उसके साथ) के साथ चेकआउट पर लौट आता है। यदि ग्राहक बिना भुगतान किए लौटा, तो संदेश है The payment was not completed. Please try again or choose another payment method. कार्ट सुरक्षित रहता है और ग्राहक फिर से भुगतान कर सकता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए विफल भुगतान के बाद ग्राहक नए प्रयास से वही ऑर्डर चुकाता है। एक कार्ट का भुगतान केवल एक बार होता है: यदि उसी कार्ट का कोई अन्य ऑर्डर पहले से भुगतान किया हुआ है, तो ग्राहक नए भुगतान के बजाय सफलता पेज पर जाता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद कर दिया गया हो (उदाहरण के लिए आपने उसे रद्द या रिफ़ंड किया हो), तो ग्राहक Your previous order was cancelled or refunded. Please confirm the order again. के साथ चेकआउट पर लौटा दिया जाता है। यदि ऑर्डर पहले ही दिया जा चुका है और कार्ट में अब दूसरे उत्पाद हैं, तो संदेश है Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर भुगतान करता है।

यदि IntaSend भुगतान शुरू नहीं कर सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर संदेश दिखता है: IntaSend could not start the payment: और IntaSend से मिला कारण, या IntaSend is temporarily unavailable. Please try again in a moment or choose another payment method. विवरण लॉग में लिखे जाते हैं। शून्य ऑर्डर कुल का भुगतान IntaSend से नहीं हो सकता।

वेबहुक स्टोर के मेंटेनेंस मोड में भी काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है जो वेबहुक और ग्राहक की वापसी को आगे जाने देता है।

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

ऑर्डर

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

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

Paid Order Status (default Processing): भुगतान पुष्ट हो गया है। एक नोट में IntaSend इनवॉइस, IntaSend पर भुगतान विधि, राशि, मोड (सैंडबॉक्स या लाइव) और पुष्टि का तरीका (वेबहुक या ग्राहक की वापसी) दिखाया जाता है।

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

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। नोट आपसे पूछता है कि यदि यह डुप्लिकेट है तो IntaSend डैशबोर्ड में उसे रिफ़ंड करें। Refunded Status वाले ऑर्डर के लिए भुगतान आने पर केवल नोट जुड़ता है और ऑर्डर फिर से नहीं खुलता।

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

VibeFox IntaSend Pay Gateway टैब

Sales > Orders में IntaSend से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox IntaSend Pay Gateway टैब ऑर्डर के IntaSend checkout attempts (तारीख, संदर्भ, IntaSend चेकआउट, वातावरण, राशि, इनवॉइस और भुगतान विधि, विफलता के कारण सहित परिणाम), Invoices processed (इनवॉइस, IntaSend स्थिति, राशि और परिणाम) और ऑर्डर के IntaSend notes दिखाता है। यह टैब केवल पढ़ने के लिए है और उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।

रिफ़ंड

रिफ़ंड स्टोर से IntaSend को नहीं भेजे जाते। IntaSend डैशबोर्ड में भुगतान रिफ़ंड करें और OpenCart में रिफ़ंड को मैन्युअल रूप से दर्ज करें, उदाहरण के लिए ऑर्डर को Refunded Status पर सेट करके।

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

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

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

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

IntaSend चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड की कुंजियाँ भरी हुई हैं और उसी मोड की हैं: टेस्ट मोड में सैंडबॉक्स कुंजियाँ (_test वाली), लाइव मोड में लाइव कुंजियाँ (_live वाली)। सेटिंग्स पेज के ऊपर का स्टेटस बॉक्स बताता है कि क्या गलत है। ग्राहक के चेकआउट की मुद्रा समर्थित होनी चाहिए। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: M-Pesa की पुष्टि में कुछ समय लग सकता है। जब IntaSend अंतिम स्थिति रिपोर्ट करता है, तब वेबहुक स्थिति सेट करता है। IntaSend डैशबोर्ड में वेबहुक URL (सैंडबॉक्स या लाइव, जो मोड आप उपयोग करते हैं) जाँचें कि वह Webhook URL में दिखाए गए URL से बिल्कुल मेल खाता है, और वहाँ का challenge Webhook challenge के समान है। ग्राहक के स्टोर पर लौटने या Check again पर क्लिक करने पर भी ऑर्डर को स्थिति मिलती है।

वेबहुक Ignored: webhook challenge not configured का उत्तर देता है: Webhook challenge खाली है। IntaSend डैशबोर्ड का challenge दर्ज करें।

वेबहुक Invalid challenge का उत्तर देता है: IntaSend और एक्सटेंशन में challenge अलग हैं, या वेबहुक में challenge नहीं है।

वेबहुक Verification unavailable, retry later या Busy, retry later का उत्तर देता है: उस समय IntaSend तक नहीं पहुँचा जा सका, ऑर्डर (उसका कार्ट) किसी और अनुरोध से पुष्ट हो रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। IntaSend वेबहुक फिर से भेजता है। कारण लॉग में है।

वेबहुक Invoice not verified या Invoice does not match the reference का उत्तर देता है: IntaSend ने पुष्टि नहीं की कि यह इनवॉइस ऑर्डर का है। कुछ नहीं बदला जाता।

वेबहुक URL ब्राउज़र में Method not allowed दिखाता है: यह सामान्य है। यह URL केवल IntaSend के अनुरोध स्वीकार करता है।

ऑर्डर On Hold Status में है: VibeFox IntaSend Pay Gateway टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, भुगतान आंशिक था, या वह ऑर्डर रद्द होने के बाद आया। IntaSend डैशबोर्ड में भुगतान जाँचें।

ग्राहक को Confirm Order के बाद त्रुटि दिखती है: एक्सटेंशन पेज पर Log फ़ील्ड देखें (अधिक विवरण के लिए Debug log चालू करें)। यदि वर्तमान मोड की कुंजियाँ गलत हैं, तो ग्राहक को IntaSend is not available at the moment. Please choose another payment method or contact the store. दिखता है। This payment method is not available. का अर्थ है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता या इस बीच भुगतान विधि बंद हो गई: ग्राहक चेकआउट को रीलोड करता है। यदि लॉग कहता है कि वापसी URL में ऐसे वर्ण हैं जिन्हें IntaSend स्वीकार नहीं करता, तो कारण स्टोर का पता है।

ग्राहक को We could not match this payment to an order दिखता है: वापसी लिंक बदल दिया गया है या किसी और ऑर्डर का है। यदि ग्राहक ने भुगतान किया है, तब भी वेबहुक ऑर्डर की स्थिति सेट करता है।

डेवलपर्स के लिए: चेकआउट बनने से पहले एक्सटेंशन अनुरोध डेटा, ऑर्डर और मोड के साथ OpenCart इवेंट intasend_p_checkout_payload चलाता है; इवेंट intasend_p_supported_currencies मुद्राओं की सूची बदल सकता है।

अनइंस्टॉल

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

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

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