VibeFox Square for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: ऑर्डर की मुद्रा आपकी Square location की मुद्रा होनी चाहिए: USD, CAD, AUD, JPY, GBP या EUR। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है। JPY पूर्ण येन में चार्ज होता है।

Square खाता: आपके पास Square Developer Dashboard में एक application होना चाहिए। वहाँ से आप Application ID और Access Token (Credentials पेज) तथा Location ID (Locations पेज) कॉपी करते हैं। Sandbox और Production के मान अलग-अलग होते हैं। कोई वेबहुक आवश्यक नहीं है: एक्सटेंशन भुगतान का परिणाम सीधे Square के उत्तर से प्राप्त करता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Sandbox Mode चालू रखें और sandbox के Application ID, Access Token और Location ID दर्ज करें (देखें कॉन्फ़िगरेशन)। Save पर क्लिक करें: एक्सटेंशन Square के साथ क्रेडेंशियल की जाँच करता है।

5. Enable/Disable चालू करें, सेव करें, और Square की sandbox टेस्टिंग गाइड के टेस्ट कार्ड से एक भुगतान आज़माएँ। फिर Sandbox Mode बंद करें, production क्रेडेंशियल दर्ज करें और दोबारा सेव करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और Square के क्रेडेंशियल वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Square Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, जब sandbox मोड चालू होता है, पेज Square Gateway अभी SANDBOX मोड में है। कोई वास्तविक चार्ज नहीं किया जाएगा। दिखाता है। यह चेतावनी देता है जब Square चालू है पर चुने गए मोड का Application ID, Access Token या Location ID गायब है (तब चेकआउट पर भुगतान विधि छिप जाती है), जब Square आपके स्टोर की डिफ़ॉल्ट मुद्रा प्रोसेस नहीं कर सकता, और जब आपकी Square location की मुद्रा उससे अलग है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्णांक होना चाहिए (ऋणात्मक मान स्वीकार्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता। फिर एक्सटेंशन चुने गए मोड के क्रेडेंशियल Square के साथ जाँचता है। सेटिंग्स हर हाल में सेव होती हैं, और चेतावनियाँ सेटिंग्स के ऊपर लाल ब्लॉक में दिखती हैं: Square ने Access Token अस्वीकार किया, इस टोकन के लिए Location ID नहीं मिला, क्रेडेंशियल की जाँच नहीं हो सकी, या location की मुद्रा स्टोर की मुद्रा से अलग है। Square केवल location की मुद्रा में चार्ज कर सकता है: एक्सटेंशन जाँची गई location की मुद्रा याद रखता है और किसी दूसरी मुद्रा के ऑर्डर के लिए भुगतान विधि छिपा देता है। यह यह भी चेतावनी देता है कि यदि sandbox Application ID को live मोड में या उल्टे क्रम में उपयोग किया गया हो।

Square

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

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। यह ऑर्डर में सेव होने वाला भुगतान विधि का नाम भी है। डिफ़ॉल्ट: Credit / debit card। आवश्यक।

Description: Confirm Order चरण में कार्ड फ़ॉर्म के ऊपर ग्राहक को दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely with your credit or debit card via Square.

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

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

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

Square खाता

Square Developer Dashboard खोलें (इस सेक्शन में उसका लिंक है), अपना application चुनें, Credentials पेज से Application ID और Access token (Sandbox और Production के मान अलग हैं) कॉपी करें, और Locations पेज से Location ID कॉपी करें। location की मुद्रा आपके स्टोर की मुद्रा से मेल खानी चाहिए। पेज केवल चुने गए मोड के क्रेडेंशियल फ़ील्ड दिखाता है: Sandbox Mode चालू होने पर sandbox फ़ील्ड, बंद होने पर live फ़ील्ड। दोनों सेट सेव रहते हैं।

Sandbox Mode: भुगतान Square sandbox में जाते हैं और कोई वास्तविक राशि नहीं काटी जाती। Square के टेस्ट कार्ड इस्तेमाल करें। डिफ़ॉल्ट: चालू। किसी ऑर्डर के रिफ़ंड हमेशा उसी वातावरण और location का उपयोग करते हैं जिसमें ऑर्डर का भुगतान हुआ था।

Sandbox Application ID: आपका Square sandbox Application ID (sandbox-sq0idb- से शुरू होता है)।

Sandbox Access Token: आपका Square sandbox Access Token।

Sandbox Location ID: आपका Square sandbox Location ID।

Live Application ID: आपका Square live Application ID (sq0idp- से शुरू होता है)।

Live Access Token: आपका Square live Access Token।

Live Location ID: आपका Square live Location ID।

सेव किए गए Access Token फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सेव किया गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया हुआ Access Token हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save पर निशान लगाएँ और Save पर क्लिक करें।

ऑर्डर

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

Order Status After Payment: Square ने ऑर्डर की राशि और मुद्रा के बिल्कुल मेल खाता भुगतान पूरा कर दिया है। डिफ़ॉल्ट: Processing।

On Hold (Review) Status: भुगतान को आपकी समीक्षा चाहिए (देखें ऑर्डर स्थितियाँ)। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

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

उन्नत

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

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / debit card)। Confirm Order चरण पर ग्राहक को Credit / debit card (Square), आपका विवरण, sandbox मोड चालू होने पर SANDBOX मोड — कोई वास्तविक चार्ज नहीं किया जाएगा। और Square का कार्ड फ़ॉर्म दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, पर अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो कार्ड ब्राउज़र में खरीदार सत्यापन (3-D Secure / SCA) के साथ टोकनाइज़ होता है: ऑर्डर की राशि, मुद्रा और भुगतान पता Square को भेजे जाते हैं, और ग्राहक का बैंक पुष्टि माँग सकता है। आपका स्टोर केवल एक बार उपयोग होने वाला टोकन पाता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है। फिर Square का कार्ड फ़ॉर्म चेकआउट पेज के नीचे, Confirm Order के ऊपर वाले ब्लॉक में दिखता है।

इसके बाद एक्सटेंशन Square Payments API के माध्यम से टोकन पर ऑर्डर की राशि, ऑर्डर की मुद्रा में चार्ज करता है, संदर्भ के रूप में ऑर्डर नंबर के साथ, ऑर्डर नंबर और आपके स्टोर के नाम वाला Order # नोट, और ग्राहक का ईमेल। भुगतान तुरंत कैप्चर होता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Square पुष्टि कर दे: Square के उत्तर में कुल ऑर्डर राशि, मुद्रा, ऑर्डर नंबर और location से बिल्कुल मेल खाता COMPLETED भुगतान दिखना चाहिए। फिर ऑर्डर OpenCart के मानक तरीके से Order Status After Payment पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है जिस पर आपका कार्ड भुगतान प्राप्त हो गया है। लिखा होता है और Square रसीद का लिंक View the receipt होता है। यदि भुगतान COMPLETED नहीं है या कोई मान मेल नहीं खाता, तो ऑर्डर On Hold (Review) Status पाता है और पेज पर आपका कार्ड भुगतान प्राप्त हो गया है और उसकी समीक्षा हो रही है। समीक्षा पूरी होते ही हम आपका ऑर्डर अपडेट करेंगे। दिखता है।

प्रति कार्ट एक समय में केवल एक भुगतान प्रयास चलता है। यदि ग्राहक दो बार क्लिक करता है या दो टैब में भुगतान करता है, तो दूसरे प्रयास को इस ऑर्डर का भुगतान पहले से हो रहा है। कृपया कुछ क्षण प्रतीक्षा करें और दोबारा प्रयास करने से पहले अपना ईमेल जाँचें। दिखता है। अनुरोध इडेम्पोटेंट होते हैं, और OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, इसलिए एक्सटेंशन कार्ट को ट्रैक करता है: जिस कार्ट का भुगतान हो चुका है, उसे दोबारा चार्ज नहीं किया जाता, और ग्राहक सीधे सफलता पेज पर पहुँचता है।

यदि Square उत्तर नहीं देता (नेटवर्क समस्या, टाइमआउट, सर्वर त्रुटि), तो वही idempotency key लेकर अनुरोध एक बार दोबारा भेजा जाता है। फिर भी उत्तर न मिले, तो एक्सटेंशन तुरंत Square में इस ऑर्डर का भुगतान खोजता है। यदि मिल जाए, तो ऑर्डर उसी के आधार पर स्थिति पाता है। यदि कोई भुगतान नहीं मिलता, तो ग्राहक Confirm Order चरण पर रहता है और भुगतान प्रदाता से पुष्टि प्राप्त नहीं हो सकी। कृपया एक मिनट बाद फिर प्रयास करें — यदि आपके कार्ड से पहले ही शुल्क लिया जा चुका है, तो भुगतान पहचाना जाएगा और आपसे दोबारा शुल्क नहीं लिया जाएगा। देखता है। उसी कार्ट का अगला प्रयास पहले पिछला भुगतान फिर से खोजता है। यदि इस खोज के लिए भी Square से संपर्क नहीं हो पाता, तो ऑर्डर बिना भुगतान के On Hold (Review) Status पाता है, साथ में यह नोट कि कार्ड से शुल्क लिया गया हो सकता है, और सफलता पेज दिखाता है Square से आपके कार्ड भुगतान की पुष्टि प्राप्त नहीं हो सकी। दोबारा भुगतान करने से पहले कृपया अपना ईमेल और कार्ड स्टेटमेंट जाँचें, या हमसे संपर्क करें।

जब बैंक कार्ड अस्वीकार करता है, तो ऑर्डर बिना स्थिति के रहता है और ग्राहक Square के त्रुटि कोड के अनुसार एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, उदाहरण के लिए आपका कार्ड अस्वीकार कर दिया गया। कृपया कोई दूसरा कार्ड या भुगतान विधि इस्तेमाल करें।, कार्ड का सुरक्षा कोड (CVV) गलत है। कृपया जाँचकर फिर प्रयास करें। या आपके बैंक को अतिरिक्त सत्यापन (3-D Secure) चाहिए। कृपया अपना कार्ड दोबारा दर्ज करें और सत्यापन पूरा करें। कार्ट सुरक्षित रहता है, और ग्राहक किसी दूसरे कार्ड से फिर प्रयास कर सकता है। तकनीकी कारण लॉग में लिखा जाता है।

OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए कार्ड अस्वीकृत होने के बाद ग्राहक उसी ऑर्डर का फिर से भुगतान करता है। Square से उत्तर के बिना भुगतान होने पर उस ऑर्डर का अगला प्रयास पहले पिछला भुगतान खोजता है। यदि चेकआउट के ऑर्डर की पहले से कोई स्थिति है (उसका भुगतान हो चुका है या स्टोर ने उसे बंद कर दिया है) और कार्ट में नए उत्पाद हैं, तो ग्राहक चेकआउट पर वापस भेज दिया जाता है और नए कार्ट का भुगतान नए ऑर्डर से होता है।

एक्सटेंशन केवल कार्ड भुगतान लेता है, जो तुरंत कैप्चर होते हैं। इसमें सेव किए गए कार्ड, ग्राहक प्रोफ़ाइल, सब्सक्रिप्शन, Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH या Square गिफ़्ट कार्ड नहीं हैं, केवल-authorization भुगतान नहीं हैं, Square वेबहुक नहीं हैं, और Square के साथ उत्पाद या इन्वेंटरी सिंक्रोनाइज़ेशन नहीं है। विवाद (disputes) Square Dashboard में संभाले जाते हैं।

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

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

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

Order Status After Payment (डिफ़ॉल्ट Processing): Square ने ऑर्डर की कुल राशि का COMPLETED भुगतान पुष्ट किया। एक नोट में Square भुगतान ID, कार्ड ब्रांड और अंतिम 4 अंक, तथा मोड (sandbox या live) दिखते हैं।

On Hold (Review) Status (डिफ़ॉल्ट Pending): Square ने ऐसे भुगतान के साथ उत्तर दिया जो COMPLETED नहीं है (उदाहरण के लिए APPROVED या PENDING), या अलग राशि, मुद्रा, संदर्भ या location के साथ। Square भुगतान की समीक्षा आवश्यक है नोट में भुगतान ID, स्थिति और राशियाँ दिखती हैं। यह स्थिति तब भी उपयोग होती है जब भुगतान के दौरान ऑर्डर बदल गया हो, और जब Square का उत्तर खो गया हो और जाँचा न जा सका हो (तब कोई भुगतान दर्ज नहीं होता, और नोट आपसे ऑर्डर नंबर को संदर्भ मानकर Square Dashboard में location के भुगतान जाँचने को कहता है)। ऑर्डर पूरा करने से पहले Square Dashboard में भुगतान सत्यापित करें।

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

यदि ऐसे कार्ट के लिए दूसरा भुगतान आता है जिसका पहले से भुगतान किया हुआ ऑर्डर है, तो भुगतान किया हुआ ऑर्डर नहीं बदला जाता। एक नोट आपसे उसे जाँचने और Square Dashboard में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है।

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

VibeFox Square Gateway टैब

Sales > Orders में Square से भुगतान किया हुआ ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Square Gateway टैब Square Payment ID दिखाता है (Square Dashboard में भुगतान से लिंक), sandbox भुगतानों के लिए Sandbox लेबल के साथ, साथ में Square Status, Card ब्रांड और अंतिम 4 अंक, Paid / order / refunded राशियाँ, Environment / location, Square receipt लिंक, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Square notes। कार्ड नंबर कभी संग्रहीत नहीं होते। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Square Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Square पर क्लिक करें। प्रश्न क्या यह राशि Square के माध्यम से रिफ़ंड करनी है? इसे वापस नहीं किया जा सकता। की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो Square ने चार्ज की थी, इसलिए राशि में अंतर होने पर आप ऑर्डर की कुल राशि नहीं, बल्कि ग्राहक द्वारा वास्तव में चुकाई गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उसी वातावरण (sandbox या live) और location पर भेजा जाता है जहाँ भुगतान हुआ था, इसलिए उस मोड का Access Token सेट होना चाहिए। रिफ़ंड अनुरोध इडेम्पोटेंट होते हैं और Square उत्तर न दे तो एक बार दोबारा भेजे जाते हैं। वह रिफ़ंड जिसे Square स्वीकार करता है (स्थिति PENDING या COMPLETED), Square रिफ़ंड ID के साथ रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। यदि Square उसे अस्वीकार करता है, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पाद स्टॉक में लौटाए, जैसे मैन्युअल स्थिति बदलने पर होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता।

Sales > Returns में उत्पाद वापसी Square के माध्यम से पैसे वापस नहीं भेजती। Square अपनी ओर से रिफ़ंड पूरे करता है: बाद में Square द्वारा अस्वीकार किया गया रिफ़ंड वापस नहीं बताया जाता, और Square Dashboard में किए गए रिफ़ंड OpenCart में नहीं दिखते।

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

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

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

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

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

Square चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड के Application ID, Access Token और Location ID भरे हुए हैं। जाँचें कि ग्राहक की मुद्रा USD, CAD, AUD, JPY, GBP या EUR है और आपकी Square location की मुद्रा से मेल खाती है। सेटिंग्स पेज इन सभी समस्याओं के लिए चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

कार्ड फ़ॉर्म लोड नहीं होता: ग्राहक को कार्ड फ़ॉर्म लोड नहीं हो सका। कृपया पेज रीलोड करें या कोई दूसरी भुगतान विधि चुनें। दिखता है। जाँचें कि Application ID और Location ID चुने गए मोड के हैं (sandbox ID sandbox- से शुरू होते हैं)। यदि ग्राहक बहुत जल्दी क्लिक करता है, तो कार्ड फ़ॉर्म अभी लोड हो रहा है। कृपया कुछ क्षण प्रतीक्षा करें और फिर प्रयास करें। दिखता है।

सेव करने के बाद भुगतान विधि गायब हो गई: Square location की मुद्रा ऑर्डर की मुद्रा से अलग है। अपने स्टोर की मुद्रा वाली Square location का Location ID दर्ज करें और दोबारा सेव करें: सफल जाँच के बाद विधि फिर दिखेगी।

Square ने चुने गए मोड का Access Token अस्वीकार किया: टोकन दूसरे मोड का है या गलत है। अपने application के Credentials पेज से उसे फिर से कॉपी करें और Sandbox Mode जाँचें।

इस Access Token के लिए Location ID नहीं मिला: उसी application और उसी मोड के Locations पेज से Location ID कॉपी करें।

ग्राहक ने देखा "भुगतान प्रदाता से पुष्टि प्राप्त नहीं हो सकी": Square ने उत्तर नहीं दिया और अभी तक कोई भुगतान नहीं मिला। Square Dashboard में इस location के भुगतान जाँचें (संदर्भ = ऑर्डर नंबर)। यदि ग्राहक फिर प्रयास करता है, तो एक्सटेंशन पहले पिछला भुगतान खोजता है और दोबारा चार्ज करने के बजाय उसी का उपयोग करता है।

ग्राहक ने देखा "आपका भुगतान प्राप्त हो गया, पर ऑर्डर स्वचालित रूप से पूरा नहीं हो सका": कार्ड से शुल्क लिया गया, पर OpenCart ऑर्डर की स्थिति सेट नहीं कर सका। लॉग पढ़ें, फिर ऑर्डर मैन्युअल रूप से पूरा करें या Square Dashboard में भुगतान रिफ़ंड करें।

ग्राहक देखता है "यह भुगतान विधि आपके ऑर्डर के लिए उपलब्ध नहीं है": चेकआउट अब ऑर्डर से मेल नहीं खाता, इस बीच भुगतान विधि बंद कर दी गई हो सकती है, या ऑर्डर की मुद्रा में चार्ज नहीं किया जा सकता। ग्राहक चेकआउट रीलोड करता है या दूसरी भुगतान विधि चुनता है।

भुगतान के बाद ऑर्डर समीक्षा स्थिति में है: VibeFox Square Gateway टैब के नोट पढ़ें (देखें ऑर्डर स्थितियाँ)। Square Dashboard में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

मोड से संबंधित संदेश के साथ रिफ़ंड विफल: भुगतान sandbox या live मोड में हुआ था, और उस मोड का Access Token सेट नहीं है। उसे दर्ज करें और फिर प्रयास करें।

अन्य त्रुटियाँ: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

अनइंस्टॉल

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

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

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