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

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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। अन्य मुद्राओं में चेकआउट पर यह भुगतान विधि छिपी रहती है।

सार्वजनिक HTTPS साइट: वेबहुक के लिए आपकी साइट इंटरनेट से HTTPS पर पहुँच योग्य होनी चाहिए।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_viva_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Viva Wallet > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

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

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Viva Wallet। फ़ील्ड्स के ऊपर, यदि वर्तमान मोड में 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 Wallet को तब तक सेटअप की आवश्यकता वाला चिह्नित किया जाता है जब तक वर्तमान मोड में ये तीनों मान न हों।

General

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: Viva Wallet।

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

Test Mode: Use the Viva demo environment (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 सत्यापन का उत्तर देने के लिए होता है।

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

Payment source: उपयोग में आने वाले हर खाते में, Sales > Online payments > Websites / apps में जाकर अपने स्टोर के डोमेन के लिए एक भुगतान स्रोत बनाएँ। Success URL और Failure URL के रूप में, सेटिंग्स में दिखाए गए दोनों पतों के डोमेन के बाद के पाथ दर्ज करें, जो इस तरह दिखते हैं: https://your-site/wc-api/viva_payment_success/ और https://your-site/wc-api/viva_payment_fail/।

Webhook: Settings > API Access > Webhooks में सेटिंग्स में दिखाया गया URL जोड़ें, जो इस तरह दिखता है: https://your-site/wp-json/wc-viva-gateway/v1/webhook, इन इवेंट्स के लिए:

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। शुरुआती # हटा दिया जाता है। डिफ़ॉल्ट रंग के लिए खाली छोड़ें। कोई भी अन्य मान सेव करते समय अस्वीकार होता है और पिछला मान रहता है।

Debug Logging: Enable logging API अनुरोधों को WooCommerce > Status > Logs में लिखता है, स्रोत wcp_viva_gateway। कुंजियाँ और ग्राहक का डेटा लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं, भले ही यह बंद हो। डिफ़ॉल्ट: बंद।

Delete Data on Uninstall: Remove all plugin data when the plugin is deleted। चालू होने पर प्लगइन हटाने से सेटिंग्स, भुगतान प्रयासों की तालिका और प्लगइन लॉग हट जाते हैं। ऑर्डर नोट और ऑर्डर का डेटा बने रहते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Viva Wallet) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए, ऑर्डर की मुद्रा में, एक Viva भुगतान ऑर्डर बनाता है और ग्राहक को Viva Smart Checkout पेज पर भेजता है। वहाँ ग्राहक आपके Viva खाते में सक्षम तरीकों में से किसी एक से भुगतान करता है, जैसे कार्ड, Apple Pay या Google Pay। ग्राहक का ईमेल, नाम, फ़ोन और देश Viva को भेजे जाते हैं, और पेज आपकी साइट की भाषा में खुलता है यदि Viva उसे समर्थन देता है, अन्यथा अंग्रेज़ी में। Viva में भुगतान WooCommerce # और ऑर्डर नंबर के रूप में दिखता है। Viva भुगतान ऑर्डर 30 मिनट बाद समाप्त हो जाता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौटता है। ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब Viva पुष्टि करे: प्लगइन वापसी पर और वेबहुक पर Viva API से लेन-देन दोबारा पढ़ता है। यदि भुगतान अभी तक पुष्ट नहीं हुआ है, तो पेज We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. दिखाता है।

यदि भुगतान विफल होता है या ग्राहक Viva पेज पर रद्द करता है, तो ऑर्डर की स्थिति नहीं बदलती। ग्राहक को Pay for order पेज पर भेजा जाता है, जहाँ 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. दिखता है। तकनीकी कारण लॉग में लिखा जाता है।

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है, जहाँ उस ऑर्डर की मुद्रा जाँची जाती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

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

Order statuses

Pending payment: ग्राहक को Viva पर भेजा गया है और उसने अभी तक भुगतान नहीं किया, भुगतान अभी पुष्ट नहीं हुआ, या भुगतान विफल हुआ या रद्द हुआ। एक नोट में Viva भुगतान ऑर्डर और वातावरण (डेमो या लाइव) दिखता है। विफल और रद्द प्रयास ऑर्डर नोट्स में जुड़ते हैं, और ग्राहक फिर से भुगतान कर सकता है।

Processing, Completed or On Hold: भुगतान पुष्ट हो गया है। स्थिति Order Status After Payment का पालन करती है। ऑर्डर नोट में राशि, Viva लेन-देन ID, वातावरण और पुष्टि कैसे हुई (वेबहुक या ग्राहक की वापसी) दिखती है।

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

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Viva Wallet पर क्लिक करें। पुष्ट Viva लेन-देन वाले ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस खाते में भेजा जाता है जिससे भुगतान हुआ था (डेमो या लाइव), भुगतान की मुद्रा में; इसलिए उस खाते का Client ID और Client Secret दर्ज होना ज़रूरी है। यदि Viva रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Viva रिफ़ंड लेन-देन के साथ ऑर्डर नोट्स में जुड़ता है।

Viva डैशबोर्ड में किए गए रिफ़ंड इम्पोर्ट नहीं होते। ज़रूरत हो तो Refund via Viva Wallet के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Viva Wallet के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, किसी दूसरी कुंजी के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।

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

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

जब लाइसेंस की समय-सीमा समाप्त होती है, तब भी प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

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

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

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 उत्तर मिलता है।

ग्राहक ऑर्डर देते समय त्रुटि देखता है: Debug Logging चालू करें और WooCommerce > Status > Logs देखें, स्रोत wcp_viva_gateway। गलत Client ID या Client Secret, या गायब Source Code, Viva Wallet भुगतान उपलब्ध न होने का संदेश देते हैं। यदि Viva तक पहुँचा नहीं जा सकता या वह भुगतान ऑर्डर अस्वीकार करता है, उदाहरण के लिए जब Source Code किसी दूसरे खाते का हो, तो ग्राहक को संदेश मिलता है कि स्टोर Viva Wallet से कनेक्ट नहीं हो सका।

भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न थी। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

लाइसेंस ब्लॉक त्रुटि दिखाता है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।

डेवलपर्स के लिए: फ़िल्टर viva_wp_supported_currencies आपके Viva खाते द्वारा समर्थित अतिरिक्त मुद्राएँ सक्षम करता है, viva_wp_create_order_payload भुगतान ऑर्डर अनुरोध बदलता है (राशि, मुद्रा और Source Code वही रहने चाहिए), और viva_wp_icon चेकआउट आइकन बदलता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा सुरक्षित रहता है; केवल कैश्ड Viva एक्सेस टोकन हटते हैं। पूरी तरह हटाने के लिए प्लगइन को निष्क्रिय करें और Plugins पेज पर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा कैश्ड टोकन और वेबहुक कुंजियाँ हमेशा हटा दी जाती हैं। सेटिंग्स, भुगतान प्रयासों की तालिका और प्लगइन लॉग (घुमाई गई लॉग फ़ाइलों और डेटाबेस लॉग प्रविष्टियों सहित) केवल तभी हटते हैं जब Delete Data on Uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और लेन-देन ID रखते हैं।

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