VibeFox Datatrans for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।

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

HTTPS: आपकी साइट इंटरनेट से HTTPS के ज़रिए पहुँच योग्य होनी चाहिए, ताकि Datatrans वेबहुक भेज सके।

Datatrans खाता: आपको Merchant ID, सर्वर-टू-सर्वर API पासवर्ड और वेबहुक के लिए, अनुशंसित रूप से, HMAC-SHA256 साइन कुंजी चाहिए। सैंडबॉक्स क्रेडेंशियल Datatrans सैंडबॉक्स Web Admin (admin.sandbox.datatrans.com) से मिलते हैं, और लाइव क्रेडेंशियल लाइव Web Admin (admin.datatrans.com) से। सैंडबॉक्स और लाइव अलग-अलग Datatrans खाते हैं, जिनके Merchant ID और कुंजियाँ भिन्न होती हैं।

मुद्रा: स्टोर की मुद्रा (या आपके बहु-मुद्रा प्लगइन की ऑर्डर मुद्रा) आपके Datatrans मर्चेंट खाते के लिए सक्षम होनी चाहिए।

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

इंस्टॉलेशन

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

2. Activate पर क्लिक करें। WooCommerce सक्रिय होना चाहिए।

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

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

5. सैंडबॉक्स क्रेडेंशियल दर्ज करें और, असली भुगतान के लिए, लाइव क्रेडेंशियल भी दर्ज करें (देखें कॉन्फ़िगरेशन)।

6. Enable/Disable चालू करें। टेस्ट करते समय Sandbox mode चालू रखें, फिर असली भुगतान लेने के लिए उसका टिक हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Datatrans। जब गेटवे सक्षम हो लेकिन मौजूदा वातावरण का Merchant ID या API पासवर्ड न हो, तो पेज छूटे हुए फ़ील्ड की सूची के साथ Datatrans is hidden at checkout until these settings are filled in: दिखाता है। जब तक सैंडबॉक्स मोड चालू है, वह Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. दिखाता है।

वेबहुक

Webhook URL सेटिंग्स के ऊपर दिखाया जाता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/datatrans_payment_callback/। प्लगइन हर लेन-देन के साथ यह URL Datatrans को भेजता है, इसलिए आपको इसे कहीं दर्ज करने की आवश्यकता नहीं है। आप इसे Datatrans Web Admin की वेबहुक सेटिंग्स में भी दर्ज कर सकते हैं, ताकि वहाँ किए गए कैप्चर और रद्दीकरण के अपडेट मिलें।

वेबहुक लेन-देन की स्थिति बताता है। प्लगइन इन स्थितियों पर कार्रवाई करता है:

HMAC साइन कुंजी होने पर हर वेबहुक की जाँच उसके Datatrans-Signature हेडर से होती है। मान्य हस्ताक्षर के बिना वेबहुक अस्वीकार कर दिए जाते हैं। साइन कुंजी न होने पर प्लगइन वेबहुक की सामग्री पर भरोसा नहीं करता और हर वेबहुक की जाँच Datatrans की स्टेटस API से करता है। वेबहुक के बिना ऑर्डर की पुष्टि तभी होती है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान के तरीके के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely via Datatrans।

Sandbox mode: Use the Datatrans sandbox (test payments, no real money)। यह API और भुगतान पेज के होस्ट, दोनों को तथा नीचे दिए गए क्रेडेंशियल को बदल देता है। रिफ़ंड और कैप्चर हमेशा उसी वातावरण का उपयोग करते हैं जिसमें भुगतान किया गया था। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए टिक हटा दें।

सैंडबॉक्स क्रेडेंशियल

इन्हें Datatrans सैंडबॉक्स Web Admin (admin.sandbox.datatrans.com) से कॉपी करें। साइन कुंजी वहाँ सुरक्षा सेटिंग्स में है।

Sandbox merchant ID: आपके सैंडबॉक्स खाते का Merchant ID।

Sandbox API password: आपके सैंडबॉक्स खाते का सर्वर-टू-सर्वर API पासवर्ड।

Sandbox HMAC sign key: वेबहुक के Datatrans-Signature हेडर की जाँच के लिए उपयोग होने वाली हेक्स कुंजी। इसके बिना हर वेबहुक की जाँच Datatrans की स्टेटस API से दोबारा की जाती है।

लाइव क्रेडेंशियल

इन्हें Datatrans लाइव Web Admin (admin.datatrans.com) से कॉपी करें।

Production merchant ID: आपके लाइव खाते का Merchant ID।

Production API password: आपके लाइव खाते का सर्वर-टू-सर्वर API पासवर्ड।

Production HMAC sign key: लाइव वेबहुक के Datatrans-Signature हेडर की जाँच के लिए उपयोग होने वाली हेक्स कुंजी। इसके बिना हर वेबहुक की जाँच Datatrans की स्टेटस API से दोबारा की जाती है।

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

भुगतान की प्रोसेसिंग

Auto settle: Capture (settle) payments immediately। डिफ़ॉल्ट: चालू। इसे बंद करने पर भुगतान केवल ऑथराइज़ होते हैं: ऑर्डर होल्ड पर रखा जाता है और आप उसे बाद में ऑर्डर एक्शन Capture Datatrans payment से कैप्चर करते हैं, या Cancel Datatrans authorization से रिलीज़ करते हैं।

Order status after payment: भुगतान सेटल होने पर लगाई जाने वाली ऑर्डर स्थिति। स्थिति तुरंत लगाई जाती है, दूसरी बार स्थिति बदले बिना।

उन्नत

Logging: Log payment events and API calls विवरण WooCommerce > Status > Logs में, स्रोत wcp_datatrans_gateway के साथ, लिखता है। त्रुटियाँ हमेशा लॉग होती हैं। कोई कुंजी, कार्ड का डेटा या ग्राहक का डेटा नहीं लिखा जाता। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the plugin settings when the plugin is deleted। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान का तरीका चुनता है (डिफ़ॉल्ट रूप से Datatrans) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर के कुल योग के लिए, ऑर्डर ID को संदर्भ बनाकर, एक Datatrans लेन-देन बनाता है और ग्राहक को Datatrans भुगतान पेज पर भेजता है। वहाँ ग्राहक आपके Datatrans खाते में सक्षम किसी भी तरीके से भुगतान करता है, उदाहरण के लिए कार्ड, TWINT या PostFinance। यदि आपकी साइट इनमें से किसी भाषा का उपयोग करती है, तो भुगतान पेज जर्मन, अंग्रेज़ी, फ़्रेंच या इतालवी में खुलता है; अन्यथा भाषा Datatrans चुनता है।

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्त पेज पर लौटता है। ऑर्डर केवल Datatrans की पुष्टि के बाद भुगतान किया हुआ चिह्नित होता है: वेबहुक से, या ग्राहक के लौटने पर Datatrans की स्टेटस API को सर्वर-साइड अनुरोध से। लौटने के पते में ऑर्डर कुंजी होती है, और लौटना अपने आप में कभी किसी ऑर्डर को भुगतान किया हुआ चिह्नित नहीं करता।

यदि ग्राहक भुगतान पेज पर रद्द करता है, तो वह Pay for order पेज पर जाता है, जहाँ यह संदेश दिखता है: The payment was canceled. You can try again or choose another payment method. भुगतान विफल होने के बाद संदेश यह होता है: The payment was not completed. Please try again or choose another payment method. ऑर्डर भुगतान योग्य बना रहता है, और ग्राहक दोबारा कोशिश कर सकता है।

यदि Datatrans भुगतान शुरू नहीं कर पाता, तो ग्राहक को The payment could not be started. Please try again or choose another payment method. दिखता है। कारण लॉग में लिखा जाता है।

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

प्लगइन केवल Datatrans भुगतान पेज पर एक बार के भुगतान लेता है। इसमें सेव किए गए कार्ड या alias नहीं हैं, सब्सक्रिप्शन नहीं हैं, Lightbox या Secure Fields इंटीग्रेशन नहीं है, सेटिंग्स में भुगतान के तरीकों का चयन नहीं है और ऑथराइज़ेशन का आंशिक कैप्चर नहीं है।

ऑर्डर और रिफ़ंड

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

Pending payment: ग्राहक को Datatrans भेजा गया और उसने अभी भुगतान नहीं किया है, उसने भुगतान पेज पर रद्द कर दिया, या Datatrans ने अभी भुगतान की पुष्टि नहीं की है। हर नया लेन-देन उसकी ID और वातावरण के साथ ऑर्डर पर दर्ज होता है।

Processing, Completed or On Hold: भुगतान सेटल हो गया। स्थिति Order status after payment के अनुसार होती है। ऑर्डर नोट में राशि, भुगतान का तरीका, Datatrans लेन-देन ID और वातावरण (सैंडबॉक्स या लाइव) दिखता है। लेन-देन ID ऑर्डर में सेव होती है।

On hold, authorized: Auto settle बंद होने पर भुगतान ऑथराइज़ हुआ लेकिन कैप्चर नहीं हुआ। ऑर्डर खोलें और ऑर्डर एक्शन में Capture Datatrans payment या Cancel Datatrans authorization चुनें। कैप्चर ऑर्डर का मौजूदा कुल योग उपयोग करता है, जो ऑथराइज़ की गई राशि से अधिक नहीं होना चाहिए। यदि अधिक है, या Datatrans कैप्चर या रद्दीकरण अस्वीकार करता है, तो कारण ऑर्डर नोट्स में जोड़ दिया जाता है।

On hold after payment: Datatrans ने ऑर्डर के कुल योग से भिन्न राशि या मुद्रा बताई (उदाहरण के लिए, भुगतान शुरू होने के बाद ऑर्डर में बदलाव किया गया), या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर नोट इसे समझाता है। Datatrans Web Admin में लेन-देन जाँचें और ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Failed: भुगतान विफल हुआ या अस्वीकार हुआ। ग्राहक दोबारा कोशिश कर सकता है।

Cancelled: ऑथराइज़ेशन रिलीज़ कर दिया गया, ऑर्डर एक्शन से या Datatrans Web Admin में।

देर से आई विफलता या रद्दीकरण की सूचना भुगतान किए गए ऑर्डर को कभी नहीं बदलती। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा सफल भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट संभावित दोहरे चार्ज की चेतावनी देता है और ज़रूरत पड़ने पर उसे Datatrans में रिफ़ंड करने को कहता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Datatrans पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें भुगतान किया गया था, इसलिए उस वातावरण के क्रेडेंशियल सेट होने चाहिए। दोबारा कोशिश किया गया रिफ़ंड दो बार क्रेडिट नहीं होता। यदि Datatrans रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड राशि और Datatrans रिफ़ंड लेन-देन ID के साथ ऑर्डर नोट्स में जोड़ दिया जाता है।

केवल ऑथराइज़ किए गए भुगतान के लिए पूरी राशि का रिफ़ंड ऑथराइज़ेशन को रद्द कर देता है। भुगतान कैप्चर होने तक आंशिक रिफ़ंड संभव नहीं है।

Datatrans Web Admin में किए गए रिफ़ंड WooCommerce में दर्ज नहीं होते। ज़रूरत हो तो WooCommerce में Refund via Datatrans के बिना मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति की जाँच बैकग्राउंड में अपने-आप दोबारा होती है।

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

चेकआउट पर Datatrans नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और मौजूदा वातावरण का Merchant ID व API पासवर्ड सेट हैं: सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, अन्यथा लाइव फ़ील्ड। सेटिंग्स पेज छूटे हुए फ़ील्ड की सूची दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर भुगतान लंबित ही रहता है: Datatrans वेबहुक URL तक नहीं पहुँच सका और ग्राहक स्टोर पर नहीं लौटा। जाँचें कि साइट इंटरनेट से HTTPS के ज़रिए पहुँच योग्य है और कोई सुरक्षा प्लगइन या फ़ायरवॉल /wc-api/datatrans_payment_callback/ के अनुरोधों को ब्लॉक नहीं कर रहा। जाँचें कि सेटिंग्स की साइन कुंजी भुगतान के वातावरण की है। Logging चालू करें और WooCommerce > Status > Logs, स्रोत wcp_datatrans_gateway, देखें।

वेबहुक Invalid signature उत्तर देता है: सेटिंग्स की HMAC साइन कुंजी Datatrans Web Admin की कुंजी से मेल नहीं खाती, या दूसरे वातावरण की है। कुंजी दोबारा कॉपी करें।

वेबहुक Not configured या Verification failed उत्तर देता है: वेबहुक की जाँच Datatrans की स्टेटस API से करनी थी, लेकिन उस वातावरण के क्रेडेंशियल नहीं हैं, या Datatrans ने उत्तर नहीं दिया। Datatrans वेबहुक दोबारा भेजता है।

HMAC साइन कुंजी सेव नहीं होती: कुंजी हेक्साडेसिमल स्ट्रिंग होनी चाहिए। इसे Datatrans Web Admin से दोबारा कॉपी करें।

ग्राहक को The payment could not be started दिखता है: Merchant ID या API पासवर्ड गलत है, दूसरे वातावरण का है, या मुद्रा आपके Datatrans खाते के लिए सक्षम नहीं है। कारण देखने के लिए Logging चालू करें।

भुगतान के बाद ऑर्डर होल्ड पर है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से भिन्न थी, भुगतान ऑर्डर रद्द होने के बाद आया, या भुगतान केवल ऑथराइज़ है और कैप्चर की प्रतीक्षा कर रहा है।

कैप्चर संभव नहीं है: ऑर्डर का कुल योग ऑथराइज़ की गई राशि से अधिक है। कैप्चर ऑर्डर का मौजूदा कुल योग उपयोग करता है, इसलिए उसे ऑथराइज़ की गई राशि या उससे कम करें।

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

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

डेवलपर्स के लिए, readme में फ़िल्टर wcp_datatrans_gateway_init_request का उल्लेख है, उदाहरण के लिए Datatrans पेज पर दिखने वाले भुगतान के तरीकों को सीमित करने के लिए।

अनइंस्टॉल

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

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