VibeFox Barion for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन एडमिन क्षेत्र में एक सूचना दिखाता है, और भुगतान विधि लोड नहीं होती।
PHP: 8.0 या उसके बाद का संस्करण।
Barion शॉप: आपको अपनी शॉप का POSKey (गोपनीय कुंजी) और उस Barion wallet का ईमेल पता चाहिए जिसमें भुगतान आते हैं। दोनों Barion पोर्टल में हैं: लाइव के लिए secure.barion.com, टेस्ट के लिए secure.test.barion.com, My stores के तहत और अपनी शॉप में। टेस्ट और लाइव के क्रेडेंशियल अलग होते हैं।
मुद्रा: स्टोर मुद्रा HUF, EUR, USD या CZK होनी चाहिए। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।
पहुँच योग्य स्टोर: Barion हर भुगतान के बाद आपके स्टोर को कॉल करता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए, मेंटेनेंस मोड, फ़ायरवॉल या /wc-api/ के सामने basic authentication के बिना।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP द्वारा wcp_barion_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Barion > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. टेस्ट POSKey और टेस्ट wallet ईमेल दर्ज करें, Test Mode चालू रखें और Enable/Disable चालू करें। एक टेस्ट ऑर्डर दें।
6. जब सब कुछ काम करने लगे, तो लाइव क्रेडेंशियल दर्ज करें और Test Mode का निशान हटाएँ।
हर भुगतान के साथ कॉलबैक URL अपने-आप Barion को भेजा जाता है। Barion पोर्टल में कुछ भी कॉन्फ़िगर करना आवश्यक नहीं है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Barion। यदि स्टोर मुद्रा समर्थित नहीं है, तो पेज इसे Barion shop credentials सेक्शन में लाल रंग में बताता है और समर्थित मुद्राओं की सूची देता है; तब चेकआउट पर भुगतान विधि छिपी रहती है।
सामान्य
Enable/Disable: Enable Barion Payment भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: Barion।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay।
Barion शॉप क्रेडेंशियल
अपना POSKey और wallet ईमेल Barion पोर्टल में प्राप्त करें: secure.barion.com (लाइव) या secure.test.barion.com (टेस्ट), My stores, और अपनी शॉप। इस सेक्शन में कॉलबैक URL भी दिखता है, उदाहरण के लिए https://your-site/wc-api/barion_payment_callback/। यह हर भुगतान के साथ Barion को भेजा जाता है; इसे केवल इंटरनेट से पहुँच योग्य होना चाहिए।
Test Mode: Enable Barion test/sandbox mode। टेस्ट मोड नीचे दिए टेस्ट क्रेडेंशियल और Barion सैंडबॉक्स (api.test.barion.com) का उपयोग करता है; कोई असली पैसा नहीं लिया जाता। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए निशान हटाएँ।
Test POSKey: Barion टेस्ट सिस्टम (secure.test.barion.com, My stores) में आपकी शॉप की गोपनीय कुंजी (POSKey)।
Test Payee Email: आपके Barion टेस्ट wallet का ईमेल पता, जिसमें टेस्ट भुगतान आते हैं।
Live POSKey: Barion लाइव सिस्टम (secure.barion.com, My stores) में आपकी शॉप की गोपनीय कुंजी (POSKey)।
Live Payee Email: आपके Barion wallet का ईमेल पता, जिसमें भुगतान आते हैं।
ऑर्डर
Order Status After Payment: सफल और सत्यापित भुगतान के बाद सेट होने वाली ऑर्डर स्थिति।
उन्नत
Logging: Enable debug logging। लॉग WooCommerce > Status > Logs में, source wcp_barion_gateway के साथ सहेजे जाते हैं। गोपनीय कुंजियाँ कभी लॉग नहीं होतीं। डिफ़ॉल्ट: off।
Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted। ऑर्डर और उनका Barion भुगतान डेटा हमेशा बना रहता है। डिफ़ॉल्ट: off।
चेकआउट
ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Barion) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए ऑर्डर की मुद्रा में Barion भुगतान शुरू करता है और ग्राहक को Barion भुगतान पेज पर भेजता है। भुगतान पर ऑर्डर के आइटम, शिपिंग, शुल्क और कर सूचीबद्ध होते हैं, ग्राहक का बिलिंग ईमेल संकेत के रूप में भेजा जाता है, और जहाँ Barion समर्थन करता है वहाँ पेज की भाषा स्टोर की भाषा के अनुसार होती है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। Barion कॉलबैक URL को भी कॉल करता है। दोनों में से कोई अनुरोध अपने-आप ऑर्डर को भुगतान किया हुआ नहीं बनाता: प्लगइन आपके POSKey से Barion से भुगतान की स्थिति पूछता है, और ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Barion उसकी पुष्टि करे और राशि तथा मुद्रा ऑर्डर से मेल खाएँ। वापसी लिंक में ऑर्डर कुंजी होती है, और केवल उस ऑर्डर के लिए शुरू किए गए भुगतान जाँचे जाते हैं।
यदि भुगतान सफल हुआ है या Barion पर अब भी प्रक्रिया में है, तो ग्राहक ऑर्डर प्राप्त पेज पर पहुँचता है। अन्यथा ग्राहक चेकआउट पर लौटता है और Payment was not completed. Please try again. देखता है। ग्राहक फिर से कोशिश कर सकता है; हर प्रयास याद रखा जाता है, इसलिए पिछले प्रयास का देर से आया भुगतान अब भी ऑर्डर पूरा करता है।
यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक को The Barion payment could not be started. Please try again or choose another payment method. दिखता है। लॉग-इन स्टोर मैनेजर को तकनीकी कारण भी दिखता है। विवरण लॉग में जाते हैं।
भुगतान विधि क्लासिक चेकआउट और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल तत्काल भुगतान लेता है। इसमें आरक्षित या विलंबित कैप्चर वाले भुगतान नहीं हैं, WooCommerce Subscriptions या आवर्ती भुगतान नहीं हैं, सेव किए गए कार्ड नहीं हैं, Barion Pixel नहीं है और अतिरिक्त 3-D Secure डेटा नहीं है; 3-D Secure को Barion अपने भुगतान पेज पर संभालता है।
ऑर्डर और रिफ़ंड
ऑर्डर की स्थितियाँ
Pending payment: Barion भुगतान शुरू हुआ और Barion ने उसकी पुष्टि अभी नहीं की। ऑर्डर नोट में Barion PaymentId, राशि और, टेस्ट मोड में, (test mode) दिखता है।
Processing or Completed: Barion ने भुगतान की पुष्टि की। स्थिति Order Status After Payment का अनुसरण करती है। ऑर्डर नोट में राशि, PaymentId और लेन-देन दिखते हैं। लेन-देन ID Barion लेन-देन ID है।
On hold: Barion ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई, उदाहरण के लिए भुगतान शुरू होने के बाद ऑर्डर बदला गया हो। Barion पोर्टल में भुगतान जाँचें और ऑर्डर को मैनुअल रूप से पूरा करें या रिफ़ंड करें।
Cancelled: नवीनतम भुगतान प्रयास Barion पर रद्द हुआ या समाप्त हो गया।
Failed: नवीनतम भुगतान प्रयास विफल हुआ।
भुगतान किए गए या रिफ़ंड किए गए ऑर्डर को बाद के किसी कॉलबैक से कभी नहीं बदला जाता। यदि भुगतान किए गए ऑर्डर के लिए कोई और भुगतान सफल होता है, तो एक नोट आपसे Barion पोर्टल में उसे जाँचने को कहता है, और यदि वह दोहरा है तो रिफ़ंड करने को।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Barion पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड का कारण Barion को टिप्पणी के रूप में भेजा जाता है। HUF रिफ़ंड पूरी राशि के होने चाहिए। रिफ़ंड उसी मोड (टेस्ट या लाइव) में भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था, इसलिए उस मोड का POSKey सेट होना चाहिए। यदि Barion रिफ़ंड स्वीकार या पुष्ट नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Barion लेन-देन और स्थिति के साथ ऑर्डर नोट में जुड़ता है।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Barion के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। स्लॉट अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर Barion ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन स्टोर मैनेजर भुगतान विधि अब भी देखते हैं, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर और जाँच सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है, और रिफ़ंड काम करते हैं।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।
समस्या-निवारण
Barion चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड में POSKey और payee ईमेल हैं, और स्टोर मुद्रा HUF, EUR, USD या CZK है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: ऑर्डर तब पूरा होता है जब Barion कॉलबैक URL को कॉल करता है या ग्राहक आपके स्टोर पर लौटता है। सुनिश्चित करें कि साइट इंटरनेट से पहुँच योग्य है (/wc-api/ के सामने मेंटेनेंस मोड, फ़ायरवॉल या basic authentication नहीं)। जाँचें कि जिस मोड में ऑर्डर का भुगतान हुआ, उसका POSKey सही है, क्योंकि प्लगइन उसी से Barion से भुगतान की स्थिति पूछता है। कॉलबैक देखने के लिए Logging चालू करें।
The callback answers Busy, retry: उसी समय ग्राहक की वापसी से यह ऑर्डर प्रोसेस हो रहा था। Barion फिर कॉल करता है।
The callback answers API error: स्टोर Barion से भुगतान की स्थिति नहीं पढ़ सका। जिस मोड में ऑर्डर का भुगतान हुआ, उसका POSKey जाँचें।
एक ऑर्डर मेल न खाने वाले नोट के साथ On hold पर है: Barion द्वारा बताई गई राशि या मुद्रा ऑर्डर की कुल राशि से अलग है। Barion पोर्टल में भुगतान जाँचें और उसे मैनुअल रूप से पूरा करें या रिफ़ंड करें।
मैं 10.50 HUF का रिफ़ंड क्यों नहीं कर सकता: Barion HUF को बिना दशमलव के प्रोसेस करता है। पूरी राशि दर्ज करें।
रिफ़ंड कहता है कि इस ऑर्डर के मोड का POSKey कॉन्फ़िगर नहीं है: ऑर्डर का भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड का POSKey खाली है। उसे दर्ज करें और फिर कोशिश करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करें और फिर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स केवल तभी हटती हैं जब Delete Data on Uninstall चालू था। अन्यथा ये बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। ऑर्डर और उनका Barion भुगतान डेटा हमेशा बना रहता है। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।
Barion उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Barion से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।