VibeFox DPO for OpenCart — सहायता

आवश्यकताएँ

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

PHP: SimpleXML एक्सटेंशन के साथ 8.0 या उसके बाद का संस्करण।

DPO Pay खाता: आपको अपने DPO मर्चेंट खाते का Company Token और Service Type ID चाहिए। DPO इन्हें आपका खाता खुलने पर जारी करता है; अपने DPO खाता प्रबंधक से लें, या dpogroup.com से। DPO अपना token और service type वाला टेस्ट खाता भी दे सकता है। अलग से कोई टेस्ट सर्वर नहीं है: DPO टेस्ट और लाइव खातों के लिए एक ही API पता इस्तेमाल करता है, और token से खाता चुना जाता है।

मुद्रा: ऑर्डर की मुद्रा आपके DPO खाते द्वारा समर्थित होनी चाहिए। DPO अधिकतम 2 दशमलव स्थान स्वीकार करता है, इसलिए 3 दशमलव वाले ऑर्डर कुल (उदाहरण के लिए KWD 12.345) का भुगतान नहीं हो सकता।

सर्वर cron: एक cron जॉब जो हर 15 मिनट में एक्सटेंशन के पुनः-जाँच URL को कॉल करता है (देखें कॉन्फ़िगरेशन)।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. परीक्षण और/या लाइव Company Token और Service Type दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. Payment notifications सेक्शन में दिखाया गया push notification URL DPO सपोर्ट को भेजें और उनसे अपने खाते के लिए इसे सेट करने को कहें। cron URL को अपने सर्वर के cron जॉब में जोड़ें।

6. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर असली भुगतान स्वीकार करने के लिए Test mode बंद करें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और DPO के क्रेडेंशियल दर्ज करें, push notification URL और cron सेट करें, और भुगतान का परीक्षण वैसे ही करें जैसे OpenCart 3 के चरण 3 से 6 में है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल push notification URL और cron URL अलग हैं (देखें भुगतान सूचनाएँ)।

नई इंस्टॉलेशन भुगतान तरीका बंद और test mode चालू के साथ शुरू होती है। इंस्टॉल होने पर एक्सटेंशन अपनी transaction तालिका और cron URL का गुप्त टोकन बनाता है।

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

सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox DPO Pay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। जब भुगतान तरीका चालू हो, लेकिन चुने गए मोड का Company Token या Service Type खाली हो, तो पेज चेतावनी देता है कि चेकआउट पर भुगतान तरीका छिपा रहेगा, और सेव करने पर भी यही चेतावनी दिखती है। Test mode चालू होने पर पेज दिखाता है Test mode is on: payments are created with the test account credentials. (टेस्ट मोड चालू है: भुगतान टेस्ट खाते की क्रेडेंशियल से बनाए जाते हैं।) एक्सटेंशन बदलने का अधिकार न हो, तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता (अधिकतम 128 अक्षर), Sort Order पूर्णांक होना चाहिए और Total 0 या उससे अधिक की संख्या; नहीं तो कुछ भी सेव नहीं होता।

DPO Pay

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण पर, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: DPO Pay के भुगतान पेज पर कार्ड या मोबाइल मनी से सुरक्षित रूप से भुगतान करें।

Sort Order: चेकआउट पर भुगतान तरीकों के बीच DPO Pay का क्रम। खाली छोड़ें या पूर्णांक दर्ज करें।

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

Total: स्टोर की डिफ़ॉल्ट मुद्रा में वह कार्ट राशि, जिस तक पहुँचने पर ही DPO Pay दिखाया जाएगा। किसी भी राशि पर DPO Pay दिखाने के लिए खाली छोड़ें।

API क्रेडेंशियल

DPO आपके मर्चेंट खाते के लिए एक Company Token और Service Type ID जारी करता है, और टेस्ट खाते के लिए अलग। इन्हें अपने DPO खाता प्रबंधक से लें या dpogroup.com से (सेक्शन वहाँ के लिंक देता है)।

Test mode: चालू होने पर नए भुगतान test Company Token और Service Type से बनाए जाते हैं। डिफ़ॉल्ट: चालू। असली क्रेडेंशियल से असली भुगतान स्वीकार करने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Test mode: payments are created with the test account. (टेस्ट मोड: भुगतान टेस्ट खाते से बनाए जाते हैं।) देखते हैं। मौजूदा भुगतानों की स्थिति जाँच और रद्दीकरण हमेशा उसी खाते का उपयोग करते हैं जिससे भुगतान बनाया गया था।

Test Company Token: आपके DPO टेस्ट खाते का Company Token।

Test Service Type: आपके DPO टेस्ट खाते का संख्यात्मक Service Type ID।

Live Company Token: आपके DPO लाइव मर्चेंट खाते का Company Token।

Live Service Type: आपके DPO लाइव मर्चेंट खाते का संख्यात्मक Service Type ID।

सेव किए गए Company Tokens दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. (सेव है — रखने के लिए खाली छोड़ें।) दिखाता है। नया मान केवल तभी दर्ज करें जब उसे बदलना हो। सेव किया गया token हटाने के लिए फ़ील्ड के नीचे Clear the saved Company Token on save पर टिक करें और Save पर क्लिक करें। Service Type संख्या होना चाहिए। कोई और मान सेव नहीं होता: पेज चेतावनी दिखाता है और पिछला मान रखता है, बाकी सेटिंग्स सेव हो जाती हैं।

भुगतान सूचनाएँ

Push notification URL: push सूचना तुरंत आपके स्टोर को बताती है कि भुगतान हो गया है, भले ही ग्राहक भुगतान के बाद ब्राउज़र बंद कर दे। यह URL किसी डैशबोर्ड में सेट नहीं होता: DPO सपोर्ट से कहें कि वे इसे आपके खाते के लिए सेट करें। OpenCart 3 पर इसका रूप https://your-store/index.php?route=extension/payment/wcp_dpo_pay/notify जैसा है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_dpo_pay/payment/wcp_dpo_pay.notify जैसा। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे ठीक वैसे ही कॉपी करें जैसा पेज दिखाता है। यह इंटरनेट से पहुँच योग्य होना चाहिए, इसके सामने कोई firewall या basic authentication नहीं होना चाहिए।

DPO की push सूचनाओं पर कोई हस्ताक्षर नहीं होता, इसलिए उनकी सामग्री पर कभी भरोसा नहीं किया जाता। एक्सटेंशन उनका उपयोग केवल transaction token से भुगतान ढूँढने के लिए करता है, और फिर परिणाम की जाँच DPO से सीधे करता है। जो token आपके स्टोर ने नहीं बनाया, उसे DPO को बिना अनुरोध किए अस्वीकार कर दिया जाता है।

निर्धारित स्थिति पुनः-जाँच (cron): सर्वर cron जॉब से हर 15 मिनट में इस URL को कॉल करें, उदाहरण के लिए curl से। बिना पुष्टि वाले भुगतान रीडायरेक्ट के 15 मिनट बाद, और भुगतान की समय-सीमा के बाद फिर DPO से जाँचे जाते हैं। इस URL में एक गुप्त token है, इसलिए इसे निजी रखें। OpenCart 4 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/wcp_dpo_pay/payment/wcp_dpo_pay.cron&token= और उसके बाद token। push URL और cron के बिना, ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। DPO द्वारा भुगतान की पुष्टि के बाद ही ऑर्डर को स्टेटस मिलता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Successful payment status: सत्यापित सफल भुगतान के बाद ऑर्डर का स्टेटस। डिफ़ॉल्ट: प्रसंस्करण में। हर भुगतान किए गए ऑर्डर को पूरा करना हो तो पूर्ण चुनें, या हर ऑर्डर की मैन्युअल स्वीकृति के लिए अपना समीक्षा स्टेटस चुनें।

DPO payment on hold status: ऐसे भुगतान का स्टेटस जिसे आपकी समीक्षा चाहिए: राशि या मुद्रा का मेल न खाना, केवल authorize किया गया भुगतान, अधिक या कम भुगतान वाला लेन-देन, या ग्राहक द्वारा रद्द करने के बाद किया गया भुगतान। ऑर्डर इतिहास का एक नोट कारण समझाता है। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Cancelled order status: जब आप बिना भुगतान वाले DPO Pay ऑर्डर को यह स्टेटस देते हैं, तो उसका खुला DPO भुगतान DPO पर भी रद्द हो जाता है। डिफ़ॉल्ट: रद्द।

उन्नत

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

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

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

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

Export: Download JSON सेटिंग्स को JSON फ़ाइल में सेव करता है। Company Tokens एक्सपोर्ट नहीं होते।

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब DPO पुष्टि करता है: एक्सटेंशन ग्राहक के लौटने पर, push सूचना आने पर और निर्धारित पुनः-जाँच में DPO से transaction का परिणाम पूछता है। इसके बाद ऑर्डर OpenCart के सामान्य तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। OpenCart 4 पर, जब DPO ग्राहक को वापस भेजता है तो ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो स्टोर से उसी वापसी पते को दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।

यदि भुगतान की पुष्टि नहीं होती, तो ग्राहक इन संदेशों में से किसी एक के साथ चेकआउट पर लौटता है (OpenCart 4 पर चेकआउट पेज के ऊपर)। कार्ट सुरक्षित रहता है।

यदि ग्राहक DPO पेज पर स्टोर लौटने के बटन पर क्लिक करता है, तो पहले transaction की जाँच होती है। यदि वह भुगतान हो चुका है, तो ग्राहक को सफलता पेज दिखता है। अन्यथा वह DPO पर रद्द हो जाता है और ग्राहक कार्ट के साथ चेकआउट पर लौट आता है।

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

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए रद्द या रिफ़ंड), तो Confirm Order या DPO से वापसी ग्राहक को चेकआउट पर वापस भेजती है: यदि उस ऑर्डर में कोई भुगतान नहीं था, तो The payment was declined or cancelled. Please try again or choose another payment method. संदेश के साथ, और यदि उसमें भुगतान था, तो Your previous order was closed by the store. Please confirm the order again: the cart will be paid with a new order. संदेश के साथ। यदि ऑर्डर पहले से भुगतान हो चुका है और उसके बाद कार्ट बदल गया है (दूसरे उत्पाद या मात्रा), तो संदेश है Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. इन सभी स्थितियों में अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है।

यदि DPO भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर बटन के ऊपर एक छोटे संदेश के साथ रहता है, जो DPO त्रुटि कोड के आधार पर चुना जाता है, जैसे DPO Pay इस ऑर्डर की मुद्रा का समर्थन नहीं करता। कृपया कोई दूसरा भुगतान तरीका चुनें। या राशि DPO Pay द्वारा अनुमत सीमा से अधिक है। कृपया कोई दूसरा भुगतान तरीका चुनें या हमसे संपर्क करें। अन्य त्रुटियों पर DPO Pay अस्थायी रूप से उपलब्ध नहीं है। कृपया दोबारा कोशिश करें या कोई दूसरा भुगतान तरीका चुनें। दिखता है। तकनीकी कारण लॉग में लिखा जाता है।

स्टोर maintenance mode में होने पर भी push सूचना और cron URL काम करते हैं: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आने देता है, और OpenCart 4 पर एक्सटेंशन push सूचना, cron URL और ग्राहक की वापसी के लिए एक स्टार्टअप ऐक्शन जोड़ता है। भुगतान तरीका बंद करने पर भी पहले से शुरू हुए भुगतान पुष्ट किए जाते हैं।

एक्सटेंशन केवल DPO पेज पर एकल भुगतान लेता है। स्टोर से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, आपकी साइट पर कार्ड फ़ील्ड, और केवल authorize किए गए भुगतानों का capture समर्थित नहीं हैं।

ऑर्डर

ऑर्डर स्टेटस

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

Successful payment status (डिफ़ॉल्ट प्रसंस्करण में): भुगतान सत्यापित हुआ। ऑर्डर इतिहास का एक नोट राशि, मुद्रा, अनुमोदन कोड और DPO transaction token की शुरुआत दिखाता है।

DPO payment on hold status (डिफ़ॉल्ट लंबित): DPO ने भुगतान की पुष्टि की, लेकिन राशि या मुद्रा ऑर्डर से अलग है, भुगतान केवल authorize हुआ है और capture नहीं हुआ, लेन-देन अधिक या कम भुगतान वाला है, या ग्राहक ने भुगतान रद्द किया था या ऑर्डर पहले ही रद्द हो चुका था। नोट कारण समझाता है। DPO पोर्टल में लेन-देन जाँचें। केवल authorize किए गए भुगतान को DPO पोर्टल में capture या void करें, फिर ऑर्डर स्टेटस अपडेट करें।

Cancelled order status (डिफ़ॉल्ट रद्द): जब आप एक्सटेंशन के किसी बिना भुगतान वाले ऑर्डर (उदाहरण के लिए केवल authorize किए गए भुगतान के लिए रोके गए ऑर्डर) को यह स्टेटस देते हैं, तो उसका खुला DPO transaction भी DPO पर रद्द हो जाता है।

बाद में आया अस्वीकृति परिणाम कभी ऑर्डर नहीं बदलता, और पुराने transactions के परिणाम मौजूदा प्रयास को कभी विफल नहीं करते। यदि DPO पहले से भुगतान किए गए ऑर्डर के लिए दूसरा सफल भुगतान पुष्ट करता है, तो ऑर्डर नहीं बदलता और उसे संभावित दोहरे भुगतान का नोट मिलता है, ताकि आप उसे DPO पोर्टल में रिफ़ंड कर सकें। वही प्रकार का नोट भुगतान किए गए ऑर्डर में तब जुड़ता है जब वही कार्ट (वही ग्राहक सत्र और कार्ट की सामग्री) किसी दूसरे ऑर्डर के साथ फिर से भुगतान किया गया हो, उदाहरण के लिए दूसरे ब्राउज़र टैब में; वह दूसरा ऑर्डर कोई स्टेटस नहीं रखता। जिस ऑर्डर को आपने किसी दूसरे स्टेटस (उदाहरण के लिए रिफ़ंड किया गया) में बदला है, उसे कभी दोबारा नहीं खोला जाता; देर से आया भुगतान केवल एक नोट जोड़ता है।

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

रिफ़ंड

इस संस्करण में स्टोर से रिफ़ंड उपलब्ध नहीं हैं। DPO मर्चेंट पोर्टल में भुगतान रिफ़ंड करें, फिर OpenCart में ऑर्डर स्टेटस बदलें।

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

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

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

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

DPO Pay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए मोड का Company Token और Service Type सेट है: test mode में test फ़ील्ड, अन्यथा live फ़ील्ड। ये न हों तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: संभवतः आपके DPO खाते के लिए push notification URL सेट नहीं है, और ग्राहक स्टोर पर वापस नहीं आया। DPO सपोर्ट से सेटिंग्स में दिखाया गया URL सेट करवाएँ, और जाँचें कि cron हर 15 मिनट में पुनः-जाँच URL कॉल कर रहा है। Logging चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

Push सूचना Unknown transaction का उत्तर देती है: transaction token इस स्टोर के DPO Pay भुगतान का नहीं है, उदाहरण के लिए push उसी DPO खाते के किसी दूसरे स्टोर से आया था।

Push सूचना Verification failed का उत्तर देती है: भुगतान की जाँच के लिए DPO तक नहीं पहुँचा जा सका, ऑर्डर उसी समय किसी दूसरे अनुरोध से प्रसंस्कृत हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। DPO सूचना दोबारा भेजता है, और निर्धारित पुनः-जाँच भी ऑर्डर की पुष्टि करती है। कारण लॉग में है।

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

Cron URL Forbidden का उत्तर देता है: URL में token गलत है। सेटिंग्स पेज से URL दोबारा कॉपी करें। सही कॉल OK checked= और जाँचे गए भुगतानों की संख्या लौटाता है।

Service Type सेव नहीं होता: यह DPO का दिया हुआ संख्यात्मक Service Type ID होना चाहिए।

ग्राहक को This payment method is not available. Please reload the checkout page.: दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान तरीका बंद कर दिया गया। ग्राहक चेकआउट पेज को दोबारा लोड करता है।

ग्राहक को DPO Pay is temporarily unavailable दिखता है: DPO ने transaction बनाने से मना किया, उदाहरण के लिए गलत Company Token या Service Type के कारण, या दूसरे मोड के token के कारण। DPO का परिणाम कोड लॉग में है।

ग्राहक को दिखता है कि DPO अधिकतम 2 दशमलव स्थान स्वीकार करता है: ऑर्डर कुल में 3 दशमलव स्थान हैं। DPO ऐसी राशियाँ नहीं काट सकता।

ग्राहक को This order has already been paid with DPO Pay दिखता है: DPO ने उसी ऑर्डर के लिए दूसरा भुगतान अस्वीकार किया। DPO पोर्टल में भुगतान और OpenCart में ऑर्डर जाँचें।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: ऑर्डर History का नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर DPO पोर्टल में transaction की समीक्षा करें।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wcp_dpo_pay_customer_data (DPO को भेजा गया ग्राहक डेटा) और wcp_dpo_pay_payment_time_limit (घंटों में भुगतान समय-सीमा) ट्रिगर करता है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox DPO Pay Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर अपने डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप ऐक्शन, जो मेंटेनेंस मोड में DPO और cron को आगे जाने देता है)। यदि Delete data चालू है, तो गेटवे की बाकी सेटिंग्स (शीर्षक, विवरण, test mode, Company Tokens, Service Types, लॉगिंग) और लॉग हटा दिए जाते हैं, और फिर से इंस्टॉल करने पर नया cron URL बनता है। यदि बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। ऑर्डरों के लिए रखा गया DPO डेटा हमेशा बना रहता है, इसलिए दोबारा इंस्टॉल करने के बाद भी देर से आने वाली सूचनाएँ और पुराने भुगतानों की पुनः-जाँच काम करती रहती हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

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

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