VibeFox Windcave for OpenCart — सहायता

आवश्यकताएँ

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

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

Windcave खाता: आपको REST API क्रेडेंशियल वाला Windcave मर्चेंट खाता चाहिए: एक API उपयोगकर्ता नाम और एक API key। Windcave इन्हें UAT टेस्ट वातावरण (uat.windcave.com) और प्रोडक्शन (sec.windcave.com) के लिए अलग-अलग जारी करता है। ये Windcave सपोर्ट या अपने खाता प्रबंधक से माँगें। PxPay keys इस एक्सटेंशन के साथ काम नहीं करतीं। जो भुगतान विधियाँ आप देना चाहते हैं (कार्ड, वॉलेट और अन्य), वे आपके Windcave खाते में सक्षम होनी चाहिए।

सूचना: Windcave अपनी भुगतान सूचना भेज सके, इसके लिए आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए। इसके लिए Windcave में कुछ भी सेट करने की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपना REST API उपयोगकर्ता नाम और key दर्ज करें: टेस्ट मोड के लिए UAT क्रेडेंशियल, और वास्तविक भुगतान के लिए प्रोडक्शन क्रेडेंशियल (देखें Configuration)।

5. लेन-देन का प्रकार और भुगतान विधियाँ चुनें, Enable/Disable चालू करें और Save पर क्लिक करें। Test mode चालू रहते हुए टेस्ट भुगतान करें, फिर वास्तविक भुगतान लेने के लिए Test mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। टेस्ट मोड चालू होने पर पेज Test mode is on: payments go to the Windcave UAT environment and no real money is taken. दिखाता है। यदि भुगतान विधि सक्षम है लेकिन वर्तमान मोड में API उपयोगकर्ता नाम या key नहीं है, तो पेज चेतावनी देता है कि चेकआउट पर यह विधि छिपी रहेगी, जैसे Windcave is enabled but the UAT API username / key are empty — the payment method is hidden at checkout. एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं होना चाहिए (Enter a title for the payment method (at most 128 characters).), Sort Order पूर्ण संख्या होना चाहिए (Sort Order must be a whole number.), Total 0 या उससे बड़ी संख्या होनी चाहिए (Total: enter a number, 0 or greater.), और चुना गया जियो ज़ोन व ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सहेजा नहीं जाता और पेज त्रुटि दिखाता है।

Windcave

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

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

Description: Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: You will be redirected to the secure Windcave payment page to complete your payment.

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

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

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

Windcave REST API

Windcave द्वारा जारी REST API क्रेडेंशियल (उपयोगकर्ता नाम और API key, PxPay keys नहीं) दर्ज करें। प्रोडक्शन और UAT क्रेडेंशियल साथ-साथ सहेजे जा सकते हैं। टेस्ट मोड केवल UAT क्रेडेंशियल, और लाइव मोड केवल प्रोडक्शन क्रेडेंशियल इस्तेमाल करता है। यह सेक्शन Windcave REST API दस्तावेज़ का लिंक देता है।

Test mode: Windcave के UAT टेस्ट वातावरण (uat.windcave.com) का उपयोग करता है। कोई वास्तविक राशि नहीं ली जाती। नए भुगतान UAT क्रेडेंशियल इस्तेमाल करते हैं। रिफ़ंड और कैप्चर हमेशा उसी वातावरण में जाते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: off।

Production API username: sec.windcave.com के लिए REST API उपयोगकर्ता नाम।

Production API key: sec.windcave.com के लिए REST API key।

UAT API username: uat.windcave.com (टेस्ट मोड) के लिए REST API उपयोगकर्ता नाम।

UAT API key: uat.windcave.com (टेस्ट मोड) के लिए REST API key।

सहेजी गई API keys फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजी गई key हटाने के लिए फ़ील्ड के नीचे Clear the saved key on save पर टिक लगाएँ और Save पर क्लिक करें।

Notification URL: वह पता दिखाता है जिस पर Windcave अपनी भुगतान सूचना (Fail-Proof Result Notification) भेजता है। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है और OpenCart 3 पर कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_windcave_payment_gateway/notify और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_windcave_payment_gateway/payment/wcp_windcave_payment_gateway.notify। Windcave में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है: एक्सटेंशन हर भुगतान सत्र के साथ अपने वापसी पते और यह सूचना पता भेजता है। यह पता इंटरनेट से पहुँच योग्य होना चाहिए; अन्यथा ऑर्डर केवल तभी पुष्ट होते हैं जब ग्राहक Windcave से लौटता है। न ग्राहक की वापसी और न ही सूचना Windcave द्वारा हस्ताक्षरित होती है, इसलिए एक्सटेंशन इन पर अकेले कभी भरोसा नहीं करता: वह हमेशा Windcave REST API से, सत्र जिस वातावरण में बना था उसके क्रेडेंशियल के साथ, सत्र का परिणाम पढ़ता है।

Payment

Transaction type: भुगतान कैसे लिया जाता है। डिफ़ॉल्ट: Purchase।

Payment methods: Windcave भुगतान पेज पर दिखाई देने वाली विधियाँ: Cards, Account2Account (न्यूज़ीलैंड बैंक ट्रांसफ़र), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm। आप एक से अधिक चुन सकते हैं। ये विधियाँ आपके Windcave खाते में सक्षम होनी चाहिए। खाते में सक्षम सभी विधियाँ दिखाने के लिए फ़ील्ड खाली छोड़ें (Every method enabled on the account)। डिफ़ॉल्ट: Cards।

Orders

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

Order Status After Payment: स्वीकृत Purchase के बाद या कैप्चर के बाद सेट होती है। डिफ़ॉल्ट: Processing।

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

Cancelled Order Status: एक्सटेंशन इसे सेट नहीं करता। इस स्थिति वाले ऑर्डर के लिए आया स्वीकृत भुगतान उसे नहीं बदलता; एक नोट आपसे उसे Windcave Payline में रिफ़ंड करने या ऑर्डर बहाल करने को कहता है। डिफ़ॉल्ट: Canceled।

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

Advanced

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

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

Clean uninstall: एक्सटेंशन हटाने पर उसकी सेटिंग्स और लॉग मिटा देता है। ऑर्डर के साथ सहेजा गया भुगतान डेटा (रिफ़ंड के लिए आवश्यक Windcave लेन-देन ID) हमेशा रखा जाता है। डिफ़ॉल्ट: off।

एक्सटेंशन का संस्करण सेक्शन के नीचे दिखाया जाता है।

Import / Export

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card (Windcave))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है; टेस्ट मोड में वह Test mode: payments go to the Windcave UAT environment, no real money is taken. भी देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक Windcave भुगतान सत्र बनाता है और ग्राहक को Windcave Hosted Payment Page पर भेजता है। OpenCart ऑर्डर नंबर मर्चेंट रेफ़रेंस के रूप में भेजा जाता है, साथ में ऑर्डर की भाषा और ग्राहक का नाम, ईमेल, फ़ोन और बिलिंग पता (और ऑर्डर को शिपिंग की ज़रूरत हो तो शिपिंग पता भी)। OpenCart 4 पर ग्राहक भुगतान विधि भुगतान विधि के ब्लॉक के Choose बटन से चुनता है, विंडो Payment method options में, और पेज के नीचे Confirm Order पर क्लिक करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Windcave उसकी पुष्टि करे: एक्सटेंशन ग्राहक की वापसी पर और Windcave की सूचना आने पर, दोनों ही समय, Windcave REST API से सत्र का परिणाम माँगता है। कार्ट-वार लॉक यह सुनिश्चित करता है कि भुगतान केवल एक बार लागू हो। इसके बाद ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक Your Windcave payment has been received. के साथ OpenCart का ऑर्डर सफलता पेज देखता है। होल्ड किए गए ऑर्डर (प्राधिकरण, या ऑर्डर से मेल न खाने वाला भुगतान) के लिए पेज Your payment was received by Windcave. The store will check it before processing your order — please do not pay again. दिखाता है।

यदि ग्राहक स्वीकृत भुगतान से लौटा है लेकिन परिणाम अभी ज्ञात नहीं है, तो Payment confirmation पेज We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. दिखाता है, साथ में एक Check again बटन। Windcave के भुगतान की पुष्टि करते ही सूचना ऑर्डर की स्थिति सेट कर देती है।

यदि ग्राहक बिना पूर्ण भुगतान के लौटता है, तो ऑर्डर बिना स्थिति के रहता है, कार्ट सुरक्षित रहता है, और चेकआउट पेज इनमें से कोई संदेश दिखाता है:

OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

ग्राहक उसी कार्ट के साथ फिर से प्रयास कर सकता है (OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए वही ऑर्डर एक नए Windcave सत्र में भुगतान होता है)। नया प्रयास पहले उस कार्ट के पिछले सत्रों की जाँच करता है: यदि उनमें से कोई पहले से भुगतान किया हुआ है, तो वह भुगतान लागू हो जाता है, ग्राहक सफलता पेज पर जाता है, और दूसरा भुगतान शुरू नहीं होता; यदि ग्राहक ने भुगतान पेज कभी इस्तेमाल नहीं किया और ऑर्डर नहीं बदला, तो उसे उसी पेज पर वापस भेज दिया जाता है। यदि उस समय पिछला भुगतान पुष्ट हो रहा है, तो ग्राहक को Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again. दिखता है।

यदि Windcave भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बटन के ऊपर एक संदेश के साथ रहता है: Windcave could not start the payment with the details of this order. Please check your billing details and try again, or choose another payment method. या The payment could not be started because the payment service is temporarily unavailable. Please try again in a moment or choose another payment method. कारण लॉग में लिखा जाता है। यदि वर्तमान मोड में क्रेडेंशियल नहीं हैं, तो ग्राहक को This payment method is not available at the moment. Please choose another payment method or contact us. दिखता है।

OpenCart 4 पर, यदि चेकआउट के ऑर्डर को Windcave भुगतान के बिना स्थिति मिल गई हो या इस बीच स्टोर ने उसे बंद कर दिया हो, तो अगला Confirm Order ग्राहक को चेकआउट पेज के ऊपर This order can no longer be paid. Please check your cart and confirm the order again. के साथ चेकआउट पर वापस भेजता है, और कार्ट का भुगतान नए ऑर्डर से होता है। यदि चेकआउट का ऑर्डर पहले से भुगतान हो चुका है, पर कार्ट तब से बदल गई है, नई मात्रा सहित, तो ग्राहक चेकआउट पर वापस भेजा जाता है और नई कार्ट का भुगतान नए ऑर्डर से होता है।

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

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

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

Order statuses

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

Order Status After Payment (डिफ़ॉल्ट Processing): एक Purchase भुगतान स्वीकृत हुआ और ऑर्डर से मेल खाता है। एक नोट राशि, लेन-देन ID, प्राधिकरण कोड, मास्क किए गए कार्ड नंबर के साथ कार्ड का प्रकार, और वातावरण (UAT या प्रोडक्शन) दिखाता है।

Windcave Payment On Hold Status, प्राधिकृत (डिफ़ॉल्ट Pending): एक Auth भुगतान स्वीकृत हुआ, पर अभी कैप्चर नहीं हुआ। नोट बताता है कि उसे कैप्चर या जारी कैसे करें।

Windcave Payment On Hold Status, मेल नहीं खाता (डिफ़ॉल्ट Pending): Windcave ने ऑर्डर से अलग राशि, मुद्रा, मर्चेंट रेफ़रेंस या लेन-देन प्रकार बताया (उदाहरण के लिए, भुगतान शुरू होने के बाद कार्ट को किसी दूसरे टैब में बदल दिया गया), या ऑर्डर पर पहले से किसी और ने स्थिति सेट कर रखी थी। नोट अंतर सूचीबद्ध करता है। स्वीकृत राशि फिर भी ऑर्डर टैब से रिफ़ंड की जा सकती है। शिपिंग से पहले Windcave Payline में भुगतान की जाँच करें और ज़रूरत हो तो रिफ़ंड करें।

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

यदि Cancelled Order Status वाले ऑर्डर के लिए स्वीकृत भुगतान आता है, या पहले से भुगतान किए गए ऑर्डर या कार्ट के लिए दूसरा स्वीकृत भुगतान आता है, तो ऑर्डर नहीं बदला जाता। लेन-देन ID वाला एक नोट आपसे Windcave Payline में उसे रिफ़ंड करने (या रद्द किए गए ऑर्डर को मैन्युअल रूप से बहाल करने) को कहता है।

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

VibeFox Windcave Payment Gateway tab

Sales > Orders में Windcave से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Windcave Payment Gateway टैब Transaction ID, Session ID, वातावरण सहित Type / status, Amount paid, Auth code / card, Capture transaction या जारी किया गया प्राधिकरण, Payment total / refunded, टेस्ट भुगतानों के लिए Test mode (UAT) लेबल, कैप्चर बटन, रिफ़ंड फ़ॉर्म और उसका इतिहास, Windcave sessions of this cart और ऑर्डर के Windcave notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।

Capture (Auth mode)

उस Windcave Payment On Hold Status ऑर्डर के लिए जिसका प्राधिकरण अभी कैप्चर या जारी नहीं हुआ है, टैब Capture Windcave payment दिखाता है। उस पर क्लिक करें और Capture the authorised amount through Windcave now? की पुष्टि करें। प्राधिकृत राशि कैप्चर होती है, ऑर्डर Order Status After Payment पर चला जाता है, और कैप्चर लेन-देन टैब में दिखता है। यदि Windcave कैप्चर स्वीकार नहीं करता, तो टैब Windcave capture failed: और कारण दिखाता है, कारण नोट्स में जुड़ जाता है, और ऑर्डर होल्ड पर रहता है। कैप्चर के लिए एक्सटेंशन बदलने का अधिकार और भुगतान के वातावरण के क्रेडेंशियल चाहिए।

Refunds

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

बिना कैप्चर किए Auth भुगतान के लिए बटन Release authorisation (void) होता है, और केवल पूरी राशि जारी की जा सकती है। आंशिक राशि पर एक त्रुटि आती है जो पूरी राशि रिफ़ंड करने या पहले भुगतान कैप्चर करने को कहती है।

यदि Windcave रिफ़ंड अस्वीकार करता है, तो टैब Windcave declined the refund: और कारण दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। यदि Windcave अभी भी रिफ़ंड संसाधित कर रहा है, तो टैब Windcave has not confirmed the refund yet. See the order notes. दिखाता है, और रिफ़ंड दर्ज नहीं होता। Windcave Payline में लेन-देन जाँचें: यदि वह स्वीकृत है, तो रिफ़ंड मैन्युअल रूप से दर्ज करें; अन्यथा फिर से प्रयास करें। उसी रिफ़ंड का दोबारा प्रयास Windcave को दो बार नहीं भेजा जाता।

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

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

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

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

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

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

Windcave चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में दोनों क्रेडेंशियल हैं: टेस्ट मोड में UAT API username और UAT API key, लाइव मोड में Production API username और Production API key। इनके गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहता है: एक्सटेंशन अभी तक Windcave से परिणाम नहीं ले पाया है। एक्सटेंशन पेज पर Log फ़ील्ड देखें: त्रुटियाँ हमेशा लॉग होती हैं, उदाहरण के लिए जब सत्र सत्यापित नहीं हो सका। जाँचें कि भुगतान के वातावरण के क्रेडेंशियल सहेजे गए हैं और सही हैं। जाँच तब दोहराई जाती है जब Windcave सूचना फिर से भेजता है (एक्सटेंशन त्रुटि कोड के साथ payment could not be verified yet, retry later से उत्तर देता है, ताकि Windcave फिर से प्रयास करे), जब ग्राहक Check again पर क्लिक करता है, और जब ग्राहक उसी कार्ट के लिए नया भुगतान शुरू करता है। आपके सर्वर को Windcave से आने वाले उन अनुरोधों को स्वीकार करना होगा जो सेटिंग्स में दिखाए गए Notification URL पर आते हैं।

सूचना order not found से उत्तर देती है: सत्र इस स्टोर द्वारा नहीं बनाया गया था, उदाहरण के लिए उसी Windcave खाते का उपयोग करने वाले किसी दूसरे स्टोर का सत्र। उसे अनदेखा किया जाता है।

लॉग में Authentication failed: REST API उपयोगकर्ता नाम या key गलत है, या दूसरे वातावरण की है। UAT क्रेडेंशियल केवल टेस्ट मोड में, और प्रोडक्शन क्रेडेंशियल केवल लाइव मोड में काम करते हैं। PxPay keys काम नहीं करतीं।

ग्राहक देखता है कि इस ऑर्डर के विवरण के साथ Windcave भुगतान शुरू नहीं कर सका: Windcave ने सत्र अनुरोध अस्वीकार किया, उदाहरण के लिए मुद्रा के कारण, या ऐसी भुगतान विधि के कारण जो आपके खाते में सक्षम नहीं है। सटीक कारण लॉग में है।

ग्राहक Confirm Order के बाद This payment method is not available. देखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट को फिर से लोड करता है।

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

टेस्ट भुगतान और वास्तविक भुगतान: UAT और प्रोडक्शन अलग रखे जाते हैं। हर सत्र उस वातावरण में जाँचा जाता है जिसमें वह बना था, और रिफ़ंड व कैप्चर भुगतान के वातावरण में जाते हैं, भले ही आप बाद में Test mode बदल दें।

रिफ़ंड वातावरण से जुड़े संदेश के साथ विफल होता है: भुगतान UAT या प्रोडक्शन में हुआ था, और उस वातावरण के क्रेडेंशियल सहेजे नहीं गए हैं। उन्हें दर्ज करें और फिर कोशिश करें।

ऑर्डर टैब में Capture Windcave payment नहीं दिखता: यह बटन केवल उन ऑर्डरों के लिए दिखता है जो Windcave Payment On Hold Status में हैं, Auth से भुगतान किए गए हैं और जिनका कैप्चर या रिलीज़ अभी नहीं हुआ है, केवल तब जब भुगतान के वातावरण के क्रेडेंशियल सहेजे गए हों, और केवल उन उपयोगकर्ताओं को जो एक्सटेंशन बदल सकते हैं।

विवरण कहाँ देखें: त्रुटियाँ और चेतावनियाँ हमेशा लॉग में लिखी जाती हैं; API अनुरोध और भुगतान इवेंट्स भी लॉग करने के लिए Debug log चालू करें।

डेवलपर्स के लिए: Windcave सत्र बनाने से पहले, एक्सटेंशन सत्र पैरामीटर और ऑर्डर के साथ OpenCart इवेंट windcave_p_session_request ट्रिगर करता है।

अनइंस्टॉल

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

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

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