VibeFox Windcave for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Windcave खाता: आपको REST API क्रेडेंशियल वाला Windcave मर्चेंट खाता चाहिए: एक API उपयोगकर्ता नाम और एक API कुंजी। Windcave इन्हें UAT टेस्ट वातावरण (uat.windcave.com) और प्रोडक्शन (sec.windcave.com) के लिए अलग-अलग जारी करता है। ये Windcave सपोर्ट या अपने खाता प्रबंधक से माँगें। PxPay कुंजियाँ इस प्लगइन के साथ काम नहीं करतीं। जो भुगतान विधियाँ आप देना चाहते हैं (कार्ड, वॉलेट और अन्य), वे आपके Windcave खाते में सक्रिय होनी चाहिए।

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

इंस्टॉलेशन

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

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

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

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

5. अपना REST API उपयोगकर्ता नाम और कुंजी डालें: टेस्ट मोड के लिए UAT क्रेडेंशियल, और असली भुगतान के लिए प्रोडक्शन क्रेडेंशियल (देखें कॉन्फ़िगरेशन)।

6. लेन-देन का प्रकार और भुगतान विधियाँ चुनें, Enable/Disable चालू करें और सेव करें। Test mode चालू रखकर एक टेस्ट भुगतान करें, फिर असली भुगतान लेने के लिए Test mode बंद करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Windcave। जब तक टेस्ट मोड चालू है, पेज पर Test mode is on: payments go to the Windcave UAT environment and no real money is taken. दिखता है। भुगतान विधियों की सूची में Windcave तब तक "सेटअप आवश्यक" के रूप में चिह्नित रहता है जब तक वर्तमान मोड में API उपयोगकर्ता नाम और API कुंजी दोनों न हों। प्लगइन का संस्करण पेज के नीचे दिखाया जाता है।

सामान्य

Enable/Disable: Enable Windcave payments से भुगतान विधि चालू या बंद होती है। डिफ़ॉल्ट: बंद।

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

Windcave द्वारा जारी REST API क्रेडेंशियल (उपयोगकर्ता नाम और API कुंजी, PxPay कुंजियाँ नहीं) डालें। प्रोडक्शन और UAT क्रेडेंशियल साथ-साथ सेव किए जा सकते हैं। टेस्ट मोड केवल UAT क्रेडेंशियल इस्तेमाल करता है, और लाइव मोड केवल प्रोडक्शन क्रेडेंशियल।

Test mode: Use the Windcave UAT test environment (uat.windcave.com)। कोई असली पैसा नहीं लिया जाता। नए भुगतान UAT क्रेडेंशियल इस्तेमाल करते हैं। रिफ़ंड और कैप्चर हमेशा उसी वातावरण में जाते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: बंद।

Production API username: sec.windcave.com के लिए REST API उपयोगकर्ता नाम।

Production API key: sec.windcave.com के लिए REST API कुंजी।

UAT API username: uat.windcave.com (टेस्ट मोड) के लिए REST API उपयोगकर्ता नाम।

UAT API key: uat.windcave.com (टेस्ट मोड) के लिए REST API कुंजी।

भुगतान

Transaction type: भुगतान कैसे लिया जाता है। डिफ़ॉल्ट: Purchase।

Purchase (capture immediately): ग्राहक के भुगतान करते ही पैसा ले लिया जाता है।

Auth (authorise now, capture later): पैसा केवल रोका जाता है। ऑर्डर होल्ड पर चला जाता है, और आप ऑर्डर क्रियाओं में Capture Windcave payment से पैसा लेते हैं, या पूरी राशि का रिफ़ंड करके उसे जारी कर देते हैं। जो ऑथराइज़ेशन कैप्चर नहीं हुए, वे कुछ दिनों में समाप्त हो जाते हैं।

Payment methods: Windcave भुगतान पेज पर दिखने वाली विधियाँ: Cards, Account2Account (न्यूज़ीलैंड बैंक ट्रांसफ़र), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm। ये आपके Windcave खाते में सक्रिय होनी चाहिए। खाते में सक्रिय सभी विधियाँ दिखाने के लिए फ़ील्ड खाली छोड़ें। डिफ़ॉल्ट: Cards।

उन्नत

Debug log: Log API requests and payment events। लॉग WooCommerce > Status > Logs में, स्रोत wcp_windcave_payment_gateway के साथ मिलता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं; यह विकल्प API अनुरोध और भुगतान घटनाएँ भी जोड़ता है। API कुंजियाँ, कार्ड डेटा और ग्राहकों का व्यक्तिगत डेटा मास्क रहता है। डिफ़ॉल्ट: बंद।

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted। ऑर्डर पर सेव भुगतान डेटा (रिफ़ंड के लिए ज़रूरी Windcave लेन-देन ID) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

सूचना URL

Windcave पर आपको सूचना URL सेट करने की ज़रूरत नहीं है। प्लगइन हर भुगतान सत्र के साथ अपने वापसी पते और सूचना पता भेजता है। Windcave, सूचना (Fail-Proof Result Notification) को https://your-site/wc-api/windcave_p_notification/ पर भेजता है। न ग्राहक की वापसी और न ही सूचना पर Windcave के हस्ताक्षर होते हैं, इसलिए प्लगइन इन पर अकेले भरोसा नहीं करता: वह हमेशा सत्र का परिणाम उसी वातावरण के आपके क्रेडेंशियल से Windcave REST API पर पढ़ता है, जिसमें सत्र बनाया गया था।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card (Windcave)) और ऑर्डर देता है। प्लगइन ऑर्डर की कुल राशि के लिए ऑर्डर की मुद्रा में Windcave भुगतान सत्र बनाता है और ग्राहक को Windcave Hosted Payment Page पर भेजता है। ऑर्डर नंबर मर्चेंट रेफ़रेंस के रूप में भेजा जाता है, साथ में स्टोर की भाषा और ग्राहक का नाम, ईमेल, फ़ोन, तथा बिलिंग और शिपिंग पते भी। टेस्ट मोड में Checkout ब्लॉक भुगतान विधि के नीचे Test mode: payments go to the Windcave UAT environment, no real money is taken. दिखाता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौटता है। ऑर्डर तभी भुगतान पूरा चिह्नित होता है जब Windcave पुष्टि कर दे: प्लगइन, ग्राहक के लौटने पर और Windcave सूचना आने पर, दोनों ही स्थितियों में Windcave REST API से सत्र का परिणाम माँगता है। हर ऑर्डर के लिए एक लॉक यह सुनिश्चित करता है कि भुगतान केवल एक बार लागू हो। यदि परिणाम अभी ज्ञात नहीं है, तो ऑर्डर प्राप्ति पेज एक बार और जाँच करता है और We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. दिखाता है।

यदि ग्राहक बिना पूरे भुगतान के लौटता है, तो चेकआउट पेज (या यदि प्रयास Pay for order पेज पर शुरू हुआ था, तो वह पेज) इनमें से कोई एक संदेश दिखाता है:

Declined: आपका भुगतान अस्वीकार कर दिया गया। कृपया फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें।

Cancelled or expired: Windcave पेज पर भुगतान पूरा नहीं हुआ। आपका ऑर्डर सेव है: आप फिर से प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं।

Not confirmed yet: हम अभी आपके भुगतान की पुष्टि नहीं कर पाए हैं। यदि आपने भुगतान पूरा कर दिया है, तो कृपया दोबारा भुगतान न करें: Windcave की पुष्टि होते ही आपको पुष्टि ईमेल मिलेगा।

Return could not be processed: हम भुगतान पेज से आपकी वापसी को प्रोसेस नहीं कर पाए। यदि आपसे शुल्क लिया गया है, तो दोबारा भुगतान करने से पहले कृपया हमसे संपर्क करें।

ग्राहक के भुगतान करने से पहले कार्ट खाली नहीं होता और स्टॉक कम नहीं होता। ग्राहक किसी अनभुगतान ऑर्डर का भुगतान फिर से कर सकता है, उदाहरण के लिए Pay for order पेज से। नया प्रयास पहले पिछले सत्र की जाँच करता है: यदि वह पहले से भुगतान किया हुआ है, तो दूसरा भुगतान नहीं बनाया जाता; यदि ग्राहक ने भुगतान पेज कभी इस्तेमाल नहीं किया और ऑर्डर नहीं बदला, तो उसे उसी पेज पर वापस भेज दिया जाता है। यदि उस समय पिछला भुगतान पुष्टि की प्रक्रिया में है, तो ग्राहक को Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again. दिखता है।

यदि Windcave भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है: कि Windcave इस ऑर्डर के विवरण के साथ भुगतान शुरू नहीं कर सका, या भुगतान सेवा अस्थायी रूप से उपलब्ध नहीं है। कारण ऑर्डर नोट्स में जोड़ दिया जाता है। यदि वर्तमान मोड के लिए कोई क्रेडेंशियल नहीं हैं, तो ग्राहक को This payment method is not available at the moment. Please choose another payment method or contact us. दिखता है।

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

इस प्लगइन में सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, आपकी साइट पर एम्बेडेड कार्ड फ़ॉर्म (ग्राहक हमेशा Windcave पेज पर भुगतान करता है) नहीं हैं, PxPay 2.0 API का समर्थन नहीं है, और यह कोई अतिरिक्त शुल्क नहीं जोड़ता। यदि Windcave कोई अधिभार जोड़ता है, तो ऑर्डर मुख्य लेन-देन से मिलान किया जाता है।

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Windcave पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Windcave ने अभी भुगतान की पुष्टि नहीं की है। यदि ग्राहक रद्द करता है या सत्र समाप्त हो जाता है, तो ऑर्डर भुगतान लंबित रहता है और एक नोट जोड़ा जाता है।

Processing or Completed: Purchase भुगतान की पुष्टि हो गई है। WooCommerce हमेशा की तरह ऑर्डर को प्रक्रिया में (Processing) या, बिना शिपिंग वाले ऑर्डर के लिए, पूर्ण (Completed) सेट करता है। ऑर्डर नोट में राशि, Windcave लेन-देन ID, ऑथ कोड, मास्क किए गए कार्ड नंबर के साथ कार्ड का प्रकार, और वातावरण (UAT या प्रोडक्शन) दिखते हैं। ऑर्डर का लेन-देन ID ही Windcave लेन-देन ID है।

On hold (authorised): Auth भुगतान स्वीकृत हुआ है, पर अभी कैप्चर नहीं हुआ। ऑर्डर नोट बताता है कि उसे कैसे कैप्चर या जारी करना है।

On hold (does not match): Windcave ने ऑर्डर से अलग राशि, मुद्रा, मर्चेंट रेफ़रेंस या लेन-देन प्रकार रिपोर्ट किया (उदाहरण के लिए, भुगतान शुरू होने के बाद ऑर्डर बदला गया था)। नोट में अंतर सूचीबद्ध होते हैं। भेजने से पहले Windcave Payline में भुगतान जाँचें, और ज़रूरत हो तो रिफ़ंड करें।

Failed: भुगतान अस्वीकार कर दिया गया। नोट में Windcave का प्रतिक्रिया पाठ और कोड दिखता है। ग्राहक फिर से प्रयास कर सकता है।

यदि किसी रद्द ऑर्डर के लिए स्वीकृत भुगतान आता है, या पहले से भुगतान किए गए ऑर्डर के लिए दूसरा स्वीकृत भुगतान आता है, तो ऑर्डर नहीं बदला जाता। लेन-देन ID वाला नोट आपसे अनुरोध करता है कि Windcave Payline में उसका रिफ़ंड करें (या रद्द ऑर्डर को हाथ से वापस लाएँ)।

कैप्चर (Auth मोड)

ऑर्डर खोलें, ऑर्डर क्रियाओं में Capture Windcave payment चुनें और अपडेट बटन पर क्लिक करें। यह क्रिया केवल उन होल्ड ऑर्डर पर दिखती है जिनका ऑथराइज़ेशन अभी कैप्चर या जारी नहीं हुआ है। ऑर्डर की पूरी राशि कैप्चर होती है, कैप्चर ऑर्डर नोट्स में जुड़ता है, और ऑर्डर भुगतान किए गए ऑर्डर के रूप में आगे बढ़ता है (आमतौर पर Processing)। यदि Windcave कैप्चर स्वीकार नहीं करता, तो ऑर्डर स्क्रीन पर कारण के साथ Windcave capture failed: दिखता है, और वह कारण ऑर्डर नोट्स में जुड़ जाता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Windcave पर क्लिक करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। रिफ़ंड उस वातावरण (UAT या प्रोडक्शन) और उस खाते में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण के क्रेडेंशियल सेव होने चाहिए। सफल रिफ़ंड, Windcave लेन-देन ID के साथ ऑर्डर नोट्स में जुड़ जाता है।

जो Auth भुगतान कैप्चर नहीं हुआ है, उसके लिए केवल पूर्ण रिफ़ंड संभव है: यह ऑथराइज़ेशन को जारी (void) कर देता है। आंशिक राशि पर एक त्रुटि आती है, जो पूरी राशि का रिफ़ंड करने या पहले भुगतान कैप्चर करने को कहती है।

यदि Windcave रिफ़ंड अस्वीकार करता है, तो WooCommerce कारण के साथ Windcave declined the refund: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। यदि Windcave अभी भी रिफ़ंड प्रोसेस कर रहा है, तो WooCommerce Windcave has not confirmed the refund yet. See the order notes. दिखाता है, और रिफ़ंड दर्ज नहीं होता। Windcave Payline में लेन-देन की जाँच करें: यदि वह स्वीकृत है, तो रिफ़ंड हाथ से दर्ज करें; नहीं तो फिर से प्रयास करें। उसी रिफ़ंड का दोहराया गया प्रयास Windcave को दो बार नहीं भेजा जाता। Windcave Payline में किए गए रिफ़ंड स्टोर को रिपोर्ट नहीं होते।

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

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

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

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

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

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

Windcave does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में दोनों क्रेडेंशियल हैं: टेस्ट मोड में UAT API username और UAT API key, लाइव मोड में Production API username और Production API key।

The payment went through, but the order stays Pending payment: प्लगइन अभी तक Windcave से परिणाम नहीं ले पाया है। ऑर्डर नोट्स खोलें: एक नोट बताता है कि सत्र कब सत्यापित नहीं हो सका और क्यों। जाँचें कि भुगतान के वातावरण के क्रेडेंशियल सेव और सही हैं। जाँच तब दोहराई जाती है जब Windcave सूचना फिर से भेजता है (परिणाम सत्यापित होने तक प्लगइन त्रुटि के साथ उत्तर देता है, ताकि Windcave फिर से प्रयास करे), और जब ग्राहक ऑर्डर प्राप्ति पेज खोलता है। आपके सर्वर को https://your-site/wc-api/windcave_p_notification/ पर Windcave के अनुरोध स्वीकार करने चाहिए।

Authentication failed in the order notes or the log: REST API उपयोगकर्ता नाम या कुंजी गलत है, या वह दूसरे वातावरण की है। UAT क्रेडेंशियल केवल टेस्ट मोड में, और प्रोडक्शन क्रेडेंशियल केवल लाइव मोड में काम करते हैं। PxPay कुंजियाँ काम नहीं करतीं।

The customer sees that Windcave could not start the payment with the details of this order: Windcave ने सत्र अनुरोध अस्वीकार किया, उदाहरण के लिए मुद्रा के कारण या ऐसी भुगतान विधि के कारण जो आपके खाते में सक्रिय नहीं है। सटीक कारण ऑर्डर नोट्स और लॉग में है।

Order is On hold after payment: ऑर्डर नोट पढ़ें। या तो भुगतान एक Auth है जो कैप्चर का इंतज़ार कर रहा है, या भुगतान की गई राशि, मुद्रा या मर्चेंट रेफ़रेंस ऑर्डर से अलग था। भुगतान को कैप्चर करें, भेजें या रिफ़ंड करें।

Test payments and live payments: UAT और प्रोडक्शन अलग रखे जाते हैं। हर सत्र उसी वातावरण में जाँचा जाता है जिसमें वह बना था, और रिफ़ंड व कैप्चर भुगतान के वातावरण में जाते हैं, भले ही आप बाद में Test mode बदल दें। प्लगइन संस्करण 1.0 से बने ऑर्डर पुरानी API URL सेटिंग के वातावरण का उपयोग करते हैं।

Refund fails with a message about the environment: भुगतान UAT या प्रोडक्शन में हुआ था, और उस वातावरण के लिए कोई क्रेडेंशियल सेव नहीं हैं। उन्हें डालें और फिर से प्रयास करें।

Capture Windcave payment is missing in the order actions: यह क्रिया केवल उन होल्ड ऑर्डर पर दिखती है जो Auth से भुगतान किए गए हैं और जिनका कैप्चर या रिलीज़ अभी नहीं हुआ है।

Where to find details: त्रुटियाँ और चेतावनियाँ हमेशा WooCommerce > Status > Logs में, स्रोत wcp_windcave_payment_gateway के साथ लिखी जाती हैं। API अनुरोध और भुगतान घटनाएँ भी दर्ज करने के लिए Debug log चालू करें।

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

अनइंस्टॉल

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

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