VibeFox Comgate for OpenCart — सहायता

आवश्यकताएँ

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

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

इंटरनेट एक्सेस: आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, और नोटिफ़िकेशन URL के सामने कोई मेंटेनेंस पेज, फ़ायरवॉल या पासवर्ड सुरक्षा नहीं होनी चाहिए, ताकि Comgate बैकग्राउंड नोटिफ़िकेशन भेज सके।

मुद्रा: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK या SEK। अन्य मुद्राओं के लिए, और Comgate की न्यूनतम सीमा से कम कुल राशि के लिए (जैसे 1 CZK, 0.10 EUR या 100 HUF) भुगतान विधि छिपी रहती है। HUF भुगतान, Comgate की आवश्यकता के अनुसार, पूर्ण फ़ोरिंट तक गोल किए जाते हैं।

Comgate खाता: आपको Comgate क्लाइंट पोर्टल में अपने स्टोर कनेक्शन का Merchant ID और secret (बैकग्राउंड संचार का पासवर्ड) चाहिए, और वहाँ सेट किया गया नोटिफ़िकेशन URL (देखें कॉन्फ़िगरेशन)। Comgate टेस्ट और लाइव भुगतानों के लिए एक ही Merchant ID और secret उपयोग करता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Comgate क्लाइंट पोर्टल से Merchant ID और Secret दर्ज करें, और वहाँ नोटिफ़िकेशन URL सेट करें (देखें कॉन्फ़िगरेशन)।

5. Enable / Disable चालू करें और Save पर क्लिक करें। ट्रायल भुगतान के लिए Test Mode चालू रखें, फिर उसे बंद कर दें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Comgate Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब Comgate चालू हो लेकिन Merchant ID या secret न भरा हो (तब दोनों भरे जाने तक चेकआउट पर भुगतान विधि छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा Comgate द्वारा समर्थित न हो। टेस्ट मोड चालू रहने पर यह Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्ण संख्या होनी चाहिए, Total ऋणात्मक नहीं हो सकता, और चुने गए geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। कोई भी जाँच विफल होने पर कुछ भी सेव नहीं होता और पेज त्रुटियाँ सूचीबद्ध करता है।

Comgate

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। डिफ़ॉल्ट: Comgate। अनिवार्य, अधिकतम 128 अक्षर।

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely via Comgate — cards, bank transfers, wallets and more। टेस्ट मोड में इसमें TEST MODE: no real money is charged. जोड़ा जाता है, या विवरण खाली होने पर केवल यही दिखता है।

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

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

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

Comgate कनेक्शन

Comgate क्लाइंट पोर्टल में Integration > shop connection settings से शॉप आइडेंटिफ़ायर (Merchant ID) और पासवर्ड (secret) लें (यह पेज पोर्टल का लिंक देता है)। वहीं URL for passing the payment result (बैकग्राउंड नोटिफ़िकेशन) को इस सेक्शन के Notification URL में दिखाए गए URL पर सेट करें। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_comgate_gateway/notify जैसा दिखता है, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_comgate_gateway/payment/wcp_comgate_gateway.notify जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स में दिखाया गया है। Comgate हर भुगतान के बाद इसे कॉल करता है; फिर एक्सटेंशन ऑर्डर बदलने से पहले Comgate स्टेटस API से भुगतान की दोबारा जाँच करता है। ग्राहक के लिए रिटर्न URL हर भुगतान के साथ भेजे जाते हैं। यदि पोर्टल रिटर्न URL (भुगतान हुआ, रद्द, लंबित) भी माँगता है, तो इस सेक्शन में दिखाया गया दूसरा URL उपयोग करें, जो back&id=${id}&refId=${refId} पर खत्म होता है (OpenCart 4 में wcp_comgate_gateway.back&id=${id}&refId=${refId})।

Merchant ID: Comgate ई-शॉप आइडेंटिफ़ायर (merchant)।

Secret: इस स्टोर कनेक्शन का बैकग्राउंड संचार पासवर्ड (secret)। सेव किया गया secret दोबारा कभी नहीं दिखाया जाता। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो। सेव किए गए secret को हटाने के लिए, फ़ील्ड के नीचे Clear the saved secret पर टिक करें और Save पर क्लिक करें।

Test Mode: टेस्ट भुगतान बनाता है (कोई पैसा नहीं लिया जाता)। Comgate टेस्ट और लाइव भुगतानों के लिए एक ही Merchant ID और secret उपयोग करता है; टेस्ट भुगतान test=true से चिह्नित होते हैं। रिफ़ंड हमेशा मूल भुगतान के मोड में भेजे जाते हैं। डिफ़ॉल्ट: चालू।

भुगतान पेज

Payment Methods: Comgate की वे भुगतान विधियाँ जिनमें से ग्राहक चुन सकता है। केवल वे विधियाँ दिखती हैं जो Comgate में आपके स्टोर के लिए सक्षम हैं।

Language: Comgate भुगतान पेज की भाषा। Automatic (store language, English as fallback) (डिफ़ॉल्ट) या 26 भाषाओं में से एक।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Comgate भुगतान की पुष्टि कर दे: यह बैकग्राउंड नोटिफ़िकेशन से या ग्राहक के लौटने पर होता है; स्टेटस हमेशा Comgate स्टेटस API से पढ़ा जाता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: वह स्टेटस जो Comgate द्वारा भुगतान की पुष्टि होने पर सेट होता है। डिफ़ॉल्ट: प्रोसेसिंग।

Comgate Payment On Hold Status: ऐसे भुगतान जो ऑर्डर से मेल नहीं खाते, लाइव मोड में टेस्ट भुगतान, और पूर्व-अधिकृत भुगतान। एक नोट कारण समझाता है। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में होल्ड स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Payment Canceled Status: एक पूर्व-अधिकृत ऑर्डर जिसका Comgate भुगतान रद्द हुआ या समाप्त हो गया। डिफ़ॉल्ट: रद्द।

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

उन्नत

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

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनके Comgate ट्रांज़ैक्शन ID हमेशा बने रहते हैं। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Comgate उसकी पुष्टि करे: एक्सटेंशन Comgate स्टेटस API से भुगतान पढ़ता है, बैकग्राउंड नोटिफ़िकेशन आने पर भी और ग्राहक के लौटने पर भी। फिर ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर होल्ड पर रखा गया है, तो पेज में Your payment is being reviewed. We will contact you if anything else is needed. जुड़ जाता है। OpenCart 4 में, जब Comgate ग्राहक को वापस भेजता है, तो ब्राउज़र स्टोर का सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो आपके स्टोर से उसी रिटर्न पते को फिर से खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।

यदि ग्राहक के लौटने पर भुगतान की अभी पुष्टि नहीं हुई है, उदाहरण के लिए रास्ते में कोई बैंक ट्रांसफ़र, तो एक Payment confirmation पेज दिखता है जिस पर Comgate has not confirmed your payment yet. Your order will be confirmed automatically as soon as the payment is confirmed — please do not pay again. लिखा होता है, साथ में Check again बटन और Back to checkout बटन होता है।

यदि भुगतान रद्द होता है या समाप्त हो जाता है, तो ग्राहक The Comgate payment was cancelled or has expired. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। OpenCart 4 में चेकआउट के संदेश चेकआउट पेज के ऊपर दिखते हैं। कार्ट सुरक्षित रहता है। हर नया प्रयास (OpenCart 3 में हर बार जब Confirm Order चरण दिखाया जाता है, नया ऑर्डर बनता है; OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और उसे अपडेट करता है) पहले Comgate पर उसी कार्ट के पिछले प्रयासों की जाँच करता है। यदि उनमें से कोई पहले ही भुगतान हो चुका है, तो उसका ऑर्डर पुष्ट होता है और ग्राहक दूसरी बार शुल्क लिए बिना सफलता पेज पर जाता है; खुले प्रयास Comgate पर रद्द कर दिए जाते हैं। किसी पुराने प्रयास का देर से आया भुगतान अब भी पहचाना जाता है और उसका ऑर्डर पुष्ट करता है। जो कार्ट किसी दूसरे ऑर्डर से पहले ही भुगतान हो चुका है, उसे दोबारा चार्ज नहीं किया जाता: ग्राहक सफलता पेज पर जाता है।

OpenCart 4 में ऑर्डर, सफलता पेज दिखाए जाने तक चेकआउट में रहता है। यदि वह ऑर्डर इस बीच बिना भुगतान के रद्द हुआ है, तो Confirm Order ग्राहक को रद्द भुगतान के संदेश के साथ चेकआउट पर वापस भेज देता है। यदि वह किसी और तरीके से बंद हुआ है (उदाहरण के लिए रिफ़ंड हुआ या भुगतान के बाद रद्द हुआ), तो संदेश है Your previous order is closed (cancelled or refunded). Please confirm the order again: the cart will be paid with a new order. दोनों स्थितियों में, अगला Confirm Order कार्ट के लिए एक नए ऑर्डर का भुगतान करता है। यदि ऑर्डर पहले ही भुगतान हो चुका है और उसके बाद कार्ट बदल गया है (अन्य उत्पाद या मात्रा), तो ग्राहक को चेकआउट पर वापस भेज दिया जाता है, और बदले हुए कार्ट को नया ऑर्डर और अपना अलग भुगतान मिलता है।

यदि Comgate भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है, और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे The Comgate payment could not be started. Please try again or choose another payment method., कि Comgate इस राशि या मुद्रा को स्वीकार नहीं करता, या चुनी गई Comgate भुगतान विधि उपलब्ध नहीं है। तकनीकी कारण लॉग में लिखा जाता है।

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

यह एक्सटेंशन Comgate पेज पर केवल एकमुश्त भुगतान लेता है। इसमें आवर्ती भुगतान, सब्सक्रिप्शन या सेव किए गए कार्ड नहीं हैं, एम्बेडेड Comgate चेकआउट नहीं है, आपकी साइट पर Apple Pay या Google Pay बटन नहीं हैं (ये Comgate पेज पर उपलब्ध हैं), और OpenCart से प्री-ऑथराइज़ेशन का कैप्चर या रद्द करना भी नहीं है। नोटिफ़िकेशन के बिना भुगतान स्टेटस अपने-आप नहीं जाँचा जाता; वह केवल ग्राहक के लौटने पर जाँचा जाता है।

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

ऑर्डर स्टेटस

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

Order Status After Payment (default Processing): Comgate ने उसी राशि और मुद्रा के साथ भुगतान को PAID बताया। एक नोट Comgate ट्रांज़ैक्शन और राशि दिखाता है। टेस्ट भुगतानों को Comgate test payment — no money was charged. नोट मिलता है।

Comgate Payment On Hold Status (default Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से अलग है, स्टोर के लाइव मोड में रहते हुए टेस्ट भुगतान की पुष्टि हुई (कोई पैसा नहीं मिला), या भुगतान केवल अधिकृत है (आपके Comgate खाते पर प्री-ऑथराइज़ेशन)। अधिकृत भुगतान, Comgate पोर्टल में कैप्चर करने पर अपने-आप भुगतान किया हुआ बन जाता है। नोट कारण समझाता है।

Payment Canceled Status (default Canceled): एक अधिकृत भुगतान Comgate पर रद्द हुआ या समाप्त हो गया। उसके बाद यदि Comgate भुगतान की पुष्टि करता है, तो ऑर्डर भुगतान किए गए के रूप में फिर से खुल जाता है, साथ में शिपिंग से पहले स्टॉक जाँचने का नोट होता है।

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

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

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

VibeFox Comgate Gateway tab

Sales > Orders में Comgate से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Comgate Gateway टैब में टेस्ट भुगतानों के लिए Test mode लेबल के साथ Comgate transaction (transId), Status, Payment amount, Order total / refunded, समीक्षा का कारण, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Comgate notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन का एक्सेस है।

रिफ़ंड

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

रिफ़ंड केवल भुगतान किए गए ऑर्डरों के लिए उपलब्ध हैं। राशि या मुद्रा के बेमेल होने के बाद होल्ड पर गया ऑर्डर OpenCart से रिफ़ंड नहीं किया जा सकता; उसे Comgate पोर्टल में रिफ़ंड करें। Sales > Returns में उत्पाद वापसी Comgate के ज़रिए पैसा वापस नहीं भेजती। Comgate पोर्टल में किए गए रिफ़ंड स्टोर को वापस रिपोर्ट नहीं होते।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Comgate Gateway, Extensions > Extensions > Payments > VibeFox Comgate Gateway > Edit पर पहला ब्लॉक है, जो सेटिंग्स के ऊपर होता है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: Check now (स्टेटस दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-payment-comgate वाली पंक्ति और 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 खाते में स्लॉट मुक्त करें।

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

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

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

Comgate does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, Merchant ID और Secret भरे हुए हैं, चेकआउट की मुद्रा समर्थित है, और ऑर्डर कुल Comgate की न्यूनतम सीमा (जैसे 1 CZK, 0.10 EUR या 100 HUF) से कम नहीं है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

The payment went through, but the order stays without a status: Comgate ने बैकग्राउंड नोटिफ़िकेशन नहीं पहुँचाया। Comgate पोर्टल में URL for passing the payment result (सेटिंग्स के Notification URL से बिल्कुल मेल खाना चाहिए) जाँचें, यह भी कि आपका स्टोर इंटरनेट से पहुँच योग्य है, और लॉग (Debug Log चालू करें) देखें। Comgate बिना डिलीवर हुए नोटिफ़िकेशन दोबारा भेजता है; एक्सटेंशन जब भी कोई नोटिफ़िकेशन प्रोसेस नहीं कर पाता, तब त्रुटि का जवाब देता है, इसलिए वह फिर से भेजा जाएगा। ग्राहक के स्टोर पर लौटने पर भी ऑर्डर को स्टेटस मिल जाता है।

Notification answers Invalid merchant or secret: सेटिंग्स का Merchant ID या secret, Comgate पोर्टल के स्टोर कनेक्शन से मेल नहीं खाता।

Notification answers Gateway not configured: सेटिंग्स में Merchant ID या secret खाली है। भरे जाने के बाद Comgate फिर से प्रयास करता है।

Notification answers Unknown transaction, Order not found or Reference mismatch: यह नोटिफ़िकेशन ऐसे भुगतान का है जो इस स्टोर ने उस ऑर्डर के लिए नहीं बनाया था। कुछ नहीं बदला जाता।

Notification answers Status verification failed, Status verification rejected or Busy, retry later: Comgate स्टेटस API तक नहीं पहुँचा जा सका, उसने अनुरोध अस्वीकार किया, या उसी समय कोई और अनुरोध ऑर्डर प्रोसेस कर रहा था। जब ऑर्डर स्टेटस सेट नहीं हो पाता, तब भी Busy उत्तर आता है; कारण लॉग में है। Comgate नोटिफ़िकेशन दोबारा भेजता है।

The notification URL shows code=1&message=POST%20required in the browser: यह सामान्य है। यह URL केवल Comgate के अनुरोध स्वीकार करता है।

The customer sees We could not verify the Comgate payment: रिटर्न लिंक ऑर्डर से मेल नहीं खाया। यदि राशि चार्ज हो गई है, तो भी नोटिफ़िकेशन ऑर्डर की पुष्टि करता है। ग्राहक दोबारा भुगतान करे, उससे पहले Comgate पोर्टल में भुगतान जाँचें।

The customer sees This payment method is not available. Please reload the checkout page.: चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट पेज को रीलोड करता है।

The customer sees The order total is below the minimum amount accepted by Comgate or A valid billing e-mail address is required for Comgate payments: ऑर्डर अपनी मौजूदा स्थिति में Comgate से भुगतान नहीं किया जा सकता।

Order is in the on-hold status after payment: VibeFox Comgate Gateway टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा अलग थी, लाइव मोड में टेस्ट भुगतान आया, या भुगतान केवल अधिकृत है। Comgate पोर्टल में भुगतान जाँचें, फिर ऑर्डर मैन्युअली पूरा करें या रिफ़ंड करें।

No refund form in the tab: टैब कारण बताता है: ऑर्डर में कोई पुष्ट Comgate भुगतान नहीं है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या Merchant ID और secret सेट नहीं हैं।

Refund fails: टैब का संदेश पढ़ें। Comgate rejected the refund: the amount exceeds the refundable amount. का अर्थ है कि राशि, रिफ़ंड के लिए बची राशि से अधिक है; PAID से भिन्न स्टेटस वाला भुगतान रिफ़ंड नहीं हो सकता। Comgate could not be reached. The refund was not made — please try again later. कनेक्शन समस्या को दर्शाता है।

डेवलपर्स के लिए: OpenCart इवेंट comgate_p_currencies (समर्थित मुद्राएँ और उनकी न्यूनतम सीमाएँ) और comgate_p_create_params (Comgate भुगतान और ऑर्डर के पैरामीटर) दूसरे एक्सटेंशनों को इन्हें बदलने देते हैं।

अनइंस्टॉलेशन

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

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

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