VibeFox CCAvenue for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 या उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण, OpenSSL एक्सटेंशन के साथ (अनुरोध को एन्क्रिप्ट करने और उत्तर को डिक्रिप्ट करने के लिए उपयोग होता है)।
CCAvenue खाता: आपको Merchant ID, Access Code और Working Key वाला CCAvenue मर्चेंट खाता चाहिए। Access Code और Working Key किसी वेबसाइट डोमेन के लिए जारी किए जाते हैं, इसलिए इन्हें इस स्टोर के डोमेन के लिए बनाएँ। CCAvenue टेस्ट वातावरण के लिए भी वही क्रेडेंशियल उपयोग करता है; टेस्ट एक्सेस आपके खाते के लिए CCAvenue द्वारा सक्षम किया जाना चाहिए। यह एक्सटेंशन CCAvenue India के एंडपॉइंट्स उपयोग करता है।
मुद्रा: ऑर्डर की मुद्रा CCAvenue को जैसी है वैसी ही भेजी जाती है। CCAvenue खाते डिफ़ॉल्ट रूप से INR स्वीकार करते हैं; अन्य मुद्राओं के लिए आपके CCAvenue खाते पर मल्टी-करेंसी प्रोसेसिंग चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_ccavenue_payment-oc3-(संस्करण).ocmod.zip और OpenCart 4 का पैकेज wcp_ccavenue_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_ccavenue_payment-oc3-(संस्करण).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox CCAvenue Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास पेमेंट एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर के लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी पेस्ट करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. अपने CCAvenue डैशबोर्ड से Merchant ID, Access Code और Working Key दर्ज करें, Enable/Disable चालू करें और Save पर क्लिक करें।
5. परीक्षण के दौरान Test mode चालू रखें, फिर असली भुगतान स्वीकार करने के लिए इसे बंद कर दें। CCAvenue डैशबोर्ड में कुछ भी सेट करने की ज़रूरत नहीं है: हर भुगतान के साथ वापसी का पता भेजा जाता है।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_ccavenue_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में पैकेज उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox CCAvenue Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और CCAvenue क्रेडेंशियल वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल वापसी URL अलग है (देखें वापसी URL)।
नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox CCAvenue Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब 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 न हो, तब मल्टी-करेंसी प्रोसेसिंग की याद दिलाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा कुछ भी सेव नहीं होता।
CCAvenue
Enable/Disable: Enable CCAvenue Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। डिफ़ॉल्ट: CCAvenue। अनिवार्य।
Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue।
Sort Order: चेकआउट पर भुगतान विधियों के बीच CCAvenue की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें।
Geo Zone: CCAvenue केवल चुने गए geo zone के बिलिंग पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक पहुँचने पर ही CCAvenue दिया जाता है। किसी भी राशि पर CCAvenue देने के लिए खाली छोड़ें।
API क्रेडेंशियल
अपने CCAvenue मर्चेंट डैशबोर्ड (M.A.R.S.) में लॉग इन करें और Settings > API Keys खोलें। इस स्टोर के डोमेन के लिए Access Code और Working Key जनरेट करें। क्रेडेंशियल में मौजूद खाली स्थान सेव करते समय हटा दिए जाते हैं।
Merchant ID: आपका संख्यात्मक CCAvenue Merchant ID। यदि इसमें अंकों के अलावा कुछ है, तो सेव करने पर CCAvenue: the Merchant ID must contain digits only — the previous value was kept. संदेश दिखता है, पहले सेव किया गया मान बना रहता है और बाकी सेटिंग्स सेव हो जाती हैं।
Access Code: इस वेबसाइट का Access Code (Settings > API Keys)।
Working Key: इस वेबसाइट की Working Key (एन्क्रिप्शन कुंजी)। यह भुगतान अनुरोध को एन्क्रिप्ट करती है और CCAvenue के उत्तर को सत्यापित करने का एकमात्र तरीका है, इसलिए इसे गुप्त रखें। सेव की गई Working Key दोबारा कभी नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो। हटाने के लिए, फ़ील्ड के नीचे Clear saved Working Key पर टिक करें और Save पर क्लिक करें।
Test mode: ग्राहकों को CCAvenue के टेस्ट वातावरण (test.ccavenue.com) पर भेजता है। CCAvenue टेस्ट और लाइव दोनों के लिए एक ही Merchant ID, Access Code और Working Key उपयोग करता है; टेस्ट एक्सेस आपके खाते के लिए CCAvenue द्वारा सक्षम किया जाना चाहिए। टेस्ट मोड में Confirm Order चरण TEST MODE: no real transactions will be processed. दिखाता है। डिफ़ॉल्ट: चालू। असली भुगतान के लिए बंद करें।
वापसी URL
CCAvenue ग्राहक को इस सेक्शन में दिखाए गए पते पर वापस भेजता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_ccavenue_payment/back जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_ccavenue_payment/payment/wcp_ccavenue_payment.back जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। एक्सटेंशन हर भुगतान के साथ यह URL भेजता है (रीडायरेक्ट और रद्द करने के URL के रूप में), इसलिए CCAvenue में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। यह CCAvenue के साथ पंजीकृत डोमेन से संबंधित होना चाहिए।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। CCAvenue के एन्क्रिप्टेड उत्तर के सत्यापित होने के बाद ही ऑर्डर को स्टेटस मिलता है। विफल या रद्द भुगतान ऑर्डर को बिना स्टेटस के छोड़ देता है, और ग्राहक कार्ट सुरक्षित रखकर चेकआउट पर लौट आता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order Status After Payment: सफल भुगतान (CCAvenue स्टेटस Success, राशि और मुद्रा सत्यापित)। डिफ़ॉल्ट: प्रोसेसिंग।
Awaiting Payment Status: Awaited: बैंक ने अभी भुगतान की पुष्टि नहीं की है। उसी tracking ID के लिए CCAvenue Success बताता है, तब ऑर्डर को Order Status After Payment मिलता है। डिफ़ॉल्ट: भुगतान लंबित।
On Hold (Review) Status: CCAvenue ने ऑर्डर कुल से अलग राशि या मुद्रा बताई, या रद्द किए गए ऑर्डर के लिए भुगतान आया। एक नोट इसे समझाता है। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में होल्ड स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Payment Status: लंबित भुगतान बाद में निरस्त किया गया (उसी tracking ID के लिए Aborted)। डिफ़ॉल्ट: रद्द।
Failed Payment Status: लंबित भुगतान बाद में विफल हुआ (उसी tracking ID के लिए Failure, Invalid या Timeout)। पिछले प्रयास की विफलता ऑर्डर नहीं बदलती। डिफ़ॉल्ट: विफल।
उन्नत
Debug log: CCAvenue की घटनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में ccavenue_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। केवल ऑर्डर संदर्भ, tracking ID और स्टेटस दर्ज होते हैं; कुंजियाँ, कार्ड डेटा, ईमेल और पते दर्ज नहीं होते। डिफ़ॉल्ट: बंद। बंद रहते समय त्रुटियों सहित कुछ भी नहीं लिखा जाता।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से एक्सटेंशन की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और CCAvenue भुगतान संदर्भ बने रहते हैं, इसलिए दोबारा इंस्टॉल करने के बाद भी पुराने भुगतान का देर से आया वापसी उत्तर संभाला जाता है। डिफ़ॉल्ट: बंद।
इंपोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। Working Key एक्सपोर्ट नहीं होती।
Import: पहले एक्सपोर्ट किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई Working Key बनी रहती है।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से CCAvenue)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो यह चरण Thank you for your order. You are being redirected to CCAvenue to complete the payment. दिखाता है और ग्राहक को CCAvenue के भुगतान पेज पर भेजता है। जब तक ब्राउज़र वहाँ जाता है, Pay via CCAvenue बटन दिखता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।
हर प्रयास को OpenCart ऑर्डर नंबर और समय से बना एक नया CCAvenue ऑर्डर संदर्भ मिलता है। ऑर्डर की कुल राशि और मुद्रा, बिलिंग विवरण, डिलीवरी पता (जब ऑर्डर शिप होता है और डिलीवरी पता बिलिंग पते से अलग होता है) और प्रयास का एक गुप्त टोकन एन्क्रिप्टेड अनुरोध में भेजे जाते हैं। नाम और पते CCAvenue द्वारा स्वीकार किए जाने वाले अक्षरों और लंबाई में साफ़ किए जाते हैं; देश और राज्य नामों के रूप में, और फ़ोन केवल अंकों के रूप में भेजे जाते हैं। ग्राहक CCAvenue के पेज पर कार्ड, Net Banking, UPI, वॉलेट या EMI चुनता है। OpenCart 4 डिफ़ॉल्ट रूप से बिलिंग पता नहीं माँगता; तब बिलिंग विवरण डिलीवरी पते से लिए जाते हैं।
भुगतान के बाद CCAvenue एक एन्क्रिप्टेड उत्तर के साथ ग्राहक को वापस भेजता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब CCAvenue उसकी पुष्टि कर दे: उत्तर आपकी Working Key से डिक्रिप्ट होना चाहिए, इस स्टोर के किसी प्रयास से संबंधित होना चाहिए, और भेजी गई तथा ऑर्डर कुल वाली राशि और मुद्रा के समान होना चाहिए। फिर ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है जिस पर Your CCAvenue payment has been received. लिखा होता है। Awaited भुगतान के लिए पेज Your CCAvenue payment is awaiting confirmation from your bank. The order will be processed as soon as the payment is confirmed. दिखाता है। राशि या मुद्रा में अंतर होने के बाद यह Your payment was received and is being reviewed by the store. दिखाता है। OpenCart 4 पर CCAvenue द्वारा ग्राहक को वापस भेजे जाने पर ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए उत्तर लागू करने के बाद एक्सटेंशन एक छोटा पेज दिखाता है, जो आपके स्टोर से वापसी पता दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।
यदि भुगतान विफल होता है, तो ग्राहक 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. होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। इन मामलों में ऑर्डर बिना स्टेटस के रहता है और कार्ट सुरक्षित रहता है, ताकि ग्राहक फिर से भुगतान कर सके। OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट का एक ही ऑर्डर रखता है और उसे अपडेट करता है। हर प्रयास को अपना CCAvenue ऑर्डर संदर्भ मिलता है। CCAvenue शुरू किए गए भुगतान को रद्द नहीं कर सकता, इसलिए किसी पुराने प्रयास का देर से आया सफल भुगतान भी उसी के अपने ऑर्डर पर लागू होता है। एक कार्ट एक ही बार भुगतान किया जाता है: जिस कार्ट का भुगतान किसी दूसरे ऑर्डर से पहले ही हो चुका है, वह CCAvenue को दोबारा नहीं भेजा जाता (ग्राहक सफलता पेज पर जाता है), और यदि वही कार्ट फिर भी दो बार भुगतान होता है (उदाहरण के लिए दो ब्राउज़र टैब में), तो दूसरा ऑर्डर बिना स्टेटस के रहता है और भुगतान किए गए ऑर्डर पर एक नोट लगता है कि ग्राहक से दो बार शुल्क लिया गया हो सकता है, ताकि आप CCAvenue डैशबोर्ड से उसकी रिफ़ंड कर सकें।
OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद कर दिया गया, तो Confirm Order ग्राहक को चेकआउट पर वापस भेजता है, और अगला Confirm Order कार्ट के एक नए ऑर्डर का भुगतान करता है। संदेश यह होता है: Payment was cancelled. You may try again. जब कोई विलंबित भुगतान रद्द किया गया हो; Payment was not completed. Please try again or choose a different payment method. जब वह विफल हुआ हो; और This order can no longer be paid (it was closed by the store). Please confirm your order again. जब आपने भुगतान वाला ऑर्डर बंद किया हो। यदि ऑर्डर का पहले से कोई स्टेटस है और तब से कार्ट बदल गया है (अन्य उत्पाद या मात्रा), तो संदेश होता है: Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order.
परिणाम केवल ग्राहक के CCAvenue से लौटने से लिया जाता है: सर्वर-से-सर्वर सूचनाएँ या स्टेटस अनुरोध नहीं होते। यदि ग्राहक लौटने से पहले ब्राउज़र बंद कर देता है, तो ऑर्डर बिना स्टेटस के रहता है; CCAvenue डैशबोर्ड में भुगतान जाँचें। इस एक्सटेंशन में OpenCart से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, साइट पर कार्ड फ़ॉर्म, और CCAvenue UAE या अन्य क्षेत्रीय प्लेटफ़ॉर्म का समर्थन नहीं है।
ऑर्डर
ऑर्डर स्टेटस
कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को CCAvenue पर भेजा गया और वह वापस नहीं लौटा, या भुगतान विफल हुआ या रद्द हुआ। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। यदि ग्राहक वापस न आए तो CCAvenue डैशबोर्ड में भुगतान जाँचें।
Order Status After Payment (default Processing): भुगतान की पुष्टि हो गई। एक नोट बैंक संदर्भ, tracking ID और भुगतान मोड दिखाता है।
Awaiting Payment Status (default Pending): CCAvenue ने भुगतान को Awaited (बैंक ने अभी पुष्टि नहीं की) बताया है। जब तक पैसा अभी भी लिया जा सकता है, ऑर्डर कभी विफल चिह्नित नहीं होता, और एक नोट आपसे ऑर्डर पूरा करने से पहले CCAvenue डैशबोर्ड में भुगतान सत्यापित करने को कहता है। उसी tracking ID के साथ बाद का उत्तर फिर भी लागू होता है: Success Order Status After Payment सेट करता है, Failure Failed Payment Status सेट करता है, Aborted Cancelled Payment Status सेट करता है। OpenCart इन बदलावों की सूचना ग्राहक को देता है।
On Hold (Review) Status (default Pending): CCAvenue ने ऐसे भुगतान की पुष्टि की जिसकी राशि या मुद्रा ऑर्डर कुल या भेजी गई राशि से अलग है, या ग्राहक ने ऑर्डर रद्द होने या विफल होने के बाद भुगतान किया। नोट में प्राप्त और अपेक्षित राशि दिखती है। CCAvenue डैशबोर्ड में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
देर से आई विफलता कभी भी भुगतान किए गए ऑर्डर को नहीं बदलती, और जो ऑर्डर आपने हाथ से पूरा किया है, वह भी नहीं बदला जाता। यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और सफल भुगतान आता है (उदाहरण के लिए दो ब्राउज़र टैब से), तो ऑर्डर नहीं बदला जाता। एक नोट आपसे CCAvenue डैशबोर्ड में डुप्लिकेट की रिफ़ंड करने को कहता है।
नोट्स ऑर्डर के History की प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox CCAvenue Payment tab
Sales > Orders में CCAvenue से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox CCAvenue Payment टैब में परीक्षण भुगतानों के लिए Test mode लेबल के साथ CCAvenue order ID, Tracking ID, Status, Bank reference, Payment mode और कार्ड का नाम, Amount sent और Amount received, Date, CCAvenue का Message, और ऑर्डर के CCAvenue notes दिखते हैं। यह टैब उन एडमिन यूज़र्स को दिखता है जिनके पास एक्सटेंशन का एक्सेस है।
रिफ़ंड
OpenCart से रिफ़ंड समर्थित नहीं हैं। CCAvenue डैशबोर्ड में भुगतान रिफ़ंड करें, फिर रिफ़ंड को OpenCart में मैन्युअली दर्ज करें, उदाहरण के लिए ऑर्डर स्टेटस बदलकर।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox CCAvenue Payment, Extensions > Extensions > Payments > VibeFox CCAvenue Payment > Edit पर पहला ब्लॉक है, जो सेटिंग्स के ऊपर होता है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: Check now (स्टेटस दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-payment-ccavenue वाली पंक्ति और 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को CCAvenue नहीं दिखाया जाता। यदि फिर भी कोई भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन यूज़र को स्टोर में भुगतान विधि (unlicensed — visible to admins only) चिह्न के साथ दिखती रहती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन को नहीं देख पाता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। इसे × से बंद करने पर यह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: शुरू हो चुके भुगतानों की पुष्टि तब भी होती है जब ग्राहक CCAvenue से लौटता है।
जब लाइसेंस की समय सीमा समाप्त होती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्टेटस अपने आप फिर से जाँचा जाता है: कुंजी दर्ज होने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन की अनइंस्टॉलेशन हमेशा लाइसेंस कुंजी और लाइसेंस स्टेटस हटा देती है।
समस्या निवारण
CCAvenue does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और तीनों क्रेडेंशियल सेट हैं: Merchant ID, Access Code और Working Key। इनमें से कोई गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
The payment went through, but the order stays without a status: ग्राहक CCAvenue से आपके स्टोर पर वापस नहीं लौटा, उदाहरण के लिए क्योंकि ब्राउज़र बंद कर दिया गया। एक्सटेंशन में सर्वर-से-सर्वर सूचनाएँ नहीं हैं। CCAvenue डैशबोर्ड में भुगतान जाँचें और ऑर्डर को मैन्युअली अपडेट करें।
Every payment ends with We could not confirm the payment result: उत्तर डिक्रिप्ट नहीं हो सकता। Working Key गलत है, किसी दूसरे डोमेन की है, या अतिरिक्त अक्षरों के साथ कॉपी की गई है। इस स्टोर के डोमेन के लिए कुंजियाँ जनरेट करें और उन्हें फिर से पेस्ट करें। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।
CCAvenue shows an error before the payment page: जाँचें कि Access Code और Working Key इस डोमेन के लिए जनरेट हुए थे, कि वापसी URL CCAvenue के साथ पंजीकृत डोमेन का है, और टेस्ट मोड में CCAvenue ने आपके खाते के लिए टेस्ट एक्सेस सक्षम किया है। INR के अलावा किसी मुद्रा के लिए आपके CCAvenue खाते पर मल्टी-करेंसी प्रोसेसिंग सक्षम होनी चाहिए।
The customer sees This payment method is temporarily unavailable: कोई एक क्रेडेंशियल गायब है, या ऑर्डर कुल शून्य है। Debug log कारण दिखाता है।
The customer sees This payment method is not available. Please reload the checkout page.: चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट पेज को रीलोड करता है।
The customer sees Payment gateway error: encryption failed: अनुरोध एन्क्रिप्ट नहीं हो सका। जाँचें कि PHP का OpenSSL एक्सटेंशन इंस्टॉल है।
The Merchant ID does not change on save: मान में अंकों के अलावा कुछ है। अपने Merchant ID के केवल अंक दर्ज करें।
Order is in the review or awaiting status: VibeFox CCAvenue Payment टैब के नोट पढ़ें (ऑर्डर स्टेटस देखें)। CCAvenue डैशबोर्ड में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
डेवलपर्स के लिए: अनुरोध एन्क्रिप्ट होने से पहले, एक्सटेंशन अनुरोध पैरामीटर और ऑर्डर के साथ OpenCart इवेंट ccavenue_p_request_params ट्रिगर करता है (उदाहरण के लिए merchant_param2 से merchant_param5 सेट करने के लिए; amount, currency, order_id या merchant_param1 न बदलें)।
अनइंस्टॉलेशन
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox CCAvenue Payment के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर इसके इवेंट और इसका स्टार्टअप एक्शन भी, जो मेंटेनेंस मोड में भी ग्राहक की वापसी को अनुमति देता है)। यदि Delete data on uninstall चालू है, तो एक्सटेंशन की बाकी सेटिंग्स (शीर्षक, विवरण, क्रेडेंशियल, टेस्ट मोड, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। CCAvenue भुगतान संदर्भ हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox CCAvenue Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
CCAvenue अपने संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन CCAvenue से संबद्ध नहीं है और न ही CCAvenue द्वारा समर्थित है।