VibeFox Flow for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।
PHP: 8.0 या उसके बाद का संस्करण।
स्टोर की मुद्रा: चिली पेसो (CLP) या अमेरिकी डॉलर (USD)। अन्य मुद्राओं में भुगतान तरीका चेकआउट पर छिपा रहता है। CLP स्टोर्स में WooCommerce > Settings > General > Number of decimals को 0 पर सेट करें, क्योंकि Flow पूर्ण पेसो में शुल्क लेता है।
Flow खाता: आपको अपने Flow खाते की API Key और Secret Key चाहिए, जो Flow में Mis datos, Datos técnicos के अंतर्गत हैं। परीक्षण के लिए sandbox.flow.cl पर अलग सैंडबॉक्स खाता बनाएँ और उसकी कुंजियाँ इस्तेमाल करें। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं। Flow खाते में कुछ कॉन्फ़िगर नहीं करना होता।
सार्वजनिक वेबसाइट: आपके स्टोर के पुष्टि, वापसी और रिफ़ंड URL इंटरनेट से पहुँच योग्य होने चाहिए; मेंटेनेंस मोड, पासवर्ड सुरक्षा या Flow को रोकने वाला फ़ायरवॉल नहीं होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी गई। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_flow_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग खोलें: WooCommerce > Settings > Payments > Flow.cl > Manage, या प्लगइन पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के सबसे ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. सैंडबॉक्स API Key और Secret Key डालें, Enable / Disable चालू करें, सेव करें और परीक्षण ऑर्डर दें।
6. वास्तविक भुगतान लेने के लिए लाइव कुंजियाँ भरें और Sandbox mode का चयन हटाएँ।
कॉन्फ़िगरेशन
सभी सेटिंग एक पेज पर हैं: WooCommerce > Settings > Payments > Flow.cl। फ़ील्ड के ऊपर पेज चेतावनी देता है जब वर्तमान मोड की कुंजियाँ खाली हों (तब Flow चेकआउट पर छिप जाता है), स्टोर की मुद्रा समर्थित न हो, या CLP स्टोर दशमलव इस्तेमाल करता हो (Flow पूर्ण पेसो में शुल्क लेता है, इसलिए Number of decimals को 0 पर सेट करें ताकि कीमत, कुल राशि और रिफ़ंड बिल्कुल मेल खाएँ)। सैंडबॉक्स मोड में Sandbox mode दिखता है — भुगतान sandbox.flow.cl पर जाते हैं, वास्तविक पैसा नहीं लिया जाता। भुगतान तरीकों की सूची में, वर्तमान मोड की कुंजियाँ होने तक Flow को सेटअप की आवश्यकता वाला चिह्न मिलता है, और सैंडबॉक्स मोड में परीक्षण मोड का बैज दिखता है।
सामान्य
Enable / Disable: Enable Flow.cl payments भुगतान तरीका चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: भुगतान तरीके का नाम जो ग्राहक चेकआउट पर देखता है। डिफ़ॉल्ट: Flow।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.
Flow API क्रेडेंशियल
अपने Flow खाते (Mis datos, Datos técnicos) से API Key और Secret Key कॉपी करें: लाइव कुंजियाँ www.flow.cl पर, सैंडबॉक्स कुंजियाँ sandbox.flow.cl पर (अलग सैंडबॉक्स खाता)।
Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys। सैंडबॉक्स मोड में वास्तविक पैसा नहीं लिया जाता। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें और लाइव कुंजियाँ भरें। रिफ़ंड हमेशा उसी वातावरण में होते हैं जिसमें ऑर्डर का भुगतान हुआ था।
Sandbox API Key: आपके sandbox.flow.cl खाते की API Key।
Sandbox Secret Key: आपके sandbox.flow.cl खाते की Secret Key। हर अनुरोध पर हस्ताक्षर करने के लिए इसका उपयोग होता है।
Live API Key: आपके www.flow.cl खाते की API Key।
Live Secret Key: आपके www.flow.cl खाते की Secret Key। इसे गोपनीय रखें।
सूचनाएँ
प्लगइन हर भुगतान और रिफ़ंड के साथ Flow को तीन URL भेजता है, इसलिए Flow खाते में कुछ कॉन्फ़िगर नहीं करना होता। यह खंड उन्हें सूचीबद्ध करता है:
पुष्टि में केवल भुगतान टोकन होता है। इसके बाद प्लगइन उस वातावरण में हस्ताक्षरित अनुरोध से Flow से भुगतान की स्थिति पूछता है जिसमें भुगतान बनाया गया था, और केवल Flow का उत्तर लागू करता है। इस स्टोर द्वारा इस ऑर्डर के लिए न बनाया गया भुगतान अस्वीकार होता है। पुष्टि न मिलने पर ग्राहक के Flow से लौटने पर ऑर्डर अपडेट होता है।
उन्नत
Debug log: Log API calls and notifications को WooCommerce > Status > Logs में, स्रोत wcp_flow_gateway के अंतर्गत रिकॉर्ड करता है, बिना कुंजियों या ग्राहक के डेटा के। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept)। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट Flow) और ऑर्डर देता है। सैंडबॉक्स मोड में चेकआउट पर SANDBOX MODE दिखता है — भुगतान Flow सैंडबॉक्स में जाते हैं। वास्तविक शुल्क नहीं लगते। वैध बिलिंग ईमेल आवश्यक है। प्लगइन ऑर्डर की मुद्रा में कुल राशि का Flow भुगतान बनाता है, जिसका विषय Order # के बाद ऑर्डर नंबर और साइट का नाम होता है, और ग्राहक को Flow भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके Flow खाते में सक्षम भुगतान तरीका चुनता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर केवल Flow की पुष्टि के बाद भुगतान किया हुआ चिह्नित होता है: पुष्टि सूचना से या ग्राहक के लौटने पर हस्ताक्षरित स्थिति अनुरोध से। भुगतान किया हुआ ऑर्डर या भुगतान की प्रतीक्षा वाला नकद कूपन, ऑर्डर प्राप्त पेज पर ले जाता है।
भुगतान अस्वीकार होने पर ग्राहक Your Flow payment was rejected. Please try again or choose another payment method. संदेश के साथ Pay for order पेज (या चेकआउट) पर लौटता है। ग्राहक बिना भुगतान Flow पेज से निकल गया हो तो संदेश The Flow payment was not completed. You can try again or choose another payment method. होता है। परिणाम की जाँच न हो सके तो संदेश We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. होता है। हर नए प्रयास पर ऑर्डर से जुड़ा नया Flow भुगतान बनता है।
Flow भुगतान शुरू न कर पाए तो ग्राहक को छोटा संदेश दिखता है, उदाहरण के लिए Could not connect to Flow. Please try again in a moment. विवरण लॉग में होते हैं।
यह भुगतान तरीका क्लासिक चेकआउट, चेकआउट ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है। ग्राहक को दिखने वाले पाठ स्पेनिश (चिली और स्पेन) में अनुवादित हैं।
प्लगइन केवल एकमुश्त भुगतान लेता है। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन, बार-बार लगने वाले शुल्क या भुगतान लिंक नहीं हैं और यह Flow भुगतान तरीका पहले से नहीं चुनता। Flow पहले से बने भुगतान लिंक को रद्द नहीं कर सकता: ग्राहक नए लिंक का भुगतान करने के बाद पुराने लिंक से भी भुगतान करे तो ऑर्डर में नोट जुड़ता है जो आपसे Flow में दोहरा भुगतान रिफ़ंड करने को कहता है।
ऑर्डर और रिफ़ंड
ऑर्डर की स्थितियाँ
Pending payment: ग्राहक Flow पर भेजा गया है और उसने अभी भुगतान नहीं किया। ऑर्डर नोट में प्रयास की राशि और Flow ऑर्डर नंबर दिखता है।
On hold, awaiting coupon payment: ग्राहक ने Servipag या Multicaja भुगतान कूपन बनाया है। Flow के भुगतान की पुष्टि करने पर ऑर्डर बदलता है।
Processing: Flow ने भुगतान हो जाने की सूचना दी है और राशि व मुद्रा मेल खाते हैं (केवल वर्चुअल डाउनलोड करने योग्य उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट अनुसार पूर्ण हो जाते हैं)। ऑर्डर नोट में राशि और Flow ऑर्डर नंबर दिखता है। ऑर्डर की लेन-देन ID, Flow ऑर्डर नंबर होती है।
On hold, amount/currency mismatch: Flow ने ऑर्डर से अलग राशि या मुद्रा बताई। ऑर्डर भुगतान किया हुआ चिह्नित नहीं हुआ; आप इसकी मैन्युअल रूप से जाँच करें।
On hold, payment for a cancelled order: ऐसे ऑर्डर का भुगतान आया जो बिना भुगतान रद्द हो गया था। ऑर्डर जाँचें और भेजें या Flow में भुगतान रिफ़ंड करें।
Failed: Flow ने अवैतनिक ऑर्डर के सबसे हाल के भुगतान प्रयास को अस्वीकार किया। ग्राहक फिर प्रयास कर सकता है।
Cancelled: सबसे हाल का भुगतान प्रयास Flow में रद्द कर दिया गया।
पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आए तो ऑर्डर नहीं बदलता। नोट आपसे अपने Flow खाते में दोहरा भुगतान रिफ़ंड करने को कहता है। भुगतान के बाद रद्द या रिफ़ंड हुआ ऑर्डर कभी दोबारा नहीं खुलता।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Flow पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था (सैंडबॉक्स या लाइव), इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए और ऑर्डर में बिलिंग ईमेल चाहिए। Flow रिफ़ंड पूरा करने के लिए ग्राहक को ईमेल भेजता है। Flow रिफ़ंड अस्वीकार करे तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल अनुरोध, Flow रिफ़ंड नंबर और स्थिति के साथ ऑर्डर नोट में जुड़ता है।
बाद में Flow द्वारा बताई गई रिफ़ंड स्थिति में बदलाव ऑर्डर नोट में जुड़ते हैं। Flow बाद में रिफ़ंड अस्वीकार या रद्द करे तो नोट बताता है कि पैसा ग्राहक को वापस नहीं मिला; WooCommerce का रिफ़ंड रिकॉर्ड बना रहता है, इसलिए आप इसे मैन्युअल रूप से संभालें। Flow डैशबोर्ड में बनाए गए रिफ़ंड WooCommerce में इंपोर्ट नहीं होते।
लाइसेंस कुंजी
प्लगइन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Flow.cl के सबसे ऊपर है। License key में कुंजी पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति फिर जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key इस्तेमाल करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Flow चेकआउट पर ग्राहकों को नहीं दिखता। फिर भी भुगतान शुरू हो तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए हुए स्टोर प्रबंधक भुगतान तरीका (unlicensed — visible to admins only) चिह्न के साथ देख सकते हैं, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप करके जाँच सकें। प्लगइन पेज और WooCommerce पेजों पर रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू भुगतान की पुष्टि होती रहती है और रिफ़ंड काम करते हैं।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति की पृष्ठभूमि में अपने-आप फिर जाँच होती है।
समस्या निवारण
Flow चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड की कुंजियाँ भरी हैं (सैंडबॉक्स मोड में सैंडबॉक्स और लाइव मोड में लाइव कुंजियाँ), और स्टोर की मुद्रा CLP या USD है। Pay for order पेज पर ऑर्डर की मुद्रा जाँची जाती है।
भुगतान हो गया, पर ऑर्डर Pending payment स्थिति में है: Flow की पुष्टि आपके स्टोर तक नहीं पहुँचती और ग्राहक वापस नहीं आया। जाँचें कि सेटिंग में दिखा पुष्टि URL इंटरनेट से खुलता है और मेंटेनेंस मोड, पासवर्ड या फ़ायरवॉल से अवरुद्ध नहीं है। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_flow_gateway देखें।
पुष्टि का उत्तर Payment does not belong to the order या Unknown order है: भुगतान इस स्टोर ने इस ऑर्डर के लिए नहीं बनाया या वह दूसरे वातावरण में बना था। ऑर्डर नहीं बदलता।
पुष्टि का उत्तर Gateway not configured है: भुगतान के वातावरण की कुंजियाँ खाली हैं। उन्हें फिर दर्ज करें।
पुष्टि का उत्तर Flow API unavailable है: Flow को भेजा स्थिति अनुरोध विफल हुआ। Flow फिर पुष्टि का प्रयास करता है।
ग्राहक को Flow payments are not available at the moment दिखता है: कुंजियाँ नहीं हैं या Flow ने उन्हें अस्वीकार किया। वर्तमान मोड की API Key और Secret Key जाँचें।
ग्राहक को A valid billing email is required for Flow payments दिखता है: Flow को ग्राहक का ईमेल चाहिए।
ग्राहक ने भुगतान किया, पर ऑर्डर On hold है: ऑर्डर नोट पढ़ें। ग्राहक ने नकद कूपन बनाया है जिसका अभी भुगतान नहीं हुआ या Flow द्वारा बताई राशि या मुद्रा ऑर्डर से मेल नहीं खाती। दशमलव वाले CLP कुल को पूर्ण पेसो में राउंड किया जाता है, इसलिए Number of decimals को 0 पर सेट करें।
रिफ़ंड सैंडबॉक्स या लाइव कुंजियों के संदेश के साथ विफल होता है: ऑर्डर उस वातावरण में भुगतान हुआ था और उसकी कुंजियाँ खाली हैं। उन्हें दर्ज करके फिर प्रयास करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, कुंजी दूसरे डोमेन पर इस्तेमाल हो रही हो तो vibefox.net खाते में स्लॉट खाली करके Check now पर क्लिक करें। साइट का पता बदला हो तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। लाइसेंस सर्वर तक न पहुँच सकने पर प्लगइन पिछली ज्ञात स्थिति के अनुसार काम करता रहता है।
डेवलपर्स के लिए readme में wc_flw_supported_currencies फ़िल्टर सूचीबद्ध है (वे मुद्राएँ जिनमें गेटवे उपलब्ध है)।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सभी डेटा बने रहते हैं। हटाने के लिए Plugins पेज पर उसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटती हैं। गेटवे की सेटिंग और लॉग केवल तब हटते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में फिर इंस्टॉल करने के लिए बने रहते हैं। ऑर्डर में सेव Flow डेटा हमेशा रखा जाता है। मौजूदा ऑर्डर में भुगतान नोट और लेन-देन ID बनी रहती हैं।
Flow अपने संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Flow से संबद्ध नहीं है और न ही Flow द्वारा अनुमोदित है।