VibeFox Moyasar for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। पुराने WooCommerce के साथ प्लगइन एक सूचना दिखाता है और लोड नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: स्टोर या ऑर्डर की मुद्रा SAR, AED, USD, EUR, KWD, BHD या OMR होनी चाहिए। किसी अन्य मुद्रा के लिए चेकआउट पर यह भुगतान तरीका छिपा रहता है।
Moyasar खाता: आपको अपने Moyasar खाते की सीक्रेट API कुंजियाँ (टेस्ट और लाइव) चाहिए। केवल सीक्रेट कुंजियाँ इस्तेमाल होती हैं। पब्लिशेबल कुंजी की ज़रूरत नहीं है, क्योंकि भुगतान Moyasar पेज पर होता है। Moyasar Dashboard में webhook की सलाह दी जाती है (देखें कॉन्फ़िगरेशन)।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_moyasar_payment_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Moyasar > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. अपनी Moyasar सीक्रेट कुंजियाँ पेस्ट करें और सेव करें। सेटिंग्स में दिखाए गए URL और शेयर्ड सीक्रेट के साथ Moyasar Dashboard में webhook सेट करें (देखें कॉन्फ़िगरेशन)।
6. Enable/Disable चालू करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर Test mode का निशान हटा दें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Moyasar। पेज के शीर्षक पर TEST MODE या LIVE बैज दिखता है। फ़ील्ड्स के ऊपर, यदि मौजूदा मोड में सीक्रेट कुंजी नहीं है (तब चेकआउट पर भुगतान तरीका छिपा रहता है) या स्टोर की मुद्रा समर्थित नहीं है, तो पेज चेतावनी देता है, और टेस्ट मोड चालू होने पर Test mode is active: payments are simulated, no money is charged. दिखाता है। भुगतान तरीकों की सूची में, जब तक मौजूदा मोड की सीक्रेट कुंजी नहीं डाली जाती, Moyasar को सेटअप की ज़रूरत वाले के रूप में चिह्नित किया जाता है। सेव करते समय प्लगइन पब्लिशेबल कुंजी, दूसरे मोड की कुंजी या स्पेस वाली कुंजी को अस्वीकार करता है, पिछला मान रखता है और कारण दिखाता है। यदि गेटवे चालू है पर मौजूदा मोड की सीक्रेट कुंजी खाली है, तो यह चेतावनी भी देता है।
सामान्य
Enable/Disable: Enable Moyasar भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का नाम। डिफ़ॉल्ट: Pay with Moyasar।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: You will be redirected to the secure Moyasar payment page to pay with mada, Visa, Mastercard, Apple Pay or STC Pay. टेस्ट मोड में चेकआउट (Test mode: no real payment is made.) जोड़ता है।
API कुंजियाँ
सीक्रेट कुंजियाँ Moyasar Dashboard > Settings > API Keys से कॉपी करें। टेस्ट और लाइव कुंजियाँ अलग-अलग हैं। टेस्ट मोड केवल टेस्ट कुंजी, और लाइव मोड केवल लाइव कुंजी इस्तेमाल करता है।
Test mode: Enable test mode टेस्ट सीक्रेट कुंजी इस्तेमाल करता है: भुगतान सिमुलेट होते हैं और कोई पैसा नहीं काटा जाता। डिफ़ॉल्ट: चालू। असली भुगतान लाइव सीक्रेट कुंजी से लेने के लिए इसे बंद करें।
Test secret key: टेस्ट मोड की सीक्रेट कुंजी। यह sk_test_ से शुरू होती है।
Live secret key: लाइव मोड की सीक्रेट कुंजी। यह sk_live_ से शुरू होती है।
भुगतान सूचनाएँ (webhook)
Webhook की सलाह दी जाती है, पर यह अनिवार्य नहीं है। ऑर्डर तब भी पुष्ट होते हैं जब ग्राहक स्टोर पर लौटता है और जब इनवॉइस का भुगतान होने पर Moyasar अपने आप आपके स्टोर को इनवॉइस सूचना भेजता है। Webhook उन ग्राहकों को भी कवर करता है जो लौटने से पहले ब्राउज़र बंद कर देते हैं, और Moyasar Dashboard में किए गए रिफ़ंड के बारे में आपको बताता है। Moyasar Dashboard > Settings > Webhooks में इस सेक्शन का URL और शेयर्ड सीक्रेट डालकर webhook जोड़ें, HTTP मेथड POST हो।
Webhook URL: केवल-पठन रूप में, Copy बटन के साथ दिखता है। यह कुछ इस तरह दिखता है: https://your-site/wp-json/moyasar_p/v1/webhook। HTTP मेथड: POST।
Webhook shared secret: Moyasar में webhook के Shared secret वाला ही मान डालें। इसे खाली छोड़कर सेव करने पर एक रैंडम सीक्रेट बनता है; फिर Show पर क्लिक करके उसे Moyasar में कॉपी करें। सही शेयर्ड सीक्रेट के बिना webhook अस्वीकार हो जाते हैं।
Webhook के लिए ये इवेंट चुनें:
किसी भी webhook या सूचना पर सीधे भरोसा नहीं किया जाता: हर एक के लिए प्लगइन ऑर्डर के मोड की सीक्रेट कुंजी से Moyasar API पर इनवॉइस पढ़ता है और जाँचता है कि वह इसी ऑर्डर के लिए बना था। उसी Moyasar खाते पर दूसरे एकीकरणों के भुगतान अनदेखे किए जाते हैं।
ऑर्डर
Status after payment: पुष्ट भुगतान के बाद ऑर्डर का स्टेटस। स्टेटस तुरंत सेट होता है, दूसरे स्टेटस बदलाव के बिना।
उन्नत
Debug log: Log API calls and notifications विवरण WooCommerce > Status > Logs में लिखता है, स्रोत wcp_moyasar_payment_gateway। त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजियाँ, कार्ड डेटा और ग्राहक का विवरण कभी दर्ज नहीं होता। डिफ़ॉल्ट: बंद।
Clean uninstall: Delete the plugin settings and logs when the plugin is deleted। ऑर्डर पर सहेजी गई भुगतान जानकारी (Moyasar इनवॉइस और भुगतान ID) रखी जाती है, ताकि रिफ़ंड का पता लगाया जा सके। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Pay with Moyasar) और ऑर्डर देता है। प्लगइन ऑर्डर की राशि के लिए ऑर्डर की मुद्रा में एक Moyasar इनवॉइस बनाता है और ग्राहक को उसके भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके Moyasar खाते में सक्रिय किसी भी तरीके से भुगतान करता है, जैसे mada, Visa, Mastercard, Apple Pay या STC Pay। इनवॉइस पर Order, ऑर्डर नंबर और आपकी साइट का नाम दिखता है।
ऑर्डर केवल Moyasar की पुष्टि के बाद भुगतान किया हुआ चिह्नित होता है: प्लगइन Moyasar API से इनवॉइस पढ़ता है और जाँचता है कि वह भुगतान हो चुका है, इसी ऑर्डर का है, और उसकी राशि व मुद्रा ऑर्डर से बिल्कुल मेल खाती है। भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्ति पेज पर लौट आता है। यदि ग्राहक बिना भुगतान किए लौटता है (उदाहरण के लिए भुगतान पेज के बैक बटन से), तो वह चेकआउट या Pay for order पेज पर इन संदेशों में से किसी एक के साथ लौटता है: The payment at Moyasar was not completed. You can try again or choose another payment method., Your Moyasar payment was declined or has expired. Please try again or choose another payment method., या जब भुगतान अभी जाँचा नहीं जा सकता, तो We could not confirm your payment with Moyasar yet. If you completed the payment, the order will be updated automatically in a few minutes — please check your e-mail before paying again.
ग्राहक बिना भुगतान वाले ऑर्डर का दोबारा भुगतान कर सकता है। यदि ऑर्डर का खुला भुगतान पेज अब भी वही राशि और मुद्रा रखता है, तो वही पेज दोबारा इस्तेमाल होता है। यदि ऑर्डर की कुल राशि बदल गई है, तो पुराना भुगतान पेज रद्द कर दिया जाता है और नया बनता है, इसलिए पुराने पेज से अब भुगतान नहीं हो सकता। यदि पिछला इनवॉइस पहले ही भुगतान हो चुका है, तो नया भुगतान बनाने के बजाय ऑर्डर पुष्ट कर दिया जाता है।
यदि Moyasar भुगतान शुरू नहीं कर पाता, तो ग्राहक को एक छोटा संदेश दिखता है, उदाहरण के लिए The Moyasar payment service is not responding. Please try again in a few minutes., और वह कोई दूसरा भुगतान तरीका चुन सकता है। विवरण लॉग में लिखे जाते हैं।
यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
यह प्लगइन केवल Moyasar पेज पर एक बार होने वाले भुगतान लेता है। आपके अपने चेकआउट पर कार्ड फ़ॉर्म नहीं है, सेव किए गए कार्ड या टोकनाइज़ेशन नहीं हैं, WooCommerce Subscriptions नहीं हैं, और अलग-अलग authorize और capture भी नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
Pending payment: इनवॉइस बन गया है और ग्राहक ने अभी भुगतान नहीं किया है। ऑर्डर नोट में इनवॉइस ID, राशि और मोड दिखता है।
Processing, Completed या On hold: भुगतान की पुष्टि हो गई है। स्टेटस Status after payment का पालन करता है। ऑर्डर नोट दिखाता है कि भुगतान कैसे पुष्ट हुआ (webhook, इनवॉइस सूचना, ग्राहक की वापसी या चेकआउट), इनवॉइस ID, भुगतान ID और भुगतान तरीका। ट्रांज़ैक्शन ID Moyasar का भुगतान ID है।
भुगतान के बाद On hold: Moyasar ने ऑर्डर की कुल राशि या मुद्रा से अलग राशि या मुद्रा बताई है (ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता), या ऑर्डर रद्द होने के बाद इनवॉइस का भुगतान हुआ। ऑर्डर नोट इसकी व्याख्या करता है। Moyasar Dashboard में भुगतान जाँचें और फिर ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।
भुगतान से पहले On hold: Moyasar भुगतान की समीक्षा के लिए रोके हुए है। Moyasar का फ़ैसला होने पर ऑर्डर अपडेट होगा।
Failed: बिना भुगतान वाले ऑर्डर का नवीनतम इनवॉइस विफल हुआ, समाप्त हो गया या रद्द हुआ। ग्राहक दोबारा भुगतान की कोशिश कर सकता है।
Cancelled: ऑर्डर ग्राहक, आपके द्वारा, या WooCommerce के स्टॉक होल्ड टाइमआउट से रद्द हुआ। ऑर्डर का खुला Moyasar इनवॉइस भी रद्द हो जाता है, इसलिए अब उसका भुगतान नहीं हो सकता।
भुगतान किया हुआ, रद्द या रिफ़ंड किया हुआ ऑर्डर बाद की सूचनाओं से कभी नहीं बदलता। यदि पहले से भुगतान किए गए ऑर्डर का दूसरा इनवॉइस भुगतान होता है (उदाहरण के लिए दो ब्राउज़र टैब से), तो ऑर्डर फिर से नहीं बदलता। एक नोट आपसे दोहरे भुगतान का Moyasar Dashboard में रिफ़ंड करने को कहता है।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Pay with Moyasar पर क्लिक करें (यह बटन भुगतान तरीके का शीर्षक इस्तेमाल करता है)। Moyasar भुगतान वाले ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। 2 घंटे से कम पहले हुए कार्ड भुगतान का पूर्ण रिफ़ंड void (सेटलमेंट से पहले रद्द करना) के रूप में भेजा जाता है; अन्यथा यह रिफ़ंड होता है। रिफ़ंड उसी मोड (टेस्ट या लाइव) की सीक्रेट कुंजी से होता है जिसमें भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। रिफ़ंड से पहले प्लगइन Moyasar पर भुगतान की मुद्रा, स्टेटस और अभी रिफ़ंड की जा सकने वाली राशि जाँचता है। यदि Moyasar रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड या void ऑर्डर नोट्स में जोड़ा जाता है।
Moyasar Dashboard में किए गए रिफ़ंड और void, webhook के ज़रिए आते हैं। यदि Moyasar, WooCommerce से अधिक रिफ़ंड राशि दिखाता है, तो ऑर्डर में एक नोट जोड़ा जाता है। ये अपने आप WooCommerce रिफ़ंड के रूप में दर्ज नहीं होते। ज़रूरत हो तो Refund via Pay with Moyasar के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से लिए गए VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Moyasar पेज के ऊपर है। कुंजी License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now इस्तेमाल करें, दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Moyasar नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉगिन किए हुए स्टोर मैनेजरों को भुगतान तरीका (unlicensed — visible to admins only) चिह्न के साथ दिखता रहता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर और परख सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं वे अब भी पुष्ट होते हैं, और रिफ़ंड चलते हैं।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्टेटस पृष्ठभूमि में अपने आप फिर से जाँचा जाता है।
समस्या निवारण
चेकआउट पर Moyasar दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड में सीक्रेट कुंजी है (टेस्ट मोड में Test secret key, लाइव मोड में Live secret key), और स्टोर या ऑर्डर की मुद्रा SAR, AED, USD, EUR, KWD, BHD या OMR है। कुंजी न होने या मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: पुष्टियाँ आपके स्टोर तक नहीं पहुँचीं। Webhook सेट करें: Moyasar Dashboard में जाँचें कि वह मौजूद है, उसका URL सेटिंग्स के Webhook URL से बिल्कुल मेल खाता है, मेथड POST है, चारों इवेंट चुने हुए हैं, और उसका शेयर्ड सीक्रेट Webhook shared secret के बराबर है। जब ग्राहक स्टोर पर लौटता है या वही ऑर्डर दोबारा भुगतान करने की कोशिश करता है, तब भी ऑर्डर पुष्ट होता है।
Webhook Unauthorized का जवाब देता है: Moyasar में शेयर्ड सीक्रेट Webhook shared secret से अलग है। Show पर क्लिक करें, मान कॉपी करें और उसे Moyasar के webhook में पेस्ट करें।
Webhook Webhook secret not configured का जवाब देता है: सेटिंग्स अभी तक शेयर्ड सीक्रेट के साथ सेव नहीं हुई हैं। एक सीक्रेट बनाने के लिए सेटिंग्स सेव करें और उसे Moyasar में कॉपी करें।
Webhook Key not configured का जवाब देता है: ऑर्डर ऐसे मोड (टेस्ट या लाइव) में भुगतान हुआ जिसकी सीक्रेट कुंजी खाली है। वह कुंजी डालें।
Webhook Verification failed या Try again later का जवाब देता है: Moyasar API से इनवॉइस नहीं पढ़ा जा सका, या उसी समय कोई दूसरा अनुरोध ऑर्डर अपडेट कर रहा था। Moyasar webhook को फिर से भेजेगा।
कुंजी को लेकर सेव करते समय त्रुटि: एक पब्लिशेबल कुंजी (pk_...) या दूसरे मोड की कुंजी पेस्ट की गई। पिछला मान रखा गया। टेस्ट कुंजियाँ sk_test_ से और लाइव कुंजियाँ sk_live_ से शुरू होती हैं।
ग्राहक को ऑर्डर देते समय त्रुटि दिखती है: Debug log चालू करें और WooCommerce > Status > Logs देखें, स्रोत wcp_moyasar_payment_gateway। 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. का मतलब है कि ऑर्डर का एक भुगतान किया हुआ इनवॉइस पहले से है जिसे आपकी समीक्षा चाहिए।
ऑर्डर On hold after payment पर है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर पूरा करें या भुगतान का रिफ़ंड करें।
रिफ़ंड विफल होता है: संदेश पढ़ें। यदि भुगतान दूसरे मोड में हुआ था, तो उस मोड की सीक्रेट कुंजी डालें। यदि राशि Moyasar पर अभी रिफ़ंड की जा सकने वाली राशि से अधिक है, तो भुगतान का कुछ हिस्सा पहले ही रिफ़ंड हो चुका है, उदाहरण के लिए Moyasar Dashboard में। यदि Moyasar ने रिफ़ंड की गई राशि की पुष्टि नहीं की, तो फिर से कोशिश करने से पहले Moyasar Dashboard में भुगतान जाँचें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदला है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन अंतिम ज्ञात स्टेटस पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने से सारा डेटा सुरक्षित रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। गेटवे सेटिंग्स और लॉग केवल तभी हटते हैं जब Clean uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।
Moyasar उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Moyasar से संबद्ध नहीं है और Moyasar द्वारा समर्थित नहीं है।