VibeFox IntaSend for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > IntaSend। फ़ील्ड्स के ऊपर एक स्टेटस बॉक्स 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: Use the IntaSend sandbox (no real money is charged)। डिफ़ॉल्ट: चालू। असली भुगतान लाइव कुंजियों से स्वीकार करने के लिए इसका चेकमार्क हटा दें। जब तक टेस्ट मोड चालू है, चेकआउट पर भुगतान विकल्प के नीचे 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 से शुरू होती है। केवल आपके सर्वर पर भुगतान की पुष्टि के लिए इस्तेमाल होती है।

वेबहुक

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

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

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

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

एडवांस्ड

Debug log: Log checkout, return and webhook events, WooCommerce > Status > Logs में, स्रोत wcp_intasend_pay के अंतर्गत। त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजियाँ और ग्राहक का डेटा कभी दर्ज नहीं होता। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted। ऑर्डर पर सेव IntaSend संदर्भ भुगतान इतिहास हैं और हमेशा रखे जाते हैं। प्लगइन निष्क्रिय करने से कुछ नहीं मिटता। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब IntaSend पुष्टि करे: प्लगइन ग्राहक के लौटने पर और वेबहुक आने पर Payment Status API से पूछता है। यदि भुगतान अभी तक पुष्ट नहीं हुआ है, तो ऑर्डर प्राप्त पेज पर 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. दिखता है। यदि ऑर्डर होल्ड पर रखा गया है, तो Your payment was received and your order is being reviewed. We will contact you if anything is needed. दिखता है।

यदि भुगतान विफल हुआ या ग्राहक बिना भुगतान किए लौट आया, तो वह चेकआउट (या Pay for order पेज) पर लौटता है और उसे 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. दिखता है। विवरण लॉग में लिखे जाते हैं।

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

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

ऑर्डर

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

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

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

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

Failed: नवीनतम भुगतान प्रयास विफल रहा। नोट में IntaSend का कारण दिखता है। ग्राहक फिर से कोशिश कर सकता है।

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

रिफ़ंड

रिफ़ंड WooCommerce से IntaSend को नहीं भेजे जाते। IntaSend डैशबोर्ड में भुगतान रिफ़ंड करें और WooCommerce में रिफ़ंड को मैन्युअल रूप से दर्ज करें।

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

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

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

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

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

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

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

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

वेबहुक का उत्तर 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 ने पुष्टि नहीं की कि यह इनवॉइस ऑर्डर का है। ऑर्डर नहीं बदला जाता।

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

ग्राहक ऑर्डर देते समय त्रुटि देखता है: Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_intasend_pay देखें। ऑर्डर का कुल योग शून्य से अधिक होना चाहिए। यदि लॉग कहता है कि रिटर्न URL में ऐसे अक्षर हैं जिन्हें IntaSend स्वीकार नहीं करता, तो कारण स्टोर का पता या उसमें का भाषा पैरामीटर है।

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

अनइंस्टॉल

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

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