VibeFox DPO for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.2 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्षम होना चाहिए। इसके बिना प्लगइन सक्षम होने से मना करता है।

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

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

मुद्रा: स्टोर की मुद्रा आपके DPO खाते द्वारा समर्थित होनी चाहिए, उदाहरण के लिए USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF या AED। DPO अधिकतम 2 दशमलव स्थान स्वीकार करता है, इसलिए 3 दशमलव स्थान वाली ऑर्डर राशियाँ (उदाहरण के लिए KWD 12.345) भुगतान नहीं हो सकतीं।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_dpo_pay फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > DPO Pay > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के ऊपर दिए गए लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. टेस्ट और/या लाइव Company Token और Service Type दर्ज करें (देखें कॉन्फ़िगरेशन)।

6. सेटिंग्स पेज पर दिखाए गए पुश नोटिफ़िकेशन URL को DPO सपोर्ट को भेजें और उनसे इसे आपके खाते के लिए सेट करने के लिए कहें।

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

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

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

सामान्य

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: Use the test account credentials below। चालू होने पर नए भुगतान टेस्ट 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।

Service Type एक संख्या होनी चाहिए। कोई भी अन्य मान सेव नहीं होता: पेज एक त्रुटि दिखाता है और पिछला मान बनाए रखता है। यदि आप 1.0 वर्शन से अपडेट करते हैं, तो उस वर्शन के क्रेडेंशियल भी टेस्ट फ़ील्ड में कॉपी हो जाते हैं।

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

पुश नोटिफ़िकेशन आपके स्टोर को तुरंत बताता है कि भुगतान हो गया है, भले ही ग्राहक भुगतान के बाद ब्राउज़र बंद कर दे। यह सेक्शन पुश नोटिफ़िकेशन URL दिखाता है। यह https://your-site/wc-api/dpo_pay_notify/ जैसा दिखता है। यह किसी डैशबोर्ड में सेट नहीं होता: DPO सपोर्ट से अपने खाते के लिए यह URL सेट करने को कहें।

DPO पुश नोटिफ़िकेशन पर कोई हस्ताक्षर नहीं होता, इसलिए उनकी सामग्री पर कभी भरोसा नहीं किया जाता। प्लगइन इन्हें केवल ऑर्डर खोजने के लिए उपयोग करता है और फिर भुगतान की जाँच सीधे DPO से करता है। पुश URL के बिना भी, ऑर्डर तब पुष्ट होते हैं जब ग्राहक स्टोर पर वापस लौटता है, और रीडायरेक्ट के 15 मिनट बाद और भुगतान की समय-सीमा के बाद होने वाली स्वचालित पुनः जाँच से भी।

ऑर्डर

Successful payment status: सत्यापित सफल भुगतान के बाद ऑर्डर का स्टेटस। स्टेटस तुरंत सेट होता है, दूसरे स्टेटस बदलाव के बिना।

एडवांस्ड

Logging: Enable logging, API कॉल और नोटिफ़िकेशन को WooCommerce > Status > Logs में, सोर्स wcp_dpo_pay के साथ, लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। टोकन मास्क किए जाते हैं, कोई ग्राहक डेटा लॉग नहीं होता। डिफ़ॉल्ट: बंद।

Delete data: Delete all plugin data when the plugin is deleted। अनइंस्टॉल पर सेटिंग्स, ऑर्डर में सेव किया गया DPO डेटा और लॉग हटा देता है। डीएक्टिवेशन कभी डेटा नहीं हटाता। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट DPO Pay) और ऑर्डर देता है। प्लगइन ऑर्डर मुद्रा में ऑर्डर की कुल राशि के लिए एक DPO ट्रांज़ैक्शन बनाता है, जिसमें विवरण के रूप में ऑर्डर नंबर और आपकी साइट का नाम होता है, और ग्राहक को DPO भुगतान पेज पर भेजता है। ग्राहक का नाम, ईमेल, फ़ोन और पता पेज को पहले से भरने के लिए भेजा जाता है। वहाँ ग्राहक आपके DPO खाते में सक्षम किसी भी तरीके से भुगतान करता है। भुगतान लिंक 5 घंटे तक वैध रहता है।

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

अगर भुगतान की पुष्टि नहीं होती, तो ग्राहक चेकआउट या Pay for order पेज पर इन संदेशों में से किसी एक के साथ वापस जाता है:

अगर ग्राहक DPO पेज पर स्टोर पर वापस जाने के बटन पर क्लिक करता है, तो ऑर्डर WooCommerce के सामान्य तरीके से रद्द हो जाता है और उसका 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 इस ऑर्डर की मुद्रा का समर्थन नहीं करता, या राशि DPO Pay द्वारा अनुमत सीमा से अधिक है, और वह दूसरा भुगतान तरीका चुन सकता है।

यह भुगतान तरीका क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

ऑर्डर

ऑर्डर स्टेटस

Pending payment: ग्राहक को DPO पर भेजा गया था और उसने अभी तक भुगतान नहीं किया है, या DPO ने अभी तक भुगतान की पुष्टि नहीं की है।

Processing, Completed या On hold: भुगतान सत्यापित हो गया है। स्टेटस Successful payment status का पालन करता है। ऑर्डर नोट में राशि, मुद्रा, एप्रूवल कोड और DPO ट्रांज़ैक्शन टोकन का शुरुआती हिस्सा दिखता है। ट्रांज़ैक्शन आईडी DPO ट्रांज़ैक्शन टोकन है।

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

Failed: भुगतान अस्वीकृत हुआ, रद्द हुआ, या भुगतान की समय-सीमा बीत गई। ग्राहक फिर से भुगतान कर सकता है।

Cancelled: ग्राहक DPO पेज से स्टोर पर वापस लौट गया, या ऑर्डर आपके द्वारा या अनपेड ऑर्डर के लिए WooCommerce के टाइमआउट से रद्द हुआ। अनपेड DPO भुगतान लिंक DPO पर रद्द हो जाता है।

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

रिफ़ंड

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

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

प्लगइन vibefox.net से एक VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > DPO Pay के ऊपर है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now का उपयोग करें, दूसरी कुंजी दर्ज करने के लिए Change key, और इसे इस साइट से हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना, DPO Pay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। अगर फिर भी कोई भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन किए हुए स्टोर मैनेजर अब भी भुगतान तरीका देखते हैं, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन को सेटअप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, वे फिर भी पुष्ट होते हैं।

जब कोई लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए रिन्यूअल चाहिए होता है। स्टेटस की जाँच बैकग्राउंड में स्वचालित रूप से फिर से होती है।

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

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

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर रुका रहता है: संभावना है कि आपके DPO खाते के लिए पुश नोटिफ़िकेशन URL सेट नहीं है, और ग्राहक स्टोर पर वापस नहीं लौटा। DPO सपोर्ट से सेटिंग्स में दिखाया गया URL सेट करने के लिए कहें। ऑर्डर रीडायरेक्ट के 15 मिनट बाद होने वाली स्वचालित पुनः जाँच से भी पुष्ट होता है। Logging चालू करें और WooCommerce > Status > Logs देखें, सोर्स wcp_dpo_pay।

पुश नोटिफ़िकेशन Unknown transaction जवाब देता है: ट्रांज़ैक्शन टोकन इस स्टोर के किसी DPO Pay ऑर्डर से संबंधित नहीं है, उदाहरण के लिए नोटिफ़िकेशन उसी DPO खाते पर किसी दूसरे स्टोर से आया।

पुश नोटिफ़िकेशन Verification failed जवाब देता है: भुगतान की जाँच के लिए DPO से संपर्क नहीं हो सका। DPO नोटिफ़िकेशन दोहराता है, और स्वचालित पुनः जाँच भी ऑर्डर की पुष्टि करती है।

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

ग्राहक को DPO Pay is temporarily unavailable दिखता है: DPO ने ट्रांज़ैक्शन बनाने से मना कर दिया, उदाहरण के लिए गलत Company Token या Service Type के कारण, या दूसरे मोड के टोकन के कारण। DPO का रिज़ल्ट कोड WooCommerce > Status > Logs में, सोर्स wcp_dpo_pay के साथ मिलता है।

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

भुगतान के बाद ऑर्डर On hold पर है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, भुगतान केवल अधिकृत है, ट्रांज़ैक्शन ज़्यादा या कम भुगतान हुआ था, या ऑर्डर रद्द हो चुका था। DPO पोर्टल में ट्रांज़ैक्शन की जाँच करें।

लाइसेंस ब्लॉक एक त्रुटि दिखाता है: ब्लॉक में दिए गए संदेश का पालन करें। उदाहरण के लिए, अगर कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। अगर लाइसेंस सर्वर से संपर्क नहीं हो पाता, तो प्लगइन आखिरी ज्ञात स्टेटस के साथ काम करता रहता है।

अनइंस्टॉल

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

DPO Pay उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन DPO Pay से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।