VibeFox Moyasar for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: चेकआउट की मुद्रा SAR, AED, USD, EUR, KWD, BHD या OMR होनी चाहिए। किसी अन्य मुद्रा के लिए चेकआउट पर भुगतान विधि छिपा दी जाती है।
Moyasar खाता: आपको अपने Moyasar खाते की सीक्रेट API कुंजियाँ (टेस्ट और लाइव) चाहिए। केवल सीक्रेट कुंजियाँ उपयोग होती हैं। पब्लिशेबल कुंजी (publishable key) की आवश्यकता नहीं है, क्योंकि भुगतान Moyasar के पेज पर होता है। Moyasar Dashboard में एक वेबहुक जोड़ने की सलाह दी जाती है (देखें कॉन्फ़िगरेशन)।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी केवल एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ज़िप फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनपैक करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_moyasar_payment_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में जाएँ Extensions > Installer, Upload पर क्लिक करें और फ़ाइल wcp_moyasar_payment_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की आवश्यकता नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Moyasar Payment Gateway खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी को पेज के ऊपर के लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. अपनी Moyasar सीक्रेट कुंजियाँ चिपकाएँ और Save पर क्लिक करें। पहली बार सेव करने पर वेबहुक का साझा सीक्रेट बनता है और सेटिंग्स के ऊपर एक बार दिखाया जाता है। इसी से Moyasar Dashboard में वेबहुक सेट करें (देखें कॉन्फ़िगरेशन)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट मोड में एक परीक्षण ऑर्डर दें, फिर Test mode बंद करें।
OpenCart 4
1. एडमिन में जाएँ Extensions > Installer, Upload पर क्लिक करें और फ़ाइल wcp_moyasar_payment_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज इसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Moyasar Payment Gateway खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।
4. लाइसेंस कुंजी, Moyasar कुंजियाँ और वेबहुक उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Webhook URL अलग है (देखें Webhook URL)।
नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब वर्तमान मोड में सीक्रेट कुंजी न हो (तब चेकआउट पर भुगतान विधि छिपी रहती है), जब सेव किया गया वेबहुक साझा सीक्रेट न हो (तब वेबहुक हर कॉल को अस्वीकार करता है), या जब स्टोर की डिफ़ॉल्ट मुद्रा समर्थित न हो। जब एक्सटेंशन टेस्ट मोड में सक्षम होता है, तो यह टेस्ट मोड सक्रिय है: भुगतान सिमुलेट किए जाते हैं, कोई राशि नहीं काटी जाती। दिखाता है। एक्सटेंशन में बदलाव करने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ स्वीकार्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता। एक्सटेंशन पब्लिशेबल कुंजी, दूसरे मोड की कुंजी या स्पेस वाली कुंजी को अस्वीकार करता है: बाकी सेटिंग्स सेव हो गईं, सिवाय लाल रंग में दिखाई गई कुंजी के। के साथ सेव होती है, पिछली कुंजी बनी रहती है और कारण दिखाया जाता है। यदि एक्सटेंशन को वर्तमान मोड की सीक्रेट कुंजी के बिना सक्षम किया जाए, तो सेटिंग्स चेतावनी के साथ सेव होती हैं।
Moyasar
Enable/Disable: Enable Moyasar भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यह ऑर्डर में भी सेव होता है। डिफ़ॉल्ट: Pay with Moyasar। आवश्यक, 128 अक्षरों तक।
Description: वह पाठ जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. टेस्ट मोड में यह चरण (टेस्ट मोड: कोई वास्तविक भुगतान नहीं किया जाता।) जोड़ता है।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Moyasar की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।
Geo Zone: Moyasar केवल चुने गए जियो ज़ोन में स्थित भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह कुल राशि, जिस तक पहुँचने पर ही Moyasar दिखाया जाएगा। किसी भी कुल राशि के लिए Moyasar दिखाने हेतु इसे खाली छोड़ें।
API कुंजियाँ
सीक्रेट कुंजियाँ Moyasar Dashboard > Settings > API Keys से कॉपी करें (पेज पर वहाँ का लिंक है)। टेस्ट और लाइव कुंजियाँ अलग-अलग हैं। टेस्ट मोड केवल टेस्ट कुंजी का, और लाइव मोड केवल लाइव कुंजी का उपयोग करता है।
Test mode: टेस्ट सीक्रेट कुंजी का उपयोग करता है: भुगतान सिमुलेट होते हैं और कोई राशि नहीं काटी जाती। डिफ़ॉल्ट: चालू। असली भुगतान स्वीकार करने के लिए लाइव सीक्रेट कुंजी के साथ इसे बंद करें। दूसरे मोड के इनवॉइस स्थिति जाँच और रिफ़ंड के लिए अपने मोड की कुंजी का ही उपयोग करते रहते हैं।
Test secret key: टेस्ट मोड की सीक्रेट कुंजी। यह sk_test_ से शुरू होती है।
Live secret key: लाइव मोड की सीक्रेट कुंजी। यह sk_live_ से शुरू होती है।
सेव की गई कुंजियाँ और सीक्रेट फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सेव किया गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल तभी नया मान टाइप करें जब उसे बदलना हो। सेव किया गया मान हटाने के लिए, फ़ील्ड के नीचे Clear the saved value on save को चुनें और Save पर क्लिक करें।
भुगतान सूचनाएँ (वेबहुक)
वेबहुक की सलाह दी जाती है, पर यह अनिवार्य नहीं है। ऑर्डर तब भी पुष्ट होते हैं जब ग्राहक स्टोर पर लौटता है, और उस इनवॉइस सूचना से भी जो Moyasar इनवॉइस भुगतान होने पर आपके स्टोर को अपने-आप भेजता है। वेबहुक उन ग्राहकों को भी कवर करता है जो लौटने से पहले ब्राउज़र बंद कर देते हैं, और Moyasar Dashboard में किए गए रिफ़ंड की भी सूचना देता है। इसे Moyasar Dashboard > Settings > Webhooks में जोड़ें।
Webhook URL: एक Copy बटन के साथ केवल-पढ़ने योग्य दिखाया जाता है। OpenCart 3 पर यह कुछ इस रूप का होता है: https://your-store/index.php?route=extension/payment/wcp_moyasar_payment_gateway/webhook, OpenCart 4 पर इस रूप का: https://your-store/index.php?route=extension/wcp_moyasar_payment_gateway/payment/wcp_moyasar_payment_gateway.webhook। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। HTTP मेथड: POST। यह URL इंटरनेट से पहुँच योग्य होना चाहिए।
Webhook shared secret: Moyasar में वेबहुक के Shared secret के समान मान दर्ज करें, या Generate a new secret पर टिक करें और सेव करें। यदि कुछ सेव नहीं है, तो Save एक यादृच्छिक सीक्रेट बनाता है। बनाया गया सीक्रेट सेव करने के बाद सेटिंग्स के ऊपर केवल एक बार दिखाया जाता है और फिर कभी नहीं, इसलिए इसे तुरंत Moyasar में कॉपी करें। सही साझा सीक्रेट के बिना वेबहुक अस्वीकार हो जाते हैं। एक ही साझा सीक्रेट दोनों मोड के लिए काम करता है।
वेबहुक के लिए ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):
किसी वेबहुक या सूचना की कोई भी जानकारी सीधे भरोसेमंद नहीं मानी जाती: हर एक के लिए, एक्सटेंशन इनवॉइस को उस मोड की सीक्रेट कुंजी के साथ Moyasar API से पढ़ता है जिसमें इनवॉइस बनाया गया था, और जाँचता है कि उसे इसी स्टोर ने बनाया था। उसी Moyasar खाते पर दूसरे एकीकरणों के भुगतान अनदेखे किए जाते हैं।
ऑर्डर
OpenCart, Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (अधूरा ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Moyasar इनवॉइस की पुष्टि कर दे। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची दिखाता है।
Status after payment: पुष्ट भुगतान के बाद सेट होने वाली स्थिति। डिफ़ॉल्ट: प्रसंस्करण में। यदि भुगतान किए गए ऑर्डर तुरंत पूरे होने चाहिए तो Complete चुनें, या यदि हर भुगतान किए गए ऑर्डर को मैन्युअल जाँच का इंतज़ार करना चाहिए तो अपनी समीक्षा स्थिति चुनें।
Awaiting Moyasar payment status: Moyasar भुगतान को समीक्षा के लिए रोक देता है; जब Moyasar उसकी पुष्टि करता है, तो ऑर्डर Status after payment पर चला जाता है। डिफ़ॉल्ट: लंबित।
Moyasar payment on hold status: Moyasar ने ऑर्डर के कुल से अलग राशि या मुद्रा बताई, या ऑर्डर के रद्द होने या किसी दूसरी स्थिति में जाने के बाद इनवॉइस का भुगतान हुआ। ऑर्डर को भुगतान पूर्ण चिह्नित नहीं किया जाता। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्वयं की स्थिति बना सकते हैं और यहाँ चुन सकते हैं।
Payment error status: समीक्षा में चल रहा भुगतान विफल हो गया। डिफ़ॉल्ट: विफल।
Refunded status: ऑर्डर पेज से भुगतान की पूरी राशि रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: रिफ़ंड किया गया।
उन्नत
Debug log: API कॉल और सूचनाएँ OpenCart के लॉग फ़ोल्डर (storage/logs) में moyasar_p_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे moyasar_p_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। API कुंजियाँ, कार्ड डेटा और ग्राहक का विवरण कभी दर्ज नहीं होता। डिफ़ॉल्ट: बंद।
Log: लॉग का वर्तमान आकार और उसकी नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Clean uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर के साथ सेव किए गए भुगतान विवरण (Moyasar इनवॉइस और भुगतान ID) रखे जाते हैं, ताकि रिफ़ंड का पता लगाया जा सके। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। कुंजियाँ और सीक्रेट निर्यात नहीं होते।
Import: पहले से निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई कुंजियाँ और सीक्रेट सुरक्षित रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Pay with Moyasar)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, जो अब भी बिना स्थिति के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक Moyasar इनवॉइस बनाता है और ग्राहक को उसके भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके Moyasar खाते में सक्रिय किसी भी तरीके से भुगतान करता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, विंडो Payment method options में, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। इनवॉइस पर Order #, ऑर्डर नंबर और आपके स्टोर का नाम दिखता है।
ऑर्डर को भुगतान पूर्ण चिह्नित तभी किया जाता है जब Moyasar उसकी पुष्टि कर दे: एक्सटेंशन Moyasar API से इनवॉइस पढ़ता है और जाँचता है कि वह भुगतान हो चुका है, इसी ऑर्डर का है, और उसकी राशि व मुद्रा ऑर्डर से बिल्कुल मेल खाती है। फिर ऑर्डर को OpenCart के मानक तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart की ऑर्डर सफलता वाली पृष्ठ दिखता है, जिसमें Moyasar के साथ आपका भुगतान प्राप्त हो गया है। लिखा होता है। यदि Moyasar भुगतान को समीक्षा के लिए रोकता है, तो पेज Moyasar आपके भुगतान की समीक्षा कर रहा है। Moyasar की पुष्टि होते ही ऑर्डर अपने-आप अपडेट हो जाएगा — कृपया दोबारा भुगतान न करें। दिखाता है। यदि ऑर्डर आपकी समीक्षा के लिए रोका गया है, तो पेज हमें आपका भुगतान मिल गया है और हम आपके ऑर्डर की समीक्षा कर रहे हैं। यदि कुछ आवश्यक हुआ तो हम आपसे संपर्क करेंगे — कृपया दोबारा भुगतान न करें। दिखाता है। यदि समीक्षा में चल रहा भुगतान बाद में विफल होता है, तो पेज Moyasar के साथ आपका भुगतान पूरा नहीं हुआ। कृपया इस ऑर्डर के बारे में हमसे संपर्क करें। दिखाता है।
यदि ग्राहक बिना भुगतान किए लौटता है (उदाहरण के लिए भुगतान पेज के बैक बटन से), तो वह इनमें से किसी एक संदेश के साथ चेकआउट पर लौट आता है: Moyasar पर भुगतान पूरा नहीं हुआ। आप दोबारा प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं।, Moyasar पर आपका भुगतान अस्वीकार हो गया या समय सीमा समाप्त हो गई। कृपया दोबारा प्रयास करें या कोई दूसरी भुगतान विधि चुनें। या, जब भुगतान की जाँच अभी संभव न हो, तो हम अभी आपके भुगतान की Moyasar पर पुष्टि नहीं कर पाए। यदि आपने भुगतान पूरा किया है, तो कुछ मिनटों में ऑर्डर अपने-आप अपडेट हो जाएगा — दोबारा भुगतान करने से पहले कृपया अपना ईमेल देखें। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है।
ग्राहक दोबारा प्रयास कर सकता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसी ऑर्डर का फिर से भुगतान होता है। एक्सटेंशन पहले उसी कार्ट के खुले इनवॉइस जाँचता है: यदि इस ऑर्डर का खुला भुगतान पेज अब भी वही मोड, राशि और मुद्रा रखता है, तो उसे दोबारा उपयोग किया जाता है; अन्यथा पुराना इनवॉइस Moyasar पर रद्द कर दिया जाता है और नया बनाया जाता है, ताकि पुराने का भुगतान अब न हो सके। यदि कार्ट का कोई पिछला इनवॉइस पहले से भुगतान किया हुआ निकलता है, तो नया भुगतान बनाने के बजाय वही भुगतान पुष्ट होता है।
OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया या उसका भुगतान विफल हुआ), तो ग्राहक Your previous order was cancelled or its payment failed. Please confirm the order again. के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर भुगतान करता है। जो ऑर्डर भुगतान के बाद रद्द या रिफ़ंड हुआ, वह कार्ट को अब नहीं रोकता।
यदि Moyasar भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बना रहता है, बटन के ऊपर एक छोटा संदेश होता है, जैसे Moyasar भुगतान सेवा प्रतिक्रिया नहीं दे रही है। कृपया कुछ मिनटों में फिर से प्रयास करें। और वह कोई दूसरी भुगतान विधि चुन सकता है। विवरण लॉग में लिखे जाते हैं।
वेबहुक और इनवॉइस सूचना तब भी काम करते हैं जब स्टोर रखरखाव मोड में हो, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को गुज़रने देता है, और OpenCart 4 पर एक्सटेंशन उनके लिए एक स्टार्टअप एक्शन (startup action) जोड़ता है, जो ग्राहक को Moyasar से लौटने भी देता है।
यह एक्सटेंशन केवल Moyasar के पेज पर एकल भुगतान स्वीकार करता है। आपके अपने चेकआउट पर कोई कार्ड फ़ॉर्म नहीं है, सेव किए गए कार्ड या टोकनाइज़ेशन नहीं हैं, सब्सक्रिप्शन नहीं हैं, और अलग-अलग ऑथराइज़ और कैप्चर नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (अधूरा ऑर्डर): ग्राहक को Moyasar पर भेजा गया और उसने भुगतान नहीं किया, Moyasar ने अभी भुगतान की पुष्टि नहीं की, या भुगतान अस्वीकार, समय-सीमा समाप्त या रद्द हो गया। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर को Missing Orders पर सेट किया गया हो।
Status after payment (डिफ़ॉल्ट प्रसंस्करण में): भुगतान की पुष्टि हुई। एक नोट दिखाता है कि भुगतान कैसे पुष्ट हुआ (वेबहुक, इनवॉइस सूचना, ग्राहक की वापसी या चेकआउट), इनवॉइस ID, भुगतान ID और भुगतान विधि, उदाहरण के लिए कार्ड ब्रांड और अंतिम चार अंक।
Awaiting Moyasar payment status (डिफ़ॉल्ट लंबित): Moyasar भुगतान को समीक्षा के लिए रोकता है। जब Moyasar भुगतान की पुष्टि करता है तो ऑर्डर Status after payment पर जाता है, और जब भुगतान विफल होता है तो Payment error status पर।
Moyasar payment on hold status (डिफ़ॉल्ट लंबित): Moyasar ने ऑर्डर के कुल से अलग राशि या मुद्रा बताई, या आपके ऑर्डर रद्द करने या उसकी स्थिति बदलने के बाद इनवॉइस का भुगतान हुआ। ऑर्डर को भुगतान पूर्ण चिह्नित नहीं किया जाता, लेकिन वास्तव में काटी गई राशि रिफ़ंड के लिए दर्ज की जाती है। नोट इसका कारण समझाता है। Moyasar Dashboard में भुगतान जाँचें और फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Payment error status (डिफ़ॉल्ट विफल): समीक्षा में चल रहा भुगतान विफल हो गया।
Refunded status (डिफ़ॉल्ट रिफ़ंड किया गया): भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड किया गया।
भुगतान किए गए या रिफ़ंड किए गए ऑर्डर बाद की घटनाओं से कभी वापस नहीं बदलते। यदि आपने खुद पहले से कोई भुगतान-पूर्ण स्थिति सेट की है, तो भुगतान दर्ज होता है, पर स्थिति नहीं बदलती। यदि पहले से भुगतान किए गए कार्ट का दूसरा इनवॉइस भी भुगतान हो जाता है (उदाहरण के लिए दो ब्राउज़र टैब से), तो भुगतान किया गया ऑर्डर नहीं बदलता। एक नोट आपको Moyasar Dashboard में दोहरे भुगतान को रिफ़ंड करने के लिए कहता है।
नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक नहीं देखता।
VibeFox Moyasar Payment Gateway टैब
Sales > Orders में Moyasar से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Moyasar Payment Gateway टैब में Moyasar invoice (परीक्षण भुगतानों के लिए Test mode लेबल के साथ), Moyasar payment, Method, Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Moyasar notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
VibeFox Moyasar Payment Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह पहले से भरी होगी), वैकल्पिक रूप से Reason (optional) लिखें, और Refund via Moyasar पर क्लिक करें। क्या यह राशि Moyasar के माध्यम से रिफ़ंड करनी है? इसे पलटा नहीं जा सकता। प्रश्न की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन में बदलाव करने का अधिकार होना चाहिए (जो System > Users > User Groups में सेट होता है)। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो Moyasar ने काटी थी। इसलिए राशि में अंतर होने के बाद आप ऑर्डर कुल के बजाय उतनी ही राशि रिफ़ंड कर सकते हैं जितनी ग्राहक ने वास्तव में चुकाई थी। 2 घंटे से कम पहले हुए कार्ड भुगतान का पूर्ण रिफ़ंड void के रूप में भेजा जाता है (सेटलमेंट से पहले रद्द करना, कोई शुल्क नहीं); STC Pay भुगतान और अन्य सभी मामलों में रिफ़ंड सामान्य रूप से होता है। रिफ़ंड उस मोड (टेस्ट या लाइव) की सीक्रेट कुंजी का उपयोग करता है जिसमें भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। एक्सटेंशन पहले Moyasar पर भुगतान की मुद्रा, स्थिति और रिफ़ंड-योग्य राशि जाँचता है। यदि Moyasar रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड या void रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में लौटाए, जैसे मैन्युअल स्थिति परिवर्तन होता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब Moyasar भुगतान की पुष्टि कर दे।
Sales > Returns में उत्पाद वापसी से Moyasar के माध्यम से पैसे वापस नहीं जाते।
Moyasar Dashboard में किए गए रिफ़ंड और void वेबहुक के द्वारा आते हैं। यदि Moyasar एक्सटेंशन द्वारा दर्ज की गई राशि से अधिक रिफ़ंड राशि दिखाता है, तो ऑर्डर में एक नोट जोड़ा जाता है। ऑर्डर की स्थिति अपने-आप नहीं बदलती। आवश्यकता होने पर Refund via Moyasar का उपयोग किए बिना उसे मैन्युअल रूप से अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Moyasar Payment Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Moyasar Payment Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क किए हुए रूप में, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-moyasar वाली पंक्ति और वह लिंक है जो आपका vibefox.net खाता खोलता है, Manage licenses and domains in your account। केवल वे एडमिन उपयोगकर्ता कुंजी बदल सकते हैं जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के पाठ एडमिन की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।
एक कुंजी केवल एक डोमेन पर काम करती है। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना चेकआउट पर Moyasar ग्राहकों को नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन किया हुआ एडमिन उपयोगकर्ता अब भी स्टोर में भुगतान विधि देखता है, जिस पर (unlicensed — visible to admins only) का निशान लगा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन के Dashboard पर एक अनुस्मारक दिखाई देता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं उनकी पुष्टि अब भी होती है, और रिफ़ंड काम करते हैं।
जब लाइसेंस की समय सीमा समाप्त होती है, तब एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीकरण आवश्यक है। जब आप एडमिन के Dashboard या Edit पेज को खोलते हैं, तब स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक दिन में एक बार, फिर सप्ताह में एक बार। cron जॉब की आवश्यकता नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
Moyasar चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में सीक्रेट कुंजी है: टेस्ट मोड में Test secret key, लाइव मोड में Live secret key। कुंजी गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। ग्राहक को SAR, AED, USD, EUR, KWD, BHD या OMR में भुगतान करना होगा (स्टोर में चुनी गई मुद्रा)। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्थिति के रह गया: पुष्टियाँ आपके स्टोर तक नहीं पहुँचीं। वेबहुक सेट करें: Moyasar Dashboard में जाँचें कि वह मौजूद है, उसका URL बिल्कुल सेटिंग्स के Webhook URL जैसा है, मेथड POST है, चारों इवेंट चुने गए हैं, और उसका शेयर्ड सीक्रेट Webhook shared secret में सेव किए गए सीक्रेट के बराबर है। ऑर्डर को स्थिति तब भी मिलती है जब ग्राहक स्टोर पर लौटता है या वही कार्ट दोबारा भुगतान करने की कोशिश करता है।
वेबहुक का उत्तर Unauthorized है: Moyasar में शेयर्ड सीक्रेट सेव किए गए से अलग है। Moyasar वेबहुक का सीक्रेट Webhook shared secret में टाइप करें और सेव करें, या Generate a new secret पर टिक करें, सेव करें और दिखाया गया सीक्रेट Moyasar में चिपकाएँ।
वेबहुक का उत्तर Webhook secret not configured है: कोई शेयर्ड सीक्रेट सेव नहीं है, उदाहरण के लिए Clear the saved value on save से हटाने के बाद। उसे बनाने के लिए Save पर क्लिक करें और Moyasar में कॉपी करें।
वेबहुक का उत्तर Key not configured है: इनवॉइस ऐसे मोड (टेस्ट या लाइव) में बना था जिसकी सीक्रेट कुंजी खाली है। वह कुंजी दर्ज करें।
वेबहुक का उत्तर Verification failed या Try again later है: Moyasar API से इनवॉइस नहीं पढ़ा जा सका, उसी क्षण कार्ट दूसरे अनुरोध से अपडेट हो रहा था, या ऑर्डर स्थिति सेट नहीं हो सकी। Moyasar वेबहुक फिर से भेजेगा। कारण देखने के लिए Debug log चालू करें।
वेबहुक URL को ब्राउज़र में खोलने पर Method not allowed दिखता है: यह सामान्य है। यह URL केवल Moyasar से आने वाले POST अनुरोध स्वीकार करता है।
कुंजी से जुड़ी सेव-त्रुटि: कोई पब्लिशेबल कुंजी (pk_...) या दूसरे मोड की कुंजी चिपकाई गई, या कुंजी में स्पेस हैं। पिछला मान बना रहा। टेस्ट कुंजियाँ sk_test_ से, लाइव कुंजियाँ sk_live_ से शुरू होती हैं।
Confirm Order के बाद ग्राहक को त्रुटि दिखती है: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। This payment method is not available. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक चेकआउट को फिर से लोड करता है। This payment method is temporarily unavailable. Please choose another payment method or contact us. आम तौर पर गलत या गायब सीक्रेट कुंजी का संकेत है। A payment for this order has already been received and is being reviewed. Please contact us instead of paying again. का अर्थ है कि कार्ट में पहले से एक भुगतान-पूर्ण इनवॉइस है जिसकी ऑर्डर स्थिति सेट नहीं हो सकी; लॉग देखें।
भुगतान के बाद ऑर्डर रोके गए स्थिति में है: VibeFox Moyasar Payment Gateway टैब के Moyasar notes पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: भुगतान अभी तक पुष्ट नहीं हुआ है, वह पूरी तरह रिफ़ंड हो चुका है, या आपके उपयोगकर्ता समूह के पास एक्सटेंशन में बदलाव करने का अधिकार नहीं है।
रिफ़ंड विफल होता है: संदेश पढ़ें। यदि भुगतान दूसरे मोड में हुआ था, तो उस मोड की सीक्रेट कुंजी दर्ज करें। यदि राशि Moyasar पर अभी रिफ़ंड-योग्य राशि से अधिक है, तो भुगतान का कुछ हिस्सा पहले ही रिफ़ंड हो चुका है, उदाहरण के लिए Moyasar Dashboard में। यदि Moyasar ने रिफ़ंड की गई राशि की पुष्टि नहीं की है, तो दोबारा कोशिश करने से पहले Moyasar Dashboard में भुगतान जाँचें।
डेवलपर्स के लिए: एक्सटेंशन समर्थित मुद्राओं और इनवॉइस डेटा को बदलने के लिए OpenCart इवेंट moyasar_p_supported_currencies और moyasar_p_invoice_params ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Moyasar Payment Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total, और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर इसके इवेंट और इसका स्टार्टअप एक्शन भी, जो रखरखाव मोड में वेबहुक को गुज़रने देता है)। यदि Clean uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, कुंजियाँ, वेबहुक शेयर्ड सीक्रेट, डीबग लॉग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। Moyasar के इनवॉइस, भुगतान और रिफ़ंड रिकॉर्ड हमेशा रखे जाते हैं, इसलिए पुराने ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Moyasar Payment Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Moyasar अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Moyasar से संबद्ध नहीं है और न ही Moyasar द्वारा समर्थित है।