VibeFox Viva Wallet for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।

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 से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Viva Wallet Gateway ढूँढकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. Viva के डेमो और/या लाइव खाते के क्रेडेंशियल डालें, और अपने Viva खाते में भुगतान स्रोत और वेबहुक सेट करें (कॉन्फ़िगरेशन देखें)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू रहते हुए Viva डेमो कार्ड से डेमो भुगतान करें, फिर लाइव जाने के लिए Test Mode बंद करें।

इंस्टॉल होने पर मॉड्यूल ऑर्डर स्थिति Viva Wallet payment on hold बनाता है। मॉड्यूल इंस्टॉलेशन के समय सक्रिय देशों के लिए दिया जाता है। मुद्राएँ, देश और ग्राहक समूह आप Payment > Preferences में बदल सकते हैं; नए देश बाद में वहीं जोड़े जा सकते हैं।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Viva Wallet Gateway > Configure। हर सेक्शन का अपना 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. दिखाता है। सेटिंग्स सेव करने पर कैश किए गए Viva एक्सेस टोकन हट जाते हैं, इसलिए नए क्रेडेंशियल तुरंत लागू होते हैं।

Viva Wallet

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

Title: वह नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सेव होता है। डिफ़ॉल्ट: Viva Wallet। आवश्यक: खाली शीर्षक सेव नहीं होता और पेज Enter a title for the payment method. दिखाता है।

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.

Test Mode: Viva डेमो वातावरण (demo.vivapayments.com) का उपयोग करता है। नए भुगतान और API कॉल डेमो खाते के क्रेडेंशियल इस्तेमाल करते हैं। कोई वास्तविक राशि नहीं काटी जाती, और चेकआउट पर ग्राहक को (Test mode: use Viva demo cards, no real money is charged.) दिखता है। डिफ़ॉल्ट: चालू। लाइव खाते से वास्तविक भुगतान लेने के लिए इसे बंद करें। जो भुगतान पहले हो चुके हैं, वे उसी वातावरण में सत्यापित और रिफ़ंड होते रहते हैं जिसमें वे हुए थे।

डेमो खाता (टेस्ट मोड) और लाइव खाता

दोनों सेक्शन में एक जैसे फ़ील्ड हैं: एक सेट डेमो खाते के लिए, एक लाइव खाते के लिए। अपने 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: किसी गुप्त मान पर टिक करें और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।

वापसी URL और वेबहुक

Addresses for the Viva account: यह फ़ील्ड आपके स्टोर के तीन पते दिखाता है जिन्हें Viva खाते में डालना है। फ़्रेंडली URL के साथ ये इस तरह दिखते हैं: https://your-shop/module/wcp_viva_gateway/success, https://your-shop/module/wcp_viva_gateway/fail और https://your-shop/module/wcp_viva_gateway/webhook, संभवतः /en/ जैसे भाषा कोड के साथ। इन्हें ठीक वैसे ही कॉपी करें जैसे सेटिंग्स इन्हें दिखाती हैं।

Payment source: हर उस Viva खाते में जिसका आप उपयोग करते हैं, 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 Status After Payment: सफल भुगतान के बाद सेट होने वाली ऑर्डर स्थिति। स्थिति तुरंत सेट होती है, दूसरे स्थिति-बदलाव के बिना।

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 अनुरोध मॉड्यूल फ़ोल्डर की logs/viva_wp_debug.log.php फ़ाइल में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। कुंजियाँ, टोकन और ग्राहक का डेटा दर्ज नहीं होते। त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।

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

Delete Data on Uninstall: चालू होने पर मॉड्यूल अनइंस्टॉल करने से सेटिंग्स और मॉड्यूल लॉग हट जाते हैं। ऑर्डर और उनका भुगतान डेटा (Viva भुगतान प्रयास, रिफ़ंड, ऑर्डर स्थिति) कभी नहीं हटते। डिफ़ॉल्ट: बंद।

चेकआउट

भुगतान के चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Viva Wallet) और यह नोट देखता है: You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). पुष्टि करने के बाद मॉड्यूल कार्ट की कुल राशि के लिए, कार्ट की मुद्रा में, एक Viva भुगतान ऑर्डर बनाता है और ग्राहक को Viva Smart Checkout पेज पर भेजता है। वहाँ ग्राहक आपके Viva खाते में सक्षम तरीकों में से किसी एक से भुगतान करता है। ग्राहक का ईमेल, नाम, फ़ोन और देश Viva को भेजे जाते हैं, और यदि Viva समर्थन करता है तो पेज कार्ट की भाषा में खुलता है। Viva में भुगतान Cart #, कार्ट नंबर और आपके स्टोर के नाम के साथ दिखता है। Viva भुगतान ऑर्डर 30 मिनट बाद समाप्त हो जाता है। इस बिंदु पर अभी कोई ऑर्डर नहीं होता।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब Viva पुष्टि कर दे: मॉड्यूल वापसी पर और वेबहुक पर लेन-देन को Viva API से दोबारा पढ़ता है। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। अगर भुगतान की पुष्टि अभी नहीं हुई है, तो 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 भुगतान की पुष्टि करते ही वेबहुक ऑर्डर बना देता है।

अगर भुगतान विफल होता है या ग्राहक 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 भुगतान शुरू नहीं कर पाता, तो ग्राहक 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. के साथ चेकआउट पर ही रहता है। तकनीकी कारण लॉग में लिखा जाता है।

वापसी के पेज ऑर्डर की पुष्टि केवल उसी ग्राहक को दिखाते हैं जिसने भुगतान किया। कोई और, जो वापसी का पता खोलता है, ऑर्डर विवरण के बिना ऑर्डर इतिहास या चेकआउट पर भेज दिया जाता है।

वेबहुक तब भी काम करता है जब स्टोर मेंटेनेंस मोड में हो, और स्टोर के देश-प्रतिबंध से अवरुद्ध नहीं होता।

मॉड्यूल केवल एक बार के भुगतान लेता है, जो Viva के पेज पर तुरंत काटे जाते हैं। इसमें प्री-ऑथराइज़ेशन और कैप्चर, किस्तें (EMI), सेव किए गए कार्ड, सब्सक्रिप्शन, Viva Native Checkout (अपने पेज पर कार्ड फ़ील्ड) या POS टर्मिनल नहीं हैं। जब ग्राहक नया प्रयास शुरू करता है, तो पुराना बिना भुगतान वाला Viva भुगतान ऑर्डर रद्द नहीं होता; Viva उसे 30 मिनट बाद समाप्त कर देता है।

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

ऑर्डर स्थितियाँ

अभी कोई ऑर्डर नहीं: ग्राहक को Viva पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान विफल हुआ या रद्द हुआ, या Viva ने अभी भुगतान पूरा नहीं किया। केवल कार्ट मौजूद है, और ग्राहक फिर से भुगतान कर सकता है।

Payment accepted, Delivered या Viva Wallet payment on hold: भुगतान की पुष्टि हो गई है। स्थिति Order Status After Payment के अनुसार होती है। भुगतान Viva लेन-देन ID के साथ दर्ज होता है, और एक नोट में राशि, लेन-देन, Viva ऑर्डर कोड, वातावरण (डेमो या लाइव) और पुष्टि का तरीका (वेबहुक या ग्राहक की वापसी) दिखता है।

असंगति के बाद Viva Wallet payment on hold: Viva ने कार्ट की कुल राशि या मुद्रा से भिन्न राशि या मुद्रा बताई है, उदाहरण के लिए जब ग्राहक के भुगतान शुरू करने के बाद कार्ट बदला गया हो। ऑर्डर बिना दर्ज भुगतान के बनता है, और नोट Viva Wallet payment held for review कारण बताता है। ग्राहक को Viva की पुष्टि के वादे के बिना मानक ऑर्डर पुष्टि पेज दिखता है। Viva डैशबोर्ड के भुगतान की तुलना ऑर्डर से करें और ऑर्डर पूरा करें या भुगतान मैन्युअली रिफ़ंड करें। अगर बाद में उसी कार्ट का मेल खाता भुगतान आता है, तो ऑर्डर भुगतान-पूरा स्थिति में चला जाता है।

रद्द या रिफ़ंड किए गए ऑर्डर पर आया भुगतान ऑर्डर की स्थिति नहीं बदलता; एक नोट आपसे ऑर्डर बहाल करने या Viva डैशबोर्ड में भुगतान रिफ़ंड करने को कहता है। अगर पहले से भुगतान किए गए ऑर्डर पर दूसरा भुगतान आता है, तो ऑर्डर नहीं बदला जाता; एक नोट आपसे डुप्लीकेट को Viva डैशबोर्ड में रिफ़ंड करने को कहता है।

Viva Wallet payment ब्लॉक

ऑर्डर पेज पर एक Viva Wallet payment ब्लॉक दिखता है, जिसमें Viva ऑर्डर कोड, लेन-देन ID, वातावरण और Source Code, Viva स्थिति, भुगतान और रिफ़ंड की गई राशि, डेमो भुगतानों के लिए Demo बैज, रिफ़ंड इतिहास, कार्ट के भुगतान प्रयास (यदि एक से अधिक थे) और ऑर्डर के Viva Wallet notes शामिल होते हैं।

रिफ़ंड

Viva Wallet payment ब्लॉक में राशि डालें (जो राशि अभी तक रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), चाहें तो कारण लिखें, और Refund via Viva Wallet पर क्लिक करें। Refund this amount via Viva Wallet? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड उन ऑर्डरों के लिए समर्थित हैं जिनका Viva लेन-देन पुष्ट हो चुका है। आपके पास ऑर्डर संपादित करने का अधिकार होना चाहिए; मॉड्यूल तक पहुँच आवश्यक नहीं है। आप उस राशि तक रिफ़ंड कर सकते हैं जो Viva ने भुगतान के लिए काटी थी, भले ही ऑर्डर बाद में संपादित हुआ हो। रिफ़ंड उसी खाते (डेमो या लाइव) में, भुगतान की मुद्रा में भेजा जाता है, इसलिए उस खाते का Client ID और Client Secret डाला होना चाहिए। अगर Viva रिफ़ंड स्वीकार नहीं करता, तो ब्लॉक त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड, Viva रिफ़ंड लेन-देन के साथ, रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड से ऑर्डर Refunded हो जाता है। आंशिक रिफ़ंड से स्थिति नहीं बदलती। बिना पुष्ट भुगतान के समीक्षा के लिए रोका गया ऑर्डर ब्लॉक से रिफ़ंड नहीं हो सकता।

मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन Viva के ज़रिए पैसे वापस नहीं भेजते। Viva डैशबोर्ड में किए गए रिफ़ंड इम्पोर्ट नहीं होते। ज़रूरत हो तो ऑर्डर मैन्युअली अपडेट करें।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक License — VibeFox Viva Wallet Gateway मॉड्यूल पेज Modules > Module Manager > VibeFox Viva Wallet Gateway > Configure पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-viva वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल के लिए Configure अनुमति वाले कर्मचारी कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल आखिरी ज्ञात स्थिति के साथ काम करता रहता है।

एक कुंजी एक ही डोमेन पर काम करती है: मुख्य स्टोर के डोमेन पर, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Viva Wallet नहीं दिखाया जाता। फिर भी अगर भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विकल्प आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे टेस्ट नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले शुरू हो चुके हैं, उनकी पुष्टि अब भी Viva वेबहुक और स्टोर पर वापसी से होती है, और रिफ़ंड काम करते हैं।

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

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

चेकआउट पर Viva Wallet दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड में उसके Client ID, Client Secret और Source Code भरे हैं (टेस्ट मोड में Demo फ़ील्ड, लाइव मोड में Live फ़ील्ड)। कार्ट की मुद्रा EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK या CHF में से एक होनी चाहिए। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर नहीं बना: वेबहुक काम नहीं कर रहा। Viva में जाँचें कि जिस खाते (डेमो या लाइव) का आप उपयोग करते हैं, उसमें वेबहुक मौजूद है, उसका URL सेटिंग्स में दिखाए गए URL से हूबहू मेल खाता है, और Transaction Payment Created चुना गया है। जाँचें कि उस भुगतान के खाते का Client ID और Client Secret अभी भी डले हैं: मॉड्यूल को भुगतान सत्यापित करने के लिए इनकी ज़रूरत होती है। Debug Logging चालू करें और Log फ़ील्ड देखें। भुगतान के बाद ग्राहक के स्टोर पर लौटने पर भी ऑर्डर बनता है।

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 जवाब मिलता है।

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

ग्राहक लौटता है और देखता है We could not find your order. If you were charged, please contact us.: वापसी पते में दिया Viva ऑर्डर कोड इस स्टोर का भुगतान नहीं है, उदाहरण के लिए इसलिए कि किसी दूसरे स्टोर का भुगतान स्रोत यहाँ की ओर इशारा कर रहा है। भुगतान स्रोत के Success URL और Failure URL जाँचें।

भुगतान के बाद ऑर्डर Viva Wallet payment on hold में है: Viva Wallet payment ब्लॉक के नोट पढ़ें (ऑर्डर स्थितियाँ देखें), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

रिफ़ंड This payment was made in the Viva demo (or live) environment: के साथ विफल: जिस खाते में भुगतान हुआ था, उसका Client ID और Client Secret नहीं डाले गए हैं। उन्हें डालें और फिर कोशिश करें। अन्य रिफ़ंड त्रुटियाँ HTTP कोड और Viva का संदेश दिखाती हैं।

ब्लॉक कहता है Transaction ID not found. Cannot process refund.: ऑर्डर पर कोई पुष्ट Viva भुगतान नहीं है, उदाहरण के लिए राशि की असंगति के बाद। ज़रूरत हो तो Viva डैशबोर्ड में भुगतान रिफ़ंड करें।

अनइंस्टॉल

मॉड्यूल बंद करने पर सारा डेटा रहता है; केवल कैश किए गए Viva एक्सेस टोकन हटते हैं। मॉड्यूल हटाने के लिए Modules > Module Manager पर जाएँ, VibeFox Viva Wallet Gateway के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटती है। कैश किए गए एक्सेस टोकन और वेबहुक कुंजियाँ हमेशा हटती हैं। अगर Delete Data on Uninstall चालू है, तो सेटिंग्स और लॉग हटते हैं। बंद होने पर बाद में दोबारा इंस्टॉल करने के लिए सारी सेटिंग्स रहती हैं। Viva भुगतान प्रयास और रिफ़ंड, तथा ऑर्डर स्थिति Viva Wallet payment on hold हमेशा बने रहते हैं, इसलिए पहले भुगतान हुए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID रखते हैं।

Viva Wallet उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Viva Wallet से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।