VibeFox Barion for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
Barion स्टोर: आपको अपने स्टोर की POSKey (गुप्त कुंजी) और उस Barion वॉलेट का ईमेल पता चाहिए जो भुगतान प्राप्त करता है। ये दोनों Barion पोर्टल में मिलेंगे: लाइव के लिए secure.barion.com, टेस्ट के लिए secure.test.barion.com, My stores के अंतर्गत और आपके स्टोर में। टेस्ट और लाइव के क्रेडेंशियल अलग-अलग होते हैं।
मुद्रा: ऑर्डर की मुद्रा HUF, EUR, USD या CZK होनी चाहिए। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।
पहुँच योग्य स्टोर: Barion हर भुगतान के बाद आपके स्टोर को कॉल करता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए, उसके सामने कोई फ़ायरवॉल या बेसिक ऑथेंटिकेशन न हो। मेंटेनेंस मोड कॉलबैक को नहीं रोकता: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_barion_gateway-oc3-(संस्करण).ocmod.zip और OpenCart 4 का पैकेज wcp_barion_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_barion_gateway-oc3-(संस्करण).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ, प्रकार Payments चुनें, VibeFox Barion Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन यूज़र के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी सेक्शन)।
4. टेस्ट POSKey और टेस्ट वॉलेट का ईमेल दर्ज करें, Test Mode चालू रखें, Enable/Disable चालू करें और Save पर क्लिक करें। एक टेस्ट ऑर्डर दें।
5. जब सब कुछ काम करने लगे, तब लाइव क्रेडेंशियल दर्ज करें और Test Mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_barion_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में पैकेज उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ, प्रकार Payments चुनें। VibeFox Barion Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और Barion क्रेडेंशियल दर्ज करें, और OpenCart 3 के चरण 3 से 5 की तरह भुगतान परखें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Callback URL अलग है (देखें Callback URL)।
कॉलबैक URL हर भुगतान के साथ अपने-आप Barion को भेजा जाता है। Barion पोर्टल में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Barion Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर, यदि वर्तमान मोड में POSKey या भुगतान प्राप्तकर्ता का ईमेल नहीं है (तब भुगतान विधि चेकआउट पर छिपी रहती है), या यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा Barion द्वारा समर्थित नहीं है, तो पेज चेतावनी देता है, साथ में समर्थित मुद्राओं की सूची भी दिखाता है। जब तक टेस्ट मोड चालू है, वह Test mode is on: payments go to the Barion sandbox (api.test.barion.com), no real money is charged. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।
सेव करते समय Title में 1 से 128 अक्षर होने चाहिए, Sort Order पूर्ण संख्या होनी चाहिए और Total 0 या उससे बड़ी संख्या होनी चाहिए। किसी भी फ़ील्ड में त्रुटि होने पर कुछ भी सेव नहीं होता और पेज उस फ़ील्ड का नाम बताता है।
Barion
Enable/Disable: Enable Barion Payment भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सेव होता है। डिफ़ॉल्ट: Barion। आवश्यक, अधिकतम 128 अक्षर।
Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Barion की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें।
Geo Zone: Barion को केवल चुने हुए जियो ज़ोन में भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह कुल राशि, जिस तक ऑर्डर पहुँचना चाहिए, तभी Barion दिखाया जाता है। किसी भी राशि के लिए Barion दिखाने हेतु खाली छोड़ें।
Barion स्टोर क्रेडेंशियल
अपना POSKey और वॉलेट ईमेल Barion पोर्टल से प्राप्त करें: secure.barion.com (लाइव) या secure.test.barion.com (टेस्ट), My stores, अपना स्टोर (पोर्टल इस सेक्शन में लिंक किए गए हैं)। टेस्ट मोड केवल टेस्ट क्रेडेंशियल का उपयोग करता है, लाइव मोड केवल लाइव क्रेडेंशियल का।
Test Mode: नीचे दिए गए टेस्ट क्रेडेंशियल और Barion सैंडबॉक्स (api.test.barion.com) का उपयोग करता है। कोई वास्तविक राशि नहीं काटी जाती। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण में Test mode: no real payment is taken. देखते हैं।
Test POSKey: Barion टेस्ट सिस्टम (secure.test.barion.com, My stores) में आपके स्टोर की गुप्त कुंजी (POSKey)।
Test Payee Email: आपके Barion टेस्ट वॉलेट का ईमेल पता, जो टेस्ट भुगतान प्राप्त करता है।
Live POSKey: Barion लाइव सिस्टम (secure.barion.com, My stores) में आपके स्टोर की गुप्त कुंजी (POSKey)।
Live Payee Email: आपके Barion वॉलेट का ईमेल पता, जो भुगतान प्राप्त करता है।
सेव किए गए POSKey फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तभी नया मान लिखें। सेव किया हुआ POSKey हटाने के लिए फ़ील्ड के नीचे Clear the saved POSKey on save पर टिक करें और Save पर क्लिक करें।
Callback URL: वह पता जिसे Barion हर भुगतान के बाद कॉल करता है। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_barion_gateway/callback, OpenCart 4 पर ऐसा: https://your-store/index.php?route=extension/wcp_barion_gateway/payment/wcp_barion_gateway.callback। यह आपके OpenCart इंस्टॉलेशन के स्टोर पते से बनता है। यह हर भुगतान के साथ Barion को भेजा जाता है, इसलिए कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। इसे केवल इंटरनेट से पहुँच योग्य होना चाहिए।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। Barion द्वारा भुगतान की रिपोर्ट करने के बाद ही (कॉलबैक द्वारा या ग्राहक की वापसी से; स्थिति हमेशा Barion से पढ़ी जाती है) उसे स्थिति मिलती है। नीचे की हर फ़ील्ड आपके OpenCart ऑर्डर स्थितियों की सूची देती है।
Order Status After Payment: सफल, सत्यापित भुगतान के बाद सेट की गई स्थिति। डिफ़ॉल्ट: प्रोसेसिंग।
Awaiting Barion Payment Status: ग्राहक Barion के पेज पर पूरा कर चुका है, लेकिन Barion अभी भी भुगतान प्रोसेस कर रहा है। डिफ़ॉल्ट: भुगतान लंबित।
Barion Payment On Hold Status: भुगतान हो गया है, लेकिन राशि या मुद्रा ऑर्डर से मेल नहीं खाती। एक नोट कारण बताता है; भुगतान की जाँच स्वयं करें। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में होल्ड पर स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Payment Failed Status: एक भुगतान-प्रतीक्षित ऑर्डर, जिसका Barion भुगतान विफल हो गया। डिफ़ॉल्ट: विफल।
Payment Canceled Status: एक भुगतान-प्रतीक्षित ऑर्डर, जिसका Barion भुगतान रद्द हो गया या समय-सीमा समाप्त हो गई। डिफ़ॉल्ट: रद्द।
Refunded Status: ऑर्डर पेज से भुगतान की पूरी राशि रिफ़ंड होने के बाद सेट होती है। डिफ़ॉल्ट: रिफ़ंड किया गया।
एडवांस्ड
Logging: Barion के अनुरोध और कॉलबैक को OpenCart के लॉग फ़ोल्डर (storage/logs) में barion_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। गुप्त कुंजियाँ और वॉलेट ईमेल लॉग नहीं होते। डिफ़ॉल्ट: बंद। बंद रहने पर त्रुटियों सहित कुछ भी नहीं लिखा जाता।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन की अनइंस्टॉलेशन गेटवे सेटिंग्स और लॉग हटा देती है। ऑर्डर और उनका Barion भुगतान डेटा हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।
इम्पोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। POSKey एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए POSKey बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Barion)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to the secure Barion payment page. OpenCart इसी चरण पर ऑर्डर बनाता है, अब भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल राशि के लिए Barion भुगतान शुरू करता है और ग्राहक को Barion के भुगतान पेज पर भेजता है। उत्पाद, शिपिंग, अन्य ऑर्डर शुल्क और टैक्स भुगतान पर सूचीबद्ध होते हैं; OpenCart ऑर्डर नंबर को ऑर्डर नंबर के रूप में भेजा जाता है, ग्राहक का ईमेल संकेत के रूप में भेजा जाता है, और जहाँ Barion समर्थन करता है वहाँ पेज की भाषा ग्राहक की भाषा का अनुसरण करती है (हंगेरियन, जर्मन, फ़्रेंच, स्पैनिश, चेक, स्लोवाक, स्लोवेनियाई, ग्रीक; अन्यथा अंग्रेज़ी)। OpenCart 4 में ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है, और Barion कॉलबैक URL को भी कॉल करता है। इनमें से कोई भी अनुरोध अपने-आप कुछ भी भुगतान-पूर्ण के रूप में चिह्नित नहीं करता: एक्सटेंशन उसी मोड के POSKey के साथ Barion से भुगतान की स्थिति माँगता है जिसमें भुगतान शुरू हुआ था। ऑर्डर को तभी भुगतान-पूर्ण माना जाता है जब Barion उसकी पुष्टि करे, और केवल तब जब राशि और मुद्रा ऑर्डर से मेल खाएँ। वापसी लिंक में भुगतान प्रयास का एक यादृच्छिक टोकन होता है, और केवल उस ऑर्डर के लिए शुरू किए गए भुगतान जाँचे जाते हैं। इसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट। OpenCart 4 पर Barion द्वारा ग्राहक को वापस भेजने पर ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है, जो आपके स्टोर से वही वापसी पता फिर से खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।
भुगतान सफल होने पर ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि भुगतान अब भी Barion पर प्रोसेस हो रहा है, तो ऑर्डर को Awaiting Barion Payment Status मिलता है और सफलता पेज पर Your payment is being confirmed by Barion. You will receive an e-mail as soon as it is confirmed. दिखता है। यदि ग्राहक के लौटने पर Barion तक पहुँच नहीं हो पाती, या भुगतान हो गया है पर अभी लागू नहीं हुआ, तो एक Payment confirmation पेज वही टेक्स्ट और Check again बटन दिखाता है; Barion द्वारा भुगतान की पुष्टि होते ही कॉलबैक ऑर्डर की स्थिति सेट कर देता है।
यदि भुगतान पूरा नहीं हुआ (रद्द, समय-सीमा समाप्त या विफल), तो ऑर्डर बिना स्थिति के रहता है, कार्ट बना रहता है और ग्राहक Payment was not completed. Please try again. संदेश के साथ चेकआउट पर वापस आता है। यदि वापसी लिंक ऑर्डर से मेल नहीं खाता, तो संदेश Payment verification failed. होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 3 पर हर नया प्रयास एक नया OpenCart ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए नया प्रयास उसी ऑर्डर के लिए एक नया Barion भुगतान होता है। Barion शुरू हो चुके भुगतान को रद्द नहीं कर सकता, इसलिए नए भुगतान से पहले एक्सटेंशन Barion पर कार्ट के पिछले खुले भुगतान जाँचता है: यदि उनमें से कोई भुगतान-पूर्ण या प्रोसेसिंग में है, तो उसका ऑर्डर पुष्ट हो जाता है और ग्राहक बिना फिर से भुगतान किए सफलता पेज पर जाता है। यदि उसी कार्ट (उसी विज़िट में वही उत्पाद) का कोई दूसरा ऑर्डर पहले से भुगतान-पूर्ण है, तो ग्राहक भी बिना नए भुगतान के सफलता पेज पर जाता है; पूरी हुई खरीदारी के बाद की नई खरीदारी एक नया कार्ट है। उसी ऑर्डर के किसी पिछले प्रयास का देर से हुआ भुगतान अब भी उसे पुष्ट करता है, और समय-सीमा समाप्त होने वाला पिछला प्रयास ऑर्डर को रद्द नहीं करता। यदि ग्राहक एक ही कार्ट के दो ऑर्डर (दो टैब) का भुगतान करता है, तो दूसरा भुगतान उसके ऑर्डर की पुष्टि नहीं करता: भुगतान-पूर्ण ऑर्डर पर एक नोट लगता है कि उसी कार्ट के लिए दूसरा भुगतान प्राप्त हुआ, ताकि आप उसे Barion पोर्टल में रिफ़ंड कर सकें।
OpenCart 4 ऑर्डर को चेकआउट में तब तक रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका भुगतान-प्रयास Barion पर रद्द हुआ, या आपने ऑर्डर रद्द किया), तो अगला Confirm Order ग्राहक को Payment was not completed. Please try again. के साथ चेकआउट पर वापस भेजता है, और चेकआउट तब कार्ट का एक नया ऑर्डर बनाता है। यदि ऑर्डर की कोई स्थिति पहले से है और इसके बाद कार्ट बदल गया है (अन्य उत्पाद या मात्रा), तो ऑर्डर चेकआउट से बाहर चला जाता है और बदले हुए कार्ट को नया ऑर्डर और उसका अपना भुगतान मिलता है।
यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है: The Barion payment could not be started. Please try again or choose another payment method., Barion does not support payments in ऑर्डर की मुद्रा, Barion payment is not available at the moment. Please choose another payment method. या Barion cannot process an order with a zero total. Logging चालू होने पर विवरण लॉग में जाते हैं।
यह एक्सटेंशन केवल तत्काल भुगतान लेता है। इसमें आरक्षित या विलंबित कैप्चर भुगतान, सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, Barion Pixel या अतिरिक्त 3-D Secure डेटा नहीं हैं; 3-D Secure को Barion अपने भुगतान पेज पर संभालता है।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Barion पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान पूरा नहीं हुआ, या Barion ने अभी तक भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Awaiting Barion Payment Status (डिफ़ॉल्ट Pending): Barion भुगतान को अब भी प्रगति में बताता है। एक नोट Barion PaymentId, राशि और, टेस्ट मोड में, (test mode) दिखाता है। Barion द्वारा भुगतान की पुष्टि होने पर ऑर्डर भुगतान-पूर्ण स्थिति में चला जाता है।
Order Status After Payment (डिफ़ॉल्ट Processing): Barion ने भुगतान की पुष्टि कर दी है। एक नोट राशि, PaymentId और Barion ट्रांज़ैक्शन दिखाता है।
Barion Payment On Hold Status (डिफ़ॉल्ट Pending): Barion ने ऑर्डर कुल से अलग राशि या मुद्रा बताई है। नोट दोनों राशियाँ दिखाता है। Barion पोर्टल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या Barion पोर्टल में भुगतान रिफ़ंड करें।
Payment Canceled Status (डिफ़ॉल्ट Canceled): प्रतीक्षित ऑर्डर का आखिरी भुगतान प्रयास Barion पर रद्द हुआ या उसकी समय-सीमा समाप्त हो गई।
Payment Failed Status (डिफ़ॉल्ट Failed): प्रतीक्षित ऑर्डर का आखिरी भुगतान प्रयास विफल हो गया।
Refunded Status (डिफ़ॉल्ट Refunded): एक्सटेंशन के माध्यम से भुगतान की पूरी राशि रिफ़ंड की गई।
यदि ऑर्डर के रद्द होने या विफल होने के बाद भी ऑर्डर का कोई भुगतान सफल होता है, तो ऑर्डर भुगतान-पूर्ण हो जाता है। भुगतान-पूर्ण या रिफ़ंड किया गया ऑर्डर बाद के किसी कॉलबैक से कभी नहीं बदलता। यदि पहले से भुगतान-पूर्ण ऑर्डर के लिए कोई और भुगतान सफल होता है, तो एक नोट आपसे Barion पोर्टल में उसकी जाँच करने और डुप्लिकेट होने पर रिफ़ंड करने को कहता है। नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक नहीं देखता।
VibeFox Barion Gateway टैब
Sales > Orders में Barion से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Barion Gateway टैब टेस्ट भुगतानों के लिए Test mode लेबल के साथ PaymentId, Barion Transaction, भुगतान की Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Barion notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।
रिफ़ंड
VibeFox Barion Gateway टैब में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Barion पर क्लिक करें। प्रश्न Refund this amount through Barion? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। कारण टिप्पणी के रूप में Barion को भेजा जाता है। HUF रिफ़ंड पूर्ण राशि में होने चाहिए। रिफ़ंड उसी मोड (टेस्ट या लाइव) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस मोड का POSKey सेट होना चाहिए। यदि Barion रिफ़ंड स्वीकार या पुष्ट नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Barion ट्रांज़ैक्शन और स्थिति के साथ रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना, और उत्पादों को स्टॉक में वापस किए बिना, ऑर्डर को Refunded Status पर सेट करता है, जैसे मैन्युअल स्टेटस बदलने पर होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता।
रिफ़ंड तभी उपलब्ध हैं जब Barion भुगतान की पुष्टि कर दे और ऑर्डर उसी से भुगतान-पूर्ण हो। राशि या मुद्रा के मेल न खाने वाले भुगतान का रिफ़ंड OpenCart से नहीं हो सकता; उसे Barion पोर्टल में रिफ़ंड करें। Sales > Returns में उत्पाद वापसी Barion के माध्यम से पैसे वापस नहीं भेजती।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Barion Gateway, Extensions > Extensions > Payments > VibeFox Barion Gateway > Edit पर पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की गई कुंजी, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-barion वाली पंक्ति और वह लिंक है जो आपका 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 खाते में मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर Barion ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट कर सकें और परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन नहीं दिखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी से छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों तक छिपा रहता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू किए गए भुगतान अब भी पुष्ट होते हैं, और रिफ़ंड काम करते हैं।
लाइसेंस समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। किसी cron job की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है।
समस्या निवारण
चेकआउट पर Barion दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में POSKey और भुगतान प्राप्तकर्ता का ईमेल है (कोई गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है), और ऑर्डर की मुद्रा HUF, EUR, USD या CZK है। यह भी जाँचें कि भुगतान का पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।
भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के है: ऑर्डर को तब स्थिति मिलती है जब Barion कॉलबैक URL को कॉल करता है या जब ग्राहक आपके स्टोर पर लौटता है। सुनिश्चित करें कि साइट इंटरनेट से पहुँच योग्य है (कॉलबैक URL के सामने कोई फ़ायरवॉल या बेसिक ऑथेंटिकेशन न हो)। जाँचें कि जिस मोड में भुगतान हुआ था उसका POSKey सही है, क्योंकि एक्सटेंशन उसी से Barion से भुगतान की स्थिति माँगता है। कॉलबैक देखने के लिए Logging चालू करें।
कॉलबैक Busy, retry उत्तर देता है: ऑर्डर उसी क्षण ग्राहक की वापसी से प्रोसेस हो रहा था, या ऑर्डर की स्थिति सेट नहीं हो पाई। Barion दोबारा कॉल करेगा। कारण देखने के लिए Logging चालू करें।
कॉलबैक API error उत्तर देता है: स्टोर Barion से भुगतान की स्थिति नहीं पढ़ पाया, या जिस मोड में भुगतान हुआ था उसका POSKey सेट नहीं है। वह POSKey जाँचें।
कॉलबैक Order not found उत्तर देता है: वह PaymentId इस स्टोर द्वारा शुरू नहीं किया गया था। दूसरे स्टोरों या टेस्ट सिस्टम के लिए Barion की कॉल अनदेखी की जाती हैं।
ग्राहक को Payment verification failed. दिखता है: वापसी लिंक ऑर्डर से मेल नहीं खाता, उदाहरण के लिए उसे संपादित किया गया हो सकता है। भुगतान की स्थिति फिर भी कॉलबैक से पुष्ट होती है।
Confirm Order के बाद ग्राहक को त्रुटि दिखती है: Logging चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। गलत POSKey या प्राप्तकर्ता ईमेल से The Barion payment could not be started. आता है। This payment method is not available. Please reload the checkout page. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट पेज दोबारा लोड करना होगा।
ऑर्डर होल्ड स्थिति में है: VibeFox Barion Gateway टैब में बेमेल वाला नोट पढ़ें, Barion पोर्टल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या Barion पोर्टल में उसे रिफ़ंड करें।
मैं 10.50 HUF रिफ़ंड क्यों नहीं कर सकता: Barion HUF को बिना दशमलव के प्रोसेस करता है। पूर्ण राशि दर्ज करें।
टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: भुगतान अभी पुष्ट नहीं हुआ है, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या भुगतान के मोड का POSKey कॉन्फ़िगर नहीं है।
डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wcp_barion_supported_currencies (मुद्राओं की सूची) और wcp_barion_payment_request (भुगतान अनुरोध और ऑर्डर, Barion को भेजे जाने से पहले) ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Barion Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में कॉलबैक को आगे जाने देता है)। यदि Delete Data on Uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, POSKey, प्राप्तकर्ता ईमेल, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। Barion के भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Barion Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Barion अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Barion से संबद्ध नहीं है और Barion द्वारा अनुमोदित नहीं है।