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

आवश्यकताएँ

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

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

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

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

Nexi XPay खाता: आपको "Pagamento Semplice" रीडायरेक्ट इंटीग्रेशन वाला Nexi XPay मर्चेंट खाता चाहिए, जिसमें आपके टर्मिनल का alias (टर्मिनल ID) और MAC कुंजी हो। टेस्ट और लाइव क्रेडेंशियल अलग-अलग होते हैं: टेस्ट क्रेडेंशियल Nexi XPay टेस्ट एरिया या डेवलपर पोर्टल (developer.nexi.it) से मिलते हैं, और लाइव क्रेडेंशियल मर्चेंट खाता सक्रिय होने के बाद Nexi XPay बैक ऑफ़िस से मिलते हैं। Nexi बैक ऑफ़िस में कुछ सेट करने की ज़रूरत नहीं है: सूचना का पता हर भुगतान के साथ भेजा जाता है।

सार्वजनिक साइट: सूचना URL इंटरनेट से पहुँचने योग्य होना चाहिए, बिना मेंटेनेंस मोड, बेसिक ऑथेंटिकेशन या Nexi को ब्लॉक करने वाले फ़ायरवॉल नियम के। अन्यथा भी भुगतान ग्राहक की हस्ताक्षरित वापसी से पुष्ट होता है।

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

इंस्टॉलेशन

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

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

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

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

5. Test Mode चालू रखें और टेस्ट alias और MAC कुंजी डालें (कॉन्फ़िगरेशन देखें)।

6. Enable/Disable चालू करें और एक टेस्ट ऑर्डर बनाएँ। जब सब कुछ ठीक चले, तो लाइव alias और MAC कुंजी डालें और Test Mode का निशान हटा दें।

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

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Nexi XPay। फ़ील्ड्स के ऊपर, जब तक टेस्ट मोड चालू है, पेज टेस्ट मोड चालू है: भुगतान Nexi XPay टेस्ट एनवायरनमेंट पर जाते हैं, कोई असली राशि नहीं काटी जाती। दिखाता है, और चेतावनी देता है जब गेटवे सक्षम हो पर वर्तमान मोड का alias या MAC कुंजी खाली हो, या स्टोर की मुद्रा EUR न हो। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है। चिपकाई गई कुंजियों के आसपास के खाली स्थान और लाइन ब्रेक सेव करते समय हटा दिए जाते हैं।

सामान्य

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

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का शीर्षक। डिफ़ॉल्ट: Credit Card (Nexi)। टेस्ट मोड में चेकआउट शीर्षक में (TEST MODE) जोड़ देता है।

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

टेस्ट एनवायरनमेंट

टेस्ट भुगतान int-ecommerce.nexi.it पर जाते हैं और कभी असली कार्ड से शुल्क नहीं लेते। टेस्ट alias और MAC कुंजी Nexi XPay टेस्ट एरिया या डेवलपर पोर्टल (developer.nexi.it) पर मिलती हैं।

Test Mode: Enable test mode Nexi XPay टेस्ट एनवायरनमेंट और टेस्ट क्रेडेंशियल का उपयोग करता है। लाइव क्रेडेंशियल से असली भुगतान लेने के लिए इसका निशान हटाएँ। डिफ़ॉल्ट: चालू।

Test Alias: आपके Nexi XPay टेस्ट टर्मिनल का alias (टर्मिनल ID)।

Test MAC Key: आपके Nexi XPay टेस्ट टर्मिनल की MAC गणना कुंजी।

लाइव एनवायरनमेंट

आपका मर्चेंट खाता सक्रिय होने के बाद लाइव alias और MAC कुंजी आपके Nexi XPay बैक ऑफ़िस (ecommerce.nexi.it) में दिखाई देती हैं।

Live Alias: आपके Nexi XPay लाइव टर्मिनल का alias (टर्मिनल ID)।

Live MAC Key: आपके Nexi XPay लाइव टर्मिनल की MAC गणना कुंजी।

भुगतान

सूचना URL हर भुगतान के साथ Nexi को भेजा जाता है, इसलिए बैक ऑफ़िस में कुछ कॉन्फ़िगर नहीं करना होता। यह सेक्शन URL दिखाता है; यह कुछ इस तरह दिखता है https://your-site/wp-json/wc-nexi-gateway/v1/s2s/{order_id}, जिसके अंत में ऑर्डर ID होता है। Nexi भुगतान का परिणाम सर्वर-से-सर्वर इसी URL पर भेजता है और ग्राहक की वापसी के साथ भी देता है। दोनों एक ही तरीके से साइन होते हैं और उस एनवायरनमेंट की MAC कुंजी, उस एनवायरनमेंट के alias और उस ऑर्डर के लिए जारी लेन-देन कोड से जाँचे जाते हैं जिसमें भुगतान हुआ था। जाँच में विफल परिणाम अस्वीकार किए जाते हैं और कुछ नहीं बदलते।

Capture: पैसा कब लिया जाता है।

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

उन्नत

Debug Log: Enable logging भुगतान घटनाएँ WooCommerce > Status > Logs में, स्रोत wcp_nexi_gateway के रूप में लॉग करता है। MAC कुंजियाँ, कार्ड डेटा और ईमेल पते लॉग नहीं होते। त्रुटियाँ और चेतावनियाँ, उदाहरण के लिए विफल MAC जाँच, विकल्प बंद होने पर भी हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।

Delete Data on Uninstall: Remove all plugin settings and logs when uninstalled। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Nexi)) और ऑर्डर देता है। अगला पेज Nexi XPay पर भुगतान के लिए रीडायरेक्ट हो रहा है... दिखाता है और ग्राहक को अपने आप Nexi XPay पेज पर भेज देता है, बैकअप के रूप में Pay Now बटन के साथ। भुगतान EUR में, एक नए लेन-देन कोड, ग्राहक के ईमेल, विवरण Order, ऑर्डर नंबर और आपकी साइट के नाम के साथ भेजा जाता है। Nexi पेज स्टोर की भाषा में खुलता है यदि वह इतालवी, अंग्रेज़ी, स्पेनिश, फ़्रेंच, जर्मन, जापानी, चीनी, अरबी, रूसी या पुर्तगाली है; अन्यथा अंग्रेज़ी में।

ग्राहक भुगतान करता है और आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब सत्यापित Nexi परिणाम ऑर्डर की सटीक राशि और मुद्रा के साथ आता है: सर्वर-से-सर्वर सूचना से या हस्ताक्षरित ग्राहक-वापसी से, जो भी पहले आए।

यदि भुगतान अस्वीकार हो जाता है, या ग्राहक Nexi पेज पर रद्द कर देता है, तो वह चेकआउट पर लौटता है (या कार्ट खाली होने पर Pay for order पेज पर) और इनमें से कोई एक संदेश देखता है: भुगतान पूरा नहीं हुआ। कृपया फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें।, भुगतान रद्द कर दिया गया। कृपया फिर से प्रयास करें। या हम भुगतान की पुष्टि नहीं कर सके। यदि आपके कार्ड से शुल्क लिया गया है, तो फिर से भुगतान करने से पहले हमसे संपर्क करें। Nexi पेज पर रद्द करने से ऑर्डर अपरिवर्तित रहता है, इसलिए ग्राहक फिर से भुगतान कर सकता है।

यदि प्लगइन वर्तमान मोड के लिए सेट नहीं है, तो ग्राहक को यह भुगतान विधि अभी उपलब्ध नहीं है। कृपया कोई दूसरी भुगतान विधि चुनें। दिखता है।

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

प्लगइन केवल Nexi XPay पेज पर भुगतान लेता है। इसमें WooCommerce से रिफ़ंड नहीं हैं, सेव किए गए कार्ड या OneClick नहीं हैं, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, Pay-By-Link नहीं है, XPay Build के एम्बेडेड फ़ील्ड नहीं हैं, और WooCommerce में चुनी गई भुगतान विधियाँ नहीं हैं: Nexi पेज आपके टर्मिनल पर सक्षम विधियाँ दिखाता है।

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

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

भुगतान लंबित: ग्राहक को Nexi पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Nexi पेज पर रद्द कर दिया है।

प्रोसेसिंग, पूर्ण या ऑन होल्ड: Nexi ने भुगतान की पुष्टि कर दी है। स्थिति Order Status After Payment का पालन करती है। ऑर्डर नोट में प्राधिकरण कोड, लेन-देन कोड, कार्ड ब्रांड और Nexi संदेश दिखता है। लेन-देन ID Nexi का लेन-देन कोड है।

ऑन होल्ड (अधिकृत): Deferred capture चुना गया है और भुगतान केवल अधिकृत है। इसे Capture Nexi XPay payment ऑर्डर-क्रिया से कैप्चर करें।

ऑन होल्ड (लंबित): Nexi ने भुगतान को पुष्टि की प्रतीक्षा में बताया है। ऑर्डर अंतिम परिणाम से अपडेट होगा।

भुगतान के बाद ऑन होल्ड: Nexi से मिली राशि या मुद्रा ऑर्डर से मेल नहीं खाई (ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता), या पहले से रद्द ऑर्डर के लिए सफल भुगतान आया। ऑर्डर नोट इसका कारण बताता है। Nexi XPay बैक ऑफ़िस में भुगतान जाँचें और ऑर्डर प्रोसेस करें या रिफ़ंड करें।

विफल: नवीनतम भुगतान प्रयास अस्वीकार, रद्द या त्रुटि के साथ समाप्त हुआ। ग्राहक फिर से भुगतान कर सकता है।

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

Deferred capture

अधिकृत और ऑन होल्ड ऑर्डर के लिए, ऑर्डर खोलें, ऑर्डर क्रियाओं में Capture Nexi XPay payment चुनें और तीर पर क्लिक करें। प्लगइन भुगतान के एनवायरनमेंट में अधिकृत राशि कैप्चर करता है और Order Status After Payment की स्थिति के साथ ऑर्डर को भुगतान किया हुआ चिह्नित करता है। यदि कैप्चर विफल होता है, तो त्रुटि ऑर्डर स्क्रीन पर दिखती है और ऑर्डर नोट्स में जुड़ती है, और ऑर्डर ऑन होल्ड रहता है।

रिफ़ंड

रिफ़ंड WooCommerce से नहीं किए जाते, इसलिए Refund via बटन नहीं है। Nexi XPay बैक ऑफ़िस में रिफ़ंड करें, फिर उसे WooCommerce में मैन्युअल रूप से दर्ज करें।

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

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

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

सक्रिय कुंजी के बिना, Nexi XPay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। लॉग इन किए हुए स्टोर मैनेजर को भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान शुरू हो चुके हैं वे अब भी पुष्ट होते हैं, और स्थगित भुगतान अब भी कैप्चर किए जा सकते हैं।

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

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

चेकआउट पर Nexi XPay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में दोनों क्रेडेंशियल भरे हैं (टेस्ट मोड में Test Alias और Test MAC Key, लाइव मोड में Live Alias और Live MAC Key), और स्टोर या ऑर्डर की मुद्रा EUR है। इन मामलों में सेटिंग्स पेज चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित पर अटका है: न सूचना स्वीकार हुई, न ग्राहक की वापसी। जाँचें कि स्टोर इंटरनेट से पहुँचने योग्य है, MAC कुंजी और alias भुगतान के एनवायरनमेंट (टेस्ट या लाइव) से मेल खाते हैं, और WooCommerce > Status > Logs, स्रोत wcp_nexi_gateway में देखने के लिए Debug Log चालू करें कि Nexi ने क्या भेजा।

सूचना invalid_mac या invalid_alias का उत्तर देती है: सेटिंग्स में MAC कुंजी या alias उस टर्मिनल से मेल नहीं खाते जिसने परिणाम भेजा। उन्हें Nexi टेस्ट एरिया या बैक ऑफ़िस से दोबारा कॉपी करें।

सूचना unknown_transaction का उत्तर देती है: वह लेन-देन कोड इस स्टोर ने उस ऑर्डर के लिए जारी नहीं किया था। परिणाम अनदेखा किया जाता है।

सूचना not_configured या busy का उत्तर देती है: भुगतान के एनवायरनमेंट का alias या MAC कुंजी खाली है, या उसी समय कोई और अनुरोध ऑर्डर अपडेट कर रहा था। Nexi सूचना दोबारा भेजता है।

भुगतान के बाद ऑर्डर ऑन होल्ड है: ऑर्डर नोट पढ़ें। Deferred capture चुना गया है (भुगतान को ऑर्डर-क्रिया से कैप्चर करें), राशि या मुद्रा मेल नहीं खाई, रद्द ऑर्डर के लिए भुगतान आया, भुगतान Nexi पर लंबित है, या भुगतान के बाद की स्थिति के रूप में ऑन होल्ड चुना गया है।

Capture Nexi XPay payment गायब है या विफल होता है: यह क्रिया केवल उन Nexi ऑर्डर के लिए दिखती है जो deferred capture के साथ अधिकृत के रूप में ऑन होल्ड हैं। विफल होने पर ऑर्डर नोट्स में त्रुटि पढ़ें; कैप्चर उस एनवायरनमेंट की कुंजियाँ इस्तेमाल करता है जिसमें भुगतान हुआ था।

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

अनइंस्टॉल

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

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