VibeFox IntaSend for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: cURL एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर या cURL के बिना मॉड्यूल इंस्टॉल नहीं होगा।

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

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

स्टोर की मुद्रा: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF या XOF। अन्य मुद्राओं के लिए भुगतान विकल्प छिपा रहता है।

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox IntaSend Pay Gateway खोजकर Configure पर क्लिक करें।

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

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

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

इंस्टॉल होने पर मॉड्यूल ऑर्डर स्थिति IntaSend payment on hold बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।

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

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

IntaSend

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

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

Description: चेकआउट पर भुगतान विकल्प के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

API कुंजियाँ

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

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

सेव की गई सीक्रेट कुंजियाँ और वेबहुक चैलेंज फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। नया मान केवल तभी डालें जब उसे बदलना हो।

वेबहुक

वेबहुक आपके स्टोर को बताता है कि भुगतान हो गया है, भले ही ग्राहक स्टोर पर वापस न आए (ब्राउज़र बंद, M-Pesa की पुष्टि बाद में हुई)। IntaSend डैशबोर्ड में, सैंडबॉक्स और लाइव दोनों में, Webhooks खोलें और इस सेक्शन में Webhook URL में दिखाया गया URL जोड़ें। फ़्रेंडली URL चालू होने पर यह कुछ ऐसा दिखता है: https://your-shop/module/wcp_intasend_pay/webhook, कभी-कभी /en/ जैसे भाषा कोड के साथ। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स में दिखाया गया है। वहाँ एक चैलेंज फ़्रेज़ दर्ज करें और मॉड्यूल में वही फ़्रेज़ दर्ज करें। सैंडबॉक्स और लाइव के लिए एक ही चैलेंज इस्तेमाल करें।

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

सेव की गई गोपनीय जानकारी हटाएँ: किसी को हटाने के लिए Sandbox secret key, Live secret key या Webhook challenge पर टिक करें और Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

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

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

उन्नत

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

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब IntaSend पुष्टि करे: मॉड्यूल ग्राहक के लौटने पर और वेबहुक आने पर Payment Status API से पूछता है। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। अगर ऑर्डर होल्ड पर रखा गया है, तो पेज पर 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. कार्ट बना रहता है और ग्राहक फिर से भुगतान कर सकता है। हर प्रयास को अपना अलग IntaSend संदर्भ मिलता है।

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

वेबहुक तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, और आपके स्टोर के देश प्रतिबंध से नहीं रुकता। जब फ़्रेंडली URL बंद होते हैं, तब ग्राहक स्टोर के होम पेज के ज़रिए लौटता है, क्योंकि IntaSend वापसी पते में कुछ अक्षर स्वीकार नहीं करता।

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

ऑर्डर

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

No order yet: ग्राहक को IntaSend पर भेजा गया है और उसने भुगतान नहीं किया है, या IntaSend ने भुगतान की पुष्टि अभी नहीं की है। केवल कार्ट मौजूद है।

Payment accepted: भुगतान की पुष्टि हो गई है। भुगतान IntaSend इनवॉइस ID को ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट में इनवॉइस, IntaSend पर भुगतान का तरीका, राशि, मोड (सैंडबॉक्स या लाइव) और पुष्टि का तरीका (वेबहुक या ग्राहक की वापसी) दिखता है।

IntaSend payment on hold: IntaSend ने कार्ट की कुल राशि से अलग राशि या मुद्रा, आंशिक भुगतान, या ऑर्डर रद्द होने के बाद आया भुगतान बताया है। नोट इसे समझाता है, और IntaSend द्वारा लिया गया राशि ऑर्डर की मुद्रा में हो तो उसे भुगतान के रूप में दर्ज किया जाता है। IntaSend डैशबोर्ड में भुगतान जाँचें और फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें। अगर बाद में सही भुगतान आता है, तो ऑर्डर Payment accepted में चला जाता है।

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

IntaSend भुगतान ब्लॉक

ऑर्डर पेज पर एक IntaSend payment ब्लॉक दिखता है, जिसमें ऑर्डर के कार्ट के हर चेकआउट प्रयास (तारीख, संदर्भ, IntaSend चेकआउट, वातावरण, राशि, इनवॉइस और परिणाम, विफलता के कारण सहित) और Invoices processed (इनवॉइस, IntaSend स्थिति, राशि और परिणाम) सूचीबद्ध होते हैं। यह ब्लॉक केवल पढ़ने के लिए है।

रिफ़ंड

रिफ़ंड स्टोर से IntaSend को नहीं भेजे जाते। IntaSend डैशबोर्ड में भुगतान रिफ़ंड करें और रिफ़ंड को PrestaShop में खुद दर्ज करें।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox IntaSend Pay Gateway, Modules > Module Manager > VibeFox IntaSend Pay Gateway > Configure पर सबसे पहला ब्लॉक है और सेटिंग्स के ऊपर होता है। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक में छिपी हुई कुंजी, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-payment-intasend वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। कुंजी केवल वे कर्मचारी बदल सकते हैं जिनके पास इस मॉड्यूल के लिए Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल आखिरी ज्ञात स्थिति पर काम करता रहता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को IntaSend नहीं दिखता। अगर फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विकल्प आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।

जब लाइसेंस की समय सीमा समाप्त होती है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। कोई cron job नहीं चाहिए। मॉड्यूल अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।

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

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

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

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

वेबहुक Invalid challenge का उत्तर देता है: IntaSend और मॉड्यूल में चैलेंज अलग हैं, या वेबहुक में चैलेंज नहीं है।

वेबहुक 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 के अनुरोध स्वीकार करता है।

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

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

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

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox IntaSend Pay Gateway के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। अगर Delete data on uninstall चालू है, तो गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। अगर बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सारी सेटिंग्स रखी जाती हैं। ऑर्डरों के IntaSend चेकआउट प्रयास और इनवॉइस, और ऑर्डर स्थिति IntaSend payment on hold, हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।

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