VibeFox PayPlug for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा और राशियाँ: यूरो (EUR), प्रति भुगतान 0.99 से 20,000.00 तक, जो PayPlug के डिफ़ॉल्ट मान हैं। यूरो को System > Localisation > Currencies में सक्षम होना चाहिए और ग्राहक द्वारा चुना जाना चाहिए। किसी अन्य चेकआउट मुद्रा के साथ या इन सीमाओं से बाहर होने पर भुगतान विधि छिप जाती है।

PayPlug खाता: आपको अपने PayPlug खाते की सीक्रेट कीज़ चाहिए: टेस्ट कुंजी (sk_test_...) और/या लाइव कुंजी (sk_live_...)। किसी और कुंजी की ज़रूरत नहीं है, और PayPlug में कोई सूचना सेट करनी नहीं होती। सूचनाएँ प्राप्त करने के लिए आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए; अन्यथा ग्राहक के PayPlug से लौटने पर ऑर्डर की पुष्टि होती है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. PayPlug पोर्टल से अपनी सीक्रेट कीज़ पेस्ट करें (कॉन्फ़िगरेशन देखें)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू रखकर एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए इसे बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज चेतावनी देता है जब भुगतान विधि चालू हो पर वर्तमान मोड की सीक्रेट कुंजी खाली हो, और जब स्टोर की डिफ़ॉल्ट मुद्रा EUR न हो। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है (किसी अन्य डिफ़ॉल्ट मुद्रा के साथ, तब तक जब तक वह मुद्रा चुनी हुई है)। एक्सटेंशन बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता और पेज त्रुटियाँ सूचीबद्ध करता है। गलत फ़ॉर्मेट वाली सीक्रेट कुंजी सेव नहीं होती, लेकिन बाकी सेटिंग्स सेव हो जाती हैं: पेज पर Settings saved, except the secret key shown in red. और, उदाहरण के लिए, Test Secret Key must start with "sk_test_". The previous value was kept. दिखता है।

Checkout

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: PayPlug। आवश्यक, 128 अक्षरों तक।

Description: वह पाठ जो ग्राहक Confirm Order चरण में, पुष्टि बटन के ऊपर देखते हैं। डिफ़ॉल्ट: Pay securely by card via PayPlug.

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

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

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

API कुंजियाँ

अपनी सीक्रेट कीज़ PayPlug पोर्टल में Developers > API keys के अंतर्गत खोजें। इस सेक्शन में पोर्टल का लिंक है।

Test Mode: नए भुगतानों के लिए टेस्ट सीक्रेट कुंजी का उपयोग करता है। कोई असली भुगतान प्रोसेस नहीं होता। दूसरे मोड में किए गए भुगतान स्टेटस जाँच और रिफ़ंड के लिए अपने मोड की कुंजी का उपयोग करते रहते हैं। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण में Test mode: no real payment will be made. देखते हैं।

Test Secret Key: आपकी PayPlug टेस्ट सीक्रेट कुंजी। यह sk_test_ से शुरू होती है।

Live Secret Key: आपकी PayPlug लाइव सीक्रेट कुंजी। यह sk_live_ से शुरू होती है।

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

सूचनाएँ

Notification URL: वह पता जिसे एक्सटेंशन हर भुगतान के साथ PayPlug को भेजता है। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_payplug_gateway/webhook, OpenCart 4 में: https://your-store/index.php?route=extension/wcp_payplug_gateway/payment/wcp_payplug_gateway.webhook और आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। PayPlug पोर्टल में कुछ भी दर्ज करने की ज़रूरत नहीं है। हर सूचना की जाँच PayPlug API से भुगतान दोबारा पढ़कर की जाती है, इसलिए ग्राहक स्टोर पर वापस न आए तब भी भुगतान की पुष्टि होती है। यह URL इंटरनेट से पहुँच योग्य होना चाहिए; अन्यथा ऑर्डर केवल तब कन्फ़र्म होते हैं जब ग्राहक PayPlug से लौटता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब PayPlug सूचना या ग्राहक की वापसी के ज़रिए भुगतान की रिपोर्ट करे; भुगतान हमेशा PayPlug से दोबारा पढ़ा जाता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।

Order Status After Payment: सफल भुगतान के बाद सेट होने वाली स्थिति, जैसे Processing या Complete। डिफ़ॉल्ट: Processing।

PayPlug Payment On Hold Status: भुगतान को आपकी समीक्षा चाहिए (ऑर्डर स्थितियाँ देखें)। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Payment Error Status: होल्ड पर चल रहे ऑर्डर का अधिकृत भुगतान विफल हुआ या रद्द हुआ। डिफ़ॉल्ट: Failed।

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होती है। डिफ़ॉल्ट: Refunded।

उन्नत

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

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

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

आयात / निर्यात

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PayPlug)। Confirm Order चरण पर ग्राहक को आपका विवरण और नोट You will be redirected to the secure PayPlug payment page to pay by card. दिखता है; टेस्ट मोड में Test mode: no real payment will be made. भी दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर राशि के लिए सेंट में एक PayPlug भुगतान बनाता है और ग्राहक को PayPlug भुगतान पेज पर भेज देता है। बिलिंग और डिलीवरी पते, ईमेल और ऑर्डर की भाषा PayPlug को भेजे जाते हैं। वहाँ ग्राहक कार्ड से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर को भुगतान पूरा तभी माना जाता है जब PayPlug उसकी पुष्टि करे: एक्सटेंशन सूचना आने पर और ग्राहक के लौटने पर PayPlug API से भुगतान पढ़ता है। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है जिस पर Your payment with PayPlug has been received. लिखा होता है। यदि ऑर्डर होल्ड पर है, तो पेज पर We are confirming your payment with PayPlug. The order will be updated automatically — please do not pay again. लिखा होता है। यदि ऑर्डर भुगतान त्रुटि स्थिति में है, तो पेज पर Your PayPlug payment was not completed. Please contact us about this order. लिखा होता है। यदि ग्राहक के लौटने पर PayPlug से पूछा नहीं जा सका, तो Payment confirmation पेज पर वही "पुष्टि हो रही है" पाठ और Check again बटन दिखता है; सूचना आते ही ऑर्डर स्थिति सेट हो जाती है।

यदि ग्राहक PayPlug पेज पर रद्द कर दे, तो भुगतान पेज PayPlug पर बंद हो जाता है, इसलिए उसे बाद में गलती से नहीं चुकाया जा सकता। ग्राहक चेकआउट पर इस संदेश के साथ लौटता है: You cancelled the PayPlug payment. You can try again or choose another payment method., The PayPlug payment session has expired. Please try again or choose another payment method., The PayPlug payment failed. Please try again or choose another payment method., या यदि भुगतान खुला छूट गया था, तो Your PayPlug payment was not completed. You can try again or choose another payment method. कार्ट बना रहता है। OpenCart 4 में ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, और OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है (नया प्रयास उसी ऑर्डर के लिए नया PayPlug भुगतान है), इसलिए एक्सटेंशन पहले उसी कार्ट के पिछले प्रयासों को देखता है। यदि उनमें से कोई इस बीच भुगतान हो चुका है, तो नया भुगतान बनाए बिना वही भुगतान उपयोग होता है और ग्राहक सफलता पेज पर जाता है। यदि इस ऑर्डर का प्रयास उसी राशि के लिए अभी भी खुला है, तो वही भुगतान पेज फिर से उपयोग होता है। अन्यथा पुराना पेज PayPlug पर बंद कर दिया जाता है और नया भुगतान बनाया जाता है। बंद पेज पर देर से आया भुगतान फिर भी दर्ज होता है। कार्ट में बदलाव (नई मात्रा सहित) को एक नया कार्ट माना जाता है, जिसे अपने भुगतान की ज़रूरत होती है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज न दिखे। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया या उसका अधिकृत भुगतान विफल हुआ), तो ग्राहक Your previous order was cancelled or refunded. Please confirm the order again to pay with a new order. संदेश के साथ चेकआउट पर लौट आता है। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि वह ऑर्डर पहले किसी कार्ट के लिए भुगतान हो चुका था और उसके बाद कार्ट बदल गया है, तो ग्राहक चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order मौजूदा कार्ट का नया ऑर्डर भुगतान करता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।

यदि PayPlug भुगतान शुरू नहीं कर सकता, तो ग्राहक Confirm Order चरण पर ही रहता है और एक छोटा संदेश देखता है, जैसे PayPlug could not accept your billing details (postcode). Please check them and try again. या The payment provider could not be reached. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।

स्टोर रखरखाव मोड में होने पर भी सूचना काम करती है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है (OpenCart 4 में एक्सटेंशन इसके लिए अपनी स्टार्टअप क्रिया जोड़ता है, जो ग्राहक की PayPlug से वापसी को भी आगे जाने देती है)।

भुगतान तुरंत कैप्चर होते हैं। इस एक्सटेंशन में Oney इंस्टॉलमेंट, वन-क्लिक सेव्ड कार्ड, एम्बेडेड भुगतान फ़ॉर्म, सब्सक्रिप्शन या विलंबित कैप्चर नहीं हैं।

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

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

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

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हो गई है। एक नोट PayPlug भुगतान और उसका मोड दिखाता है।

PayPlug Payment On Hold Status (डिफ़ॉल्ट Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (नोट amount/currency mismatch); या स्टोर के लाइव मोड में रहते हुए टेस्ट भुगतान हुआ, इसलिए कोई पैसा नहीं मिला; या ऑर्डर को कोई और स्थिति मिलने के बाद भुगतान आया, उदाहरण के लिए वह रद्द हो चुका था; या भुगतान अधिकृत है पर कैप्चर नहीं हुआ (इसे PayPlug पोर्टल में कैप्चर करें; PayPlug के भुगतान को पूर्ण बताने पर ऑर्डर भुगतान पूरा चिह्नित होता है)। नोट बताता है कि क्या जाँचना है।

Payment Error Status (डिफ़ॉल्ट Failed): होल्ड पर चल रहे ऑर्डर का अधिकृत भुगतान विफल हुआ या रद्द हुआ। OpenCart इस बदलाव की सूचना ग्राहक को देता है।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।

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

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

VibeFox PayPlug Gateway टैब

Sales > Orders में PayPlug से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayPlug Gateway टैब में PayPlug payment ID दिखता है (टेस्ट भुगतानों के लिए Test mode लेबल के साथ), भुगतान की Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास (हर रिफ़ंड के मोड के साथ) और ऑर्डर के PayPlug notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox PayPlug Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via PayPlug पर क्लिक करें। Refund this amount through PayPlug? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन बदलने का अधिकार होना चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उस राशि तक होते हैं जो PayPlug ने वास्तव में वसूली है, इसलिए राशि में अंतर होने पर आप ऑर्डर की कुल राशि के बजाय वह राशि लौटा सकते हैं जो ग्राहक ने चुकाई थी। रिफ़ंड उसी भुगतान पर जाता है जिसने ऑर्डर को वास्तव में चुकाया, और उस मोड (टेस्ट या लाइव) की सीक्रेट कुंजी से किया जाता है जिसमें वह किया गया था, इसलिए वह कुंजी सेट होनी चाहिए। यदि PayPlug रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड को PayPlug रिफ़ंड ID और कारण के साथ रिफ़ंड इतिहास और नोट्स में जोड़ा जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस लौटाए बिना ऑर्डर को Refunded Status पर सेट करता है, जैसे मैनुअल स्थिति परिवर्तन। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब PayPlug भुगतान को भुगतान किया हुआ बता दे।

Sales > Returns में उत्पाद वापसी से PayPlug के ज़रिए पैसे वापस नहीं जाते।

PayPlug पोर्टल में किए गए रिफ़ंड सूचना के ज़रिए आते हैं और नोट्स में केवल एक बार जुड़ते हैं। वे रिफ़ंड इतिहास में सूचीबद्ध होते हैं, लेकिन एक्सटेंशन के रिफ़ंड के रूप में नहीं गिने जाते और ऑर्डर स्थिति नहीं बदलते। ज़रूरत हो तो इन्हें मैन्युअली दर्ज करें।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी से चलता है। लाइसेंस ब्लॉक License — VibeFox PayPlug Gateway, Extensions > Extensions > Payments > VibeFox PayPlug Gateway > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस कब तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी डालने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: opencart-payment-payplug वाली पंक्ति और 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 पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

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

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

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

चेकआउट पर PayPlug दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड में सीक्रेट कुंजी है (टेस्ट मोड में Test Secret Key, लाइव मोड में Live Secret Key), चेकआउट मुद्रा EUR है, और ऑर्डर राशि 0.99 से 20,000.00 EUR के बीच है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है। डेवलपर OpenCart इवेंट ppg_supported_currencies और ppg_amount_limits (सेंट में मान) से मुद्राएँ और सीमाएँ, तथा ppg_payment_data से भुगतान अनुरोध बदल सकते हैं।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: सूचना आपके स्टोर तक नहीं पहुँची और ग्राहक वापस नहीं आया। जाँचें कि आपका स्टोर सेटिंग्स में दिखाए गए Notification URL पर इंटरनेट से पहुँच योग्य है, उदाहरण के लिए कोई फ़ायरवॉल या पासवर्ड सुरक्षा उसे ब्लॉक तो नहीं कर रही। Logging चालू करें और अस्वीकृत सूचनाओं के लिए Log फ़ील्ड देखें।

सूचना का उत्तर Verification failed. है: PayPlug API से भुगतान पढ़ा नहीं जा सका, उदाहरण के लिए PayPlug ने उत्तर नहीं दिया या भुगतान के मोड की सीक्रेट कुंजी सेट नहीं है। ऑर्डर नहीं बदलता, और PayPlug सूचना दोबारा भेजता है।

सूचना का उत्तर Temporarily unavailable. है: उसी समय किसी और अनुरोध (जैसे ग्राहक की वापसी) से कार्ट अपडेट हो रहा था, या ऑर्डर स्थिति सेट नहीं हो सकी। PayPlug सूचना दोबारा भेजता है। लॉग कारण दिखाता है।

सूचना का उत्तर Unknown payment. या Payment does not belong to the order. है: भुगतान इस स्टोर द्वारा नहीं बनाया गया या इस ऑर्डर के लिए नहीं है, उदाहरण के लिए उसी PayPlug खाते पर किसी और स्टोर का भुगतान। इसे अनदेखा किया जाता है।

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

ग्राहक को Confirm Order के बाद एक त्रुटि दिखती है: Logging चालू करें और Log फ़ील्ड देखें। गलत कुंजी This payment method is temporarily unavailable. Please choose another payment method. दिखाती है; अन्य संदेश बताते हैं कि PayPlug ने कौन-सा बिलिंग फ़ील्ड अस्वीकार किया।

ग्राहक लौटता है और Payment verification failed. देखता है: वापसी लिंक ऑर्डर के किसी भुगतान प्रयास से मेल नहीं खाता, उदाहरण के लिए वह किसी दूसरे ब्राउज़र में खोला गया था। PayPlug पोर्टल में भुगतान जाँचें; सूचना फिर भी ऑर्डर स्थिति सेट करती है।

भुगतान के बाद ऑर्डर होल्ड पर है: VibeFox PayPlug Gateway टैब के नोट पढ़ें (ऑर्डर स्थितियाँ देखें), फिर ऑर्डर प्रोसेस करें या भुगतान रिफ़ंड करें।

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

रिफ़ंड Unexpected response from PayPlug. के साथ विफल होता है: PayPlug ने बिना वैध रिफ़ंड के उत्तर दिया। कुछ दर्ज नहीं हुआ। दोबारा प्रयास करने से पहले PayPlug पोर्टल में रिफ़ंड जाँचें।

अनइंस्टॉल

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

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

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