VibeFox Square for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Square। जब तक sandbox मोड चालू है, फ़ील्ड्स के ऊपर पेज Square Gateway is currently in SANDBOX mode. No real charges will be made. का संदेश दिखाता है। यह चेतावनी देता है जब Square सक्षम हो पर चुने हुए मोड का Application ID, Access Token या Location ID खाली हो (तब भुगतान विधि चेकआउट पर छिप जाती है), और जब Square स्टोर की मुद्रा संभाल नहीं सकता। भुगतान विधियों की सूची में, sandbox मोड चालू रहने पर, Square के आगे Test mode बैज दिखता है।

सेव करने पर प्लगइन चुने हुए मोड के क्रेडेंशियल Square के साथ जाँचता है। यदि Square Access Token को अस्वीकार करता है, यदि इस टोकन के लिए Location ID नहीं मिलता, यदि क्रेडेंशियल की जाँच नहीं हो पाती, या यदि लोकेशन की मुद्रा स्टोर की मुद्रा से अलग है, तो आपको त्रुटि दिखती है। Square केवल लोकेशन की मुद्रा में शुल्क ले सकता है: प्लगइन जाँची गई लोकेशन की मुद्रा याद रखता है और किसी भी दूसरी मुद्रा के लिए चेकआउट पर भुगतान विधि छिपा देता है, और सेटिंग्स पेज चेतावनी दिखाता रहता है। यह यह भी चेतावनी देता है कि यदि sandbox का Application ID live मोड में, या उसका उलटा, इस्तेमाल हो रहा हो।

General

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

Title: चेकआउट के दौरान ग्राहक को दिखने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: Credit / debit card।

Description: चेकआउट के दौरान ग्राहक को दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely with your credit or debit card via Square।

Square account

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

Sandbox Mode: Enable sandbox (test) mode। भुगतान Square sandbox को भेजे जाते हैं और कोई असली पैसा नहीं लिया जाता। Square के टेस्ट कार्ड इस्तेमाल करें। डिफ़ॉल्ट: on।

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 production Application ID (sq0idp- से शुरू होता है)।

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

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

Advanced

Debug log: Log API requests and responses। त्रुटियाँ हमेशा लॉग होती हैं। इसे चालू करें ताकि हर अनुरोध भी लॉग हो, बिना कार्ड डेटा या कुंजियों के। लॉग WooCommerce > Status > Logs में हैं, स्रोत wcp_square_gateway। डिफ़ॉल्ट: off।

Delete data on uninstall: Remove all plugin data when the plugin is deleted। प्लगइन हटाने पर गेटवे सेटिंग्स और लॉग फ़ाइलें हट जाती हैं। ऑर्डर का भुगतान डेटा रखा जाता है। डिफ़ॉल्ट: off।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit / debit card) और विवरण के नीचे दिखाए गए Square कार्ड फ़ॉर्म में कार्ड दर्ज करता है। sandbox मोड में चेकआउट पर sandbox की सूचना दिखती है। जब ग्राहक Place order पर क्लिक करता है, तो कार्ड ब्राउज़र में खरीदार सत्यापन (3-D Secure / SCA) के साथ टोकनाइज़ होता है: राशि, मुद्रा और बिलिंग संपर्क Square को भेजे जाते हैं, और ग्राहक का बैंक पुष्टि माँग सकता है। आपके सर्वर को केवल एक बार उपयोग होने वाला टोकन मिलता है।

इसके बाद प्लगइन Square Payments API के माध्यम से ऑर्डर की मुद्रा में ऑर्डर की कुल राशि के लिए टोकन से शुल्क लेता है, संदर्भ के रूप में ऑर्डर ID के साथ, ऑर्डर नंबर और आपकी साइट के नाम वाला एक Order # नोट, तथा बिलिंग ईमेल भेजता है। भुगतान तुरंत कैप्चर हो जाता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब Square पुष्टि कर दे: Square के उत्तर में ऑर्डर की कुल राशि, मुद्रा, ऑर्डर ID और लोकेशन से ठीक मेल खाता COMPLETED भुगतान दिखना चाहिए। फिर ग्राहक ऑर्डर प्राप्ति पेज पर जाता है। यदि भुगतान COMPLETED नहीं है या कोई मान अलग है, तो ऑर्डर एक नोट के साथ होल्ड पर रखा जाता है, और ग्राहक फिर भी ऑर्डर प्राप्ति पेज पर जाता है।

प्रति ऑर्डर एक समय में केवल एक भुगतान प्रयास चलता है। यदि ग्राहक दो बार क्लिक करे या दो टैब में भुगतान करे, तो दूसरे प्रयास में This order is already being paid. Please wait a moment and check your e-mail before trying again. (इस ऑर्डर का भुगतान पहले से हो रहा है। कृपया कुछ क्षण प्रतीक्षा करें और दोबारा प्रयास करने से पहले अपना ईमेल देखें।) दिखता है। अनुरोध idempotent होते हैं: वही ऑर्डर, टोकन और राशि कभी दूसरा भुगतान नहीं बनाते।

यदि Square उत्तर नहीं देता (नेटवर्क समस्या, टाइमआउट, सर्वर त्रुटि), तो वही idempotency key इस्तेमाल करके अनुरोध एक बार फिर भेजा जाता है। फिर भी उत्तर न मिले तो ग्राहक को We could not get a confirmation from the payment provider. Please wait a minute and try again — if your card was already charged, the payment will be recognised and you will not be charged twice. (भुगतान प्रदाता से पुष्टि प्राप्त नहीं हो सकी। कृपया एक मिनट प्रतीक्षा करके फिर से प्रयास करें — यदि आपका कार्ड पहले ही चार्ज हो चुका है, तो भुगतान पहचान लिया जाएगा और आपसे दोबारा शुल्क नहीं लिया जाएगा।) दिखता है। ऑर्डर नोट आपसे Square Dashboard जाँचने को कहता है। अगले प्रयास में प्लगइन पहले Square पर इस ऑर्डर का पिछला भुगतान खोजता है और उसी से ऑर्डर पूरा करता है, कार्ड दोबारा चार्ज नहीं करता।

जब बैंक कार्ड अस्वीकार करता है, तो ग्राहक को Square के एरर कोड के अनुसार एक संक्षिप्त संदेश दिखता है, जैसे Your card was declined. Please use another card or payment method., The card security code (CVV) is incorrect. Please check it and try again. या Your bank requires additional verification (3-D Secure). Please enter your card again and complete the verification.। तकनीकी कारण ऑर्डर नोट्स और लॉग में जाता है। ग्राहक दूसरे कार्ड से फिर प्रयास कर सकता है, बाद में Pay for order पेज से भी।

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

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

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

ऑर्डर स्टेटस

Pending payment: ऑर्डर बना है और उसका भुगतान अभी नहीं हुआ है, उदाहरण के लिए कार्ड अस्वीकृत होने या Square से उत्तर खो जाने के बाद।

Processing: Square ने ऑर्डर की कुल राशि का COMPLETED भुगतान पुष्ट किया है। यह भुगतान के बाद WooCommerce की मानक स्थिति है (केवल डाउनलोड योग्य वर्चुअल उत्पादों वाले ऑर्डर Completed हो जाते हैं)। ऑर्डर नोट में Square भुगतान ID, कार्ड ब्रांड और अंतिम 4 अंक, तथा मोड (sandbox या live) दिखते हैं। लेन-देन ID Square भुगतान ID है, और ऑर्डर स्क्रीन पर यह Square Dashboard के भुगतान से लिंक होता है।

On hold: Square ने ऐसे भुगतान के साथ उत्तर दिया जो COMPLETED नहीं है, या जिसकी राशि, मुद्रा, संदर्भ या लोकेशन अलग है। Square payment needs review नोट भुगतान ID, स्थिति और राशियाँ दिखाता है। ऑर्डर पूरा करने से पहले Square Dashboard में कैप्चर, राशि और मुद्रा जाँचें।

प्लगइन ऑर्डर पर Square भुगतान ID, कार्ड ब्रांड और अंतिम 4 अंक, एनवायरनमेंट और लोकेशन सहेजता है। कार्ड नंबर कभी संग्रहीत नहीं किए जाते।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit / debit card पर क्लिक करें (बटन पर आपका Title दिखता है)। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। रिफ़ंड उसी एनवायरनमेंट (sandbox या production) और लोकेशन को भेजा जाता है जहाँ भुगतान हुआ था, इसलिए उस मोड का Access Token सेट होना चाहिए। रिफ़ंड अनुरोध idempotent होते हैं और यदि Square उत्तर न दे तो एक बार दोहराए जाते हैं। Square द्वारा स्वीकृत रिफ़ंड (स्टेटस PENDING या COMPLETED) Square रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ता है। यदि Square उसे अस्वीकार करता है, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता।

Square रिफ़ंड अपनी ओर से पूरा करता है। जो रिफ़ंड Square बाद में अस्वीकार करता है, वह WooCommerce को वापस नहीं बताया जाता, और Square Dashboard में किए गए रिफ़ंड WooCommerce में नहीं दिखते।

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

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

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

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

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

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

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

कार्ड फ़ॉर्म लोड नहीं होता: ग्राहक को The card form could not be loaded. Please reload the page or choose another payment method. (कार्ड फ़ॉर्म लोड नहीं हो सका। कृपया पेज दोबारा लोड करें या कोई दूसरी भुगतान विधि चुनें।) दिखता है। जाँचें कि Application ID और Location ID चुने हुए मोड के हैं (sandbox ID sandbox- से शुरू होते हैं)। यदि ग्राहक बहुत जल्दी क्लिक करता है, तो The card form is still loading. Please wait a moment and try again. (कार्ड फ़ॉर्म अभी लोड हो रहा है। कृपया कुछ क्षण प्रतीक्षा करें और फिर प्रयास करें।) दिखता है।

कार्ड ठीक होने पर भी भुगतान अस्वीकृत: लोकेशन की मुद्रा स्टोर की मुद्रा के बराबर होनी चाहिए। क्रेडेंशियल जाँच का परिणाम देखने के लिए सेटिंग्स सेव करें; सफल जाँच के बाद अन्य मुद्राओं के लिए भुगतान विधि छिप जाती है।

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

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

ग्राहक ने देखा «We could not get a confirmation from the payment provider»: Square ने उत्तर नहीं दिया। ऑर्डर नोट पढ़ें और Square Dashboard में इस लोकेशन के भुगतान जाँचें (संदर्भ = ऑर्डर ID)। यदि ग्राहक फिर प्रयास करता है, तो प्लगइन पहले पिछला भुगतान खोजता है और उसी से ऑर्डर पूरा करता है, दोबारा चार्ज नहीं करता।

ऑर्डर On hold है: नोट Square payment needs review पढ़ें। भुगतान COMPLETED नहीं था, या उसकी राशि, मुद्रा या लोकेशन ऑर्डर से अलग थी। इसे Square Dashboard में जाँचें, फिर ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।

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

अन्य त्रुटियाँ: Debug log चालू करें और WooCommerce > Status > Logs देखें, स्रोत wcp_square_gateway।

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

अनइंस्टॉल

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

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