VibeFox GoPay for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: GoPay CZK, EUR, PLN, USD, GBP, HUF, RON और BGN स्वीकार करता है। किसी अन्य चेकआउट मुद्रा पर भुगतान विधि चेकआउट पर छिपी रहती है।
GoPay खाता: आपको अपने GoPay मर्चेंट खाते का GoID, Client ID और Client Secret चाहिए। ये खाते की इंटीग्रेशन सेटिंग्स में हैं। सैंडबॉक्स (परीक्षण) खाते के अपने अलग क्रेडेंशियल होते हैं। सूचनाओं के लिए GoPay खाते में कुछ सेट करने की ज़रूरत नहीं है, लेकिन आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ज़िप फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। उसमें README.txt, OpenCart 3 का पैकेज wcp_gopay_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_gopay_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। दोनों संस्करणों के लिए लाइसेंस कुंजी एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_gopay_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox GoPay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. सैंडबॉक्स GoID, Client ID और Client Secret दर्ज करें, Test Mode चालू रखें, Enable/Disable चालू करें और Save पर क्लिक करें।
5. एक परीक्षण ऑर्डर दें। सब कुछ काम करने पर production क्रेडेंशियल दर्ज करें और Test Mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_gopay_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 फ़ाइल के नाम से एक्सटेंशन कोड लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox GoPay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी और GoPay क्रेडेंशियल वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल नोटिफ़िकेशन URL अलग है (देखें भुगतान सूचनाएँ)।
नई इंस्टॉलेशन में भुगतान विधि बंद रहती है और test mode चालू रहता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox GoPay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर पेज Sandbox mode — test payments only या Production mode — real payments दिखाता है। यदि वर्तमान मोड के GoID, Client ID या Client Secret गायब हैं, या GoPay स्टोर की डिफ़ॉल्ट मुद्रा स्वीकार नहीं करता, तो यह चेतावनी देता है। क्रेडेंशियल के बिना GoPay चेकआउट पर नहीं दिया जाता; असमर्थित डिफ़ॉल्ट मुद्रा होने पर यह केवल उन ग्राहकों को दिया जाता है जो समर्थित मुद्रा पर स्विच करते हैं। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।
सहेजते समय, गलत मान वाला फ़ील्ड अपना पिछला मान रखता है और पेज एक त्रुटि दिखाता है; अन्य फ़ील्ड सहेजे जाते हैं। यह उस Title पर लागू होता है जो खाली हो या 128 अक्षरों से लंबा हो, उस GoID पर जिसमें 6 से 20 अंक न हों, उस Sort Order पर जो पूर्ण संख्या न हो, उस Total पर जो 0 या अधिक की संख्या न हो, और उस geo zone या ऑर्डर स्टेटस पर जो मौजूद न हो। सहेजने पर कैश किए गए GoPay एक्सेस टोकन भी साफ़ हो जाते हैं, ताकि नए क्रेडेंशियल तुरंत इस्तेमाल हों।
GoPay
Enable/Disable: Enable GoPay payment gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर दिखने वाला भुगतान विधि का शीर्षक। यह ऑर्डर में सहेजे गए भुगतान विधि के नाम के रूप में भी दर्ज होता है। डिफ़ॉल्ट: GoPay। अनिवार्य, 128 अक्षरों तक।
Description: Confirm Order चरण पर पुष्टि बटन के ऊपर दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely via GoPay - cards, wallets, bank transfers.
Sort Order: चेकआउट पर भुगतान विधियों के बीच GoPay की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें।
Geo Zone: GoPay केवल चुने गए geo zone में स्थित भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: चेकआउट का वह कुल योग, स्टोर की डिफ़ॉल्ट मुद्रा में, जो ऑर्डर को पहुँचना चाहिए, तभी GoPay दिया जाए। किसी भी राशि पर देने के लिए खाली छोड़ें।
API क्रेडेंशियल
GoID, Client ID और Client Secret आपके GoPay मर्चेंट खाते (इंटीग्रेशन सेटिंग्स) में दिखते हैं। सैंडबॉक्स (परीक्षण) खाते के अपने अलग क्रेडेंशियल होते हैं। इस सेक्शन में GoPay API दस्तावेज़ का लिंक है।
Test Mode: भुगतान को sandbox क्रेडेंशियल के साथ gw.sandbox.gopay.com पर भेजता है। कोई वास्तविक राशि नहीं ली जाती। production क्रेडेंशियल के साथ असली भुगतान स्वीकार करने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू।
Sandbox GoID: आपके GoPay sandbox (परीक्षण) खाते का GoID।
Sandbox Client ID: sandbox खाते का OAuth Client ID।
Sandbox Client Secret: sandbox खाते का OAuth Client Secret।
Production GoID: आपकी GoPay मर्चेंट ID (GoID)।
Production Client ID: GoPay का OAuth Client ID।
Production Client Secret: GoPay का OAuth Client Secret।
GoID में केवल 6 से 20 अंक होते हैं, उदाहरण के लिए 8123456789। यदि आप कुछ और दर्ज करते हैं, तो पेज GoID must contain digits only, 6 to 20 digits (for example 8123456789). The previous value was kept. दिखाता है।
सहेजे गए client secret कभी दोबारा नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
Clear saved client secrets: इसे चिह्नित करें और Save पर क्लिक करें, दोनों सहेजे गए client secret हट जाएँगे। खाली फ़ील्ड सहेजे गए मान को रखता है।
भुगतान
Payment Page Language: GoPay भुगतान पेज की भाषा। डिफ़ॉल्ट: Automatic (site language, then billing country)। स्वचालित मोड आपके स्टोरफ़्रंट की भाषा का उपयोग करता है; यदि GoPay उसे नहीं रखता, तो बिलिंग देश तय करता है, और अन्यथा अंग्रेज़ी उपयोग होती है। आप 19 भाषाओं में से कोई एक भी तय कर सकते हैं: Czech, English, Slovak, German, Polish, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Estonian, Latvian, Lithuanian, French, Italian, Spanish, Portuguese, Ukrainian या Russian।
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (missing order)। ऑर्डर को स्टेटस तभी मिलता है जब GoPay भुगतान की पुष्टि करे, सूचना से या ग्राहक की वापसी से; स्थिति हमेशा GoPay API से पढ़ी जाती है। नीचे का हर स्टेटस फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।
Order Status After Payment: भुगतान की पुष्टि होने पर सेट होने वाला ऑर्डर स्टेटस। डिफ़ॉल्ट: प्रक्रियाधीन। उदाहरण के लिए वर्चुअल उत्पादों के लिए पूर्ण चुनें।
GoPay Payment On Hold Status: ऐसे भुगतान जो ऑर्डर से मेल नहीं खाते, रद्द होने के बाद के भुगतान, और केवल पूर्व-प्राधिकृत भुगतान। एक नोट कारण बताता है; GoPay खाते में भुगतान जाँचें। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Order Status: इस स्टेटस (या रिफ़ंड स्टेटस) वाले ऑर्डर के लिए आने वाला GoPay भुगतान ऑर्डर को चुपचाप दोबारा खोलने के बजाय होल्ड पर रखता है। डिफ़ॉल्ट: रद्द।
Refunded Status: ऑर्डर पेज से या GoPay की रिपोर्ट पर भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: रिफ़ंड किया गया।
भुगतान सूचनाएँ
सूचना आपके स्टोर को बताती है कि भुगतान हो चुका है। Notification URL इस सेक्शन में दिखाया जाता है और हर भुगतान के साथ GoPay को भेजा जाता है, इसलिए GoPay खाते में कुछ सेट करने की ज़रूरत नहीं है। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_gopay_gateway/notify, और OpenCart 4 पर ऐसा: https://your-store/index.php?route=extension/wcp_gopay_gateway/payment/wcp_gopay_gateway.notify। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह इंटरनेट से पहुँच योग्य होना चाहिए: इसके सामने कोई पासवर्ड सुरक्षा या फ़ायरवॉल नहीं होना चाहिए। यह स्टोर के maintenance mode में होने पर भी काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है, जो सूचना और ग्राहक की GoPay से वापसी को आगे जाने देता है।
GoPay सूचनाओं में केवल भुगतान ID होता है और कोई हस्ताक्षर नहीं होता। हर सूचना की जाँच GoPay API से भुगतान की स्थिति पूछकर की जाती है, उसी मोड के क्रेडेंशियल के साथ जिसमें भुगतान हुआ था; भुगतान वह होना चाहिए जो एक्सटेंशन ने आपके स्टोर के किसी ऑर्डर के लिए बनाया था। जब GoPay से स्थिति नहीं पढ़ी जा सकती, तो आपका स्टोर एक त्रुटि के साथ उत्तर देता है, और GoPay सूचना को दोबारा भेजता है। सूचनाओं के बिना, ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।
उन्नत
Logging: GoPay घटनाओं को OpenCart लॉग फ़ोल्डर (storage/logs) में gopay_p_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं। क्रेडेंशियल, टोकन, कार्ड डेटा और ग्राहक का ईमेल तथा नाम कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। लॉग खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स, कैश किए गए GoPay एक्सेस टोकन और लॉग हट जाते हैं। ऑर्डर और उनका GoPay भुगतान डेटा हमेशा सुरक्षित रहता है। डिफ़ॉल्ट: बंद।
इम्पोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। client secret एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए client secret बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से GoPay)। Confirm Order चरण पर ग्राहक को आपका विवरण दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में, उत्पादों, गिफ़्ट सर्टिफ़िकेट, शिपिंग और अन्य ऑर्डर कुल योग के साथ, ऑर्डर कुल योग के लिए एक GoPay भुगतान बनाता है और ग्राहक को GoPay भुगतान पेज पर भेजता है। वहाँ GoPay आपके GoPay खाते में सक्षम भुगतान विधियाँ देता है, जैसे भुगतान कार्ड, बैंक ट्रांसफ़र और वॉलेट। ग्राहक का नाम, ईमेल, फ़ोन और भुगतान पता GoPay को दिए जाते हैं; खाली फ़ील्ड नहीं भेजे जाते। भुगतान GoPay पर ऑर्डर नंबर OC- और OpenCart ऑर्डर नंबर के साथ दिखता है।
OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में, भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। OpenCart 4 में गिफ़्ट सर्टिफ़िकेट नहीं होते, इसलिए GoPay को कोई भी नहीं भेजा जाता। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं माँगता; तब एक्सटेंशन GoPay को शिपिंग पते का नाम और पता भेजता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब GoPay उसकी पुष्टि करे: सूचना से, या ग्राहक के लौटने पर GoPay API को भेजे गए अनुरोध से। एक साथ आने वाली सूचना और वापसी एक के बाद एक संसाधित होती हैं, इसलिए भुगतान केवल एक बार लागू होता है। फिर ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर होल्ड स्टेटस में गया, तो पेज में Your payment is being reviewed. We will contact you if anything else is needed. जुड़ जाता है।
यदि ग्राहक के लौटने तक GoPay ने भुगतान की पुष्टि नहीं की है (उदाहरण के लिए बैंक ट्रांसफ़र रास्ते में है, या GoPay तक पहुँच नहीं हो पा रही है), तो एक Payment confirmation पेज GoPay 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 GoPay payment was not completed. You can try again or choose another payment method. या The GoPay payment was cancelled or has expired. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। हर नया प्रयास (OpenCart 3 में हर बार जब Confirm Order चरण दिखता है, OpenCart एक नया ऑर्डर बनाता है; OpenCart 4 में चेकआउट का ऑर्डर अपडेट होता है और उसी ऑर्डर नंबर के तहत एक नए GoPay भुगतान से उसका भुगतान होता है) पहले GoPay API से कार्ट के खुले GoPay भुगतान जाँचता है। यदि उनमें से कोई पहले ही भुगतान हो चुका है, तो वह भुगतान पक्का होता है और ग्राहक बिना दोबारा भुगतान किए सफलता पेज पर जाता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नई कार्ट माना जाता है जिसे अपना अलग भुगतान चाहिए।
OpenCart 4 ऑर्डर को सफलता पेज दिखने तक चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद कर दिया गया (उदाहरण के लिए आपने उसे रद्द या रिफ़ंड किया), तो ग्राहक Your previous order was cancelled or refunded. Please confirm the order again. (या रद्द भुगतान वाला संदेश) के साथ चेकआउट पर लौट जाता है, और अगला Confirm Order एक नया ऑर्डर चुकाता है। भुगतान किया हुआ ऑर्डर कभी किसी अलग कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।
यदि GoPay भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, उदाहरण के लिए GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. या GoPay is temporarily unavailable. Please try again in a moment or choose another payment method.। तकनीकी कारण लॉग में लिखा जाता है।
ग्राहक GoPay पेज पर भुगतान विधि चुनता है; उसे OpenCart में नहीं चुना जा सकता। एक्सटेंशन में सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, एम्बेडेड भुगतान फ़ॉर्म, और OpenCart से पूर्व-प्राधिकरणों का कैप्चर या रद्दीकरण नहीं है।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
No status (missing order): ग्राहक को GoPay पर भेजा गया था और उसने भुगतान नहीं किया, या GoPay ने अभी भुगतान की पुष्टि नहीं की है। रद्द या समाप्त हुआ GoPay भुगतान ऑर्डर को एक नोट के साथ बिना स्टेटस के छोड़ देता है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई है। एक नोट में GoPay भुगतान ID दिखता है।
GoPay Payment On Hold Status (डिफ़ॉल्ट Pending): GoPay ने भुगतान की पुष्टि की है, पर राशि, मुद्रा या ऑर्डर नंबर ऑर्डर से अलग है; या भुगतान तब आया जब ऑर्डर रद्द या रिफ़ंड हो चुका था; या भुगतान केवल पूर्व-प्राधिकृत है और पैसा अभी कैप्चर नहीं हुआ है। नोट इसे समझाता है। पूर्व-प्राधिकृत भुगतान को GoPay में कैप्चर करना होगा; फिर जब GoPay भुगतान को भुगतान किया हुआ बताता है, तब ऑर्डर भुगतान किए गए स्टेटस में चला जाता है।
Refunded Status (डिफ़ॉल्ट Refunded): ऑर्डर का GoPay भुगतान एक्सटेंशन के माध्यम से या GoPay खाते में पूरी तरह रिफ़ंड किया गया।
यदि पहले से भुगतान किए गए ऑर्डर का कोई और भुगतान प्रयास भी भुगतान हो जाए, या उसी कार्ट का कोई पुराना ऑर्डर भुगतान हो जाए, तो भुगतान किया हुआ ऑर्डर नहीं बदला जाता। एक नोट आपसे डुप्लिकेट भुगतान को GoPay खाते में रिफ़ंड करने को कहता है। जब किसी ऐसे ऑर्डर के लिए GoPay भुगतान हो जाए जिसे GoPay के बिना (उदाहरण के लिए मैन्युअल रूप से) पहले ही भुगतान किया हुआ चिह्नित किया गया था, तब भी ऐसा ही नोट जुड़ता है। रद्द या रिफ़ंड किया गया ऑर्डर किसी बाद की सूचना से कभी दोबारा नहीं खुलता।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता।
VibeFox GoPay Gateway टैब
Sales > Orders में GoPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox GoPay Gateway टैब में GoPay payment ID (sandbox भुगतानों पर Sandbox लेबल के साथ), GoPay state और भुगतान माध्यम, Payment amount, Paid / refunded, ऑर्डर होल्ड पर होने पर कारण के साथ Needs review, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के GoPay notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional), और Refund via GoPay पर क्लिक करें। Refund this amount through GoPay? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। GoPay आंशिक रिफ़ंड केवल भुगतान के 24 घंटे बाद तक स्वीकार करता है। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो GoPay ने चार्ज की थी, इसलिए राशि या मुद्रा में अंतर के बाद आप उतना ही रिफ़ंड कर सकते हैं जितना ग्राहक ने वास्तव में भुगतान किया था। रिफ़ंड भुगतान किए गए ऑर्डर के लिए और अंतर या देर से आए भुगतान के बाद होल्ड पर रखे ऑर्डर के लिए उपलब्ध हैं। रिफ़ंड उसी मोड में भेजा जाता है जिसमें भुगतान हुआ था (sandbox या production), इसलिए उस मोड के क्रेडेंशियल सेट होने चाहिए। यदि GoPay रिफ़ंड अस्वीकार करता है, तो टैब GoPay का संदेश दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में जुड़ता है; ऐसा रिफ़ंड जिसे GoPay ने बाद में प्रोसेस करने के लिए स्वीकार किया है, उसे स्वीकृत के रूप में नोट किया जाता है। पूर्ण रिफ़ंड ऑर्डर को बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में लौटाए Refunded Status पर सेट करता है, जैसे मैन्युअल स्टेटस बदलाव। आंशिक रिफ़ंड स्टेटस नहीं बदलता।
Sales > Returns में उत्पाद वापसी GoPay के माध्यम से पैसे वापस नहीं भेजती।
GoPay खाते में किए गए रिफ़ंड सूचना के ज़रिए आते हैं। पूर्ण रिफ़ंड ऑर्डर को रिफ़ंड स्टेटस में बदलता है; आंशिक रिफ़ंड एक नोट जोड़ता है। वे टैब के रिफ़ंड इतिहास में नहीं जोड़े जाते।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox GoPay Gateway, Extensions > Extensions > Payments > VibeFox GoPay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्टेटस (उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-gopay की पंक्ति और आपके 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, GoPay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देख पाता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है, और रिफ़ंड काम करते हैं।
जब लाइसेंस की अवधि समाप्त हो जाती है, तो एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं तो स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
GoPay does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में GoID, Client ID और Client Secret हैं, और चेकआउट मुद्रा CZK, EUR, PLN, USD, GBP, HUF, RON या BGN में से एक है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।
The payment went through, but the order stays without a status: GoPay सेटिंग्स में दिखाए गए notification URL तक नहीं पहुँच पाया, और ग्राहक स्टोर पर वापस नहीं आया। URL को रोकने वाली पासवर्ड सुरक्षा या फ़ायरवॉल नियम हटाएँ। जाँचें कि जिस मोड में भुगतान हुआ था उसके क्रेडेंशियल सेट हैं, क्योंकि हर सूचना उन्हीं से सत्यापित होती है। Logging चालू करें और Log फ़ील्ड देखें। GoPay उन सूचनाओं को दोबारा भेजता है जिन्हें सफल उत्तर नहीं मिला।
Notification answers Order not found: भुगतान इस स्टोर द्वारा नहीं बनाया गया था।
Notification answers Missing payment ID: अनुरोध GoPay से नहीं आया, या URL बदल दिया गया। कुछ करने की ज़रूरत नहीं है।
Notification answers Payment state could not be verified: GoPay API तक पहुँच नहीं हो पाई, या उस मोड के क्रेडेंशियल गायब या गलत हैं। GoPay सूचना दोबारा भेजता है।
Notification answers Busy, retry later: उसी समय ऑर्डर किसी दूसरे अनुरोध द्वारा संसाधित किया जा रहा था। GoPay सूचना दोबारा भेजता है। कारण देखने के लिए Logging चालू करें।
The customer sees an error after Confirm Order: Logging चालू करें और Log फ़ील्ड देखें। गलत क्रेडेंशियल, या दूसरे मोड के क्रेडेंशियल, आम कारण हैं। बिलिंग विवरण से जुड़ा संदेश बताता है कि GoPay ने ईमेल, फ़ोन या पता स्वीकार नहीं किया। This payment method is not available. Please reload the checkout page. का अर्थ है कि चेकआउट सेशन अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई।
The customer comes back and sees We could not verify the GoPay payment. If money was charged, please contact us before paying again.: वापसी लिंक स्टोर के किसी ऑर्डर से मेल नहीं खाया, उदाहरण के लिए वह किसी दूसरे ब्राउज़र में खोला गया या बदला गया। GoPay खाते में भुगतान जाँचें; सूचना फिर भी एक असली भुगतान की पुष्टि करती है।
Test payments do not confirm a live order: sandbox और production अलग रखे जाते हैं। हर भुगतान उसी मोड में जाँचा जाता है जिसमें वह बनाया गया था। Test Mode को वांछित मोड पर सेट करें और उस मोड के क्रेडेंशियल का उपयोग करें।
Order is in the on hold status after payment: VibeFox GoPay Gateway टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, भुगतान ऑर्डर रद्द होने के बाद आया, या भुगतान केवल पूर्व-प्राधिकृत है।
Refund fails: टैब में GoPay का संदेश पढ़ें। आंशिक रिफ़ंड केवल भुगतान के 24 घंटे बाद ही संभव है। मोड से जुड़ा संदेश बताता है कि भुगतान sandbox या production मोड में हुआ था और उस मोड के क्रेडेंशियल सेट नहीं हैं। You do not have permission to refund (modify this extension). का अर्थ है कि आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है।
डेवलपर्स के लिए: भुगतान को GoPay पर भेजने से पहले, एक्सटेंशन भुगतान अनुरोध और ऑर्डर के साथ OpenCart इवेंट gopay_p_payment_payload ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox GoPay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और चार ऑर्डर स्टेटस फ़ील्ड, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी हटते हैं, जो maintenance mode में सूचना और ग्राहक की वापसी को आगे जाने देता है)। यदि Delete Data on Uninstall चालू है, तो अन्य गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, क्रेडेंशियल, भुगतान पेज की भाषा, लॉगिंग), कैश किए गए GoPay एक्सेस टोकन और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे रहते हैं। ऑर्डर का GoPay भुगतान डेटा और रिफ़ंड हमेशा रखे जाते हैं, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकें। मौजूदा ऑर्डर अपनी भुगतान टिप्पणियाँ रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox GoPay Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल कूड़ेदान बटन) पर क्लिक करें।
GoPay उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन GoPay से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।