VibeFox Paysera for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
Paysera प्रोजेक्ट: आपको अपने Paysera प्रोजेक्ट की प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड (हस्ताक्षर कुंजी) चाहिए। ग्राहक को दिखने वाले भुगतान तरीके वही हैं जो इस प्रोजेक्ट में सक्षम हैं। कॉलबैक के लिए Paysera में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है: उसका URL हर भुगतान अनुरोध के साथ भेजा जाता है।
पहुँच योग्य स्टोर: ऑर्डर अपनी स्थिति Paysera कॉलबैक से लेते हैं, इसलिए आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, लॉगिन, बेसिक ऑथेंटिकेशन या फ़ायरवॉल के पीछे नहीं। स्टोर रखरखाव मोड में होने पर भी कॉलबैक काम करता है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
यह एक ही zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_paysera_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_paysera_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_paysera_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Paysera Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के ऊपर के लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।
4. अपने Paysera खाते की Project ID और Project password दर्ज करें (कॉन्फ़िगरेशन देखें)।
5. वैकल्पिक: बिना पैसे लिए प्रवाह आज़माने के लिए Paysera प्रोजेक्ट में Allow test payments और एक्सटेंशन में Test payments चालू करें। बिक्री शुरू करने से पहले इसे बंद कर दें।
6. Enable/Disable चालू करें और Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_paysera_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Paysera Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी, प्रोजेक्ट ID और पासवर्ड, और टेस्ट सेटिंग्स OpenCart 3 के चरण 3 से 6 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Callback URL अलग है (देखें Paysera प्रोजेक्ट)।
नया इंस्टॉल भुगतान विधि बंद, टेस्ट भुगतान बंद और Production वातावरण के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Paysera Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज Paysera is hidden at checkout until the project ID and the project password are entered. दिखाता है जब इनमें से कोई एक खाली हो, और Test mode is on: customers are not charged. Turn off "Test payments" and select "Production" before accepting real orders. दिखाता है जब टेस्ट भुगतान या सैंडबॉक्स चालू हो। एक्सटेंशन बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Project ID में केवल अंक होने चाहिए, Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और ऑर्डर स्थितियाँ मौजूद होनी चाहिए। किसी भी जाँच में विफल होने पर कुछ भी सेव नहीं होता और पेज त्रुटियाँ सूचीबद्ध करता है।
Paysera
Enable/Disable: Enable Paysera Payment भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: Paysera। आवश्यक, 128 अक्षरों तक।
Description: वह पाठ जो ग्राहक Confirm Order चरण में, पुष्टि बटन के ऊपर देखते हैं। डिफ़ॉल्ट: Pay securely via Paysera।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Paysera की स्थिति। खाली छोड़ें या कोई पूर्ण संख्या दर्ज करें।
Geo Zone: Paysera केवल चुने हुए जियो ज़ोन के भुगतान पतों के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट होते हैं।
Total: चेकआउट कुल राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Paysera दिया जाए। किसी भी राशि पर Paysera देने के लिए खाली छोड़ें।
Paysera प्रोजेक्ट
प्रोजेक्ट ID और प्रोजेक्ट पासवर्ड आपके Paysera खाते में Projects and activities, अपने प्रोजेक्ट, General project settings के अंतर्गत मिलते हैं। इस सेक्शन में Paysera खाते का लिंक है।
Callback URL: वह पता जिससे Paysera हर भुगतान की पुष्टि करता है। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_paysera_payment/callback, और OpenCart 4 में: https://your-store/index.php?route=extension/wcp_paysera_payment/payment/wcp_paysera_payment.callback। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह हर भुगतान के साथ अपने-आप भेजा जाता है, इसलिए Paysera में कुछ सेट करने की ज़रूरत नहीं है, लेकिन यह इंटरनेट से पहुँच योग्य होना चाहिए। ऑर्डर अपनी स्थिति केवल इन हस्ताक्षरित या एन्क्रिप्टेड कॉलबैक से पाते हैं।
Project ID: आपके Paysera प्रोजेक्ट की संख्यात्मक ID। केवल अंक स्वीकार होते हैं: कोई और मान दर्ज करने पर Project ID must contain digits only: the numeric ID of your Paysera project. त्रुटि आती है और कुछ भी सेव नहीं होता।
Project password: प्रोजेक्ट पासवर्ड (हस्ताक्षर कुंजी)। यह भुगतान अनुरोधों पर हस्ताक्षर करता है और Paysera कॉलबैक को सत्यापित करता है। सेव किया गया पासवर्ड दोबारा कभी नहीं दिखाया जाता। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान लिखें जब उसे बदलना हो। सेव किया हुआ पासवर्ड हटाने के लिए, फ़ील्ड के नीचे Clear saved password (tick and save; an empty field keeps the saved value) पर टिक करें और Save पर क्लिक करें।
परीक्षण
Test payments: भुगतान टेस्ट मोड में भेजता है, इसलिए कोई राशि नहीं काटी जाती। Paysera ग्राहक से शुल्क लिए बिना सफल टेस्ट भुगतान लौटाता है। पहले Paysera प्रोजेक्ट सेटिंग्स में Allow test payments चालू करें। यह विकल्प चालू रहने पर टेस्ट भुगतान ऑर्डर को भुगतान किया हुआ चिह्नित करते हैं; बंद होने पर टेस्ट भुगतान ऑर्डर को होल्ड पर डाल देता है। डिफ़ॉल्ट: बंद। चालू रहने पर ग्राहक Confirm Order चरण पर TEST MODE — no money will be charged. देखते हैं।
Environment: ग्राहक को कहाँ भेजा जाता है। सामान्य Paysera प्रोजेक्ट के लिए Production रखें, टेस्ट भुगतानों के लिए भी। डिफ़ॉल्ट: Production।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्थिति केवल Paysera कॉलबैक से मिलती है। रद्द या निष्पादित न हुआ भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।
Order Status After Payment: जब Paysera अपेक्षित राशि और मुद्रा के साथ भुगतान की पुष्टि करे, तब सेट होने वाली स्थिति। डिफ़ॉल्ट: Processing।
Awaiting Payment Status: बैंक ने भुगतान आदेश स्वीकार कर लिया है, पर अभी निष्पादित नहीं किया। Paysera के भुगतान की पुष्टि करने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है। डिफ़ॉल्ट: Pending।
On Hold Status: Test payments बंद होने पर एक TEST भुगतान, अलग राशि या मुद्रा, या ग्राहक द्वारा रद्द करने के बाद का भुगतान। ऑर्डर को भुगतान किया हुआ नहीं चिह्नित किया जाता; एक नोट कारण बताता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Order Status: एक्सटेंशन यह स्थिति कभी सेट नहीं करता, केवल पढ़ता है: इस स्थिति वाले ऑर्डर के लिए आया भुगतान ऑर्डर को दोबारा नहीं खोलता, केवल एक नोट जोड़ता है। डिफ़ॉल्ट: Canceled।
उन्नत
Debug log: भुगतान घटनाओं को OpenCart के लॉग फ़ोल्डर (storage/logs) में wc_psr_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ और चेतावनियाँ हमेशा लिखी जाती हैं; बाकी चरण केवल तब लिखे जाते हैं जब यह विकल्प चालू हो। पासवर्ड और ग्राहक डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete data: चालू होने पर एक्सटेंशन अनइंस्टॉल करते समय उसकी सेटिंग्स और लॉग हटा दिए जाते हैं। ऑर्डर डेटा (ऑर्डर, Paysera भुगतान रिकॉर्ड) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। प्रोजेक्ट पासवर्ड निर्यात नहीं होता।
Import: पहले निर्यात किया गया JSON पेस्ट करें और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किया गया प्रोजेक्ट पासवर्ड बना रहता है।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Paysera)। Confirm Order चरण पर ग्राहक को आपका विवरण और नोट You will be redirected to the Paysera payment window (bank links, cards and other Paysera methods) to complete the payment. दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक Payment method options विंडो में भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन एक हस्ताक्षरित भुगतान अनुरोध बनाता है, जिसमें ऑर्डर नंबर, ऑर्डर मुद्रा की सबसे छोटी इकाई में कुल राशि, ग्राहक का नाम, ईमेल और बिलिंग पता, और स्टोर पेज की भाषा शामिल होती है (लिथुआनियाई, लातवियाई, एस्टोनियाई, रूसी, जर्मन, पोलिश; अन्यथा अंग्रेज़ी)। ग्राहक को Paysera भुगतान विंडो पर भेजा जाता है, जहाँ वह बैंक, कार्ड या कोई अन्य तरीका चुनता है।
Paysera भुगतान की पुष्टि सर्वर-से-सर्वर कॉलबैक से करता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Paysera उसे हस्ताक्षरित कॉलबैक से पुष्टि करे; ग्राहक का स्टोर पर लौटना कभी ऑर्डर का भुगतान नहीं करता। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। कॉलबैक के बाद ग्राहक लौटता है तो OpenCart की ऑर्डर सफलता पेज दिखती है। यदि बैंक ने भुगतान आदेश स्वीकार कर लिया है पर अभी निष्पादित नहीं किया, तो ऑर्डर को Awaiting Payment Status मिलता है और पेज पर Paysera is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. दिखता है। होल्ड पर ऑर्डर के लिए पेज पर Your payment is being reviewed. We will contact you if anything else is needed. दिखता है।
यदि ग्राहक कॉलबैक से पहले लौट आता है, तो एक Payment confirmation पेज दिखता है जो समझाता है कि Paysera के भुगतान की पुष्टि करते ही ऑर्डर कन्फ़र्म होगा, और Check again व Back to checkout विकल्प देता है।
यदि ग्राहक Paysera विंडो में रद्द कर दे, तो वह The Paysera payment was cancelled. You can try again or choose another payment method. संदेश के साथ चेकआउट पर लौटता है। यदि Paysera बताए कि भुगतान निष्पादित नहीं हुआ, तो संदेश है The payment was not completed. You can try again or choose another payment method. दोनों स्थितियों में कार्ट बना रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, जबकि OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है (नया प्रयास उसी ऑर्डर का भुगतान करता है); यदि उसी कार्ट का कोई और ऑर्डर पहले से भुगतान किया हुआ, भुगतान प्रतीक्षारत या होल्ड पर है, तो नया प्रयास दूसरे भुगतान के बजाय सीधे सफलता पेज पर जाता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा शामिल है, एक नया कार्ट माना जाता है जिसे अपने भुगतान की ज़रूरत है।
OpenCart 4 में ऑर्डर सफलता पेज दिखने तक चेकआउट में रहता है। यदि इस बीच वह ऑर्डर बंद हो गया (उदाहरण के लिए आपने बैंक भुगतान का इंतज़ार कर रहा ऑर्डर रद्द किया), तो ग्राहक Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. संदेश के साथ चेकआउट पर वापस भेज दिया जाता है। अगला Confirm Order एक नया ऑर्डर चुकाता है। यदि वह ऑर्डर पहले किसी पिछले कार्ट के लिए पहले ही चुकाया जा चुका है और तब से कार्ट बदल गया है, तो ग्राहक चेकआउट पर वापस ले जाया जाता है, और अगला Confirm Order वर्तमान कार्ट का नया ऑर्डर चुकाता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।
यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और Paysera payments are temporarily unavailable. Please choose another payment method. देखता है; या अमान्य ऑर्डर राशि के लिए This order cannot be paid via Paysera. देखता है। कारण लॉग में लिखा जाता है।
स्टोर रखरखाव मोड में होने पर भी कॉलबैक काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है (OpenCart 4 में एक्सटेंशन इसके लिए अपनी स्टार्टअप क्रिया जोड़ता है, जिससे ग्राहक Paysera से वापस भी आ सकता है)।
इस एक्सटेंशन में एडमिन से रिफ़ंड, चेकआउट पेज पर बैंक या भुगतान तरीका चुनने, सब्सक्रिप्शन, सेव्ड कार्ड, और Paysera की डिलीवरी या कूरियर सेवाएँ नहीं हैं।
ऑर्डर
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Paysera पर भेजा गया और कॉलबैक अभी नहीं आया, या ग्राहक ने रद्द किया, या भुगतान निष्पादित नहीं हुआ। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order Status After Payment (डिफ़ॉल्ट Processing): Paysera ने मेल खाती राशि और मुद्रा के साथ भुगतान की पुष्टि की। एक नोट अनुरोध और भुगतान तरीका दिखाता है, टेस्ट भुगतानों के लिए (TEST — no money charged) चिह्न के साथ।
Awaiting Payment Status (डिफ़ॉल्ट Pending): Paysera ने भुगतान आदेश स्वीकार कर लिया है, पर बैंक ने उसे अभी निष्पादित नहीं किया। Paysera के भुगतान की पुष्टि होने पर ऑर्डर Order Status After Payment पर चला जाता है।
On Hold Status (डिफ़ॉल्ट Pending): भुगतान को मैन्युअल समीक्षा चाहिए। चुकाई गई राशि या मुद्रा ऑर्डर कुल से अलग है; या Test payments बंद होने के दौरान एक TEST भुगतान आया (कोई राशि नहीं काटी गई); या ग्राहक द्वारा रद्द करने के बाद भुगतान की पुष्टि हुई। नोट इसे समझाता है, और ऑर्डर टैब आपसे कहता है कि Paysera खाते में भुगतान जाँचें, फिर ऑर्डर को भुगतान किए गए स्तर पर सेट करें या उसे रद्द करके Paysera में भुगतान रिफ़ंड करें। उसी ऑर्डर के लिए बाद में सही भुगतान आने पर वह भुगतान किया हुआ चिह्नित होता है।
Cancelled Order Status (डिफ़ॉल्ट Canceled): रद्द किए गए ऑर्डर के लिए बाद में पुष्टि किया गया भुगतान उसकी स्थिति नहीं बदलता। एक नोट आपसे ऑर्डर बहाल करने (उसे भुगतान किए गए स्तर पर सेट करने) या Paysera में भुगतान रिफ़ंड करने को कहता है। यदि ऑर्डर का भुगतान तरीका अब Paysera नहीं है, तो पुष्टि किया गया भुगतान केवल एक नोट जोड़ता है।
यदि पहले से भुगतान किए गए ऑर्डर के लिए, या पहले से भुगतान किए गए कार्ट के किसी और ऑर्डर के लिए, कोई और सफल भुगतान आता है, तो भुगतान किया हुआ ऑर्डर नहीं बदलता, और एक नोट आपसे अपने Paysera खाते में डुप्लिकेट रिफ़ंड करने को कहता है। अन्य Paysera स्थितियाँ (भुगतान निष्पादित नहीं, अतिरिक्त जानकारी) केवल एक नोट जोड़ती हैं। नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Paysera Payment टैब
Sales > Orders में Paysera से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Paysera Payment टैब Paysera order ID (ऑर्डर नंबर और प्रयास), Paysera request ID, Environment और TEST payment चिह्न, भुगतान की Status, Requested / paid राशियाँ, Payment method और एक्सटेंशन के Notes दिखाता है। होल्ड पर ऑर्डर के लिए यह दिखाता है कि क्या जाँचना है। यह टैब केवल जानकारी दिखाता है और उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।
रिफ़ंड
एडमिन से रिफ़ंड समर्थित नहीं हैं: Paysera भुगतान विंडो प्रोटोकॉल में रिफ़ंड API नहीं है। रिफ़ंड अपने Paysera खाते से करें। जब Paysera रिफ़ंड की सूचना दे, तो ऑर्डर में रिफ़ंड राशि वाला नोट जुड़ता है, और ऑर्डर स्थिति नहीं बदलती। ज़रूरत हो तो OpenCart में रिफ़ंड मैन्युअली दर्ज करें। Sales > Returns में उत्पाद वापसी से Paysera के ज़रिए पैसे वापस नहीं जाते।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Paysera Payment लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Paysera Payment > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) के साथ, और बटन दिखाता है: Check now (स्थिति दोबारा जाँचें), Change key (दूसरी कुंजी दर्ज करें) और Remove key (इस स्टोर से कुंजी हटाएँ)। इनके नीचे Product: opencart-payment-paysera की पंक्ति और लिंक 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, Paysera चेकआउट पर ग्राहकों को नहीं दिखाया जाता। फिर भी भुगतान शुरू हो तो ग्राहक को 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 ज़रूरी नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।
समस्या निवारण
चेकआउट पर Paysera दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और Project ID तथा Project password दोनों दर्ज हैं। इनमें से कोई एक खाली होने तक सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: ऑर्डर को अपनी स्थिति Paysera कॉलबैक से मिलती है, ग्राहक के लौटने से नहीं। जाँचें कि आपका स्टोर सेटिंग्स में दिखाए गए Callback URL पर इंटरनेट से पहुँच योग्य है (लॉगिन, बेसिक ऑथेंटिकेशन या फ़ायरवॉल के पीछे नहीं), और एक्सटेंशन पेज पर Log फ़ील्ड देखें।
कॉलबैक का उत्तर Invalid signature है: Project password प्रोजेक्ट से मेल नहीं खाता, या कॉलबैक Paysera से नहीं आया। प्रोजेक्ट पासवर्ड दोबारा कॉपी करें। यदि आपने प्रोजेक्ट या पासवर्ड बदला है, तो बदलाव से पहले शुरू किए गए भुगतान अब सत्यापित नहीं हो सकते।
कॉलबैक का उत्तर Project ID mismatch है: सेटिंग्स में Project ID उस प्रोजेक्ट से अलग है जिसने भुगतान किया।
कॉलबैक का उत्तर Order not found है: कॉलबैक के ऑर्डर का इस स्टोर में कोई Paysera भुगतान नहीं है, उदाहरण के लिए भुगतान उसी प्रोजेक्ट वाले किसी दूसरे स्टोर में शुरू हुआ था।
कॉलबैक का उत्तर Gateway not configured, Busy या Temporary error है: प्रोजेक्ट ID या पासवर्ड खाली है, उसी कार्ट के लिए कोई और कॉलबैक अभी चल रहा है, या ऑर्डर स्थिति सेट नहीं हो सकी। Paysera कॉलबैक दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।
Paysera भुगतान विंडो अस्वीकार करता है या कहता है कि प्रोजेक्ट मौजूद नहीं है: Environment जाँचें। सामान्य Paysera प्रोजेक्ट केवल Production के साथ काम करता है; Sandbox के लिए Paysera सैंडबॉक्स वातावरण में बना प्रोजेक्ट चाहिए।
टेस्ट भुगतान ऑर्डर का भुगतान नहीं करता: एक TEST भुगतान ऑर्डर का भुगतान केवल तब करता है जब Test payments चालू हो। अन्यथा ऑर्डर होल्ड पर चला जाता है, एक नोट के साथ कि कोई राशि नहीं काटी गई। Paysera प्रोजेक्ट में Allow test payments भी चालू करें।
ऑर्डर राशि या मुद्रा मेल न खाने के नोट के साथ होल्ड पर है: Paysera ने ऐसे भुगतान की पुष्टि की है जिसकी राशि या मुद्रा ऑर्डर कुल से अलग है। अपने Paysera खाते में भुगतान मिलाएँ और ऑर्डर स्वीकार करें या भुगतान मैन्युअली रिफ़ंड करें।
ग्राहक को Paysera payments are temporarily unavailable दिखता है: Log फ़ील्ड देखें। प्रोजेक्ट ID या पासवर्ड खाली हो सकता है, या Paysera को भेजे गए स्टोर पतों में से कोई 255 अक्षरों से लंबा हो सकता है।
ग्राहक को This payment method is not available. Please reload the checkout page. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट दोबारा लोड करे।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Paysera Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और वह स्टार्टअप क्रिया भी, जो मेंटेनेंस मोड में कॉलबैक और ग्राहक की वापसी को आगे जाने देती है)। यदि Delete data चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, प्रोजेक्ट ID और पासवर्ड, टेस्ट, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए वे रखे जाते हैं। Paysera भुगतान रिकॉर्ड हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Paysera Payment के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Paysera अपने-अपने मालिक का ट्रेडमार्क है। यह एक्सटेंशन Paysera से संबद्ध नहीं है और Paysera द्वारा समर्थित नहीं है।