VibeFox Viva Wallet for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित)।
PHP: 8.0 या बाद का संस्करण।
Viva खाता: एक Viva मर्चेंट खाता। परीक्षण के लिए आप डेमो खाता (demo.vivapayments.com) और वास्तविक भुगतान के लिए लाइव खाता (www.vivapayments.com) उपयोग कर सकते हैं। हर खाते के अपने क्रेडेंशियल होते हैं। भुगतान के लिए आपको Smart Checkout क्रेडेंशियल (Client ID और Client Secret) और किसी भुगतान स्रोत का Source Code चाहिए। Merchant ID और API Key वैकल्पिक हैं: ये केवल Viva के वेबहुक URL सत्यापन का उत्तर देने के लिए उपयोग होते हैं।
मुद्रा: EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK या CHF। स्टोर में ग्राहक द्वारा चुनी गई मुद्रा इनमें से एक होनी चाहिए; अन्य मुद्राओं में चेकआउट पर भुगतान विधि छिप जाती है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_viva_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_viva_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_viva_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर की जगह आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Viva Wallet Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें License key)।
4. Viva के डेमो और/या लाइव खाते के क्रेडेंशियल दर्ज करें, और अपने Viva खाते में भुगतान स्रोत तथा वेबहुक सेट करें (देखें Configuration)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू रहते हुए Viva डेमो कार्ड से डेमो भुगतान करें, फिर वास्तविक संचालन के लिए Test Mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_viva_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज इसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Viva Wallet Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी, Viva के क्रेडेंशियल, भुगतान स्रोत और वेबहुक OpenCart 3 के चरण 3 से 5 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Viva खाते के पते अलग हैं (देखें Configuration)।
नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर, यदि वर्तमान मोड में Client ID, Client Secret या Source Code नहीं है, तो पेज चेतावनी देता है (Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered., या लाइव मोड में Live), और यदि स्टोर की डिफ़ॉल्ट मुद्रा समर्थित नहीं है तब भी। टेस्ट मोड चालू होने पर यह Test mode is on: payments go to the Viva demo environment. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।
सहेजते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं होना चाहिए (Enter a title for the payment method (at most 128 characters).), Sort Order पूर्ण संख्या होना चाहिए (Sort Order must be a whole number.), Total 0 या उससे बड़ी संख्या होनी चाहिए (Total: enter a number, 0 or greater.), और चुना गया जियो ज़ोन व ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सहेजा नहीं जाता और पेज त्रुटि दिखाता है। सेटिंग्स सहेजने पर कैश किए गए Viva एक्सेस टोकन हट जाते हैं, ताकि नए क्रेडेंशियल तुरंत इस्तेमाल हों।
Viva Wallet
Enable/Disable: Enable Viva Wallet payment gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी भुगतान विधि के रूप में यही नाम सहेजा जाता है। डिफ़ॉल्ट: Viva Wallet। आवश्यक, अधिकतम 128 अक्षर।
Description: Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.
Test Mode: Viva के डेमो वातावरण (demo.vivapayments.com) का उपयोग करता है। नए भुगतान और API कॉल डेमो खाते के क्रेडेंशियल इस्तेमाल करते हैं। कोई वास्तविक राशि नहीं काटी जाती, और Confirm Order चरण पर ग्राहक (Test mode: use Viva demo cards, no real money is charged.) देखते हैं। डिफ़ॉल्ट: on। वास्तविक भुगतान लाइव खाते से लेने के लिए इसे बंद करें। जो भुगतान पहले ही हो चुके हैं, वे उसी वातावरण में सत्यापित और रिफ़ंड होते रहते हैं जिसमें वे हुए थे।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Viva Wallet की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें; ऋणात्मक संख्याएँ भी स्वीकार्य हैं।
Geo Zone: Viva Wallet केवल चुने गए जियो ज़ोन के भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: चेकआउट कुल, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Viva Wallet दिखाया जाता है: 0 या उससे बड़ी संख्या। किसी भी राशि के लिए दिखाने हेतु खाली छोड़ें।
Demo account (test mode) and Live account
दोनों सेक्शन में एक जैसे फ़ील्ड हैं: एक सेट डेमो खाते के लिए, एक लाइव खाते के लिए। अपने Viva खाते में Settings > API Access खोलें और Smart Checkout क्रेडेंशियल (Client ID, Client Secret), Merchant ID और API Key कॉपी करें। Source Code Sales > Online payments > Websites / apps में मिलता है।
Client ID (Demo) / Client ID (Live): खाते का Smart Checkout OAuth 2.0 Client ID। भुगतान के लिए आवश्यक।
Client Secret (Demo) / Client Secret (Live): खाते का Smart Checkout OAuth 2.0 Client Secret। भुगतान के लिए आवश्यक।
Source Code (Demo) / Source Code (Live): खाते के भुगतान स्रोत का 4-अंकीय कोड। इसके Success URL और Failure URL इसी स्टोर की ओर इंगित होने चाहिए (नीचे देखें)। भुगतान के लिए आवश्यक।
Merchant ID (Demo) / Merchant ID (Live): वैकल्पिक। केवल Viva के वेबहुक URL सत्यापन का उत्तर देने के लिए उपयोग होता है।
API Key (Demo) / API Key (Live): वैकल्पिक। केवल Viva के वेबहुक URL सत्यापन का उत्तर देने के लिए उपयोग होता है।
सहेजे गए Client Secret और API Key फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
Clear saved secrets: Live account सेक्शन के अंत में। किसी सहेजे गए सीक्रेट पर टिक लगाएँ और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजे गए मान को बनाए रखता है।
Return URLs and webhook
Addresses for the Viva account: यह फ़ील्ड आपके स्टोर के तीन पते दिखाता है, जिन्हें Viva खाते में दर्ज करना है। ये आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनते हैं और OpenCart 3 पर कुछ इस तरह दिखते हैं: https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&, https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail& और https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook OpenCart 3 पर हैं, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&, https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail& और https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook हैं। इन्हें बिल्कुल वैसे ही कॉपी करें जैसे सेटिंग्स दिखाती हैं। सफलता और विफलता पतों के अंत में & आवश्यक है: Viva पते में लेन-देन जोड़ता है, और इसके बिना OpenCart पेज न मिलने का उत्तर देता है।
Payment source: आप जिस भी खाते का उपयोग करते हैं, उसमें Sales > Online payments > Websites / apps में अपने स्टोर के डोमेन के लिए एक भुगतान स्रोत बनाएँ। Success URL और Failure URL के रूप में, सफलता और विफलता पतों में डोमेन के बाद के पथ दर्ज करें।
Webhook: Settings > API Access > Webhooks में इन इवेंट्स के लिए वेबहुक पता जोड़ें:
Viva इसे सहेजने से पहले URL की जाँच करता है। एक्सटेंशन आपके खाते की सत्यापन कुंजी से उत्तर देता है: यह वर्तमान मोड के Merchant ID और API Key से कुंजी लेता है, या नीचे दर्ज की गई कुंजी का उपयोग करता है। वेबहुक तब भी भुगतान की पुष्टि करते हैं जब ग्राहक ब्राउज़र बंद कर दे। Viva के वेबहुक पर हस्ताक्षर नहीं होते, इसलिए एक्सटेंशन अकेले वेबहुक पर कभी भरोसा नहीं करता: ऑर्डर को स्थिति मिलने से पहले हर भुगतान Viva API से सत्यापित होता है। वेबहुक के बिना, ऑर्डर को स्थिति तभी मिलती है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।
Webhook Verification Key: वैकल्पिक। वर्तमान मोड के Merchant ID और API Key से कुंजी अपने-आप लाने के लिए खाली छोड़ें, या अपने Viva खाते की सत्यापन कुंजी यहाँ चिपकाएँ।
Order statuses
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। Viva भुगतान सत्यापित होने के बाद ही ऑर्डर को स्थिति मिलती है। स्थिति फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची दिखाते हैं।
Order Status After Payment: भुगतान किए गए ऑर्डर को मिलने वाली स्थिति। यह एक ही स्थिति-परिवर्तन के साथ तुरंत सेट होती है।
Processing Status: Default और Processing के लिए भुगतान किए गए ऑर्डर की स्थिति। डिफ़ॉल्ट: Processing।
Complete Status: Completed के लिए भुगतान किए गए ऑर्डर की स्थिति। डिफ़ॉल्ट: Complete।
On Hold Status: On Hold के लिए भुगतान किए गए ऑर्डर की स्थिति, और उस ऑर्डर की स्थिति जिसका Viva भुगतान ऑर्डर राशि या मुद्रा से मेल नहीं खाता (समीक्षा के लिए रोका गया, भुगतान नहीं माना गया; नोट में कारण लिखा होता है)। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Order Status: इस स्थिति वाले ऑर्डर के लिए मिला Viva भुगतान उसे कभी दोबारा नहीं खोलता; एक नोट आपसे ऑर्डर बहाल करने या भुगतान रिफ़ंड करने को कहता है। एक्सटेंशन यह स्थिति कभी सेट नहीं करता। डिफ़ॉल्ट: Canceled।
Refunded Status: ऑर्डर टैब से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होती है। बाद का भुगतान भी ऐसे ऑर्डर को दोबारा नहीं खोलता। डिफ़ॉल्ट: Refunded।
Advanced Settings
Brand Color: Viva भुगतान पेज के लिए 6-अंकों का HEX रंग कोड, जैसे 0000ff। शुरुआती # हटा दिया जाता है। डिफ़ॉल्ट रंग के लिए खाली छोड़ें। कोई दूसरा मान सहेजा नहीं जाता: बाकी सेटिंग्स सहेजी जाती हैं, और पेज Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept. दिखाता है।
Debug Logging: API अनुरोधों को OpenCart के लॉग फ़ोल्डर (storage/logs, OpenCart 4 पर system/storage/logs) में viva_wp_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ, टोकन और ग्राहक डेटा कभी लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं, भले ही यह बंद हो। डिफ़ॉल्ट: off।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग मिट जाते हैं। ऑर्डर और उनका भुगतान डेटा (Viva भुगतान प्रयास, रिफ़ंड) कभी नहीं मिटते। डिफ़ॉल्ट: off।
Import / Export
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। सीक्रेट निर्यात नहीं होते।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए सीक्रेट बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Viva Wallet)। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि भुगतान विधि के ब्लॉक के Choose बटन से चुनता है, विंडो Payment method options में, और पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक Viva भुगतान ऑर्डर बनाता है और ग्राहक को Viva Smart Checkout पेज पर भेजता है, यदि Brand Color सेट है तो उसी रंग में। वहाँ ग्राहक आपके Viva खाते में सक्षम तरीकों में से किसी एक से भुगतान करता है। ग्राहक का ईमेल, नाम, फ़ोन, देश और स्टोर की भाषा Viva को भेजे जाते हैं। Viva में भुगतान OpenCart # और ऑर्डर नंबर के रूप में दिखता है, और ग्राहक को Order, ऑर्डर नंबर, at और आपके स्टोर के नाम के रूप में बताया जाता है। Viva भुगतान ऑर्डर 30 मिनट बाद समाप्त हो जाता है।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Viva उसकी पुष्टि करता है: एक्सटेंशन ग्राहक की वापसी पर और वेबहुक आने पर, दोनों ही समय, Viva API से लेन-देन दोबारा पढ़ता है। इसके बाद ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। यदि भुगतान की अभी पुष्टि नहीं हुई है, तो Payment confirmation पेज We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. दिखाता है, साथ में Check again और Back to checkout बटन। भुगतान की पुष्टि होने तक कार्ट सुरक्षित रहता है; Viva के पुष्टि करते ही वेबहुक ऑर्डर की स्थिति सेट कर देता है। OpenCart 4 पर, जब ग्राहक Viva पेज से लौटता है, तो एक छोटा मध्यवर्ती पेज आपके स्टोर का वापसी पता फिर से खोलता है, ताकि कार्ट और ग्राहक सत्र सुरक्षित रहें।
यदि भुगतान विफल होता है या ग्राहक Viva पेज पर रद्द कर देता है, तो ऑर्डर बिना स्थिति के रहता है और कार्ट सुरक्षित रहता है। ग्राहक चेकआउट पर लौटता है और उसे The Viva Wallet payment was not completed. Please try again or choose another payment method. या The Viva Wallet payment was cancelled. You can try again or choose another payment method. दिखता है, और वह फिर से भुगतान कर सकता है। हर नया प्रयास एक नया Viva भुगतान ऑर्डर शुरू करता है। एक कार्ट केवल एक बार भुगतान किया जाता है: यदि वही कार्ट उसी चेकआउट के किसी दूसरे ऑर्डर से पहले ही भुगतान हो चुका है, तो ग्राहक सीधे सफलता पेज पर जाता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नए कार्ट के रूप में गिना जाता है जिसके लिए अपना भुगतान चाहिए।
OpenCart 4 भुगतान का सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। विफल या रद्द भुगतान के बाद ग्राहक उसी ऑर्डर का दोबारा भुगतान एक नए Viva भुगतान ऑर्डर से करता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए आपने उसे रद्द कर दिया), या वह ऐसी कार्ट के लिए भुगतान किया गया था जो तब से बदल चुकी है, तो ग्राहक This order can no longer be paid. Please confirm your order again. के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है।
यदि Viva भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बटन के ऊपर एक संदेश के साथ रहता है: Viva Wallet payments are not available at the moment. Please choose another payment method or contact us. (क्रेडेंशियल गायब या गलत हैं) या We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।
वापसी पेज ऑर्डर सफलता पेज केवल उस ग्राहक को दिखाते हैं जिसने भुगतान किया है। वापसी का पता खोलने वाले किसी और को ऑर्डर विवरण के बिना ऑर्डर इतिहास या चेकआउट पर भेज दिया जाता है।
स्टोर के रखरखाव मोड में होने पर भी वेबहुक काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को जाने देता है।
यह एक्सटेंशन केवल एकमुश्त भुगतान लेता है, जो Viva पेज पर तुरंत काटे जाते हैं। इसमें प्री-ऑथराइज़ेशन और कैप्चर, किस्तें, सेव किए गए कार्ड, सदस्यता, Viva Native Checkout (आपके अपने पेज पर कार्ड फ़ील्ड) या POS टर्मिनल नहीं हैं। जब ग्राहक नया प्रयास शुरू करता है, तो पुराना बिना भुगतान वाला Viva भुगतान ऑर्डर रद्द नहीं होता; Viva उसे 30 मिनट बाद समाप्त कर देता है।
ऑर्डर और रिफ़ंड
Order statuses
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Viva पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान विफल हुआ या रद्द हुआ, या Viva ने भुगतान अभी पूरा नहीं किया है। ग्राहक फिर से भुगतान कर सकता है। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। OpenCart 4.1 पर ऐसे ऑर्डर की स्थिति Voided भी हो सकती है, जिसे OpenCart तब सेट करता है जब confirm चरण फिर से दिखाया जाता है; एक्सटेंशन इसे बिना स्थिति वाला ऑर्डर मानता है।
Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई है। एक नोट राशि, लेन-देन, Viva ऑर्डर कोड, वातावरण (डेमो या लाइव) और पुष्टि का तरीका (वेबहुक या ग्राहक की वापसी) दिखाता है।
असंगति के बाद On Hold Status (डिफ़ॉल्ट Pending): Viva ने ऑर्डर कुल से अलग राशि या मुद्रा बताई है। ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता, और Viva Wallet payment held for review नोट कारण बताता है। Viva डैशबोर्ड में भुगतान की तुलना ऑर्डर से करें, फिर ऑर्डर पूरा करें या मैन्युअल रूप से रिफ़ंड करें। यदि बाद में उसी ऑर्डर के लिए मेल खाता भुगतान आता है, तो ऑर्डर भुगतान किए गए स्थिति में चला जाता है।
Cancelled Order Status या Refunded Status वाले ऑर्डर के लिए आया भुगतान ऑर्डर की स्थिति नहीं बदलता; एक नोट आपसे ऑर्डर बहाल करने या Viva डैशबोर्ड में भुगतान रिफ़ंड करने को कहता है। यदि पहले से भुगतान किए गए ऑर्डर, या पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदला जाता; भुगतान किए गए ऑर्डर पर एक नोट आपसे Viva डैशबोर्ड में डुप्लिकेट रिफ़ंड करने को कहता है।
नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को नहीं दिखतीं। स्थिति परिवर्तन ग्राहक को अपने-आप सूचित नहीं करते; जब भुगतान किया हुआ ऑर्डर पहली बार स्थिति पाता है, तब OpenCart अपना सामान्य ऑर्डर ईमेल भेजता है।
VibeFox Viva Wallet Gateway tab
Sales > Orders में Viva Wallet से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Viva Wallet Gateway टैब में Viva order code, डेमो भुगतानों के लिए Demo लेबल वाला Transaction ID, Environment / Source Code, Viva status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, ऑर्डर के Viva payment attempts (यदि एक से अधिक थे) और ऑर्डर के Viva Wallet notes दिखाए जाते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।
Refunds
VibeFox Viva Wallet Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह भर दी जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Viva Wallet पर क्लिक करें। Refund this amount via Viva Wallet? This cannot be undone. प्रश्न की पुष्टि करें। पुष्टि किए गए Viva भुगतान वाले ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (यह System > Users > User Groups में सेट होता है)। ऑर्डर बाद में संपादित हुआ हो तब भी आप उस राशि तक रिफ़ंड कर सकते हैं जो Viva ने भुगतान के लिए काटी थी। रिफ़ंड उसी खाते (डेमो या लाइव) में, भुगतान की मुद्रा में भेजा जाता है, इसलिए उस खाते का Client ID और Client Secret दर्ज होना चाहिए। यदि Viva रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड, Viva रिफ़ंड लेन-देन के साथ, रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस रखे बिना, मैन्युअल स्थिति-परिवर्तन की तरह ऑर्डर को Refunded Status पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। असंगति के बाद समीक्षा के लिए रोका गया ऑर्डर बिना पुष्टि किए भुगतान के होता है और टैब से रिफ़ंड नहीं हो सकता।
Sales > Returns में उत्पाद वापसी Viva के माध्यम से पैसे वापस नहीं भेजती। Viva डैशबोर्ड में किए गए रिफ़ंड आयात नहीं होते। ज़रूरत हो तो ऑर्डर को मैन्युअल रूप से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Viva Wallet Gateway, Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-viva वाली पंक्ति और 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Viva Wallet नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन में लॉग इन है, उसे स्टोर में भुगतान विधि (unlicensed — visible to admins only) चिह्न के साथ अब भी दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी से छिपी रहती है। एक बार Edit पेज खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जिन भुगतानों की शुरुआत हो चुकी है उनकी पुष्टि अब भी Viva webhook और स्टोर पर वापसी से होती है, और रिफ़ंड काम करते हैं।
लाइसेंस की अवधि समाप्त होने पर भी एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण आवश्यक है। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तब स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है।
समस्या निवारण
Viva Wallet चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में उसका Client ID, Client Secret और Source Code है (टेस्ट मोड में Demo फ़ील्ड, लाइव मोड में Live फ़ील्ड)। स्टोर में चुनी गई मुद्रा EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK या CHF में से एक होनी चाहिए। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहता है: वेबहुक काम नहीं कर रहा है। Viva में जाँचें कि वेबहुक उस खाते में मौजूद है जिसका आप उपयोग करते हैं (डेमो या लाइव), उसका URL सेटिंग्स में दिखाए गए URL से बिल्कुल मेल खाता है, और Transaction Payment Created चुना हुआ है। जाँचें कि उस भुगतान के खाते का Client ID और Client Secret अभी भी दर्ज हैं: एक्सटेंशन को भुगतान सत्यापित करने के लिए इनकी ज़रूरत होती है। Debug Logging चालू करें और Log फ़ील्ड देखें। भुगतान के बाद ग्राहक स्टोर पर लौटता है तो ऑर्डर को भी स्थिति मिल जाती है।
ग्राहक एक पेज न मिलने पर लौटता है: भुगतान स्रोत का Success URL या Failure URL & पर समाप्त नहीं होता। पथों को ठीक वैसे ही कॉपी करें जैसे सेटिंग्स दिखाती हैं।
Viva वेबहुक URL सत्यापित नहीं कर पा रहा: वर्तमान मोड का Merchant ID और API Key दर्ज करें (या Webhook Verification Key में स्वयं सत्यापन कुंजी), सहेजें, और Viva में फिर से सत्यापित करें। दूसरे खाते का वेबहुक सत्यापित करने के लिए पहले Test Mode बदलें या उस खाते की कुंजी दर्ज करें।
वेबहुक त्रुटि के साथ उत्तर देता है: Viva आपके स्टोर का उत्तर दिखाता है और विफल वेबहुक को फिर से भेजता है। verification_failed (HTTP 500) का अर्थ है कि भुगतान सत्यापित करने के लिए Viva API तक नहीं पहुँचा जा सका, या ऑर्डर की स्थिति सेट नहीं हो सकी। busy (HTTP 503) का अर्थ है कि उसी समय ऑर्डर किसी दूसरे अनुरोध द्वारा संसाधित हो रहा था। transaction_not_found (HTTP 404) का अर्थ है कि उस भुगतान के खाते में लेन-देन मौजूद नहीं है, उदाहरण के लिए गलत क्रेडेंशियल के कारण। उसी Viva खाते पर दूसरे स्टोरों के भुगतानों के इवेंट्स का उत्तर ignored से दिया जाता है।
ग्राहक Confirm Order के बाद त्रुटि देखता है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। गलत Client ID या Client Secret से संदेश आता है कि Viva Wallet भुगतान उपलब्ध नहीं हैं। यदि Viva तक नहीं पहुँचा जा सकता या वह भुगतान ऑर्डर अस्वीकार करता है, जैसे कि Source Code किसी दूसरे खाते का हो, तो ग्राहक को संदेश मिलता है कि स्टोर Viva Wallet से कनेक्ट नहीं हो सका। This payment method is not available. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता: ग्राहक चेकआउट को फिर से लोड करे।
ग्राहक लौटता है और We could not find your order. If you were charged, please contact us.: देखता है: वापसी पते में दिया Viva ऑर्डर कोड इस स्टोर का भुगतान नहीं है, उदाहरण के लिए किसी दूसरे स्टोर का भुगतान स्रोत यहाँ की ओर इंगित कर रहा हो। भुगतान स्रोत के Success URL और Failure URL जाँचें।
भुगतान के बाद ऑर्डर समीक्षा स्थिति में है: VibeFox Viva Wallet Gateway टैब के नोट पढ़ें (देखें Order statuses), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: ऑर्डर का कोई पुष्टि किया हुआ Viva भुगतान नहीं है (Transaction ID not found. Cannot process refund.), वह पूरी तरह रिफ़ंड हो चुका है, भुगतान के खाते के क्रेडेंशियल गायब हैं, या आपके उपयोगकर्ता समूह को एक्सटेंशन बदलने का अधिकार नहीं है।
This payment was made in the Viva demo (or live) environment संदेश के साथ रिफ़ंड विफल होता है: जिस खाते में भुगतान हुआ था, उसका Client ID और Client Secret दर्ज नहीं हैं। उन्हें दर्ज करें और फिर कोशिश करें। अन्य रिफ़ंड त्रुटियाँ Viva का संदेश दिखाती हैं।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Viva Wallet Gateway के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Order statuses सेक्शन के स्थिति फ़ील्ड, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट मानों पर लौट आते हैं। कैश किए गए Viva एक्सेस टोकन और वेबहुक कुंजियाँ हमेशा हटा दी जाती हैं। OpenCart 4 पर एक्सटेंशन के इवेंट्स और उसकी startup action भी हमेशा हटा दिए जाते हैं, जो maintenance mode में वेबहुक और वापसी पतों को आगे जाने देती है। यदि Delete Data on Uninstall चालू है, तो बाकी गेटवे सेटिंग्स (टाइटल, विवरण, टेस्ट मोड, क्रेडेंशियल, भुगतान के बाद ऑर्डर स्थिति, ब्रांड रंग, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे जाते हैं। Viva भुगतान प्रयास और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड हो सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Viva Wallet Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Viva Wallet उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Viva Wallet से संबद्ध या उसके द्वारा समर्थित नहीं है।