VibeFox CCAvenue for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

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

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

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

इंस्टॉलेशन

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

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox CCAvenue Payment ढूँढकर Configure पर क्लिक करें।

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

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

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

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox CCAvenue Payment > Configure। हर सेक्शन का अपना 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 न हो, तब मल्टी-करेंसी प्रोसेसिंग की याद दिलाता है।

CCAvenue

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

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। यदि इसमें अंकों के अलावा कुछ भी है, तो सेव करते समय 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: चेकबॉक्स चिह्नित करें और सहेजी गई Working Key हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजा गया मान बनाए रखता है।

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

Return URL

CCAvenue ग्राहक को इस सेक्शन में दिखाए गए पते पर वापस भेजता है। फ्रेंडली URL के साथ यह https://your-shop/module/wcp_ccavenue_payment/return जैसा दिखता है, और इसके साथ /en/ जैसा भाषा कोड भी हो सकता है। मॉड्यूल हर भुगतान के साथ यह URL भेजता है (रीडायरेक्ट और रद्द URL के रूप में), इसलिए CCAvenue में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। यह उस डोमेन का होना चाहिए जो CCAvenue में पंजीकृत है।

उन्नत

Debug log: CCAvenue इवेंट्स को मॉड्यूल फ़ोल्डर में logs/ccavenue_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। केवल ऑर्डर संदर्भ, ट्रैकिंग ID और स्थितियाँ लॉग होती हैं; कुंजियाँ, कार्ड डेटा, ईमेल और पते लॉग नहीं होते। डिफ़ॉल्ट: बंद। बंद होने पर कुछ भी नहीं लिखा जाता, त्रुटियाँ भी नहीं।

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

Delete data on uninstall: चालू होने पर मॉड्यूल हटाने से मॉड्यूल सेटिंग्स, लॉग और CCAvenue ऑर्डर संदर्भ हट जाते हैं। ऑर्डर और मॉड्यूल की ऑर्डर स्थितियाँ बनी रहती हैं। डिफ़ॉल्ट: बंद।

चेकआउट

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

हर प्रयास को कार्ट नंबर और समय से बना नया CCAvenue ऑर्डर संदर्भ मिलता है। कार्ट का कुल और मुद्रा, बिलिंग विवरण, डिलीवरी पता (जब वह बिलिंग पते से अलग हो) और प्रयास का गोपनीय टोकन एन्क्रिप्टेड अनुरोध में भेजे जाते हैं। नाम और पते CCAvenue द्वारा स्वीकृत अक्षरों और लंबाई तक साफ़ किए जाते हैं; देश और राज्य नाम के रूप में, तथा फ़ोन केवल अंकों में भेजे जाते हैं। ग्राहक CCAvenue पेज पर कार्ड, नेट बैंकिंग, UPI, वॉलेट या EMI चुनता है।

भुगतान के बाद CCAvenue ग्राहक को एन्क्रिप्टेड उत्तर के साथ वापस लाता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब CCAvenue उसकी पुष्टि कर दे: उत्तर आपकी Working Key से डिक्रिप्ट होना चाहिए, इस स्टोर के किसी प्रयास का होना चाहिए, और भेजी गई तथा कार्ट के कुल की राशि और मुद्रा से मेल खाना चाहिए। तब ऑर्डर बनता है और ग्राहक को 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 shop. दिखाता है। यदि लंबित ऑर्डर बाद में बिना भुगतान के रद्द या विफल हो जाए, तो पुष्टि पेज Your CCAvenue payment was not completed. Please contact us about this order. दिखाता है।

यदि भुगतान विफल होता है, तो ग्राहक 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. होता है। इन मामलों में कोई ऑर्डर नहीं बनता और कार्ट सुरक्षित रहती है, ताकि ग्राहक फिर से भुगतान कर सके। यदि कार्ट में पहले से ऑर्डर है, तो नया प्रयास दूसरे भुगतान के बजाय सीधे उसी ऑर्डर के पुष्टि पेज पर जाता है।

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

ऑर्डर

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

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

Payment accepted: भुगतान की पुष्टि हुई। भुगतान को CCAvenue ट्रैकिंग ID के साथ लेन-देन ID के रूप में दर्ज किया जाता है, और एक नोट में बैंक संदर्भ, ट्रैकिंग ID और भुगतान मोड दिखता है।

Awaiting CCAvenue payment: CCAvenue ने भुगतान को Awaited (बैंक ने अभी पुष्टि नहीं की) बताया है। जब तक पैसा कैप्चर हो सकता है, ऑर्डर को कभी विफल चिह्नित नहीं किया जाता। पूरा करने से पहले इसे CCAvenue डैशबोर्ड में सत्यापित करें। उसी ट्रैकिंग ID के साथ बाद में आया उत्तर फिर भी लागू होता है: Success Payment accepted करता है, Failure Payment error करता है, और Aborted Canceled करता है।

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

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

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

ऑर्डर पेज पर CCAvenue payment ब्लॉक दिखता है, जिसमें CCAvenue ऑर्डर ID, ट्रैकिंग ID, स्थिति, बैंक संदर्भ, भुगतान मोड और कार्ड का नाम, भेजी और प्राप्त राशि, तारीख और CCAvenue संदेश शामिल हैं, तथा टेस्ट भुगतानों के लिए Test mode बैज। CCAvenue नोट्स ऑर्डर के निजी संदेश हैं, जो केवल बैक ऑफ़िस में दिखते हैं।

रिफ़ंड

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

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

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

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

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

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

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

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

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

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

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

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

ग्राहक को This payment method is temporarily unavailable दिखता है: क्रेडेंशियल में से एक गायब है, या कार्ट का कुल शून्य है। Debug log कारण दिखाता है।

ग्राहक को This payment method is not available दिखता है: मॉड्यूल बंद है, या Payment > Preferences में कार्ट की मुद्रा, देश या ग्राहक समूह के लिए अनुमत नहीं है।

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

सेव करने पर Merchant ID नहीं बदलता: मान में अंकों के अलावा कुछ है। अपनी Merchant ID के केवल अंक दर्ज करें।

ऑर्डर CCAvenue payment on hold या Awaiting CCAvenue payment पर है: ऑर्डर नोट पढ़ें (ऑर्डर स्थितियाँ देखें)। CCAvenue डैशबोर्ड में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

डेवलपर्स के लिए, मॉड्यूल हुक actionCcavenueRequestParams प्रदान करता है (एन्क्रिप्शन से पहले CCAvenue को भेजे जाने वाले डेटा को बदलता है, उदाहरण के लिए merchant_param2 से merchant_param5; मानों में & नहीं होना चाहिए; amount, currency, order_id और merchant_param1 न बदलें)।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox CCAvenue Payment के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। पुष्टि संदेश याद दिलाता है कि जब तक Delete data on uninstall चालू न हो, सेटिंग्स और CCAvenue संदर्भ सुरक्षित रहते हैं। यदि वह चालू है, तो मॉड्यूल सेटिंग्स, लॉग और CCAvenue ऑर्डर संदर्भ हटा दिए जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सब कुछ रखा जाता है। ऑर्डर स्थितियाँ Awaiting CCAvenue payment और CCAvenue payment on hold हमेशा रखी जाती हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और लेन-देन ID बनाए रखते हैं।

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