VibeFox Netopia for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।

PHP: OpenSSL और DOM एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण।

मुद्रा: स्टोर या ऑर्डर की मुद्रा RON, EUR, USD या GBP होनी चाहिए। EUR, USD और GBP आपके Netopia खाते में सक्रिय होने चाहिए। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।

Netopia खाता: आपको एक बिक्री बिंदु वाले Netopia Payments विक्रेता खाते की आवश्यकता है। उसकी तकनीकी सेटिंग्स से आपको खाता हस्ताक्षर और, उपयोग किए जा रहे हर वातावरण (सैंडबॉक्स और लाइव) के लिए, सार्वजनिक प्रमाणपत्र (.cer) और निजी कुंजी (.key) चाहिए। Netopia की तरफ़ कुछ सेट करने की ज़रूरत नहीं है: हर भुगतान अनुरोध के साथ IPN का पता भेजा जाता है।

सार्वजनिक साइट: IPN (पुष्टि) URL इंटरनेट से पहुँच योग्य होना चाहिए, लॉगिन, बेसिक प्रमाणीकरण या रखरखाव पेज के पीछे नहीं। ऑर्डर केवल Netopia IPN से अपडेट होते हैं।

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

इंस्टॉलेशन

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

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

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

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

5. Netopia एडमिन में अपना बिक्री बिंदु खोलें, खाता हस्ताक्षर कॉपी करें, और सैंडबॉक्स तथा लाइव वातावरण का प्रमाणपत्र और निजी कुंजी डाउनलोड करें। हस्ताक्षर और फ़ाइलों की पूरी सामग्री सेटिंग्स में चिपकाएँ (देखें कॉन्फ़िगरेशन)।

6. Enable/Disable चालू करें। सैंडबॉक्स मोड में एक भुगतान का परीक्षण करें, फिर वास्तविक भुगतान लेने के लिए Test mode का निशान हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Netopia Payments। फ़ील्ड्स के ऊपर, यदि सक्रिय वातावरण का खाता हस्ताक्षर, प्रमाणपत्र या निजी कुंजी गायब है तो पेज चेतावनी देता है (तब चेकआउट पर भुगतान विधि छिपा दी जाती है), और परीक्षण मोड चालू होने पर Test mode is on: payments go to the Netopia sandbox and no real money is charged. दिखाता है। भुगतान विधियों की सूची में, जब तक सक्रिय वातावरण पूरा न हो, Netopia को सेटअप की ज़रूरत वाला बताया जाता है। सेव करते समय अमान्य प्रमाणपत्र या निजी कुंजी त्रुटि के साथ अस्वीकार हो जाती है और पिछला मान रहता है।

IPN (confirm) URL

सेटिंग्स के ऊपर केवल-पढ़ने योग्य रूप में दिखाया जाता है। यह https://your-site/wc-api/netopia_payment_callback/ जैसा दिखता है। इसे हर भुगतान अनुरोध के साथ पुष्टि URL के रूप में भेजा जाता है, इसलिए इसे Netopia एडमिन में दर्ज करने की ज़रूरत नहीं है। Netopia IPN इसी URL पर भेजता है; प्लगइन इसे सक्रिय वातावरण की निजी कुंजी से डिक्रिप्ट करता है और आपके खाता हस्ताक्षर तथा भुगतान अनुरोध की जाँच करता है। Netopia ये कार्रवाइयाँ रिपोर्ट करता है:

Netopia त्रुटि कोड (जैसे कार्ड अस्वीकृत) वाली सूचना बिना भुगतान वाले ऑर्डर को Failed चिह्नित करती है। जो सूचनाएँ डिक्रिप्ट नहीं हो सकतीं, जिनमें कोई अन्य खाता हस्ताक्षर है, या जो उस ऑर्डर के भुगतान अनुरोध का उत्तर नहीं देतीं, वे अस्वीकार हो जाती हैं और कुछ नहीं बदलतीं।

चेकआउट

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

Title: चेकआउट पर दिखने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: Card Payment (Netopia)।

Description: चेकआउट पर दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely with your credit or debit card via Netopia.

Netopia खाता

Netopia एडमिन में Seller accounts > your point of sale > Technical settings पर जाएँ: खाता हस्ताक्षर कॉपी करें और हर वातावरण का सार्वजनिक प्रमाणपत्र (.cer) और निजी कुंजी (.key) डाउनलोड करें। फ़ाइलों को टेक्स्ट एडिटर में खोलें और BEGIN/END लाइनों सहित उनकी पूरी सामग्री चिपकाएँ।

Account signature: विक्रेता खाते का हस्ताक्षर (फ़ॉर्मेट XXXX-XXXX-XXXX-XXXX-XXXX), सैंडबॉक्स और लाइव दोनों के लिए एक ही।

Test mode: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys। भुगतान पेज और कुंजी जोड़ी को बदलता है। डिफ़ॉल्ट: चालू। लाइव कुंजियों से वास्तविक भुगतान लेने के लिए इसे बंद करें।

Sandbox public certificate (.cer): सैंडबॉक्स सार्वजनिक प्रमाणपत्र फ़ाइल की सामग्री। इसका उपयोग भुगतान अनुरोध को एन्क्रिप्ट करने के लिए होता है।

Sandbox private key (.key): सैंडबॉक्स निजी कुंजी फ़ाइल की सामग्री। इसका उपयोग IPN को डिक्रिप्ट करने के लिए होता है। सेव करने के बाद यह फिर कभी नहीं दिखाई जाती; फ़ील्ड में A private key is saved. दिखता है। सहेजी गई कुंजी रखने के लिए इसे खाली छोड़ें, या बदलने के लिए नई कुंजी चिपकाएँ।

Live public certificate (.cer): लाइव सार्वजनिक प्रमाणपत्र फ़ाइल की सामग्री।

Live private key (.key): लाइव निजी कुंजी फ़ाइल की सामग्री। सेव करने के बाद यह फिर कभी नहीं दिखाई जाती; सहेजी गई कुंजी रखने के लिए इसे खाली छोड़ें।

ऑर्डर

Order status after payment: भुगतान किए गए ऐसे ऑर्डर का स्टेटस जिसे भेजना ज़रूरी है। केवल वर्चुअल या डाउनलोड योग्य आइटम वाले ऑर्डर वैसे भी WooCommerce द्वारा पूरे कर दिए जाते हैं। स्टेटस एक ही बदलाव और ग्राहक को एक ही ईमेल के साथ सेट होता है।

एडवांस्ड

Debug log: Log requests and IPN processing WooCommerce > Status > Logs में, स्रोत wcp_netopia_gateway के साथ लिखता है। कार्ड डेटा, कुंजियाँ और ग्राहक विवरण लॉग नहीं होते। त्रुटियाँ, जैसे अस्वीकृत IPN, विकल्प बंद होने पर भी हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept)। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट Card Payment (Netopia)) और ऑर्डर देता है। अगला पेज Redirecting you to Netopia for secure payment… दिखाता है और ग्राहक को अपने आप Netopia भुगतान पेज पर भेज देता है, बैकअप के रूप में Proceed to payment और Cancel order बटन होते हैं। भुगतान अनुरोध आपके Netopia प्रमाणपत्र से एन्क्रिप्ट होता है और ऑर्डर की मुद्रा में ऑर्डर का कुल, Order # के साथ ऑर्डर नंबर, तथा बिलिंग और शिपिंग संपर्क विवरण शामिल करता है। सैंडबॉक्स मोड में अनुरोध Netopia सैंडबॉक्स पर जाता है।

ग्राहक Netopia पेज पर कार्ड से भुगतान करता है और आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। केवल लौटने से ऑर्डर भुगतान किया हुआ नहीं होता। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Netopia IPN के ज़रिए उसकी पुष्टि कर दे। तब तक ऑर्डर प्राप्ति पेज पर Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. दिखता है। On hold ऑर्डर के लिए यह Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. दिखाता है। यदि भुगतान रद्द हुआ, तो The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. दिखता है।

यदि कार्ड अस्वीकृत होता है, तो ऑर्डर Failed चिह्नित होता है और ग्राहक ऑर्डर पेज से उसका फिर से भुगतान कर सकता है। यदि प्लगइन सही तरह से सेट नहीं है, तो भुगतान पेज पर Netopia gateway is not configured properly. Please contact the store administrator. दिखता है।

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

प्लगइन केवल Netopia v1 कार्ड प्रोटोकॉल के माध्यम से कार्ड भुगतान लेता है। इसमें WooCommerce से रिफ़ंड या कैप्चर नहीं है, सेव किए गए कार्ड या वन-क्लिक भुगतान नहीं हैं, सब्सक्रिप्शन, किस्तें, SMS, बैंक ट्रांसफ़र या क्रिप्टो भुगतान नहीं हैं, और Netopia API v2 नहीं है।

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Netopia पर भेजा गया है, या Netopia ने अभी IPN नहीं भेजा है।

Processing or Completed: Netopia ने भुगतान की पुष्टि की है। स्टेटस Order status after payment का पालन करता है। ऑर्डर नोट में राशि, मास्क्ड कार्ड नंबर और Netopia लेनदेन दिखता है; सैंडबॉक्स भुगतान पर [sandbox] अंकित होता है। लेनदेन ID Netopia का लेनदेन ID है।

On hold: भुगतान एक प्री-ऑथराइज़ेशन है जो Netopia एडमिन में कैप्चर का इंतज़ार कर रहा है, या Netopia पर समीक्षाधीन है। Netopia की पुष्टि होने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है। इनवॉइस की राशि या मुद्रा ऑर्डर से अलग होने, भुगतान का केवल एक हिस्सा कैप्चर होने, या Netopia द्वारा रद्द ऑर्डर के भुगतान की पुष्टि होने पर भी ऑर्डर On hold में जाता है। ऑर्डर नोट कारण बताता है। Netopia एडमिन में लेनदेन जाँचें और ऑर्डर को मैन्युअल रूप से पूरा करें या रिफ़ंड करें।

Failed: Netopia ने त्रुटि रिपोर्ट की, जैसे कार्ड अस्वीकृत। ग्राहक फिर से भुगतान कर सकता है।

Cancelled: Netopia ने भुगतान रद्द किया, या ग्राहक ने Netopia पर जाने से पहले Cancel order पर क्लिक किया।

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

रिफ़ंड

रिफ़ंड WooCommerce से नहीं किए जाते: Netopia v1 कार्ड प्रोटोकॉल में रिफ़ंड कॉल नहीं है, इसलिए Refund via बटन नहीं होता। लेनदेन को Netopia एडमिन में रिफ़ंड करें। इसके बाद Netopia एक क्रेडिट IPN भेजता है, और प्लगइन कारण Refund initiated by Netopia. के साथ ऑर्डर पर रिफ़ंड अपने आप दर्ज कर देता है। आंशिक रिफ़ंड ऑर्डर का स्टेटस नहीं बदलते; जब रिफ़ंड के लिए कुछ न बचे, तब WooCommerce ऑर्डर को Refunded चिह्नित करता है। EUR, USD और GBP ऑर्डर के लिए, Netopia जो रिफ़ंड राशि RON में बताता है, उसे ऑर्डर की मुद्रा में वापस बदला जाता है। कोई रिफ़ंड दो बार दर्ज नहीं होता और बची हुई राशि से अधिक दर्ज नहीं होता। स्टॉक अपने आप वापस नहीं जुड़ता।

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

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

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

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

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

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

चेकआउट पर Netopia दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुना गया मोड पूरा है (परीक्षण मोड में सैंडबॉक्स का Account signature और प्रमाणपत्र तथा निजी कुंजी, या लाइव मोड में लाइव वातावरण के), और स्टोर या ऑर्डर की मुद्रा RON, EUR, USD या GBP है। कुछ छूटने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment में रहता है: IPN आपके स्टोर तक नहीं पहुँची या अस्वीकार हो गई। सेटिंग्स में दिए IPN (पुष्टि) URL का इंटरनेट से पहुँच योग्य होना जाँचें (रखरखाव मोड, बेसिक प्रमाणीकरण या फ़ायरवॉल नहीं होना चाहिए)। Debug log चालू करें और WooCommerce > Status > Logs में, स्रोत wcp_netopia_gateway, IPN की पंक्तियाँ देखें। अकेले ग्राहक का लौटना ऑर्डर को कभी भुगतान किया हुआ नहीं बनाता।

Log shows failed decrypting data: निजी कुंजी उस वातावरण के प्रमाणपत्र से मेल नहीं खाती जिसे Netopia ने इस्तेमाल किया। IPN सक्रिय वातावरण की कुंजी से डिक्रिप्ट होता है, और परीक्षण मोड बदलने से पहले शुरू हुए भुगतानों के लिए दूसरे वातावरण की कुंजी से। Netopia उसे दोबारा भेजता है।

Log shows signature mismatch: Account signature उस बिक्री बिंदु से मेल नहीं खाता जिसने IPN भेजा। इसे Netopia एडमिन से दोबारा कॉपी करें।

Log shows unknown payment request: IPN उस भुगतान अनुरोध का उत्तर नहीं है जो आपके स्टोर ने उस ऑर्डर के लिए उस वातावरण (सैंडबॉक्स या लाइव) में किया था। कुछ नहीं बदलता।

Log shows gateway not configured: निजी कुंजी या खाता हस्ताक्षर गायब है। Netopia IPN दोबारा भेजता है, और सेटिंग्स पूरी होने पर भुगतान एक बार दर्ज हो जाता है।

Error on save about the certificate or private key: चिपकाया गया पाठ वैध प्रमाणपत्र या कुंजी नहीं है। BEGIN/END लाइनों सहित फ़ाइल की पूरी सामग्री चिपकाएँ। पिछला मान रखा गया।

Order is On hold after payment: ऑर्डर नोट पढ़ें। भुगतान प्री-ऑथराइज़ेशन या समीक्षाधीन हो सकता है, राशि या मुद्रा अलग रही हो सकती है, केवल आंशिक कैप्चर हुआ हो सकता है, ऑर्डर रद्द हुआ हो सकता है, या स्टोर लाइव मोड में होने पर सैंडबॉक्स भुगतान की पुष्टि हुई हो सकती है (कोई असली पैसा नहीं मिला)। Netopia एडमिन में लेनदेन जाँचें।

A refund made in Netopia does not appear on the order: क्रेडिट IPN स्टोर तक नहीं पहुँची या अस्वीकार हो गई। लॉग जाँचें। ज़रूरत हो तो WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

अनइंस्टॉल

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

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