VibeFox Paymob for OpenCart — सहायता

आवश्यकताएँ

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

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

Paymob खाता: समर्थित देशों में से किसी एक में मर्चेंट खाता: मिस्र, संयुक्त अरब अमीरात, सऊदी अरब, ओमान या पाकिस्तान। Paymob डैशबोर्ड से चार मान चाहिए: API key, ऑनलाइन भुगतान इंटीग्रेशन का integration ID, भुगतान पेज का iFrame ID और HMAC secret।

मुद्रा: चेकआउट की मुद्रा आपके Paymob देश की मुद्रा होनी चाहिए: मिस्र के लिए EGP, UAE के लिए AED, सऊदी अरब के लिए SAR, ओमान के लिए OMR, पाकिस्तान के लिए PKR। यदि यह आपके स्टोर में नहीं है, तो System > Localisation > Currencies में जोड़ें। किसी दूसरी मुद्रा के साथ चेकआउट पर भुगतान विधि छिप जाती है। मल्टी-करेंसी Paymob खाते समर्थित नहीं हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Paymob Pay खोजें और Install (हरा + बटन) पर क्लिक करें।

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

4. Paymob country चुनें और API key, integration ID, iFrame ID और HMAC secret दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. Paymob डैशबोर्ड में अपने इंटीग्रेशन के callback URLs को उस URL पर सेट करें जो Callbacks सेक्शन में दिखाया गया है (देखें Callbacks)।

6. Enable/Disable चालू करें और Save पर क्लिक करें। Paymob test integration के ID से एक परीक्षण भुगतान करें, फिर अपने live integration का ID दर्ज करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी, Paymob कुंजियाँ और IDs तथा callback URLs उसी तरह दर्ज करें जैसे OpenCart 3 के चरण 3 से 6 में। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल callback URL अलग है (देखें Callbacks)।

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

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

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

सेव करते समय Title 128 अक्षरों से लंबा नहीं हो सकता, Sort Order पूर्णांक होना चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और चुने गए geo zone और ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता और पेज वह फ़ील्ड बताता है।

Paymob

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

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

Description: वह टेक्स्ट जो Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया जाता है। डिफ़ॉल्ट: Pay securely by card or mobile wallet on the Paymob payment page. कोई टेक्स्ट न दिखाने के लिए खाली छोड़ें।

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

Geo Zone: Paymob केवल चुने गए geo zone के भुगतान पते के लिए ऑफ़र करें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं। OpenCart 4 पर, जब स्टोर भुगतान पता नहीं माँगता, तब शिपिंग पता उपयोग होता है।

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

Paymob खाता

सभी मान आपके Paymob मर्चेंट डैशबोर्ड में हैं। कोई अलग test mode नहीं है: परीक्षण भुगतानों के लिए test mode वाले इंटीग्रेशन का integration ID दर्ज करें। कोई और सेटिंग नहीं बदलती।

Paymob country: आपके Paymob खाते का देश। यह API और भुगतान पेज सर्वर चुनता है, और चेकआउट की मुद्रा इसी देश की मुद्रा होनी चाहिए। डिफ़ॉल्ट: Egypt।

API key: Paymob डैशबोर्ड में Settings > Account info > API Key के अंतर्गत।

Integration ID: Paymob डैशबोर्ड में Developers > Payment Integrations के अंतर्गत: कार्ड या वॉलेट ऑनलाइन भुगतान इंटीग्रेशन की संख्यात्मक ID। Paymob पेज पर दिखाए जाने वाले भुगतान तरीके इसी इंटीग्रेशन के होते हैं।

iFrame ID: Paymob डैशबोर्ड में Developers > iframes के अंतर्गत: भुगतान iFrame की संख्यात्मक ID।

HMAC secret: Paymob डैशबोर्ड में Settings > Account info > HMAC के अंतर्गत। आवश्यक: ऑर्डर केवल इसी secret से हस्ताक्षरित callbacks द्वारा भुगतान हुआ चिह्नित होते हैं।

Integration ID और iFrame ID में केवल अंक होने चाहिए। खाली स्थान हटा दिए जाते हैं। कोई और मान सेव करते समय अस्वीकार होता है, और संदेश आता है कि यह फ़ील्ड must contain digits only — the previous value was kept होना चाहिए। बाकी फ़ील्ड सेव होते हैं।

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

Callbacks

Paymob हर लेन-देन की सूचना आपके स्टोर को देता है। Paymob डैशबोर्ड में Developers > Payment Integrations खोलें, अपना इंटीग्रेशन चुनें, Edit पर क्लिक करें, और Transaction processed callback तथा Transaction response callback दोनों को इस सेक्शन में दिखाए गए Callback URL पर सेट करें। OpenCart 3 में यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_paymob_pay/callback, OpenCart 4 में: https://your-store/index.php?route=extension/wcp_paymob_pay/payment/wcp_paymob_pay.callback। यह आपकी OpenCart इंस्टॉलेशन के storefront पते से बनता है। Copy बटन से इसे कॉपी करें। इस सेक्शन में चुने गए देश के Paymob डैशबोर्ड का लिंक भी है। जिन भी इंटीग्रेशन का उपयोग करते हैं, उन सभी में URLs सेट करें, परीक्षण इंटीग्रेशन सहित।

Transaction processed callback Paymob के सर्वर से भेजा जाता है। Transaction response callback ग्राहक को आपके स्टोर पर वापस लाता है। दोनों आपके HMAC secret से हस्ताक्षरित होते हैं और एक्सटेंशन द्वारा जाँचे जाते हैं। बिना वैध हस्ताक्षर वाले callbacks अस्वीकार होते हैं और कुछ नहीं बदलते। यदि सर्वर callback देर से आए या खो जाए, तो हस्ताक्षरित ग्राहक वापसी भी भुगतान की पुष्टि करती है। callback URL स्टोर के maintenance mode में होने पर भी काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन एक startup action जोड़ता है जो callbacks और ग्राहक की वापसी को आगे जाने देता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (missing order)। ऑर्डर को स्थिति तभी मिलती है जब Paymob किसी सही ढंग से हस्ताक्षरित लेन-देन की रिपोर्ट कर चुका हो। अस्वीकृत भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है; ग्राहक कार्ट सुरक्षित रहते हुए चेकआउट पर लौट जाता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।

Order Status After Payment: Paymob लेन-देन अपेक्षित राशि और मुद्रा के साथ भुगतान हो चुका है। डिफ़ॉल्ट: प्रोसेसिंग।

Awaiting Paymob Payment Status: लेन-देन लंबित है, जैसे कैश या किओस्क भुगतान। Paymob की पुष्टि होने पर ऑर्डर भुगतान के बाद की स्थिति पाता है। डिफ़ॉल्ट: लंबित।

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

अगले तीन फ़ील्ड एक्सटेंशन को बताते हैं कि आपका स्टोर कौन सी स्थितियाँ उपयोग करता है। एक्सटेंशन इन्हें कभी सेट नहीं करता।

Payment Error Status: वह स्थिति जो आपका स्टोर भुगतान त्रुटि वाले ऑर्डरों के लिए उपयोग करता है। लंबित लेन-देन ऐसे ऑर्डर को प्रतीक्षा स्थिति में ला सकता है। डिफ़ॉल्ट: विफल।

Cancelled Order Status: वह स्थिति जो आपका स्टोर रद्द ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए मिला भुगतान उसे on hold में डालता है, या यदि वह पहले भुगतान हो चुका था तो केवल एक नोट जोड़ता है। डिफ़ॉल्ट: रद्द।

Refunded Order Status: वह स्थिति जो आपका स्टोर रिफ़ंड किए गए ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए मिला भुगतान केवल एक नोट जोड़ता है। डिफ़ॉल्ट: रिफ़ंड।

उन्नत

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

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

Clean uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के लिए सेव किए गए Paymob ID (भुगतान प्रयास) हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।

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

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API key और HMAC secret एक्सपोर्ट नहीं होते।

Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए secrets बने रहते हैं।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान हुआ चिह्नित होता है जब Paymob उसे एक हस्ताक्षरित लेन-देन से पुष्ट करता है। इसके बाद ऑर्डर सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ OpenCart के सामान्य तरीके से स्थिति पाता है, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। लंबित भुगतान (जैसे कैश या किओस्क) या अधिकृत भुगतान भी ऑर्डर को स्थिति देता है, यानी प्रतीक्षा या on hold, और सफलता पेज पर ले जाता है।

यदि ग्राहक के लौटने पर ऑर्डर अभी भी पुष्ट हो रहा है, तो Payment confirmation पेज दिखाता है: Paymob accepted your payment and we are confirming it. You will receive an e-mail as soon as your order is confirmed — there is no need to pay again. लंबित भुगतान के लिए टेक्स्ट यह है: Your Paymob payment is pending (for example a cash or kiosk payment). Complete it as Paymob instructed you: your order is confirmed as soon as Paymob reports the payment. पेज पर Check again और Back to checkout बटन होते हैं।

यदि भुगतान अस्वीकृत हुआ, तो ग्राहक उसी कार्ट के साथ चेकआउट पर लौटता है और Your Paymob payment was not completed. Please try again or choose another payment method. संदेश देखता है। हर नया प्रयास अपना Paymob ऑर्डर दर्ज करता है, इसलिए ग्राहक कार्ट को फिर से भुगतान कर सकता है। OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और उसे अपडेट करता है, इसलिए ग्राहक उसी ऑर्डर को नए प्रयास से भुगतान करता है। यदि Paymob की प्रतिक्रिया सत्यापित नहीं की जा सकी, तो ग्राहक We could not verify the response from Paymob. If you were charged, your order will be updated as soon as Paymob confirms the payment. देखता है। यदि उसी कार्ट का कोई और ऑर्डर पहले ही भुगतान हो चुका है या भुगतान की प्रतीक्षा में है (जैसे दूसरे ब्राउज़र टैब से), तो ग्राहक फिर से भुगतान करने के बजाय सफलता पेज पर पहुँच जाता है। OpenCart 4 पर Paymob से वापसी के बाद के संदेश चेकआउट पेज के ऊपर दिखते हैं।

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

यदि Paymob भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है, और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे Paymob could not start the payment. Please check your billing details and try again, or choose another payment method. या Could not connect to Paymob. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।

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

ऑर्डर

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

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

OpenCart 4 पर बिना भुगतान वाला चेकआउट ऑर्डर Voided स्थिति पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्थिति वाला ऑर्डर मानता है, और बाद का भुगतान फिर भी उसकी पुष्टि करता है।

Order Status After Payment (default Processing): Paymob ने भुगतान की पुष्टि की। एक नोट लेन-देन, राशि और कार्ट के प्रकार को अंतिम चार अंकों के साथ दिखाता है।

Awaiting Paymob Payment Status (default Pending): भुगतान Paymob पर लंबित है, जैसे कैश या किओस्क भुगतान। Paymob के भुगतान की पुष्टि करने पर ऑर्डर भुगतान के बाद की स्थिति में चला जाता है।

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

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

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

VibeFox Paymob Pay टैब

Sales > Orders में Paymob से भुगतान किया गया कोई ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Paymob Pay टैब ऑर्डर के हर Paymob प्रयास को दिखाता है: Paymob order जिसमें मर्चेंट ऑर्डर ID और देश है, Paymob transaction ID, Status, Requested राशि, कार्ड के साथ Amount reported by Paymob, और Paymob message। इनके नीचे इस ऑर्डर के लिए एक्सटेंशन के Notes हैं। यह टैब एक्सटेंशन तक पहुँच रखने वाले उपयोगकर्ताओं को दिखता है।

रिफ़ंड

एडमिन से रिफ़ंड समर्थित नहीं हैं। Paymob डैशबोर्ड में भुगतान रिफ़ंड या void करें। जब Paymob रिफ़ंड या void की रिपोर्ट करता है, तो ऑर्डर में एक नोट जुड़ जाता है, और ऑर्डर की स्थिति नहीं बदलती। ऑर्डर को मैन्युअली अपडेट करें।

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

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

सक्रिय लाइसेंस कुंजी के बिना चेकआउट पर ग्राहकों को Paymob नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को 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 की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

चेकआउट पर Paymob नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, सभी चार मान (API key, integration ID, iFrame ID, HMAC secret) भरे हुए हैं, और चेकआउट मुद्रा चुने गए Paymob country की मुद्रा है। कुछ छूटने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्थिति के रहता है: callbacks आपके स्टोर तक नहीं पहुँच रहे। जाँचें कि जिस इंटीग्रेशन का उपयोग कर रहे हैं उसके Transaction processed callback और Transaction response callback ठीक वही URL हैं जो Callbacks सेक्शन में दिखाया गया है, और HMAC secret उसी Paymob खाते का है। अस्वीकृत callbacks लॉग में चेतावनी के रूप में लिखे जाते हैं, भले ही Debug log बंद हो। एक्सटेंशन पेज पर Log फ़ील्ड देखें।

Callback का उत्तर Invalid signature है: सेटिंग्स का HMAC secret Paymob खाते से मेल नहीं खाता, या किसी दूसरे देश का खाता चुना गया है। HMAC secret फिर से कॉपी करें।

Callback का उत्तर Not configured है: HMAC secret खाली है। secret दर्ज करें; Paymob callback फिर से प्रयास करेगा।

Callback का उत्तर locked या retry है: ऑर्डर उसी समय किसी दूसरे अनुरोध, जैसे ग्राहक की वापसी, से अपडेट हो रहा था, या ऑर्डर स्थिति सेट नहीं हो सकी। Paymob callback फिर से प्रयास करेगा। कारण लॉग में लिखा जाता है।

ब्राउज़र में callback URL खोलने पर चेकआउट पर पहुँचकर "could not verify" संदेश दिखता है: यह सामान्य है। यह URL केवल Paymob के हस्ताक्षरित अनुरोध स्वीकार करता है।

ग्राहक को Confirm Order के बाद त्रुटि दिखती है: Debug log चालू करें और लॉग देखें। Paymob payments are temporarily unavailable का मतलब गलत API key या किसी मान का गायब होना है। Paymob could not start the payment का मतलब है कि Paymob ने अनुरोध अस्वीकार किया, जैसे गलत integration ID या अधूरे बिलिंग विवरण के कारण। This order cannot be paid with Paymob का मतलब है कि ऑर्डर कुल शून्य है। Paymob does not accept payments in और उसके बाद एक मुद्रा का मतलब है कि ऑर्डर की मुद्रा चुने गए Paymob देश की मुद्रा नहीं है। This payment method is not available. का मतलब है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक चेकआउट रीलोड करता है।

भुगतान के बाद ऑर्डर on hold या प्रतीक्षा स्थिति में है: VibeFox Paymob Pay टैब के नोट पढ़ें। भुगतान लंबित है (कैश या किओस्क), लेन-देन केवल अधिकृत हुआ है (Paymob डैशबोर्ड में कैप्चर करें), राशि या मुद्रा मेल नहीं खाई, या ऑर्डर रद्द होने के बाद भुगतान आया।

परीक्षण भुगतान: Paymob test integration का ID Integration ID में दर्ज करें और उस इंटीग्रेशन में callback URLs सेट करें। असली भुगतानों के लिए अपने live integration का ID फिर से दर्ज करें।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Paymob Pay के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart हमेशा एक्सटेंशन की अपनी सेटिंग्स हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। OpenCart 4 पर एक्सटेंशन का OpenCart event और उसका startup action भी हटाए जाते हैं, जो maintenance mode में callbacks और ग्राहक की वापसी को आगे जाने देता है। Clean uninstall चालू होने पर बाकी गेटवे सेटिंग्स (title, description, देश, कुंजियाँ और ID, लॉगिंग) और लॉग हटा दिए जाते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। ऑर्डरों के Paymob भुगतान प्रयास हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और Paymob ID बनाए रखते हैं।

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

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