VibeFox Nets Nexi for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Nets खाता: आपको अपने Nets Easy खाते की सीक्रेट कुंजियाँ (टेस्ट और लाइव) चाहिए। केवल सीक्रेट कुंजियाँ इस्तेमाल होती हैं। चेकआउट कुंजियों की ज़रूरत नहीं है, क्योंकि ग्राहक Nets के होस्ट किए गए भुगतान पेज पर भुगतान करते हैं।

मुद्राएँ और भुगतान विधियाँ: प्लगइन मुद्राओं या देशों पर कोई प्रतिबंध नहीं लगाता। अपने Nets खाते में सक्रिय मुद्राएँ इस्तेमाल करें; असमर्थित मुद्रा की सूचना भुगतान बनाते समय Nets देता है। ग्राहक को कौन-सी भुगतान विधियाँ दिखेंगी, यह आपके Nets अनुबंध, देश और मुद्रा पर निर्भर करता है।

Webhooks के लिए HTTPS: Nets केवल सार्वजनिक HTTPS पते कॉल करता है जो अधिकतम 256 अक्षरों के हों और जिनमें "&" न हो, इसलिए Webhooks प्राप्त करने के लिए आपकी साइट पर HTTPS और साफ़ permalinks होने चाहिए। अन्य साइटों पर भी भुगतान तब पुष्ट होता है जब ग्राहक स्टोर पर लौटता है, या ऑर्डर क्रिया के माध्यम से।

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

इंस्टॉलेशन

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

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

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

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

5. Nets Easy टेस्ट पोर्टल से टेस्ट सीक्रेट कुंजी कॉपी करें और उसे Test Secret Key में चिपकाएँ (देखें कॉन्फ़िगरेशन)।

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

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

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

सामान्य

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

Title: चेकआउट के दौरान ग्राहकों को दिखने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: Nets Easy।

Description: चेकआउट के दौरान ग्राहकों को दिखने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely with Nets Easy।

API कुंजियाँ

Nets Easy पोर्टल में Company > Integration से सीक्रेट कुंजियाँ कॉपी करें: टेस्ट कुंजी के लिए टेस्ट पोर्टल (test.portal.dibspayment.eu) और लाइव कुंजी के लिए लाइव पोर्टल (portal.dibspayment.eu)। चेकआउट कुंजियों की ज़रूरत नहीं है।

Test Mode: Enable test mode। टेस्ट मोड टेस्ट सीक्रेट कुंजी के साथ test.api.dibspayment.eu का उपयोग करता है; लाइव मोड लाइव सीक्रेट कुंजी के साथ api.dibspayment.eu का उपयोग करता है। किसी ऑर्डर के रिफ़ंड और कैप्चर हमेशा उसी वातावरण का उपयोग करते हैं जिसमें उसका भुगतान हुआ था। डिफ़ॉल्ट: चालू।

Test Secret Key: आपकी Nets टेस्ट वातावरण की सीक्रेट API कुंजी।

Live Secret Key: आपकी Nets लाइव वातावरण की सीक्रेट API कुंजी।

भुगतान

Nets सूचनाएँ (Webhooks) हर भुगतान के साथ अपने-आप पंजीकृत होती हैं। Nets पोर्टल में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। यह सेक्शन Webhook URL दिखाता है। यह https://your-site/wc-api/nng_nets_nexi/ जैसा दिखता है। अगर यह URL सार्वजनिक HTTPS पता नहीं है, तो सेक्शन चेतावनी देता है कि साइट Webhooks प्राप्त नहीं कर सकती; तब भुगतान की पुष्टि तब होती है जब ग्राहक स्टोर पर लौटता है या ऑर्डर क्रिया Nets: check payment status and capture से। ये इवेंट पंजीकृत होते हैं:

हर Webhook में वह यादृच्छिक सीक्रेट होना चाहिए जो प्लगइन ने उस ऑर्डर के लिए बनाया था। सही सीक्रेट के बिना आए Webhooks अस्वीकार कर दिए जाते हैं। Webhook केवल यह बताता है कि कौन-सा भुगतान बदला: भुगतान स्वयं हमेशा आपकी सीक्रेट कुंजी से Nets API से पढ़ा जाता है।

Order Status After Payment: Nets द्वारा भुगतान की पुष्टि और चार्ज करने के बाद ऑर्डर की स्थिति। स्थिति तुरंत सेट होती है, ताकि ग्राहक को सिर्फ़ एक ईमेल मिले।

एडवांस्ड

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

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं मिटता। ऑर्डरों पर सहेजा गया भुगतान डेटा हमेशा रहता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि (डिफ़ॉल्ट Nets Easy) चुनता है और ऑर्डर देता है। प्लगइन ऑर्डर की पंक्तियों, शिपिंग और शुल्कों के साथ ऑर्डर की मुद्रा में एक Nets भुगतान बनाता है और ग्राहक को Nets के होस्ट किए गए भुगतान पेज पर भेजता है। ग्राहक का ईमेल, नाम, पता और फ़ोन नंबर Nets को तब दिए जाते हैं जब Nets उनका फ़ॉर्मेट स्वीकार करता है; आपकी नियम और शर्तों वाली पेज Nets पेज पर लिंक की जाती है। टेस्ट मोड में चेकआउट पर Test mode: no real money will be charged. दिखता है।

ग्राहक भुगतान करता है और आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Nets उसकी पुष्टि करता है: प्लगइन Nets API से भुगतान पढ़ता है, आरक्षित राशि और मुद्रा की ऑर्डर से तुलना करता है, रिज़र्वेशन चार्ज करता है और तभी ऑर्डर पूरा करता है। यह Webhook पर, ग्राहक के ऑर्डर प्राप्ति पेज पर लौटने पर, या ऑर्डर क्रिया Nets: check payment status and capture से होता है।

अगर ग्राहक Nets पेज पर रद्द करता है, तो वह चेकआउट या Pay for order पेज पर लौट आता है, जहाँ The Nets payment was cancelled. You can try again or choose another payment method. संदेश दिखता है। ग्राहक बिना भुगतान वाले ऑर्डर का दोबारा भुगतान कर सकता है। प्लगइन पहले पिछले भुगतान की जाँच करता है; यदि वह पहले ही भुगतान हो चुका है, तो ऑर्डर की पुष्टि हो जाती है। अन्यथा नया सत्र शुरू होने से पहले पिछला Nets सत्र बंद कर दिया जाता है। अगर ऑर्डर का कोई भुगतान आपकी समीक्षा के लिए रोका गया है, तो ग्राहक को A payment for this order is already being reviewed by the shop. Please contact us instead of paying again. दिखता है।

अगर Nets भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. या The payment service could not be reached. Please try again in a moment. विवरण लॉग में लिखे जाते हैं।

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

प्लगइन केवल होस्ट किए गए भुगतान पेज का उपयोग करता है। इसमें पेज पर एम्बेडेड Nets चेकआउट, सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, इनवॉइस शुल्क, केवल प्राधिकरण मोड, या प्रति शिपमेंट आंशिक कैप्चर नहीं हैं।

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

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

Pending payment: ग्राहक को Nets पर भेजा गया है और उसने अभी तक भुगतान नहीं किया है। ऑर्डर नोट में Nets भुगतान ID, राशि और वातावरण दिखता है।

Processing or Completed: Nets ने भुगतान की पुष्टि करके उसे चार्ज कर दिया है। स्थिति Order Status After Payment का पालन करती है। ऑर्डर नोट में भुगतान ID, चार्ज ID और भुगतान विधि दिखती है। लेन-देन ID Nets का भुगतान ID है।

On hold: Nets पर राशि या मुद्रा ऑर्डर से अलग है (कैप्चर नहीं हुआ), कैप्चर अस्वीकार हुआ, या ग्राहक ने ऑर्डर रद्द होने के बाद भुगतान किया (रिज़र्व हुआ, कैप्चर नहीं हुआ)। ऑर्डर नोट इसकी व्याख्या करता है। ऑर्डर की समीक्षा के बाद ऑर्डर क्रिया Nets: check payment status and capture से कैप्चर करें, या Nets पोर्टल में रिज़र्वेशन रद्द करें।

Cancelled: ऑर्डर के नवीनतम भुगतान का रिज़र्वेशन रद्द किया गया है, उदाहरण के लिए Nets पोर्टल में।

बार-बार आने वाले Webhooks और रीलोड कभी दोबारा चार्ज नहीं करते या डुप्लिकेट नोट, स्टॉक कटौती या ईमेल नहीं जोड़ते, और भुगतान के बाद भुगतान किया गया, रिफ़ंड किया गया या रद्द किया गया ऑर्डर कभी दोबारा नहीं खुलता। अगर किसी पहले से भुगतान किए गए ऑर्डर के लिए पुराना भुगतान लिंक पूरा होता है, तो दूसरा रिज़र्वेशन अपने-आप जारी हो जाता है; अगर वह पहले ही चार्ज हो चुका है, तो नोट आपसे Nets पोर्टल में उसे रिफ़ंड करने को कहता है।

ऑर्डर क्रिया

Nets भुगतान वाले बिना भुगतान के ऑर्डरों के लिए, ऑर्डर क्रिया सूची में Nets: check payment status and capture होता है। यह Nets से भुगतान पढ़ता है और मेल खाने वाला रिज़र्वेशन कैप्चर करता है। अगर कुछ नहीं बदलता, तो नोट कारण बताता है, जैसे कि ग्राहक ने अभी तक भुगतान पूरा नहीं किया है।

रिफ़ंड

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

Nets पोर्टल में सीधे किए गए रिफ़ंड WooCommerce रिफ़ंड नहीं बनते। ज़रूरत हो तो Refund via Nets Easy का उपयोग किए बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

चेकआउट पर Nets Nexi दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और चुने गए मोड में सीक्रेट कुंजी है: टेस्ट मोड में Test Secret Key, लाइव मोड में Live Secret Key। कुंजी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment में रहता है: Webhook आपके स्टोर तक नहीं पहुँचा। जाँचें कि साइट HTTPS और साफ़ permalinks इस्तेमाल करती है, ताकि Payment सेक्शन में Webhook URL "&" के बिना सार्वजनिक HTTPS पता हो, और भुगतान के वातावरण की सीक्रेट कुंजी सेट है। फिर ऑर्डर क्रिया Nets: check payment status and capture का उपयोग करें। ग्राहक के ऑर्डर प्राप्ति पेज पर लौटने पर भी ऑर्डर की पुष्टि हो जाती है।

Webhook answers Unauthorized: Webhook में उस ऑर्डर की सीक्रेट नहीं थी। Webhooks केवल उसी सीक्रेट के साथ स्वीकार होते हैं जो भुगतान के साथ पंजीकृत हुई थी।

Webhook answers Busy, retry later, Payment lookup failed या Payment not reserved yet: कोई और अनुरोध ऑर्डर अपडेट कर रहा था, Nets API तक पहुँच नहीं बन सकी, या रिज़र्वेशन अभी दिख नहीं रहा था। Nets Webhook को अपने-आप दोबारा भेजता है।

ग्राहक ऑर्डर देते समय त्रुटि देखता है: Debug log चालू करें और WooCommerce > Status > Logs में, स्रोत wcp_nets_nexi_gateway, देखें। This payment method is temporarily unavailable. Please choose another payment method. आमतौर पर गलत या गायब सीक्रेट कुंजी का संकेत है। अस्वीकृत मुद्रा Nets लॉग में बताता है।

Order is On hold after payment: ऑर्डर नोट पढ़ें। अगर कैप्चर अस्वीकार हुआ, तो ऑर्डर क्रिया Nets: check payment status and capture से दोबारा प्रयास करें या Nets पोर्टल में चार्ज करें। अगर राशि या मुद्रा अलग है, तो Nets पोर्टल में भुगतान जाँचें। अगर ग्राहक ने रद्द होने के बाद भुगतान किया, तो ऑर्डर की समीक्षा करें और रिज़र्वेशन कैप्चर या रद्द करें।

Refund via Nets Easy गायब है या विफल होता है: रिफ़ंड केवल भुगतान चार्ज होने के बाद संभव है। ऑर्डर नोट में चार्ज की जाँच करें। रिफ़ंड उस वातावरण की सीक्रेट कुंजी का उपयोग करता है जिसमें ऑर्डर का भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए।

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

अनइंस्टॉल

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

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