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

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

मुद्रा: ग्राहक को EUR में चेकआउट करना होगा, इसलिए System > Localisation > Currencies में EUR मुद्रा सक्षम होनी चाहिए। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।

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

सार्वजनिक स्टोर: सूचना URL इंटरनेट से पहुँच योग्य होना चाहिए, बिना basic authentication के और बिना ऐसे firewall नियम के जो Nexi को रोकें। अगर सूचना स्टोर तक नहीं पहुँच पाती, तब भी ग्राहक की हस्ताक्षरित वापसी से भुगतान की पुष्टि हो जाती है।

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

इंस्टॉलेशन

डाउनलोड एक ज़िप फ़ाइल है जिसमें OpenCart के दोनों संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर खोल लें। इसमें README.txt, OpenCart 3 का पैकेज wcp_nexi_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_nexi_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_nexi_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर की जगह आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Nexi XPay Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता को भुगतान एक्सटेंशन की सूची बदलने का अधिकार चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के ऊपर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी अनुभाग)।

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

5. Enable/Disable चालू करें, Save पर क्लिक करें और EUR में एक टेस्ट ऑर्डर दें। जब सब कुछ काम करने लगे, तो लाइव alias और लाइव MAC कुंजी डालें और Test Mode बंद करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_nexi_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज इसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Nexi XPay Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. लाइसेंस कुंजी, alias और MAC कुंजियाँ उसी तरह डालें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें Notification URL)।

नई इंस्टॉलेशन भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होती है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Nexi XPay Gateway > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर, टेस्ट मोड चालू होने पर पेज Test mode is on: payments go to the Nexi XPay test environment, no real money is charged. दिखाता है। जब गेटवे सक्षम हो लेकिन वर्तमान मोड का alias या MAC कुंजी खाली हो, तो पेज चेतावनी देता है (तब भुगतान विधि चेकआउट पर छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा EUR न हो तब भी चेतावनी देता है (तब भुगतान विधि केवल EUR में चेकआउट करने वाले ग्राहकों को दिखती है)। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सहेज नहीं सकता।

सहेजते समय Title 128 अक्षरों से लंबा नहीं हो सकता, Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्टेटस मौजूद होने चाहिए; इनमें से कोई भी गलत हो तो कुछ भी सहेजा नहीं जाता। चिपकाए गए alias और कुंजियों के आसपास के खाली स्थान हटा दिए जाते हैं।

Nexi XPay

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

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

Description: ग्राहक को Confirm Order चरण पर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card via Nexi XPay।

Sort Order: चेकआउट पर भुगतान विधियों के बीच Nexi XPay की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें।

Geo Zone: Nexi XPay केवल चुने हुए जियो ज़ोन के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक पहुँचने पर ही Nexi XPay दिया जाता है। किसी भी राशि के लिए देने हेतु खाली छोड़ें।

टेस्ट वातावरण

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

Test Mode: Nexi XPay का टेस्ट वातावरण और टेस्ट क्रेडेंशियल उपयोग करता है। असली भुगतान लाइव क्रेडेंशियल से लेने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण पर TEST MODE: the payment goes to the Nexi XPay test environment, no real money is charged. देखते हैं।

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

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

लाइव वातावरण

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

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

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

सहेजी गई MAC कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान लिखें जब उसे बदलना हो। सहेजी गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved MAC key on save पर टिक करें और Save पर क्लिक करें।

भुगतान

Notification URL: संदर्भ के लिए दिखाया जाता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_nexi_gateway/s2s&nexi_order={order_id} जैसा दिखता है, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_nexi_gateway/payment/wcp_nexi_gateway.s2s&nexi_order={order_id} जैसा, अंत में ऑर्डर नंबर के साथ, और आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह हर भुगतान के साथ Nexi को भेजा जाता है, इसलिए Nexi back office में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। Nexi भुगतान का परिणाम इस URL पर सर्वर-से-सर्वर भेजता है और ग्राहक की वापसी के साथ भी देता है। दोनों एक ही तरह से हस्ताक्षरित होते हैं और उस वातावरण की MAC कुंजी, उस वातावरण के alias और उस ऑर्डर के लिए जारी लेन-देन कोड से जाँचे जाते हैं जिसमें भुगतान हुआ था। जाँच में विफल परिणाम अस्वीकार होते हैं और कुछ नहीं बदलते।

Capture: राशि कब ली जाती है।

Order Status After Payment: सफल भुगतान के बाद ऑर्डर का स्टेटस। हर विकल्प के लिए उपयोग होने वाले OpenCart स्टेटस Orders अनुभाग में सेट होते हैं।

ऑर्डर

OpenCart ऑर्डर को Confirm Order चरण पर बिना स्टेटस के बनाता है (गायब ऑर्डर, missing order)। ऑर्डर को स्टेटस केवल सत्यापित Nexi परिणाम से मिलता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है। OpenCart में On hold स्टेटस नहीं है: डिफ़ॉल्ट रूप से Pending उपयोग होता है और एक ऑर्डर नोट कारण समझाता है। आप System > Localisation > Order Statuses में अपने स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Status: Processing: जब Order Status After Payment Processing हो तब उपयोग होता है। डिफ़ॉल्ट: Processing।

Status: Completed: जब Order Status After Payment Completed हो तब उपयोग होता है। डिफ़ॉल्ट: Complete।

Status: awaiting payment: Nexi भुगतान को लंबित (esito PEN) के रूप में दर्ज करता है। डिफ़ॉल्ट: Pending।

Status: on hold: राशि या मुद्रा का मेल न होना, रद्द ऑर्डर के लिए प्राप्त भुगतान, विलंबित कैप्चर (authorized, अभी कैप्चर नहीं हुआ), या Order Status After Payment का On hold पर सेट होना। डिफ़ॉल्ट: Pending।

Status: payment failed: लंबित भुगतान जो बाद में विफल हो गया। डिफ़ॉल्ट: Failed।

Status of cancelled orders: वह स्टेटस जो आपका स्टोर रद्द ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए प्राप्त भुगतान होल्ड पर रखा जाता है, कभी भुगतान किया हुआ चिह्नित नहीं होता। एक्सटेंशन केवल इस स्टेटस को पढ़ता है, कभी सेट नहीं करता। डिफ़ॉल्ट: Canceled।

उन्नत

Debug Log: भुगतान इवेंट्स को OpenCart लॉग फ़ोल्डर (storage/logs) में nexi_ip_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। MAC कुंजियाँ, MAC मान, कार्ड डेटा और ईमेल पते दर्ज नहीं होते। त्रुटियाँ और चेतावनियाँ, जैसे विफल MAC जाँच, विकल्प बंद होने पर भी हमेशा दर्ज होती हैं। डिफ़ॉल्ट: बंद।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Delete Data on Uninstall: चालू होने पर एक्सटेंशन को अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के Nexi XPay भुगतान रिकॉर्ड हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

इंपोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। MAC कुंजियाँ एक्सपोर्ट नहीं होतीं।

Import: एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई MAC कुंजियाँ नहीं बदलतीं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Nexi))। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में उसे चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो पेज Redirecting to the Nexi XPay payment page... और Please do not close this window. दिखाता है और एक सेकंड बाद ग्राहक को अपने-आप Nexi XPay पेज पर भेज देता है, विकल्प के रूप में Pay with Nexi XPay बटन के साथ। भुगतान ऑर्डर कुल के लिए EUR में, नए लेन-देन कोड, ग्राहक के ईमेल और Order विवरण, ऑर्डर नंबर और आपके स्टोर के नाम के साथ भेजा जाता है। Nexi पेज ग्राहक के स्टोर की भाषा में खुलता है यदि वह इतालवी, अंग्रेज़ी, स्पेनिश, फ़्रेंच, जर्मन, जापानी, चीनी, अरबी, रूसी या पुर्तगाली है; अन्यथा अंग्रेज़ी में।

ग्राहक भुगतान करता है और आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब ऑर्डर की सटीक राशि और मुद्रा के साथ सत्यापित Nexi परिणाम मिल जाए: सर्वर-से-सर्वर सूचना से या हस्ताक्षरित ग्राहक वापसी से, जो भी पहले आए। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को Your Nexi XPay payment has been received. के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। यदि Nexi भुगतान को लंबित बताता है, तो पेज Your payment is pending confirmation from Nexi XPay. We will update your order as soon as the payment is confirmed. दिखाता है। होल्ड पर चल रहे ऑर्डर (विलंबित कैप्चर या मैन्युअल समीक्षा) के लिए Your Nexi XPay payment has been received and is being reviewed. We will contact you if anything is needed. दिखाया जाता है।

यदि ग्राहक के लौटने पर परिणाम अभी तक संसाधित नहीं हुआ है, तो एक Payment confirmation पेज We have not received the payment confirmation from Nexi XPay yet. If you completed the payment, your order will be updated shortly. दिखाता है और Check again बटन होता है। सूचना आते ही ऑर्डर का स्टेटस सेट हो जाता है।

यदि भुगतान अस्वीकार हो जाता है, कोई लंबित भुगतान विफल हो जाता है, या ग्राहक Nexi पेज पर रद्द कर देता है, तो वह चेकआउट पर लौटता है और इनमें से कोई एक संदेश देखता है: The payment was not completed. Please try again or choose a different payment method., Payment was cancelled. Please try again., या We could not confirm the payment. If your card was charged, please contact us before paying again. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। बिना स्टेटस वाला ऑर्डर बिना स्टेटस के रहता है और कार्ट सुरक्षित रहती है, ताकि ग्राहक दोबारा भुगतान कर सके। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और नए लेन-देन कोड के साथ उसी ऑर्डर का फिर से भुगतान करता है; जब उसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ, भुगतान की प्रतीक्षा में या होल्ड पर हो, तो ग्राहक नए भुगतान के बजाय सफलता पेज पर जाता है।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए कोई लंबित भुगतान विफल हुआ, या आपने उसे रद्द किया), तो ग्राहक को Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस भेजा जाता है, Nexi से लौटने पर भी, और अगला Confirm Order एक नया ऑर्डर भुगतान के लिए बनाता है। यदि ऑर्डर का भुगतान हो चुका था और फिर स्टोर ने उसे बंद किया (उदाहरण के लिए रिफ़ंड), तो संदेश है Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. यदि चेकआउट का ऑर्डर पहले ही दर्ज हो चुका है और उसके बाद कार्ट बदल गया है, तो संदेश है Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नई कार्ट माना जाता है जिसे अपने भुगतान की ज़रूरत होती है।

यदि एक्सटेंशन वर्तमान मोड के लिए सेट नहीं है, तो ग्राहक को This payment method is not available right now. Please choose another payment method. दिखता है।

स्टोर मेंटेनेंस मोड में होने पर भी सूचना काम करती है, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है, जो ग्राहक को Nexi से लौटने की भी अनुमति देता है।

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

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक को Nexi पर भेजा गया और उसने भुगतान नहीं किया, रद्द किया, या भुगतान अस्वीकार हुआ, या Nexi ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब फ़िल्टर Order Status को Missing Orders पर सेट किया गया हो।

Status: Processing, Completed or on hold: Nexi ने भुगतान की पुष्टि की है। स्टेटस Order Status After Payment का अनुसरण करता है। एक नोट authorization कोड, लेन-देन कोड, कार्ड ब्रांड और Nexi संदेश दिखाता है।

Status: on hold (authorized): विलंबित कैप्चर चुना गया है और भुगतान केवल authorized है। ऑर्डर टैब में Capture Nexi XPay payment से कैप्चर करें।

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

Status: on hold after payment: Nexi से मिली राशि या मुद्रा ऑर्डर से मेल नहीं खाती (ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता), या पहले से रद्द ऑर्डर के लिए सफल भुगतान आया। नोट इसे समझाता है। Nexi XPay back office में भुगतान जाँचें और ऑर्डर को प्रोसेस करें या रिफ़ंड करें।

Status: payment failed: लंबित भुगतान विफल हो गया।

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

नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Nexi XPay Gateway टैब

Sales > Orders में Nexi XPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Nexi XPay Gateway टैब लेन-देन कोड (codTrans), टेस्ट भुगतानों के लिए Test environment लेबल, स्टेटस और Nexi परिणाम, कैप्चर मोड और स्थिति, Nexi को भेजी गई और प्राप्त राशि, authorization कोड, कार्ड ब्रांड, Nexi संदेश, तारीख और ऑर्डर के Nexi XPay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन तक पहुँच है।

विलंबित कैप्चर

authorized और होल्ड पर चल रहे ऑर्डर के लिए, टैब में Capture Nexi XPay payment पर क्लिक करें (बटन पर राशि दिखती है) और प्रश्न Capture the authorized amount through Nexi XPay? की पुष्टि करें। आपको एक्सटेंशन बदलने का अधिकार चाहिए (जो System > Users > User Groups में सेट होता है)। एक्सटेंशन भुगतान के वातावरण में, उस वातावरण की कुंजियों से, authorized राशि कैप्चर करता है और नोट के साथ Order Status After Payment से स्टेटस सेट करता है। स्टेटस मैन्युअल स्टेटस बदलाव की तरह सीधे बदला जाता है, बिना ईमेल और स्टॉक गतिविधि के। कैप्चर विफल होने पर टैब त्रुटि दिखाता है, एक नोट जोड़ा जाता है और ऑर्डर होल्ड पर रहता है। उसी भुगतान का दूसरा कैप्चर अस्वीकार हो जाता है।

रिफ़ंड

रिफ़ंड OpenCart से नहीं किए जाते, इसलिए Nexi XPay के लिए रिफ़ंड बटन नहीं है। Nexi XPay back office में रिफ़ंड करें, फिर उसे OpenCart में मैन्युअली दर्ज करें। Sales > Returns में उत्पाद वापसी Nexi के माध्यम से पैसा वापस नहीं भेजती।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Nexi XPay Gateway, Extensions > Extensions > Payments > VibeFox Nexi XPay Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्टेटस (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन: स्टेटस दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-nexi वाली पंक्ति और वह लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

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

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

लाइसेंस की समाप्ति पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन को अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

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

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

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

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

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

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

ब्राउज़र में सूचना URL method_not_allowed दिखाता है: यह सामान्य है। यह URL केवल Nexi के अनुरोध स्वीकार करता है।

ग्राहक को This payment method is not available. Please reload the checkout page. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई। ग्राहक चेकआउट को रीलोड करता है।

भुगतान के बाद ऑर्डर होल्ड स्टेटस में है: टैब में Nexi XPay notes पढ़ें। विलंबित कैप्चर चुना गया है (बटन से भुगतान कैप्चर करें), राशि या मुद्रा मेल नहीं खाई, रद्द ऑर्डर के लिए भुगतान आया, या Order Status After Payment On hold पर सेट है।

Capture Nexi XPay payment गायब है या विफल होता है: यह बटन केवल उन Nexi XPay ऑर्डरों के लिए दिखता है जो विलंबित कैप्चर के साथ authorized के रूप में होल्ड पर हैं, और केवल उन उपयोगकर्ताओं को जो एक्सटेंशन बदल सकते हैं। यदि भुगतान के वातावरण का alias या MAC कुंजी खाली है, तो टैब यह बताता है। यदि कैप्चर विफल होता है, तो टैब और नोट्स में त्रुटि पढ़ें, उदाहरण के लिए Nexi कोड और संदेश के साथ Nexi XPay refused the capture।

टेस्ट भुगतान लाइव भुगतान की पुष्टि नहीं करते: हर भुगतान उसी वातावरण की कुंजियों से जाँचा जाता है जिसमें वह शुरू हुआ था। Test Mode को वांछित मोड में बदलें और उस मोड का alias और MAC कुंजी उपयोग करें।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Nexi XPay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders अनुभाग के स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका startup action भी, जो मेंटेनेंस मोड में सूचना को आगे जाने देता है)। यदि Delete Data on Uninstall चालू है, तो गेटवे की बाकी सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, alias, MAC कुंजियाँ, कैप्चर, भुगतान के बाद ऑर्डर स्टेटस, debug लॉग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। ऑर्डरों के Nexi XPay भुगतान रिकॉर्ड (भुगतान, कैप्चर और रिफ़ंड) हमेशा रखे जाते हैं, इसलिए दोबारा इंस्टॉल करने के बाद भी authorized भुगतान कैप्चर किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Nexi XPay Gateway के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

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