VibeFox Flow for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: चिली पेसो (CLP) या अमेरिकी डॉलर (USD)। अन्य चेकआउट मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है। CLP के लिए System > Localisation > Currencies में CLP मुद्रा के दशमलव स्थान 0 पर सेट करें, क्योंकि Flow पूर्ण पेसो में शुल्क लेता है।

Flow खाता: आपको अपने Flow खाते की API Key और Secret Key चाहिए, जो Flow में Mis datos, Datos técnicos के अंतर्गत मिलती हैं। परीक्षण के लिए sandbox.flow.cl पर अलग सैंडबॉक्स खाता बनाएँ और उसकी कुंजियाँ उपयोग करें। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं। Flow खाते में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है।

सार्वजनिक वेबसाइट: आपके स्टोर के पुष्टि, वापसी और रिफ़ंड URL इंटरनेट से पहुँच योग्य होने चाहिए, बिना पासवर्ड सुरक्षा या ऐसे फ़ायरवॉल के जो Flow को अवरुद्ध करे। स्टोर का मेंटेनेंस मोड इन्हें अवरुद्ध नहीं करता।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. सैंडबॉक्स API Key और Secret Key दर्ज करें, Enable / Disable चालू करें, Save पर क्लिक करें और एक परीक्षण ऑर्डर दें।

5. वास्तविक भुगतान स्वीकार करने के लिए लाइव कुंजियाँ भरें, Sandbox mode बंद करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और Flow कुंजियाँ OpenCart 3 के चरण 3 से 5 के अनुसार दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Flow URLs अलग हैं (देखें Flow URLs); वे हर भुगतान के साथ भेजे जाते हैं, इसलिए Flow खाते में कुछ बदलने की ज़रूरत नहीं है।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Flow Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब वर्तमान मोड की कुंजियाँ खाली हों (तब Flow चेकआउट पर छिपा रहता है), जब स्टोर की डिफ़ॉल्ट मुद्रा CLP या USD न हो, और जब CLP मुद्रा के दशमलव स्थान हों (उन्हें 0 पर सेट करें ताकि कीमतें, कुल राशि और रिफ़ंड बिल्कुल मेल खाएँ)। सैंडबॉक्स मोड में यह Sandbox mode — payments go to sandbox.flow.cl, no real money is charged. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

Flow.cl

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

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर दिखाया जाने वाला भुगतान विधि विवरण। डिफ़ॉल्ट: Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.

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

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

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

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

अपने Flow खाते (Mis datos, Datos técnicos) से API Key और Secret Key कॉपी करें: लाइव कुंजियाँ www.flow.cl पर, सैंडबॉक्स कुंजियाँ sandbox.flow.cl पर (अलग सैंडबॉक्स खाता)। सैंडबॉक्स मोड केवल सैंडबॉक्स कुंजियाँ उपयोग करता है, लाइव मोड केवल लाइव कुंजियाँ।

Sandbox mode: Flow सैंडबॉक्स (sandbox.flow.cl) और सैंडबॉक्स कुंजियाँ उपयोग करता है। सैंडबॉक्स मोड में कोई वास्तविक राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। वास्तविक भुगतान स्वीकार करने के लिए इसे बंद करें और लाइव कुंजियाँ भरें। रिफ़ंड हमेशा उसी वातावरण में होते हैं जिसमें ऑर्डर का भुगतान हुआ था। चालू रहने पर ग्राहक Confirm Order चरण पर SANDBOX MODE — Payments go to the Flow sandbox. No real charges. देखते हैं।

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। इसे गोपनीय रखें।

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

सूचनाएँ

एक्सटेंशन हर भुगतान और रिफ़ंड के साथ Flow को तीन URL भेजता है, इसलिए Flow खाते में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। इस सेक्शन का Flow URLs फ़ील्ड संदर्भ के लिए उन्हें सूचीबद्ध करता है। ये आपके OpenCart इंस्टॉलेशन के स्टोर पते से बनते हैं और इस प्रकार दिखते हैं:

OpenCart 4 पर URL में विधि का नाम एक बिंदु (dot) के बाद आता है: https://your-store/index.php?route=extension/wcp_flow_gateway/payment/wcp_flow_gateway.confirmation, ….back और ….refundCallback।

पुष्टि में केवल एक भुगतान टोकन होता है। एक्सटेंशन इस टोकन को उन भुगतानों में खोजता है जो उसने बनाए हैं, भुगतान जिस वातावरण में बना था उसमें हस्ताक्षरित अनुरोध से Flow से भुगतान स्थिति पूछता है, और केवल Flow का उत्तर लागू करता है। जो भुगतान यह स्टोर नहीं बनाता, उसे Flow से पूछे बिना अस्वीकार कर दिया जाता है। पुष्टि के बिना, ग्राहक के Flow से लौटने पर ऑर्डर को स्थिति मिलती है।

ऑर्डर

OpenCart Confirm Order चरण पर बिना स्थिति के ऑर्डर बनाता है (लापता ऑर्डर, «missing order»)। Flow द्वारा भुगतान की सूचना देने के बाद (पुष्टि या ग्राहक की वापसी से) ही ऑर्डर को स्थिति मिलती है। स्थिति हमेशा हस्ताक्षरित अनुरोध से Flow से पढ़ी जाती है। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।

Order Status After Payment: सत्यापित Flow भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रोसेसिंग।

Awaiting Flow Payment Status: ग्राहक ने नकद भुगतान कूपन बनाया (Servipag, Multicaja आदि)। पैसा बाद में आता है, और Flow उसकी पुष्टि करता है। डिफ़ॉल्ट: लंबित।

Flow Payment On Hold Status: भुगतान हो गया, पर राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या रद्द ऑर्डर के लिए पैसा आया। एक नोट कारण बताता है; भुगतान की मैन्युअल जाँच करें। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में «On hold» स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Payment Rejected Status: कूपन भुगतान की प्रतीक्षा कर रहा ऑर्डर, जिसका Flow भुगतान अस्वीकार हुआ। डिफ़ॉल्ट: विफल।

Payment Annulled Status: कूपन भुगतान की प्रतीक्षा कर रहा ऑर्डर, जिसका Flow भुगतान रद्द (annulled) हुआ। डिफ़ॉल्ट: रद्द।

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

उन्नत

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

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

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

इम्पोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API Keys और Secret Keys एक्सपोर्ट नहीं होतीं।

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Flow)। Confirm Order चरण पर ग्राहक को आपका विवरण और नोट You will be redirected to Flow to complete the payment. दिखता है। OpenCart इसी चरण पर बिना स्थिति के ऑर्डर बनाता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में, भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल राशि के लिए एक Flow भुगतान बनाता है, जिसका विषय Order # है, उसके बाद ऑर्डर नंबर और स्टोर का नाम, और ग्राहक को Flow भुगतान पेज पर भेजता है। ग्राहक का ईमेल Flow को दिया जाता है। वहाँ ग्राहक आपके Flow खाते में सक्षम भुगतान विधि चुनता है। ऑर्डर पर Flow payment started नोट लगता है, जिसमें राशि, Flow ऑर्डर नंबर और वातावरण होते हैं।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब Flow उसकी पुष्टि करता है: पुष्टि के माध्यम से, या ग्राहक की वापसी पर हस्ताक्षरित स्थिति अनुरोध के माध्यम से। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि ग्राहक ने Servipag या Multicaja कूपन बनाया, तो ऑर्डर को Awaiting Flow Payment Status मिलता है और पेज पर Your Flow payment coupon was generated. The order will be processed as soon as Flow confirms the payment. भी दिखता है। यदि राशि मेल नहीं खाई, तो पेज Your Flow payment was received and is being reviewed by the store. दिखाता है।

यदि ग्राहक के लौटने पर Flow तक पहुँच नहीं हो पाती, या उसी समय कोई और अनुरोध ऑर्डर की पुष्टि कर रहा है, तो एक Payment confirmation पेज दिखता है जिसमें We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly — please do not pay again. लिखा होता है, साथ में Check again बटन और Back to checkout बटन।

यदि भुगतान अस्वीकार हुआ, तो ग्राहक Your Flow payment was rejected. Please try again or choose another payment method. के साथ चेकआउट पर लौटता है। ऑर्डर बिना स्थिति के रहता है। यदि ग्राहक बिना भुगतान किए 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. होता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

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

OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज नहीं दिखाया जाता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए, आपने उसे रद्द किया), तो ग्राहक The Flow payment was not completed. You can try again or choose another payment method. संदेश के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है। यदि वह ऑर्डर पहले ही भुगतान हो चुका है या उसके पास कूपन है, पर उसके बाद कार्ट बदल गया है, जिसमें नई मात्रा भी शामिल है, तो ग्राहक चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order नए कार्ट को एक नए ऑर्डर के साथ भुगतान करता है। भुगतान किया हुआ ऑर्डर कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

यदि Flow भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर एक छोटा संदेश देखता है, उदाहरण के लिए Could not connect to Flow. Please try again in a moment. विवरण लॉग में हैं।

एक्सटेंशन केवल एकल भुगतान स्वीकार करता है। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन, आवर्ती शुल्क या भुगतान लिंक नहीं हैं, और यह कोई Flow भुगतान विधि पहले से नहीं चुनता। यदि कोई ग्राहक ऑर्डर का भुगतान हो जाने के बाद कोई पुराना Flow भुगतान करता है, तो ऑर्डर पर एक नोट लगता है कि आप डुप्लिकेट को Flow में रिफ़ंड करें।

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

ऑर्डर स्टेटस

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

Order Status After Payment (default Processing): Flow ने भुगतान को भुगतान किया हुआ बताया है, और राशि व मुद्रा मेल खाती हैं। एक नोट राशि और Flow ऑर्डर नंबर दिखाता है।

Awaiting Flow Payment Status (default Pending): ग्राहक ने नकद भुगतान कूपन बनाया है। एक नोट कूपन का प्रकार बताता है। Flow द्वारा भुगतान की पुष्टि होने पर ऑर्डर Order Status After Payment पर चला जाता है।

Flow Payment On Hold Status (default Pending): Flow ने ऑर्डर कुल से अलग राशि या मुद्रा बताई है, या रद्द ऑर्डर के लिए भुगतान आया है। Flow द्वारा लिया गया भुगतान दर्ज होता है, और नोट इसे समझाता है। ऑर्डर की जाँच करें और उसे भेजें या भुगतान रिफ़ंड करें।

Payment Rejected Status (default Failed): Flow ने प्रतीक्षारत ऑर्डर के कूपन भुगतान को अस्वीकार किया।

Payment Annulled Status (default Canceled): प्रतीक्षारत ऑर्डर के कूपन भुगतान को Flow में रद्द (annulled) किया गया।

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

यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे डुप्लिकेट को अपने Flow खाते में रिफ़ंड करने के लिए कहता है। रिफ़ंड किया गया ऑर्डर कभी दोबारा नहीं खोला जाता।

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

VibeFox Flow Gateway टैब

Sales > Orders में Flow से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Flow Gateway टैब भुगतान विधि के साथ Flow order नंबर दिखाता है, सैंडबॉक्स भुगतानों के लिए Sandbox लेबल, commerceOrder संदर्भ (और प्रयासों की संख्या), भुगतान की Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Flow notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Flow पर क्लिक करें। Refund this amount via Flow? Flow e-mails the customer to complete the refund. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन बदलने का अधिकार होना चाहिए (System > Users > User Groups में सेट किया जाता है)। रिफ़ंड उस राशि तक सीमित हैं जो Flow ने वास्तव में चार्ज की, इसलिए राशि में अंतर होने पर आप ऑर्डर कुल के बजाय ग्राहक द्वारा चुकाई गई राशि तक ही रिफ़ंड कर सकते हैं। CLP रिफ़ंड पूर्ण राशि में होने चाहिए। रिफ़ंड उस वातावरण (सैंडबॉक्स या लाइव) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण की कुंजियाँ भरी होनी चाहिए, और ग्राहक के पास वैध ईमेल होना चाहिए। यदि Flow रिफ़ंड अस्वीकार करता है, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल अनुरोध Flow रिफ़ंड नंबर और स्थिति के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैन्युअल स्थिति परिवर्तन। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब Flow भुगतान की पुष्टि कर चुका हो।

Flow द्वारा रिपोर्ट किए गए रिफ़ंड के बाद के स्थिति परिवर्तन नोट्स में जुड़ते हैं। यदि बाद में Flow रिफ़ंड को अस्वीकार या रद्द करता है, तो नोट बताता है कि पैसा ग्राहक को वापस नहीं मिला, और राशि फिर से रिफ़ंड की जा सकती है। Sales > Returns में उत्पाद वापसी Flow के माध्यम से पैसा वापस नहीं भेजती। Flow डैशबोर्ड में बनाए गए रिफ़ंड OpenCart में आयात नहीं होते।

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

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

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

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

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

चेकआउट पर Flow नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड की कुंजियाँ भरी हुई हैं (सैंडबॉक्स मोड में सैंडबॉक्स कुंजियाँ, लाइव मोड में लाइव कुंजियाँ), और चेकआउट मुद्रा CLP या USD है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: Flow की पुष्टि आपके स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं लौटा। जाँचें कि Flow URLs में दिखाया गया पुष्टि URL इंटरनेट से खुलता है और पासवर्ड सुरक्षा या फ़ायरवॉल से अवरुद्ध नहीं है। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

पुष्टि का उत्तर Payment does not belong to the order: टोकन इस स्टोर द्वारा बनाए गए भुगतान का नहीं है, या Flow ने उसके लिए कोई और संदर्भ बताया। कुछ नहीं बदलता।

पुष्टि का उत्तर Gateway not configured: भुगतान के वातावरण की कुंजियाँ खाली हैं। उन्हें फिर से दर्ज करें। Flow पुष्टि दोबारा करेगा।

पुष्टि का उत्तर Flow API unavailable or Busy, retry: Flow को स्थिति अनुरोध विफल हुआ, या उसी समय कोई और अनुरोध ऑर्डर की पुष्टि कर रहा था। Flow पुष्टि दोबारा करेगा।

ग्राहक देखता है Flow payments are not available at the moment: कुंजियाँ गायब हैं, या Flow ने उन्हें अस्वीकार किया। वर्तमान मोड की API Key और Secret Key जाँचें।

ग्राहक देखता है This payment method is not available. Please reload the checkout page.: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई। ग्राहक चेकआउट पेज फिर से लोड करता है।

ग्राहक देखता है A valid billing email is required for Flow payments: Flow को ग्राहक का ईमेल चाहिए।

ग्राहक देखता है The order total is too small to be paid with Flow: ऑर्डर कुल ऑर्डर की मुद्रा में शून्य पर पूर्णांकित होता है।

ग्राहक ने भुगतान किया, पर ऑर्डर प्रतीक्षा या होल्ड स्थिति में है: VibeFox Flow Gateway टैब के नोट पढ़ें। ग्राहक ने एक नकद कूपन बनाया है जो अभी भुगतान नहीं हुआ, या Flow द्वारा बताई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती। दशमलव वाले CLP कुल पूर्ण पेसो में पूर्णांकित होते हैं, इसलिए CLP के दशमलव स्थान 0 पर सेट करें।

टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: भुगतान अभी पुष्ट नहीं है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है, या जिस वातावरण में भुगतान हुआ उसकी कुंजियाँ खाली हैं।

सैंडबॉक्स या लाइव कुंजियों के संदेश के साथ रिफ़ंड विफल: ऑर्डर उस वातावरण में भुगतान हुआ था, और उसकी कुंजियाँ खाली हैं। उन्हें दर्ज करें और फिर प्रयास करें।

Flow accepts CLP refunds in whole units only के साथ रिफ़ंड विफल: पूर्ण राशि दर्ज करें।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wc_flw_supported_currencies (वे मुद्राएँ जिनके लिए भुगतान विधि दी जाती है) और wc_flw_payment_subject (Flow को भेजा गया भुगतान विषय) ट्रिगर करता है।

अनइंस्टॉल

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

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

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