VibeFox Cardcom for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

HTTPS: आपके स्टोर को इंटरनेट से HTTPS के ज़रिए पहुँचा जा सकना चाहिए, ताकि Cardcom भुगतान की सूचना भेज सके।

मुद्रा: ऑर्डर की मुद्रा (जिस मुद्रा में ग्राहक खरीदारी करता है) ILS, USD, EUR या GBP होनी चाहिए। किसी अन्य मुद्रा के लिए चेकआउट में भुगतान विधि छिपी रहती है।

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

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_cardcom_payment_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की आवश्यकता नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Cardcom Payment Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key के भीतर अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Enable/Disable चालू करें, Test Mode चालू रहने दें और Save पर क्लिक करें। कार्ड 4580 0000 0000 0000, किसी भी भविष्य की समाप्ति तिथि और CVV 123 के साथ एक परीक्षण ऑर्डर दें।

5. वास्तविक भुगतानों के लिए Test Mode बंद करें, Cardcom से प्राप्त Terminal Number, API Username और API Password दर्ज करें और Save पर क्लिक करें। Cardcom डैशबोर्ड में कुछ भी सेट करने की ज़रूरत नहीं है: सूचना और वापसी के पते हर भुगतान के साथ भेजे जाते हैं।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_cardcom_payment_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 फ़ाइल के नाम से एक्सटेंशन का कोड लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में पैकेज दिखाई देता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Cardcom Payment Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. OpenCart 3 के चरण 3 से 5 की तरह, लाइसेंस कुंजी दर्ज करें, भुगतान का परीक्षण करें और लाइव क्रेडेंशियल दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें Notification URL)।

नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। टेस्ट मोड चालू होने पर सेटिंग्स के ऊपर पेज एक चेतावनी दिखाता है। लाइव मोड में यह चेतावनी देता है जब टर्मिनल नंबर या API उपयोगकर्ता नाम गायब हो (तब Cardcom चेकआउट में छिपा रहता है), जब लाइव फ़ील्ड में सार्वजनिक टेस्ट टर्मिनल 1000 / CardTest1994 लिखा हो (तब भी Cardcom चेकआउट में छिपा रहता है, क्योंकि कोई वास्तविक धनराशि नहीं काटी जाती), और याद दिलाता है कि API पासवर्ड के बिना OpenCart से रिफ़ंड संभव नहीं हैं। यह यह भी चेतावनी देता है जब आपके स्टोर की डिफ़ॉल्ट मुद्रा समर्थित नहीं है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन व ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सहेजा नहीं जाता। जब आप लाइव मोड को गायब या टेस्ट क्रेडेंशियल के साथ सहेजते हैं, तो सेटिंग्स इस चेतावनी के साथ सहेजी जाती हैं कि आपका अपना टर्मिनल नंबर और API उपयोगकर्ता नाम दर्ज होने तक गेटवे चेकआउट में छिपा रहेगा।

Cardcom

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट में देखते हैं। ऑर्डर में भी यही भुगतान विधि का नाम सहेजा जाता है। डिफ़ॉल्ट: Credit Card (Cardcom)। आवश्यक।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely with your credit card via Cardcom.

Sort Order: चेकआउट में भुगतान विधियों के बीच Cardcom की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

Geo Zone: Cardcom केवल चुने गए जियो ज़ोन के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।

Total: चेकआउट की वह राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Cardcom दिया जाता है। किसी भी राशि पर Cardcom देने के लिए इसे खाली छोड़ें।

टेस्ट मोड

टेस्ट मोड सार्वजनिक Cardcom टेस्ट टर्मिनल 1000 (API उपयोगकर्ता CardTest1994) का उपयोग करता है। कोई वास्तविक धनराशि नहीं काटी जाती और Cardcom खाते की आवश्यकता नहीं है। टेस्ट कार्ड: 4580 0000 0000 0000, कोई भी भविष्य की समाप्ति तिथि और CVV 123। टेस्ट मोड में Confirm Order चरण में इस टेस्ट कार्ड वाली एक पंक्ति भी दिखती है।

Test Mode: टेस्ट मोड चालू करता है (टर्मिनल 1000, कोई वास्तविक धनराशि नहीं)। डिफ़ॉल्ट: चालू। नीचे दिए लाइव क्रेडेंशियल के साथ वास्तविक भुगतान स्वीकार करने के लिए इसे बंद करें। रिफ़ंड हमेशा उसी मोड के क्रेडेंशियल से भेजे जाते हैं जिसमें ऑर्डर का भुगतान हुआ था।

लाइव क्रेडेंशियल

टर्मिनल नंबर, API उपयोगकर्ता नाम और API पासवर्ड आपके मर्चेंट खाते के साथ Cardcom द्वारा दिए जाते हैं: Cardcom डैशबोर्ड में API सेटिंग्स के अंतर्गत, या Cardcom सहायता से। ये फ़ील्ड केवल लाइव मोड में उपयोग होते हैं।

Terminal Number: आपका Cardcom टर्मिनल नंबर। इसमें केवल अंक होने चाहिए। अगर आप कुछ और दर्ज करते हैं, तो बाकी सेटिंग्स एक चेतावनी के साथ सहेजी जाती हैं और पिछला टर्मिनल नंबर बना रहता है।

API Username: इस टर्मिनल के लिए आपका Cardcom API उपयोगकर्ता नाम (ApiName)। सहेजते समय स्पेस हटा दिए जाते हैं।

API Password: आपका Cardcom API पासवर्ड। यह केवल OpenCart से रिफ़ंड के लिए आवश्यक है। सहेजा गया पासवर्ड फिर कभी नहीं दिखता: फ़ील्ड खाली रहता है और सहेजा गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजा गया पासवर्ड हटाने के लिए फ़ील्ड के नीचे Clear the saved API password को चिह्नित करें और Save पर क्लिक करें।

भुगतान पेज

Notification URL: Cardcom भुगतान सूचनाएँ (IndicatorUrl) इस पते पर भेजता है। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook जैसा दिखता है, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook जैसा। यह आपकी OpenCart इंस्टॉलेशन के storefront पते से बनता है। यह पता हर भुगतान के साथ ऑर्डर नंबर सहित Cardcom को अपने-आप भेजा जाता है, इसलिए Cardcom में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। यह इंटरनेट से HTTPS के ज़रिए पहुँचने योग्य होना चाहिए।

Operation: भुगतान पेज पर Cardcom क्या करता है।

Max Installments: Cardcom पेज पर ग्राहक जितनी अधिकतम किस्तें (भुगतान) चुन सकता है, 1 से 36 के बीच। 1 का अर्थ है बिना किस्त। डिफ़ॉल्ट: 1।

ऑर्डर

OpenCart Confirm Order चरण में बिना स्थिति वाला ऑर्डर (एक लापता ऑर्डर) बनाता है। ऑर्डर को स्थिति तभी मिलती है जब Cardcom भुगतान की पुष्टि कर दे। नीचे के हर फ़ील्ड में आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध हैं।

Success Order Status: पुष्टि किए गए भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रक्रिया में।

On Hold (Review) Status: वे भुगतान जो ऑर्डर से मेल नहीं खाते (राशि, मुद्रा, लेन-देन नंबर नहीं), उन्हें यह स्थिति और कारण बताने वाला एक नोट मिलता है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में रोका गया स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होती है। डिफ़ॉल्ट: वापस किया गया।

उन्नत

Debug log: API अनुरोधों और सूचनाओं को OpenCart लॉग फ़ोल्डर (storage/logs) की cardcom_p_debug.log.php फ़ाइल में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे घुमा दिया जाता है। त्रुटियाँ हमेशा दर्ज होती हैं। क्रेडेंशियल, कार्ड टोकन और कार्डधारक का विवरण कभी नहीं लिखा जाता। डिफ़ॉल्ट: बंद।

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

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

इंपोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। API पासवर्ड एक्सपोर्ट नहीं किया जाता।

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजा गया API पासवर्ड बना रहता है।

चेकआउट

Payment Method चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Cardcom))। Confirm Order चरण में ग्राहक को आपका विवरण और यह सूचना दिखती है: You will be redirected to the secure Cardcom payment page. OpenCart इसी चरण में ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल के लिए एक Cardcom भुगतान पेज बनाता है और ग्राहक को वहाँ भेजता है। ऑर्डर की भाषा हिब्रू होने पर पेज हिब्रू में खुलता है, अन्यथा अंग्रेज़ी में। ऑर्डर के उत्पाद Cardcom को उत्पाद नाम के रूप में भेजे जाते हैं। ग्राहक कार्ड का विवरण डालता है और, यदि किस्तों की अनुमति हो, तो भुगतानों की संख्या चुनता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Cardcom भुगतान की पुष्टि कर दे। Cardcom सूचना पते को कॉल करता है, और एक्सटेंशन उस कॉल से केवल भुगतान पेज कोड लेता है। वह जाँचता है कि यह कोड आपके स्टोर ने इस ऑर्डर के लिए जारी किया था, और फिर सर्वर-से-सर्वर तरीके से Cardcom से असली परिणाम माँगता है। यदि सूचना देर से आती है, तो ग्राहक के लौटने पर वही जाँच चलती है। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है, जिस पर Your payment with Cardcom has been received. लिखा होता है। यदि ग्राहक के लौटने तक Cardcom ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज दिखता है, जिस पर Your payment is being confirmed by Cardcom. You will receive an e-mail as soon as it is confirmed. लिखा होता है, साथ में Check again और Back to checkout बटन; सूचना आते ही ऑर्डर स्थिति सेट कर देती है। OpenCart 4 पर, Cardcom जब ग्राहक को वापस भेजता है तो ब्राउज़र स्टोर का सत्र नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो आपके स्टोर से उसी वापसी पते को दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन सुरक्षित रहते हैं।

यदि भुगतान पूरा नहीं होता या Cardcom उसे अस्वीकार कर देता है, तो ग्राहक The card payment was not completed. Please try again or choose a different payment method. के साथ चेकआउट पर लौट आता है। OpenCart 4 पर यह संदेश चेकआउट पेज के ऊपर दिखाया जाता है। ऑर्डर बिना स्थिति के रहता है और कार्ट सुरक्षित रहता है। ग्राहक फिर से प्रयास कर सकता है: OpenCart 3 में Confirm Order चरण दिखने पर हर बार नया ऑर्डर बनता है, OpenCart 4 में चेकआउट के लिए एक ही ऑर्डर रखा जाता है और अपडेट होता है, और हर प्रयास को एक नया Cardcom भुगतान पेज मिलता है। नया पेज बनाने से पहले, इस ऑर्डर के और उसी कार्ट (वही ग्राहक सत्र और वही कार्ट सामग्री) के अन्य ऑर्डरों के, पिछले 24 घंटों के खुले Cardcom भुगतान पेजों की Cardcom के साथ जाँच की जाती है। यदि उनमें से कोई भुगतान किया हुआ निकलता है, तो वह ऑर्डर पुष्ट हो जाता है और ग्राहक दोबारा भुगतान करने के बजाय सफलता पेज पर जाता है। किसी दूसरे ऑर्डर से पहले ही भुगतान किए गए कार्ट पर फिर से शुल्क नहीं लगता: ग्राहक सफलता पेज पर जाता है। पुराने पेज पर अस्वीकृति नए प्रयास को प्रभावित नहीं करती।

यदि चेकआउट का ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), तो Confirm Order या Cardcom से वापसी ग्राहक को This order can no longer be paid. Please confirm your order again. के साथ चेकआउट पर वापस भेज देती है, और अगला Confirm Order कार्ट के एक नए ऑर्डर का भुगतान करता है। OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज नहीं दिखता: यदि उस ऑर्डर की कोई स्थिति पहले से है और इस बीच कार्ट बदल गया है (दूसरे उत्पाद या मात्रा), तो ग्राहक को वही संदेश मिलता है, और बदले हुए कार्ट को नया ऑर्डर और उसका अपना भुगतान मिलता है, जबकि वही कार्ट बिना नए भुगतान के सफलता पेज पर जाती है।

यदि Cardcom भुगतान पेज नहीं खोल पाता, तो ग्राहक बटन के ऊपर एक संक्षिप्त संदेश के साथ Confirm Order चरण पर ही रहता है, जैसे Cardcom से कनेक्ट नहीं हो सका। कृपया थोड़ी देर बाद फिर से प्रयास करें।, या यह संदेश कि Cardcom भुगतान पेज नहीं खोल सका, Cardcom कोड के साथ, और ग्राहक कोई दूसरी भुगतान विधि चुन सकता है।

सूचना तब भी काम करती है जब स्टोर रखरखाव मोड में हो: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है, जो सूचना और ग्राहक की वापसी को आगे जाने देता है।

यह एक्सटेंशन केवल Cardcom पेज पर एकल कार्ड भुगतान लेता है। इसमें सहेजे गए कार्ड या वन-क्लिक भुगतान नहीं हैं, सब्सक्रिप्शन नहीं हैं, सहेजे गए टोकन पर शुल्क नहीं लेता, Cardcom इनवॉइस या रसीद सेटिंग्स नहीं हैं, Cardcom के ज़रिए Bit, Apple Pay, Google Pay या PayPal नहीं है, iframe मोड नहीं है और बाद में कैप्चर करने वाले सौदे नहीं हैं।

ऑर्डर और रिफ़ंड

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

कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Cardcom पर भेजा गया और उसने भुगतान नहीं किया, भुगतान अस्वीकृत हुआ, या Cardcom ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Success Order Status (डिफ़ॉल्ट प्रक्रिया में): भुगतान की पुष्टि हो गई। एक नोट Cardcom लेन-देन दिखाता है और, जब Cardcom उन्हें बताता है, कार्ड के अंतिम चार अंक, इनवॉइस नंबर और किस्तों की संख्या, तथा भुगतान कैसे पुष्ट हुआ (सूचना, वापसी या नया प्रयास)। टेस्ट भुगतानों पर टेस्ट मोड — कोई वास्तविक धनराशि नहीं काटी गई। लिखा होता है।

On Hold (Review) Status (डिफ़ॉल्ट लंबित): Cardcom ने ऐसे भुगतान की पुष्टि की जो ऑर्डर से मेल नहीं खाता, उदाहरण के लिए अलग राशि या मुद्रा काटी गई, या Cardcom ने कोई लेन-देन नंबर नहीं लौटाया। नोट इसका कारण बताता है, और ऑर्डर टैब इसे Needs review: के अंतर्गत दिखाता है। Cardcom डैशबोर्ड में भुगतान की तुलना ऑर्डर से करें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Refunded Status (डिफ़ॉल्ट वापस किया गया): एक्सटेंशन के ज़रिए भुगतान पूरी तरह रिफ़ंड किया गया।

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

नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Cardcom Payment Gateway टैब

Sales > Orders में Cardcom से भुगतान किया गया एक ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Cardcom Payment Gateway टैब में Transaction दिखता है (टेस्ट भुगतानों के लिए Test mode लेबल के साथ), Payment page (LowProfileCode), Status, Card, Installments, Invoice, Card token (Charge + Save token के साथ), काटी गई राशि Charged, Order total / refunded, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Cardcom notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास इस एक्सटेंशन तक पहुँच है।

रिफ़ंड

टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Cardcom पर क्लिक करें। Refund this amount through Cardcom? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं, और एक ही ऑर्डर के लिए कई आंशिक रिफ़ंड किए जा सकते हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उसी राशि और मुद्रा में किए जाते हैं जो Cardcom ने काटी थी, इसलिए राशि या मुद्रा में अंतर होने पर आप ऑर्डर कुल तक नहीं, बल्कि ग्राहक ने वास्तव में जितना भुगतान किया था उतनी राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उसी मोड के क्रेडेंशियल से भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था: टेस्ट ऑर्डर लाइव मोड पर स्विच करने के बाद भी Cardcom टेस्ट टर्मिनल पर रिफ़ंड होते हैं, और लाइव ऑर्डर हमेशा आपके लाइव क्रेडेंशियल का उपयोग करते हैं। लाइव रिफ़ंड के लिए API Username और API Password चाहिए। यदि Cardcom रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड, Cardcom रिफ़ंड लेन-देन और कारण के साथ रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना, मैन्युअल स्थिति परिवर्तन की तरह ऑर्डर को Refunded Status पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता।

Sales > Returns में उत्पाद वापसी Cardcom के ज़रिए पैसा वापस नहीं भेजती। Cardcom डैशबोर्ड में किए गए रिफ़ंड स्टोर को वापस रिपोर्ट नहीं होते।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Cardcom Payment Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (जैसे वह तिथि जिस तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-cardcom वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। केवल उन एडमिन उपयोगकर्ताओं को कुंजी बदलने की अनुमति है जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

सक्रिय कुंजी के बिना Cardcom चेकआउट में ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। एडमिन में उसी ब्राउज़र से लॉग इन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (अनलाइसेंस्ड — केवल एडमिन को दिखाई देती है) का चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू किए गए भुगतान अब भी पुष्ट होते हैं, और रिफ़ंड काम करते हैं।

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

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

Cardcom चेकआउट में दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और ग्राहक की मुद्रा ILS, USD, EUR या GBP है। लाइव मोड में जाँचें कि Terminal Number और API Username आपके अपने क्रेडेंशियल से भरे हैं, न कि टेस्ट टर्मिनल 1000 / CardTest1994 से। कुछ गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहा: Cardcom आपके स्टोर तक नहीं पहुँच सका, उदाहरण के लिए फ़ायरवॉल, पासवर्ड सुरक्षा या किसी स्थानीय डेवलपमेंट साइट के कारण। सूचना पता इंटरनेट से HTTPS द्वारा पहुँचने योग्य होना चाहिए। भुगतान के बाद ग्राहक जब स्टोर पर लौटता है, तब भी ऑर्डर को स्थिति मिलती है। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

सूचना Missing or invalid lowprofilecode या Unknown lowprofilecode for this order से जवाब देती है: कॉल में इस ऑर्डर के लिए आपके स्टोर द्वारा जारी किया गया भुगतान पेज कोड नहीं था। कुछ नहीं बदलता।

सूचना Gateway not configured या Indicator check failed से जवाब देती है: जिस मोड में भुगतान पेज बना था उसके क्रेडेंशियल गायब हैं, या जाँच के लिए Cardcom तक नहीं पहुँचा जा सका। कुछ नहीं बदलता; ग्राहक के स्टोर पर लौटने पर भुगतान फिर से जाँचा जाता है।

सूचना Busy, retry से जवाब देती है: उसी समय कोई दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था, या ऑर्डर स्थिति सेट नहीं की जा सकी। कारण देखने के लिए Debug log चालू करें।

सूचना ReturnValue mismatch या Terminal mismatch से जवाब देती है: Cardcom ने किसी दूसरे ऑर्डर या दूसरे टर्मिनल के लिए भुगतान की सूचना दी। कुछ नहीं बदलता। जाँचें कि Terminal Number आपके खाते का टर्मिनल है।

ब्राउज़र में सूचना URL पर Missing or invalid lowprofilecode दिखता है: यह सामान्य है। यह URL केवल Cardcom की कॉल स्वीकार करता है।

ग्राहक को “भुगतान त्रुटि: यह मुद्रा Cardcom द्वारा समर्थित नहीं है।” दिखता है: ऑर्डर की मुद्रा ILS, USD, EUR या GBP नहीं है।

ग्राहक को “कार्ड भुगतान अस्थायी रूप से उपलब्ध नहीं है। कृपया कोई दूसरी भुगतान विधि चुनें।” दिखता है: लाइव मोड चालू है, लेकिन टर्मिनल नंबर या API उपयोगकर्ता नाम गायब है, या लाइव फ़ील्ड में सार्वजनिक टेस्ट टर्मिनल लिखा है।

Confirm Order के बाद ग्राहक को “यह भुगतान विधि उपलब्ध नहीं है।” दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट को दोबारा लोड करता है।

Confirm Order के बाद ग्राहक को कोई और त्रुटि दिखती है: Debug log चालू करें और Log फ़ील्ड देखें। कनेक्शन की समस्याएँ और Cardcom त्रुटि कोड वहाँ लिखे जाते हैं।

भुगतान के बाद ऑर्डर समीक्षा स्थिति में है: नोट्स या VibeFox Cardcom Payment Gateway टैब में Needs review: पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

रिफ़ंड “API username and API password are required for refunds” के साथ विफल होता है: सेटिंग्स में API Password (और API Username) दर्ज करें और फिर से प्रयास करें।

रिफ़ंड “Could not connect to Cardcom” के साथ विफल होता है: फिर से प्रयास करने से पहले Cardcom डैशबोर्ड देखें, क्योंकि रिफ़ंड हुआ हो भी सकता है और नहीं भी।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट cardcom_p_supported_currencies को ट्रिगर करता है, जो मुद्राओं की सूची बढ़ाता है (केवल वे मुद्राएँ जोड़ें जो आपके Cardcom टर्मिनल पर सक्षम हों), और cardcom_p_low_profile_params, जो भुगतान पेज बनने से पहले उसके पैरामीटर बदलता है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Cardcom Payment Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders अनुभाग की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में Cardcom को आगे जाने देता है)। यदि Delete on Uninstall चालू है, तो गेटवे की बाकी सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, क्रेडेंशियल, भुगतान पेज विकल्प, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। Cardcom लेन-देन और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।

OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Cardcom Payment Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Cardcom उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Cardcom से संबद्ध नहीं है और न ही Cardcom द्वारा समर्थित है।