VibeFox DPO for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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 कॉल करता है (देखें Configuration)।

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox DPO Pay Gateway ढूँढकर Configure पर क्लिक करें।

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

4. टेस्ट और/या लाइव Company Token और Service Type दर्ज करें (देखें Configuration)।

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

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

इंस्टॉल होने पर मॉड्यूल ऑर्डर स्टेटस DPO payment on hold बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।

Configuration

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

DPO Pay

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card or mobile money on the DPO Pay payment page.

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

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

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

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 Token दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना चाहने पर नया मान दर्ज करें। Service Type एक संख्या होना चाहिए। कोई और मान सेव नहीं होता: पेज चेतावनी दिखाता है और पिछला मान रखता है।

Clear saved Company Tokens: किसी token को चिह्नित करें और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

भुगतान नोटिफ़िकेशन

Push notification URL: push नोटिफ़िकेशन आपके स्टोर को तुरंत बताता है कि भुगतान हो गया है, भले ही ग्राहक भुगतान के बाद ब्राउज़र बंद कर दे। यह URL किसी डैशबोर्ड में सेट नहीं होता: DPO सपोर्ट से अनुरोध करें कि यह URL आपके खाते के लिए सेट करे। फ़्रेंडली URL के साथ यह इस तरह दिखता है: https://your-shop/module/wcp_dpo_pay/notify, संभवतः भाषा कोड के साथ। इसे ठीक वैसे ही कॉपी करें जैसे पेज इसे दिखाता है। यह इंटरनेट से पहुँच योग्य होना चाहिए, और इसके सामने मेंटेनेंस मोड, फ़ायरवॉल या बेसिक ऑथेंटिकेशन नहीं होना चाहिए।

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

Scheduled status re-check (cron): इस URL को हर 15 मिनट में सर्वर cron जॉब से कॉल करें, उदाहरण के लिए curl से। अपुष्ट भुगतानों की DPO से फिर से जाँच रीडायरेक्ट के 15 मिनट बाद और भुगतान की समय-सीमा के बाद होती है। URL में एक गुप्त टोकन होता है, इसलिए इसे निजी रखें। push URL और cron के बिना ऑर्डर तभी बनता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

Successful payment status: सत्यापित सफल भुगतान के बाद का ऑर्डर स्टेटस।

राशि या मुद्रा का बेमेल, केवल अधिकृत भुगतान, और अधिक या कम भुगतान किए गए ट्रांज़ैक्शन हमेशा DPO payment on hold में जाते हैं।

एडवांस्ड

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

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

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

चेकआउट

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

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

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

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

अगर ग्राहक उसी कार्ट के लिए फिर से भुगतान करता है, तो पहले पिछले DPO ट्रांज़ैक्शन की जाँच होती है। अगर वह भुगतान हो चुका है, तो बिना दूसरे चार्ज के ऑर्डर बनता है। अगर वह अब भी प्रोसेस हो रहा है, तो ग्राहक को Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. दिखता है। अन्यथा पुराना ट्रांज़ैक्शन DPO पर रद्द होता है और नया बनता है।

अगर DPO भुगतान शुरू नहीं कर पाता, तो ग्राहक चेकआउट पर रहता है और DPO के त्रुटि कोड के अनुसार चुना गया एक छोटा संदेश दिखता है, जैसे DPO Pay does not support the currency of this order. Please choose another payment method. या The amount exceeds the limit allowed by DPO Pay. Please choose another payment method or contact us. अन्य त्रुटियों पर DPO Pay is temporarily unavailable. Please try again or choose another payment method. दिखता है। तकनीकी कारण लॉग में लिखा जाता है।

push नोटिफ़िकेशन और cron URL स्टोर के मेंटेनेंस मोड में भी काम करते हैं, और आपके स्टोर की देश-सीमा से अवरुद्ध नहीं होते।

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

ऑर्डर

ऑर्डर स्टेटस

No order yet: ग्राहक को DPO पर भेजा गया और उसने भुगतान नहीं किया, भुगतान अस्वीकार या रद्द हुआ, या DPO ने अभी भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।

Payment accepted, Delivered or DPO payment on hold: भुगतान सत्यापित हुआ। स्टेटस Successful payment status का पालन करता है। भुगतान DPO ट्रांज़ैक्शन टोकन को ट्रांज़ैक्शन ID के रूप में दर्ज होता है। ऑर्डर पेज पर एक निजी नोट राशि, मुद्रा, स्वीकृति कोड और टोकन की शुरुआत दिखाता है।

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

Cancelled: जब आप मॉड्यूल का कोई अनपेड ऑर्डर रद्द करते हैं (उदाहरण के लिए केवल अधिकृत भुगतान के कारण होल्ड पर पड़ा ऑर्डर), तो उसका खुला DPO ट्रांज़ैक्शन भी DPO पर रद्द हो जाता है।

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

रिफ़ंड

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

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

मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox DPO Pay Gateway लाइसेंस ब्लॉक Modules > Module Manager > VibeFox DPO Pay Gateway > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, स्थिति (जैसे लाइसेंस कब तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-payment-dpo की पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल के लिए Configure अनुमति वाले कर्मचारी ही कुंजी बदल सकते हैं। ब्लॉक के पाठ बैक ऑफ़िस की भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल आखिरी ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर का डोमेन, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना DPO Pay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।

जब लाइसेंस समाप्त होता है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। cron जॉब की ज़रूरत नहीं है। मॉड्यूल अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

DPO Pay does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और चुने गए मोड के Company Token और Service Type सेट हैं: टेस्ट मोड में टेस्ट फ़ील्ड, अन्यथा लाइव फ़ील्ड। वे गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट मुद्रा, ग्राहक के देश और ग्राहक समूह के लिए अनुमति प्राप्त है।

The payment went through, but no order was created: संभवतः आपके DPO खाते के लिए push नोटिफ़िकेशन URL सेट नहीं है, और ग्राहक स्टोर पर वापस नहीं आया। DPO सपोर्ट से सेटिंग्स में दिखाया गया URL सेट करने को कहें, और जाँचें कि cron हर 15 मिनट में पुनः जाँच URL कॉल कर रहा है। Logging चालू करें और मॉड्यूल पेज पर Log फ़ील्ड देखें।

Push notification answers Unknown transaction: ट्रांज़ैक्शन टोकन इस स्टोर के DPO Pay भुगतान का नहीं है, उदाहरण के लिए जब push उसी DPO खाते पर किसी दूसरे स्टोर से आया हो।

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

The push URL shows Method not allowed in the browser: यह सामान्य है। यह URL केवल DPO से आए अनुरोध स्वीकार करता है।

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

The Service Type is not saved: यह DPO से मिला संख्यात्मक Service Type ID होना चाहिए।

The customer sees DPO Pay is temporarily unavailable: DPO ने ट्रांज़ैक्शन बनाने से इनकार किया, उदाहरण के लिए गलत Company Token या Service Type के कारण, या दूसरे मोड के token के कारण। DPO का परिणाम कोड लॉग में है।

The customer sees that DPO accepts at most 2 decimal places: कार्ट की कुल राशि में 3 दशमलव स्थान हैं। DPO ऐसी राशियाँ नहीं काट सकता।

The customer sees This order has already been paid with DPO Pay: DPO ने उसी कार्ट के लिए दूसरे भुगतान से इनकार किया। DPO पोर्टल में भुगतान और PrestaShop में ऑर्डर जाँचें।

Order is DPO payment on hold after payment: ऑर्डर पेज पर निजी नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर DPO पोर्टल में ट्रांज़ैक्शन की समीक्षा करें।

डेवलपर actionWcpDpoPayCustomerData हुक से DPO को भेजे गए ग्राहक डेटा को, और actionWcpDpoPayPaymentTimeLimit हुक से भुगतान की समय-सीमा को बदल सकते हैं।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox DPO Pay Gateway के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। अगर Delete data चालू है, तो मॉड्यूल सेटिंग्स और लॉग हट जाते हैं। बंद होने पर बाद में फिर से इंस्टॉल करने के लिए सारी सेटिंग्स रहती हैं। ऑर्डरों के लिए सेव किया गया DPO डेटा और ऑर्डर स्टेटस DPO payment on hold हमेशा रखे जाते हैं, इसलिए दोबारा इंस्टॉल करने के बाद भी पुराने भुगतानों की देर से आने वाली सूचनाएँ काम करती रहती हैं। मौजूदा ऑर्डर अपने भुगतान नोट और ट्रांज़ैक्शन ID रखते हैं।

DPO Pay उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल DPO Pay से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।