VibeFox CCAvenue for WooCommerce — सहायता

आवश्यकताएँ

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

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

PHP: 8.0 या उसके बाद का संस्करण, OpenSSL एक्सटेंशन के साथ (अनुरोध को एन्क्रिप्ट करने और उत्तर को डिक्रिप्ट करने के लिए उपयोग होता है)।

CCAvenue खाता: आपको CCAvenue मर्चेंट खाता चाहिए, जिसमें Merchant ID, Access Code और Working Key हों। Access Code और Working Key एक वेबसाइट डोमेन के लिए जारी होते हैं, इसलिए इन्हें इस स्टोर के डोमेन के लिए बनाएँ। CCAvenue टेस्ट वातावरण के लिए भी वही क्रेडेंशियल उपयोग करता है; टेस्ट एक्सेस आपके खाते पर CCAvenue द्वारा सक्षम होना चाहिए। प्लगइन CCAvenue के भारतीय एंडपॉइंट्स उपयोग करता है।

मुद्रा: ऑर्डर की मुद्रा जैसी है वैसी ही CCAvenue को भेजी जाती है। CCAvenue खाते डिफ़ॉल्ट रूप से INR स्वीकार करते हैं; अन्य मुद्राओं के लिए आपके CCAvenue खाते पर मल्टी-करेंसी प्रोसेसिंग चाहिए।

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

इंस्टॉलेशन

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

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

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

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

5. अपने CCAvenue डैशबोर्ड से Merchant ID, Access Code और Working Key दर्ज करें और Enable/Disable चालू करें।

6. परीक्षण के दौरान Test mode चालू रखें, फिर असली भुगतान लेने के लिए उसे बंद करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > CCAvenue। फ़ील्ड के ऊपर पेज चेतावनी देता है जब CCAvenue चालू है पर Merchant ID, Access Code या Working Key गायब है (तब भुगतान विधि तीनों सेट होने तक चेकआउट पर छिपी रहती है)। टेस्ट मोड चालू होने पर CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken. दिखता है, और जब स्टोर की मुद्रा INR न हो तो मल्टी-करेंसी प्रोसेसिंग की याद दिलाता है।

सामान्य

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: CCAvenue।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue।

API क्रेडेंशियल

अपने CCAvenue मर्चेंट डैशबोर्ड (M.A.R.S.) में लॉग इन करें और Settings > API Keys खोलें। इस स्टोर के डोमेन के लिए Access Code और Working Key बनाएँ। सहेजते समय क्रेडेंशियल से स्पेस हटा दिए जाते हैं।

Merchant ID: आपका संख्यात्मक CCAvenue Merchant ID। यदि इसमें अंकों के अलावा कुछ हो, तो सहेजते समय त्रुटि दिखती है और पिछला सहेजा गया मान रहता है।

Access Code: इस वेबसाइट का Access Code।

Working Key: इस वेबसाइट की Working Key (एन्क्रिप्शन कुंजी)। यह भुगतान अनुरोध को एन्क्रिप्ट करती है और CCAvenue उत्तर सत्यापित करने का एकमात्र तरीका है, इसलिए इसे गोपनीय रखें।

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com)। CCAvenue टेस्ट और लाइव दोनों के लिए वही Merchant ID, Access Code और Working Key उपयोग करता है; टेस्ट एक्सेस आपके खाते पर CCAvenue द्वारा सक्षम होना चाहिए। टेस्ट मोड में चेकआउट पर TEST MODE: no real transactions will be processed. दिखता है। डिफ़ॉल्ट: on। असली भुगतानों के लिए इसे बंद करें।

Return URL

CCAvenue ग्राहक को इस सेक्शन में दिखाए गए पते पर लौटाता है। यह ऐसा दिखता है: https://your-site/wc-api/ccavenue_p_callback/। प्लगइन यह URL हर भुगतान के साथ भेजता है, इसलिए CCAvenue में कुछ सेट करने की ज़रूरत नहीं है। यह URL CCAvenue के साथ पंजीकृत डोमेन का होना चाहिए।

उन्नत

Debug log: Log CCAvenue events ऑर्डर ID, CCAvenue संदर्भ और स्थितियाँ WooCommerce > Status > Logs में, source wcp_ccavenue_payment के साथ लिखता है। कुंजियाँ, कार्ड डेटा और पते लॉग नहीं होते। डिफ़ॉल्ट: off।

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted। प्लगइन निष्क्रिय करने से कुछ भी नहीं हटता। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से CCAvenue) और ऑर्डर देता है। Pay for order पेज पर Thank you for your order. You are being redirected to CCAvenue to complete the payment. दिखता है, और ग्राहक CCAvenue भुगतान पेज पर भेजा जाता है। JavaScript के बिना ग्राहक Pay via CCAvenue या Cancel order पर क्लिक करता है। हर प्रयास को नया CCAvenue ऑर्डर संदर्भ मिलता है। ऑर्डर की कुल राशि और मुद्रा, बिलिंग और डिलीवरी विवरण और ऑर्डर कुंजी एन्क्रिप्टेड अनुरोध में भेजे जाते हैं। नाम और पते वे अक्षर और लंबाई रखते हैं जो CCAvenue स्वीकार करता है; देश और राज्य नामों के रूप में, और फ़ोन केवल अंकों में भेजे जाते हैं।

भुगतान के बाद CCAvenue ग्राहक को एन्क्रिप्टेड उत्तर के साथ लौटाता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब CCAvenue उसकी पुष्टि करे: उत्तर आपकी Working Key से डिक्रिप्ट होना चाहिए, इसी ऑर्डर का होना चाहिए, और ऑर्डर जैसी ही राशि और मुद्रा रखता हो। फिर ग्राहक ऑर्डर प्राप्त पेज पर पहुँचता है।

यदि भुगतान विफल होता है, तो ग्राहक Payment was not completed. Please try again or choose a different payment method. के साथ चेकआउट पर लौटता है। यदि ग्राहक CCAvenue पेज पर रद्द करता है, तो संदेश है Payment was cancelled. You may try again. यदि उत्तर सत्यापित नहीं हो पाता, तो संदेश है We could not confirm the payment result. If your account was charged, please contact us before paying again. ग्राहक ऐसे ऑर्डर का भुगतान दोबारा कर सकता है जिसका भुगतान नहीं हुआ है, उदाहरण के लिए Pay for order पेज से। यदि भुगतान Pay for order पेज से शुरू हुआ और कार्ट खाली है, तो WooCommerce कार्ट पेज पर संदेश दिखाता है; विफल ऑर्डर का भुगतान My account > Orders से दोबारा किया जा सकता है।

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

परिणाम केवल ग्राहक की CCAvenue से वापसी से लिया जाता है: सर्वर-से-सर्वर सूचनाएँ और स्टेटस अनुरोध नहीं होते। यदि ग्राहक लौटने से पहले ब्राउज़र बंद कर दे, तो ऑर्डर Pending payment पर रहता है। प्लगइन में WooCommerce से रिफ़ंड नहीं हैं, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, iframe या साइट पर कार्ड फ़ॉर्म नहीं है, और CCAvenue UAE या अन्य क्षेत्रीय प्लेटफ़ॉर्म का समर्थन नहीं है।

ऑर्डर

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

Pending payment: ग्राहक को CCAvenue पर भेजा गया है और वह अभी लौटा नहीं है। यदि ग्राहक वापस न आए, तो CCAvenue डैशबोर्ड में भुगतान जाँचें।

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

On hold, राशि/मुद्रा में अंतर: CCAvenue ने ऐसे भुगतान की पुष्टि की जिसकी राशि या मुद्रा ऑर्डर से भिन्न है, उदाहरण के लिए ग्राहक के भुगतान शुरू करने के बाद ऑर्डर बदला गया, या CCAvenue का कोई डिस्काउंट ऑफ़र लागू हुआ। नोट में प्राप्त और अपेक्षित राशि दिखती है। CCAvenue डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर पूरा करें या उसका रिफ़ंड करें।

On hold, बैंक पुष्टि की प्रतीक्षा: CCAvenue ने भुगतान को Awaited बताया। ऑर्डर कभी विफल चिह्नित नहीं होता, जब तक पैसा अभी कैप्चर हो सकता है। ऑर्डर पूरा करने से पहले CCAvenue डैशबोर्ड में इसे सत्यापित करें और स्थिति मैन्युअली बदलें। उसी ट्रैकिंग ID वाला बाद का उत्तर फिर भी लागू होता है।

On hold, रद्द ऑर्डर का भुगतान: ग्राहक ने ऑर्डर रद्द होने के बाद भुगतान किया। स्टॉक जाँचें और ऑर्डर पूरा करें या उसका रिफ़ंड करें।

Cancelled: ग्राहक ने CCAvenue पेज पर भुगतान रद्द किया।

Failed: भुगतान विफल हुआ, या CCAvenue ने Invalid, Timeout या कोई अन्य असफल स्थिति लौटाई। नोट में CCAvenue संदेश दिखता है। देर से आई विफलता कभी भुगतान किए गए ऑर्डर को नहीं बदलती।

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

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

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

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

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

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

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

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

CCAvenue चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और तीनों क्रेडेंशियल भरे हैं: Merchant ID, Access Code और Working Key। कोई एक गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: ग्राहक CCAvenue से आपके स्टोर पर नहीं लौटा, उदाहरण के लिए ब्राउज़र बंद होने के कारण। प्लगइन में सर्वर-से-सर्वर सूचनाएँ नहीं होतीं। CCAvenue डैशबोर्ड में भुगतान जाँचें और ऑर्डर मैन्युअली अपडेट करें।

हर भुगतान पर We could not confirm the payment result दिखता है: उत्तर डिक्रिप्ट नहीं हो पा रहा। Working Key गलत है, किसी दूसरे डोमेन की है, या अतिरिक्त अक्षरों के साथ कॉपी हुई है। इस स्टोर के डोमेन के लिए कुंजियाँ बनाएँ और फिर से दर्ज करें। Debug log चालू करें और WooCommerce > Status > Logs में source wcp_ccavenue_payment देखें।

भुगतान पेज से पहले CCAvenue त्रुटि दिखाता है: जाँचें कि Access Code और Working Key इस डोमेन के लिए बने हैं, Return URL CCAvenue के साथ पंजीकृत डोमेन का है, और टेस्ट मोड में CCAvenue ने आपके खाते पर टेस्ट एक्सेस सक्षम किया है। INR के अलावा अन्य मुद्रा के लिए आपके CCAvenue खाते पर मल्टी-करेंसी प्रोसेसिंग सक्षम होनी चाहिए।

ग्राहक को This payment method is temporarily unavailable दिखता है: कोई एक क्रेडेंशियल गायब है।

ग्राहक को Payment gateway error: encryption failed दिखता है: अनुरोध एन्क्रिप्ट नहीं हो पाया। जाँचें कि PHP का OpenSSL एक्सटेंशन इंस्टॉल है।

Order is On hold after payment: ऑर्डर नोट पढ़ें। चुकाई गई राशि या मुद्रा ऑर्डर से भिन्न थी, भुगतान बैंक पुष्टि की प्रतीक्षा में है, या ऑर्डर रद्द हो चुका था। CCAvenue डैशबोर्ड में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।

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

डेवलपर्स के लिए: readme फ़ाइल में फ़िल्टर ccavenue_p_request_params दिया गया है (CCAvenue को भेजे जाने वाले डेटा को बदलने के लिए, उदाहरण के लिए merchant_param2 से merchant_param5 या promo_code; amount, currency, order_id या merchant_param1 न बदलें), और चेकआउट आइकन के लिए फ़िल्टर ccavenue_p_icon।

अनइंस्टॉल

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

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