VibeFox Comgate for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य होनी चाहिए, ताकि Comgate पृष्ठभूमि की सूचना भेज सके।

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

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

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

इंस्टॉलेशन

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

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

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

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

5. Comgate client portal से Merchant ID और Secret दर्ज करें, और वहीं सूचना URL सेट करें (देखें कॉन्फ़िगरेशन)।

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

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

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

सामान्य

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

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

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

Comgate कनेक्शन

Comgate client portal में Integration > shop connection settings से शॉप पहचानकर्ता (Merchant ID) और पासवर्ड (secret) लें। वहीं URL for passing the payment result (पृष्ठभूमि सूचना) को इस सेक्शन में दिखाए URL पर सेट करें। यह ऐसा दिखता है: https://your-site/wc-api/comgate_payment_callback/। Comgate हर भुगतान के बाद इसे कॉल करता है; तब प्लगइन ऑर्डर बदलने से पहले Comgate status API से भुगतान की दोबारा जाँच करता है। ग्राहक के लिए रिटर्न URL हर भुगतान के साथ भेजे जाते हैं। यदि पोर्टल रिटर्न URL (paid, cancelled, pending) भी माँगे, तो इस सेक्शन में दिखाया गया दूसरा URL उपयोग करें, जो ऐसा दिखता है: https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}।

Merchant ID: Comgate ई-शॉप पहचानकर्ता (merchant)।

Secret: इस शॉप कनेक्शन का पृष्ठभूमि संचार का पासवर्ड (secret)।

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

भुगतान पेज

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

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

ऑर्डर

Order Status After Payment: Comgate द्वारा भुगतान की पुष्टि होने पर सेट होने वाली स्थिति। स्थिति एक ही बार में सेट होती है, दूसरे स्थिति-बदलाव के बिना।

उन्नत

Debug Log: Log API requests and notifications को WooCommerce > Status > Logs में, source wcp_comgate_gateway के साथ लिखता है। सीक्रेट और व्यक्तिगत डेटा कभी लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: off।

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted। ऑर्डर और उनके Comgate लेन-देन हमेशा बने रहते हैं। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Comgate) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए ऑर्डर की मुद्रा में Comgate पर भुगतान बनाता है और ग्राहक को Comgate भुगतान पेज पर भेजता है। बिलिंग ईमेल और नाम Comgate को भेजे जाते हैं, और भुगतान पर ऑर्डर नंबर लिखा जाता है। एक मान्य बिलिंग ईमेल पता आवश्यक है। Comgate पेज पर ग्राहक आपकी अनुमति वाली विधियों में से किसी एक से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Comgate उसकी पुष्टि करे: प्लगइन Comgate status API से भुगतान पढ़ता है, पृष्ठभूमि सूचना आने पर भी और ग्राहक के लौटने पर भी। यदि भुगतान की अभी पुष्टि नहीं हुई है, उदाहरण के लिए बैंक ट्रांसफ़र रास्ते में है, तो ऑर्डर प्राप्त पेज पर यह संदेश दिखता है: Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. यदि ऑर्डर होल्ड पर रखा गया, तो पेज दिखाता है: Your payment is being reviewed. We will contact you if anything else is needed.

यदि भुगतान रद्द होता है या समाप्त हो जाता है, तो ग्राहक The Comgate payment was cancelled or has expired. You can try again or choose another payment method. के साथ चेकआउट (या कार्ट) पर लौटता है। ग्राहक किसी बिना भुगतान वाले ऑर्डर का भुगतान दोबारा कर सकता है, उदाहरण के लिए Pay for order पेज से। पिछला प्रयास पहले जाँचा जाता है, ताकि जो भुगतान पहले ही हो चुका है वह दो बार चार्ज न हो, और यदि वह अभी खुला है तो Comgate पर रद्द कर दिया जाता है। पुराने प्रयास का देर से आया भुगतान भी बिना भुगतान वाले ऑर्डर को चुका हुआ बनाता है।

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

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

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

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

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

Pending payment: ग्राहक को Comgate पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Comgate भुगतान को लंबित बताता है। ऑर्डर नोट में बनाया गया Comgate भुगतान दिखता है।

Processing या Completed: Comgate ने भुगतान को PAID बताया, उसी राशि और मुद्रा के साथ। स्थिति Order Status After Payment का अनुसरण करती है। ऑर्डर का लेन-देन ID Comgate लेन-देन ID है; सभी प्रयास ऑर्डर के साथ सहेजे जाते हैं। टेस्ट भुगतानों पर नोट लगता है: Comgate test payment — no money was charged.

On hold: भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न है, लाइव मोड में शॉप के दौरान टेस्ट भुगतान की पुष्टि हुई (कोई पैसा नहीं मिला), या भुगतान केवल प्राधिकृत है (आपके Comgate खाते पर प्री-प्राधिकरण)। प्राधिकृत भुगतान Comgate पोर्टल में कैप्चर करने पर अपने-आप भुगतान किया हुआ बन जाता है। ऑर्डर नोट कारण बताता है।

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

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Comgate पर क्लिक करें (बटन पर भुगतान विधि का शीर्षक दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड PAID Comgate लेन-देन पर जाता है और मूल भुगतान के मोड (टेस्ट या लाइव) में भेजा जाता है। Comgate केवल PAID भुगतानों का रिफ़ंड करता है, और अधिकतम चुकाई गई राशि तक; HUF रिफ़ंड पूरे फ़ोरिंट में होने चाहिए। यदि Comgate रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड राशि, Comgate लेन-देन और कारण के साथ ऑर्डर नोट में जुड़ता है।

Comgate पोर्टल में किए गए रिफ़ंड स्टोर को वापस रिपोर्ट नहीं होते। ज़रूरत हो तो WooCommerce में, गेटवे के Refund via के बिना, मैनुअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

Comgate चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, Merchant ID और Secret भरे हैं, ऑर्डर की मुद्रा समर्थित है, और ऑर्डर की कुल राशि Comgate की न्यूनतम सीमा से कम नहीं है (उदाहरण के लिए 1 CZK, 0.10 EUR या 100 HUF)। क्रेडेंशियल गायब होने या मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: Comgate पृष्ठभूमि की सूचना नहीं पहुँचा पाया। Comgate पोर्टल में URL for passing the payment result जाँचें, कि आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य है (कोई मेंटेनेंस मोड या पासवर्ड सुरक्षा नहीं), और लॉग देखें (Debug Log चालू करें)। Comgate बिना पहुँची सूचनाएँ दोबारा भेजता है; जब प्लगइन कोई सूचना प्रोसेस नहीं कर पाता, तो वह त्रुटि लौटाता है, इसलिए वह दोबारा प्रयास की जाएगी। ग्राहक के स्टोर पर लौटने पर भी ऑर्डर की पुष्टि होती है।

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

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

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

Notification answers Status verification failed, Status verification rejected या Busy, retry later: Comgate status API तक पहुँच नहीं हो पाई, उसने अनुरोध अस्वीकार किया, या उसी समय कोई और अनुरोध ऑर्डर को प्रोसेस कर रहा था। Comgate सूचना दोबारा भेजता है।

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

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 On hold after payment: ऑर्डर नोट पढ़ें। चुकाई गई राशि या मुद्रा भिन्न थी, लाइव मोड में टेस्ट भुगतान आया, या भुगतान केवल प्राधिकृत है। Comgate पोर्टल में भुगतान जाँचें, फिर ऑर्डर मैन्युअली पूरा करें या उसका रिफ़ंड करें।

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. का अर्थ है कनेक्शन की समस्या।

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

अनइंस्टॉल

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

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