VibeFox eWAY for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, cURL एक्सटेंशन के साथ।

मुद्रा: AUD, NZD, SGD, HKD या MYR। अन्य चेकआउट मुद्राओं के लिए भुगतान विधि चेकआउट पर छिपी रहती है। भुगतान ऑर्डर की मुद्रा में लिया जाता है।

eWAY खाता: आपको Rapid API पहुँच वाला eWAY मर्चेंट खाता और उसकी Rapid API कुंजी व पासवर्ड चाहिए। ये MyeWAY में Settings, API Key के अंतर्गत मिलते हैं। परीक्षण के लिए आपको अपनी कुंजी और पासवर्ड वाला eWAY sandbox खाता चाहिए। Sandbox और लाइव कुंजियाँ अलग-अलग होती हैं। MyeWAY में कुछ भी सेट करने की आवश्यकता नहीं है: हर भुगतान के साथ रिटर्न URL भेजा जाता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी sandbox API कुंजी और पासवर्ड दर्ज करें, Sandbox Mode चालू रखें, Enable/Disable चालू करें, Save पर क्लिक करें और एक टेस्ट ऑर्डर दें।

5. अपनी लाइव API कुंजी और पासवर्ड दर्ज करें, Sandbox Mode बंद करें और Save पर क्लिक करें।

6. वैकल्पिक: सेटिंग्स पेज पर दिखाए गए cron URL को अपने सर्वर के cron जॉब में जोड़ें (देखें कॉन्फ़िगरेशन)।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी, eWAY कुंजियाँ और cron URL उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 6 में है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल cron URL अलग है (देखें Re-check of lost returns (cron))।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox eWAY Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर एक बैज मोड दिखाता है: SANDBOX — payments go to the eWAY sandbox, no real money is charged. या LIVE — real payments are taken with the live API key. यदि वर्तमान मोड की API कुंजी या पासवर्ड गायब है (तब भुगतान विधि चेकआउट पर नहीं दिखती), या स्टोर की डिफ़ॉल्ट मुद्रा eWAY द्वारा समर्थित नहीं है, तो पेज चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

सहेजते समय, Title में 1 से 128 अक्षर होने चाहिए, Sort Order पूर्ण संख्या होनी चाहिए, Total शून्य से कम न हो, और चुना गया जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए। अन्यथा कुछ भी सहेजा नहीं जाता और पेज बताता है कि क्या सुधारना है।

eWAY

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

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

Description: Confirm Order चरण में, कन्फ़र्म बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.

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

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

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

API क्रेडेंशियल

Rapid API कुंजी और पासवर्ड MyeWAY में Settings, API Key के अंतर्गत हैं। eWAY के पास लाइव और sandbox कुंजियों के गाइड हैं, जो इस सेक्शन में लिंक किए गए हैं। Sandbox और लाइव कुंजियाँ अलग-अलग हैं। Sandbox मोड केवल sandbox क्रेडेंशियल का उपयोग करता है, और लाइव मोड केवल लाइव क्रेडेंशियल का।

Sandbox Mode: भुगतान sandbox कुंजी और पासवर्ड के साथ eWAY sandbox में जाते हैं। कोई वास्तविक राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। लाइव कुंजी से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर, ग्राहक Confirm Order चरण में Test mode: no real payment is taken. देखते हैं।

Live API Key: आपके लाइव eWAY खाते की Rapid API कुंजी।

Live API Password: आपके लाइव eWAY खाते का Rapid API पासवर्ड।

Sandbox API Key: आपके eWAY sandbox (पार्टनर/डेवलपर) खाते की Rapid API कुंजी।

Sandbox API Password: आपके eWAY sandbox खाते का Rapid API पासवर्ड।

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

Return URL: एक्सटेंशन का रिटर्न पता दिखाता है। इसे हर भुगतान के साथ ऑर्डर और भुगतान प्रयास की एक यादृच्छिक कुंजी के साथ अपने आप eWAY को भेजा जाता है, इसलिए MyeWAY में कुछ भी सेट करने की आवश्यकता नहीं है। भुगतान का परिणाम हमेशा eWAY से सर्वर-से-सर्वर पर पढ़ा जाता है।

Re-check of lost returns (cron): एक वैकल्पिक cron URL, जो Return URL के नीचे दिखता है। इसे अपने सर्वर के cron जॉब से हर 15 मिनट पर कॉल करें, उदाहरण के लिए curl से। यदि ग्राहक भुगतान करता है और स्टोर पर लौटने से पहले ब्राउज़र बंद कर देता है, तो ग्राहक को eWAY पर भेजे जाने के लगभग 60 मिनट बाद eWAY से भुगतान के बारे में पूछा जाता है और ऑर्डर अपडेट हो जाता है। यदि eWAY तक पहुँच नहीं है, तो जाँच तीन बार तक दोहराई जाती है। इस URL को गोपनीय रखें: इसमें इंस्टॉल के समय बना एक गुप्त टोकन है, और गलत टोकन के साथ कॉल का उत्तर Forbidden होता है। OpenCart 4 पर URL इस तरह दिखता है: https://your-store/index.php?route=extension/wcp_eway_payment_gateway/payment/wcp_eway_payment_gateway.cron&token=(token)।

ऑर्डर

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

Order Status on Success: eWAY के भुगतान की पुष्टि करने पर सेट की जाने वाली स्थिति। डिफ़ॉल्ट: प्रक्रियाधीन।

eWAY payment on hold status: स्वीकृत लेकिन आपकी समीक्षा वाले भुगतान की स्थिति: राशि या मुद्रा ऑर्डर से मेल नहीं खाती, ग्राहक द्वारा eWAY पेज पर Cancel दबाने के बाद भुगतान स्वीकृत हुआ, या ऑर्डर पर पहले से कोई दूसरी स्थिति थी। ऑर्डर इतिहास का एक नोट कारण समझाता है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

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

उन्नत

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

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

Delete all extension data on uninstall: चालू होने पर, एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के eWAY भुगतान और रिफ़ंड के रिकॉर्ड हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

आयात / निर्यात

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। एक्सटेंशन ब्राउज़र पर भरोसा नहीं करता: वह इस ऑर्डर के लिए बने भुगतान पेज का परिणाम eWAY से सर्वर-से-सर्वर पर पूछता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब eWAY पुष्टि करता है और स्वीकृत राशि तथा मुद्रा ऑर्डर से मेल खाती हैं। फिर ऑर्डर OpenCart के मानक तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। रोक कर रखे गए ऑर्डर के लिए पेज अतिरिक्त रूप से Your payment was received and is being reviewed by the store. We will contact you if anything is needed. दिखाता है।

यदि उस समय eWAY से नहीं पूछा जा सकता, तो Payment confirmation पेज We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. दिखाता है, साथ में Check again बटन और Back to checkout बटन। जब ग्राहक दोबारा जाँचता है या cron URL चलता है, तब ऑर्डर को स्थिति मिलती है।

यदि भुगतान अस्वीकार होता है, तो ग्राहक कारण के साथ चेकआउट पर लौट आता है, उदाहरण के लिए Your payment was declined: D4451 Insufficient funds. Please try again or use a different payment method. ऑर्डर बिना स्थिति के रहता है। यदि ग्राहक eWAY पेज पर Cancel पर क्लिक करता है, तो एक्सटेंशन पहले eWAY से जाँचता है कि कुछ भी भुगतान नहीं हुआ (उदाहरण के लिए किसी दूसरे टैब में)। उसके बाद ग्राहक को You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. दिखता है। यदि भुगतान पूरा नहीं हुआ, तो संदेश है The payment was not completed. Please try again. हर स्थिति में कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

ग्राहक फिर से कोशिश कर सकता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है, इसलिए नई कोशिश उसी ऑर्डर के लिए एक नया eWAY भुगतान पेज खोलती है। नया भुगतान पेज बनाने से पहले इस ऑर्डर और इसी कार्ट के दूसरे ऑर्डरों के पिछले भुगतान पेज eWAY से जाँचे जाते हैं। यदि उनमें से कोई पहले से भुगतान किया हुआ है, तो दूसरे भुगतान के बजाय वही भुगतान पक्का किया जाता है। यदि उनके बारे में eWAY से नहीं पूछा जा सकता, तो ग्राहक को We could not check the status of your previous payment attempt. Please try again in a moment. दिखता है। यदि eWAY भुगतान पेज नहीं बना सकता, तो ग्राहक Confirm Order चरण पर ही रहता है, एक छोटे संदेश के साथ, उदाहरण के लिए Payment error: Unable to connect to eWAY. Please try again. या eWAY त्रुटि कोड के साथ eWAY could not start the payment।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद कर दिया गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order कार्ट के लिए एक नया ऑर्डर चुकाता है। यदि वह ऑर्डर पहले से भुगतान किया हुआ है, लेकिन उसके बाद कार्ट बदल गया है, जिसमें मात्रा का नया होना भी शामिल है, तो संदेश है Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. भुगतान किया हुआ ऑर्डर कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

रिटर्न और cron URL स्टोर के मेंटेनेंस मोड में होने पर भी काम करते हैं, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन उनके लिए एक startup action जोड़ता है।

eWAY Shared Page के लिए सर्वर-से-सर्वर सूचनाएँ नहीं भेजता: परिणाम तब लिया जाता है जब ग्राहक लौटता है और cron URL द्वारा। एक्सटेंशन की आपकी साइट पर कोई कार्ड फ़ील्ड नहीं है, कोई सहेजे गए कार्ड या सब्सक्रिप्शन नहीं हैं, केवल-अधिकृत और बाद में कैप्चर नहीं है, और Beagle धोखाधड़ी स्कोर का मूल्यांकन नहीं करता (eWAY के धोखाधड़ी नियमों से रोके गए लेन-देन को eWAY स्वयं अस्वीकार करता है)।

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

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

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

Order Status on Success (default Processing): भुगतान स्वीकृत हो गया। एक नोट eWAY ट्रांज़ैक्शन ID, ऑथ कोड, प्रतिक्रिया और मोड (sandbox या लाइव) दिखाता है।

eWAY payment on hold status (default Pending): eWAY ने ऑर्डर से अलग राशि या मुद्रा स्वीकृत की (उदाहरण के लिए Approved for partial amount), ग्राहक द्वारा eWAY पेज पर रद्द करने के बाद भुगतान स्वीकृत हुआ, या उस ऑर्डर के लिए स्वीकृत हुआ जिसे आप पहले ही कोई स्थिति दे चुके थे, उदाहरण के लिए Canceled। eWAY ने वास्तव में जो राशि ली, वह दर्ज होती है, और नोट उसे समझाता है। ऑर्डर की जाँच करें और उसे पूरा करें या भुगतान रिफ़ंड करें।

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

यदि पहले से भुगतान किए गए ऑर्डर के लिए, या इसी कार्ट के किसी दूसरे ऑर्डर के लिए दूसरा भुगतान स्वीकृत होता है, तो भुगतान किया हुआ ऑर्डर नहीं बदलता। एक नोट आपसे MyeWAY में डुप्लिकेट को रिफ़ंड करने को कहता है। किसी दूसरे इनवॉइस संदर्भ के लिए स्वीकृत भुगतान कभी ऑर्डर पर लागू नहीं होता।

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

VibeFox eWAY Payment Gateway टैब

Sales > Orders में eWAY से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox eWAY Payment Gateway टैब Sandbox या Live लेबल के साथ eWAY transaction ID, Auth code, eWAY का Response, Invoice reference, भुगतान का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के eWAY notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

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

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

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

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

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

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

eWAY does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की API कुंजी और पासवर्ड सेट हैं (sandbox मोड में sandbox फ़ील्ड, लाइव मोड में लाइव फ़ील्ड), और चेकआउट मुद्रा AUD, NZD, SGD, HKD या MYR है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

The payment went through, but the order stays without a status: ग्राहक eWAY से वापस नहीं आया, या उस समय eWAY से नहीं पूछा जा सका। eWAY Shared Page के लिए सूचनाएँ नहीं भेजता। Re-check of lost returns (cron) का cron URL सेट करें: वह लगभग एक घंटे बाद भुगतान उठा लेगा। MyeWAY में ट्रांज़ैक्शन की जाँच करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

The cron URL answers Forbidden: URL में टोकन गलत है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स पेज दिखाता है।

The customer sees This payment method is temporarily unavailable: वर्तमान मोड की API कुंजी या पासवर्ड गायब हैं, या eWAY ने उन्हें अस्वीकार किया। वर्तमान मोड के क्रेडेंशियल जाँचें।

The customer sees eWAY could not start the payment: eWAY ने त्रुटि कोड लौटाए, जो संदेश में दिखते हैं। अक्सर बिलिंग विवरण अमान्य होते हैं।

The customer sees eWAY cannot take payments in a currency: ऑर्डर की मुद्रा उन मुद्राओं में से नहीं है जो eWAY लेता है। AUD, NZD, SGD, HKD या MYR का उपयोग करें।

The customer sees We could not match this payment to an order: रिटर्न लिंक इस स्टोर के किसी ऑर्डर का नहीं है, या eWAY ने किसी दूसरे इनवॉइस संदर्भ के लिए भुगतान स्वीकृत किया। यदि ग्राहक से राशि ली गई है, तो MyeWAY में भुगतान खोजें।

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

Order is in the on hold status after payment: VibeFox eWAY Payment Gateway टैब के eWAY notes पढ़ें (देखें ऑर्डर स्थितियाँ), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

Refund fails with a message about the sandbox or live mode: ऑर्डर उस वातावरण में भुगतान किया गया था, और उसकी API कुंजी और पासवर्ड सेट नहीं हैं। उन्हें दर्ज करें और फिर कोशिश करें।

Refund fails with at most … can be refunded: राशि, eWAY द्वारा ली गई राशि में से पहले किए गए रिफ़ंड घटाने के बाद की राशि से अधिक है।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wcp_eway_payment_gateway_supported_currencies (यदि आपका eWAY खाता अधिक मुद्राओं के लिए सक्षम है) और wcp_eway_payment_gateway_create_access_code_request (भुगतान पेज बनने से पहले का अनुरोध बॉडी) ट्रिगर करता है।

अनइंस्टॉल

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

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

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