VibeFox CorvusPay for WooCommerce — सहायता

आवश्यकताएँ

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

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

PHP: 8.0 या उसके बाद का संस्करण।

मुद्रा: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK या USD। किसी अन्य मुद्रा में भुगतान विधि चेकआउट पर छिपी रहती है। राशियाँ 2 दशमलव के साथ भेजी जाती हैं; इससे अधिक दशमलव वाला कुल योग (उदाहरण के लिए 3 दशमलव वाले BHD स्टोर में) राउंड करने के बजाय अस्वीकार कर दिया जाता है।

CorvusPay खाता: आपको CorvusPay मर्चेंट खाता चाहिए। CorvusPay हर स्टोर के लिए Store ID और Secret Key जारी करता है, टेस्ट और प्रोडक्शन स्टोर के लिए अलग-अलग; ये CorvusPay Merchant Center में दिखते हैं। प्लगइन का Success URL और Cancel URL वहाँ दर्ज करना ज़रूरी है (कॉन्फ़िगरेशन देखें)।

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

इंस्टॉलेशन

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

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

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

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

5. अपने CorvusPay टेस्ट स्टोर की Store ID और Secret Key दर्ज करें (और लाइव भुगतान के लिए प्रोडक्शन स्टोर की भी)। सेटिंग पेज पर दिखाए गए Success URL और Cancel URL को टेस्ट और प्रोडक्शन स्टोर के लिए CorvusPay Merchant Center में कॉपी करें।

6. Enable/Disable चालू करें, एक टेस्ट ऑर्डर दें, फिर लाइव होने के लिए Test Mode का निशान हटा दें।

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

सभी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > CorvusPay। टेस्ट मोड चालू रहने पर पेज फ़ील्ड के ऊपर Test mode is on. दिखाता है, और चेतावनी देता है जब गेटवे चालू हो पर मौजूदा मोड की Store ID या Secret Key खाली हो (तब वह भरे जाने तक चेकआउट पर छिपा रहता है) तथा जब स्टोर की मुद्रा CorvusPay द्वारा समर्थित न हो।

सामान्य

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

Title: भुगतान विधि का वह नाम जो ग्राहकों को चेकआउट पर दिखता है। डिफ़ॉल्ट: Credit/Debit Card (CorvusPay)।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely with your credit or debit card via CorvusPay। टेस्ट मोड में इसमें (Test mode — no real payment is taken.) जोड़ दिया जाता है।

स्टोर क्रेडेंशियल

Store ID और Secret Key CorvusPay हर स्टोर के लिए (टेस्ट और प्रोडक्शन अलग-अलग) जारी करता है और ये CorvusPay Merchant Center में दिखते हैं।

Test Mode: Enable test mode CorvusPay के टेस्ट वातावरण (wallet.test.corvuspay.com) और टेस्ट Store ID व Secret Key का उपयोग करता है। डिफ़ॉल्ट: चालू।

Test Store ID: आपके CorvusPay टेस्ट स्टोर की संख्यात्मक Store ID।

Test Secret Key: आपके CorvusPay टेस्ट स्टोर की Secret Key, जिसका उपयोग HMAC-SHA256 हस्ताक्षरों के लिए होता है।

Live Store ID: आपके CorvusPay प्रोडक्शन स्टोर की संख्यात्मक Store ID।

Live Secret Key: आपके CorvusPay प्रोडक्शन स्टोर की Secret Key, जिसका उपयोग HMAC-SHA256 हस्ताक्षरों के लिए होता है।

Store ID में केवल अंक होने चाहिए। कुछ और दर्ज करने पर त्रुटि दिखती है और पिछला मान बना रहता है। भुगतान की जाँच हमेशा उसी स्टोर की Secret Key से होती है जिसमें वह किया गया था, इसलिए जब तक टेस्ट ऑर्डर खुले हों, टेस्ट कुंजी भरी रहने दें।

Success URL और Cancel URL

इस सेक्शन में दिखाए गए दोनों पते टेस्ट और प्रोडक्शन स्टोर के लिए CorvusPay Merchant Center में कॉपी करें। भुगतान के बाद CorvusPay ग्राहक को इन्हीं पर वापस भेजता है।

भुगतान

Transaction Type: कार्ड से शुल्क कैसे लिया जाए।

Payment Page Language: CorvusPay भुगतान पेज की भाषा। Site language (डिफ़ॉल्ट) आपकी साइट की मौजूदा भाषा का उपयोग करता है यदि CorvusPay उसका समर्थन करता है, अन्यथा अंग्रेज़ी का। आप क्रोएशियाई, अंग्रेज़ी, जर्मन, इतालवी, सर्बियाई या स्लोवेनियाई भी चुन सकते हैं।

Order Status After Payment: सफल Sale भुगतान के बाद ऑर्डर की स्थिति। स्थिति तुरंत सेट होती है, दूसरी बार स्थिति बदले बिना।

उन्नत

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

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled)। निष्क्रिय करने पर कुछ भी नहीं हटता। ऑर्डर पर सहेजा गया भुगतान डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card (CorvusPay)) और ऑर्डर देता है। ऑर्डर भुगतान लंबित स्थिति में रहता है, और Pay for order पेज Redirecting to CorvusPay for payment. Please wait... दिखाता है और हस्ताक्षरित फ़ॉर्म CorvusPay भुगतान पेज पर भेजता है। यदि रीडायरेक्ट शुरू नहीं होता, तो ग्राहक Pay via CorvusPay पर क्लिक करता है। ऑर्डर का कुल योग, मुद्रा, कार्ट का संक्षिप्त विवरण और बिलिंग विवरण (भुगतान पेज को पहले से भरने के लिए) भेजे जाते हैं। जब तक राशि नहीं बदलती, वही CorvusPay ऑर्डर नंबर दोबारा उपयोग होता है, और CorvusPay उसके लिए दूसरा भुगतान स्वीकार नहीं करता।

भुगतान के बाद CorvusPay ग्राहक को Success URL पर वापस भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब CorvusPay उसकी पुष्टि कर दे: CorvusPay ऑर्डर नंबर इसी ऑर्डर के लिए जारी हुआ हो, हस्ताक्षर उस स्टोर की Secret Key से मेल खाए जिसमें भुगतान किया गया था, और राशि व मुद्रा ऑर्डर से मेल खाएँ। इसके बाद ग्राहक ऑर्डर प्राप्त हुआ पेज पर पहुँचता है। भुगतान की पुष्टि होने पर स्टॉक घटाया जाता है, और कार्ट ऑर्डर प्राप्त हुआ पेज पर खाली किया जाता है।

यदि ग्राहक CorvusPay पेज पर रद्द करता है, तो बिना भुगतान वाला ऑर्डर रद्द हो जाता है और ग्राहक कार्ट सुरक्षित रहते हुए The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। यदि भुगतान Pay for order पेज से शुरू हुआ था और कार्ट खाली है, तो WooCommerce कार्ट पेज पर The CorvusPay payment was cancelled and the order was not paid. दिखाता है। यदि Success URL अनुरोध की जाँच नहीं हो पाती, तो ग्राहक को We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. दिखता है और ऑर्डर में कोई बदलाव नहीं होता।

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

ऑर्डर केवल तब पुष्ट होता है जब CorvusPay ग्राहक को Success URL पर वापस भेजता है; सर्वर-से-सर्वर सूचनाएँ नहीं हैं। यदि ग्राहक भुगतान के तुरंत बाद ब्राउज़र बंद कर देता है, तो ऑर्डर भुगतान लंबित स्थिति में रहता है। प्लगइन में WooCommerce से रिफ़ंड, कैप्चर या void नहीं हैं (CorvusPay सर्वर API के लिए क्लाइंट सर्टिफ़िकेट चाहिए), और सेव किए गए कार्ड, सब्सक्रिप्शन, किस्तें, IBAN / PIS या CorvusWallet के विकल्प भी नहीं हैं।

ऑर्डर

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

Pending payment: ग्राहक को CorvusPay भेजा गया था और वह अभी लौटा नहीं है। यदि ग्राहक ने भुगतान किया पर लौटा नहीं, तो CorvusPay Merchant Center में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें।

Processing, Completed या On Hold: Sale भुगतान की पुष्टि हो गई। स्थिति Order Status After Payment के अनुसार तय होती है। ऑर्डर नोट में CorvusPay ऑर्डर नंबर, स्वीकृति कोड और कार्ड का प्रकार दिखता है। ऑर्डर की ट्रांज़ैक्शन ID CorvusPay की ट्रांज़ैक्शन ID होती है, या यदि CorvusPay कोई ID नहीं भेजता तो CorvusPay ऑर्डर नंबर, जिससे Merchant Center में भुगतान खोजा जा सकता है।

On hold, अधिकृत: Authorize only चुना गया है। CorvusPay Merchant Center में भुगतान कैप्चर करें, फिर ऑर्डर को प्रक्रिया में पर सेट करें।

On hold, राशि/मुद्रा में अंतर: भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती। CorvusPay Merchant Center में भुगतान की जाँच करने से पहले शिप न करें।

On hold, रद्द किए गए ऑर्डर के लिए भुगतान: ऑर्डर रद्द होने के बाद, उदाहरण के लिए बिना भुगतान वाले ऑर्डर की समय-सीमा समाप्त होने से, एक सफल भुगतान आया। ऑर्डर पूरा करें या CorvusPay Merchant Center में भुगतान रिफ़ंड करें।

Cancelled: ग्राहक ने CorvusPay पेज पर भुगतान रद्द कर दिया।

यदि पहले से भुगतान किए गए या बंद ऑर्डर के लिए कोई दूसरा, अलग सफल भुगतान आता है, तो ऑर्डर में बदलाव नहीं होता। एक नोट आपसे CorvusPay Merchant Center जाँचने और ज़रूरत पड़ने पर दोहरा भुगतान रिफ़ंड करने को कहता है।

Refunds: WooCommerce से रिफ़ंड, कैप्चर और void समर्थित नहीं हैं। इन्हें CorvusPay Merchant Center में करें और रिफ़ंड को WooCommerce में मैन्युअली दर्ज करें।

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

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

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

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

लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति की जाँच बैकग्राउंड में अपने-आप दोबारा होती है।

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

CorvusPay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड की Store ID और Secret Key भरी हैं (टेस्ट मोड में Test Store ID और Test Secret Key, लाइव मोड में Live Store ID और Live Secret Key) और स्टोर की मुद्रा CorvusPay द्वारा समर्थित है। हर स्थिति में सेटिंग पेज चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर भुगतान लंबित स्थिति में है: संभवतः Success URL CorvusPay Merchant Center में दर्ज नहीं है, या WooCommerce की Secret Key स्टोर से मेल नहीं खाती। Logging चालू करें और WooCommerce > Status > Logs में, स्रोत wcp_corvuspay_gateway के साथ, INVALID signature खोजें। यदि ग्राहक ने लौटने से पहले ब्राउज़र बंद कर दिया हो, तब भी ऑर्डर लंबित रहता है; तब Merchant Center में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें।

ग्राहक को We could not confirm this CorvusPay payment दिखता है: Success URL अनुरोध अस्वीकार हो गया: आवश्यक फ़ील्ड गायब थे, CorvusPay ऑर्डर नंबर इस ऑर्डर के लिए जारी नहीं हुआ था, उस स्टोर की Secret Key खाली है या हस्ताक्षर मेल नहीं खाया। ऑर्डर में कोई बदलाव नहीं होता। लॉग में कारण दिखता है।

ग्राहक को This order total cannot be paid via CorvusPay दिखता है: कुल योग शून्य है या उसमें 2 से अधिक दशमलव हैं।

ग्राहक को CorvusPay is not configured या CorvusPay does not accept payments in … दिखता है: मौजूदा मोड की Store ID या Secret Key गायब है, या ऑर्डर की मुद्रा समर्थित नहीं है।

ऑर्डर On hold है: ऑर्डर नोट पढ़ें। Authorize only चुना गया है, भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई, या भुगतान ऑर्डर रद्द होने के बाद आया।

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

अनइंस्टॉल

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

CorvusPay अपने संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन CorvusPay से संबद्ध नहीं है और न ही CorvusPay द्वारा अनुमोदित है।