VibeFox Datatrans for OpenCart — सहायता

आवश्यकताएँ

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

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

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

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Datatrans सैंडबॉक्स Web Admin के सैंडबॉक्स क्रेडेंशियल दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। सैंडबॉक्स मोड में एक टेस्ट भुगतान करें। सब कुछ काम करने पर प्रोडक्शन क्रेडेंशियल दर्ज करें और Sandbox mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। जब भुगतान विधि सक्षम हो, पर वर्तमान वातावरण में मर्चेंट 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. दिखाता है। एक्सटेंशन को संशोधित करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

Datatrans

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

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via Datatrans.

Sandbox mode: Datatrans सैंडबॉक्स का उपयोग करता है: केवल टेस्ट भुगतान, कोई वास्तविक पैसा नहीं। यह स्विच Datatrans सर्वरों और नए भुगतानों के लिए उपयोग होने वाले क्रेडेंशियल, दोनों को बदल देता है। डिफ़ॉल्ट: चालू। वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर Sandbox mode: no real payment is taken. देखते हैं। रिफ़ंड और कैप्चर हमेशा उसी वातावरण का उपयोग करते हैं जिसमें भुगतान हुआ था, चाहे यह स्विच कुछ भी हो।

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

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

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

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

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

Sandbox merchant ID: आपके सैंडबॉक्स खाते की मर्चेंट ID।

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

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

प्रोडक्शन क्रेडेंशियल

इन्हें Datatrans प्रोडक्शन Web Admin (admin.datatrans.com) से कॉपी करें।

Production merchant ID: आपके प्रोडक्शन खाते की मर्चेंट ID।

Production API password: प्रोडक्शन खाते का सर्वर-से-सर्वर API पासवर्ड।

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

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

Webhook URL

यह सेक्शन आपके स्टोर का वेबहुक URL दिखाता है। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_datatrans_gateway/webhook, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_datatrans_gateway/payment/wcp_datatrans_gateway.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। एक्सटेंशन यह URL हर लेन-देन के साथ Datatrans को भेजता है, इसलिए आपको इसे कहीं दर्ज नहीं करना है। आप इसे Datatrans Web Admin की वेबहुक सेटिंग्स में भी डाल सकते हैं, ताकि वहाँ किए गए कैप्चर और रद्दीकरण के अपडेट मिलें। इसे ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। Datatrans Web Admin में किए गए रिफ़ंड ऑर्डर में दर्ज नहीं होते।

वेबहुक लेन-देन की स्थिति बताता है। एक्सटेंशन इन स्थितियों के अनुसार काम करता है:

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

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

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

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

Order status after payment: भुगतान settle होने और उसकी राशि व मुद्रा मेल खाने पर ऑर्डर का स्टेटस। डिफ़ॉल्ट: Processing।

Datatrans payment on hold: केवल authorize हुए भुगतान (Auto settle बंद), राशि या मुद्रा का बेमेल, और ऑर्डर रद्द होने के बाद आए भुगतान। एक नोट कारण समझाता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Authorization canceled: Cancel Datatrans authorization से या Datatrans Web Admin में authorization जारी होने पर सेट होता है। डिफ़ॉल्ट: Canceled।

Refunded: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।

उन्नत

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

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से मॉड्यूल सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों के Datatrans भुगतान रिकॉर्ड (लेन-देन, रिफ़ंड) बने रहते हैं। डिफ़ॉल्ट: बंद।

आयात / निर्यात

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। पासवर्ड और साइन कुंजियाँ निर्यात नहीं होतीं।

Import: पहले निर्यात की गई JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए पासवर्ड और साइन कुंजियाँ बने रहते हैं।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Datatrans उसकी पुष्टि करे: या तो वेबहुक से, या ग्राहक के लौटने पर सर्वर-साइड से Datatrans status API के अनुरोध से। लौटने के पते में भुगतान प्रयास का एक यादृच्छिक टोकन होता है, और वह पता स्वयं कभी भरोसेमंद नहीं माना जाता। फिर ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है, जिस पर Your payment with Datatrans has been received. लिखा होता है। केवल authorize हुए भुगतान के लिए पेज पर Your payment with Datatrans has been authorized. The amount will be charged when your order is processed. दिखता है। यदि Datatrans ने अभी भुगतान की पुष्टि नहीं की है, तो Payment confirmation पेज Your payment is being confirmed by Datatrans. You will receive an e-mail as soon as it is confirmed. Please do not pay again. दिखाता है, साथ में Check again और Back to checkout बटन होते हैं; वेबहुक पहुँचते ही ऑर्डर स्टेटस सेट कर देता है। OpenCart 4 पर, जब Datatrans ग्राहक को वापस भेजता है तो ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो स्टोर से उसी वापसी पते को दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।

यदि ग्राहक Datatrans पेज पर रद्द करता है, तो वह 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. OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, और नया प्रयास उसी ऑर्डर के लिए एक नया Datatrans लेनदेन होता है। नया भुगतान शुरू होने से पहले, उसी कार्ट के पिछले ऑर्डरों के खुले Datatrans लेन-देन जाँचे जाते हैं: भुगतान किया हुआ या authorize हुआ लेन-देन नए भुगतान के बजाय पुष्ट किया जाता है, और खुला लेन-देन Datatrans पर रद्द किया जाता है। कार्ट एक ही बार भुगतान होता है: यदि उसी कार्ट का कोई और ऑर्डर पहले से भुगतान किया हुआ या authorize हुआ है, तो नया भुगतान शुरू नहीं होता और ग्राहक सफलता पेज पर चला जाता है। यदि पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर का भुगतान फिर भी आता है, तो वह ऑर्डर बिना स्टेटस के रहता है, और भुगतान किए गए ऑर्डर पर एक नोट लगता है कि Datatrans में दोहरे भुगतान की जाँच करके उसे रिफ़ंड करें।

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

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

स्टोर के मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है, OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को गुज़रने देता है, और OpenCart 4 पर एक्सटेंशन एक स्टार्टअप ऐक्शन जोड़ता है जो वेबहुक और ग्राहक की वापसी को गुज़रने देता है।

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

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

ऑर्डर स्टेटस

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

Order status after payment (default Processing): भुगतान settle हो गया। एक नोट राशि, भुगतान विधि, Datatrans लेन-देन ID, वातावरण, और पुष्टि कैसे हुई (वेबहुक या वापसी) दिखाता है।

Datatrans payment on hold after an authorization (default Pending): Auto settle बंद है और भुगतान केवल authorize हुआ है। ऑर्डर टैब में इसे कैप्चर या रद्द करें।

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

Authorization canceled (default Canceled): authorization ऑर्डर टैब में या Datatrans Web Admin में जारी किया गया।

Refunded (default Refunded): भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड किया गया।

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

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

VibeFox Datatrans Gateway टैब

Sales > Orders में Datatrans से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Datatrans Gateway टैब सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ Transaction ID, Datatrans का Status, Payment method, Amount, Paid / refunded राशियाँ, कैप्चर और रद्द करने के बटन या रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, और ऑर्डर के Datatrans notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है। इसकी कार्रवाइयों के लिए एक्सटेंशन संशोधित करने का अधिकार चाहिए (यह System > Users > User Groups में सेट होता है)।

कैप्चर और रद्द करना

केवल authorize हुए भुगतान के लिए टैब Capture Datatrans payment और Cancel Datatrans authorization दिखाता है। कैप्चर वर्तमान ऑर्डर कुल के लिए भुगतान settle करता है, जो authorize की गई राशि से अधिक नहीं हो सकती; फिर ऑर्डर Order status after payment पर चला जाता है। रद्द करने से authorization जारी होता है और ऑर्डर Authorization canceled पर सेट होता है। दोनों कार्रवाइयाँ भुगतान के वातावरण में जाती हैं। यदि Datatrans मना करता है, तो टैब त्रुटि दिखाता है और एक नोट जुड़ता है।

रिफ़ंड

टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) भी लिखें, और Refund via Datatrans पर क्लिक करें। Refund this amount through Datatrans? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं, उस राशि तक जो Datatrans ने वास्तव में चार्ज की थी, घटाकर पिछले रिफ़ंड। रिफ़ंड भुगतान के वातावरण में भेजा जाता है, इसलिए उस वातावरण की मर्चेंट ID और API पासवर्ड सेट होने चाहिए। दोबारा प्रयास किया गया रिफ़ंड दो बार क्रेडिट नहीं होता। यदि Datatrans रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड, Datatrans रिफ़ंड लेन-देन ID के साथ, रिफ़ंड इतिहास और नोट्स में जुड़ जाता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना ऑर्डर को Refunded पर सेट करता है, जैसे मैन्युअल स्टेटस बदलना। आंशिक रिफ़ंड स्टेटस नहीं बदलता।

रिफ़ंड तभी उपलब्ध होते हैं जब Datatrans भुगतान settle कर चुका हो। केवल authorize हुए भुगतान के बजाय उसे कैप्चर या रद्द किया जाता है, और जिस authorization की राशि मेल नहीं खाती, उसे settle होने तक रिफ़ंड नहीं किया जा सकता।

Sales > Returns में उत्पाद वापसी Datatrans के माध्यम से पैसे वापस नहीं भेजती। Datatrans Web Admin में किए गए रिफ़ंड OpenCart में रिकॉर्ड नहीं होते।

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

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

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

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

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

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रहा: Datatrans वेबहुक URL तक नहीं पहुँच सका और ग्राहक स्टोर पर वापस नहीं आया। जाँचें कि स्टोर इंटरनेट से पहुँच योग्य है और कोई फ़ायरवॉल वेबहुक URL के अनुरोधों को ब्लॉक नहीं कर रहा। जाँचें कि सेटिंग्स की साइन कुंजी भुगतान के वातावरण की है। एक्सटेंशन पेज पर Log फ़ील्ड देखें।

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

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

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

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

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

ग्राहक को Datatrans payments are not configured yet दिखता है: वर्तमान वातावरण की मर्चेंट ID या API पासवर्ड गायब है।

ग्राहक को The payment could not be started दिखता है: Log फ़ील्ड देखें। गलत मर्चेंट ID या API पासवर्ड, या गलत वातावरण के क्रेडेंशियल, आम कारण हैं।

ग्राहक को We could not verify the payment दिखता है: लौटने का पता ऑर्डर के किसी भुगतान प्रयास से मेल नहीं खाया। यदि पैसे चार्ज हो गए हैं, तो भी वेबहुक ऑर्डर स्टेटस सेट करता है।

भुगतान के बाद ऑर्डर on hold स्टेटस में है: ऑर्डर टैब में Datatrans notes पढ़ें (ऑर्डर स्टेटस देखें), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

कैप्चर अस्वीकृत होता है: ऑर्डर की कुल राशि authorize की गई राशि से अधिक है। Datatrans authorize की गई राशि से अधिक settle नहीं कर सकता।

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

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

डेवलपर के लिए: Datatrans लेन-देन बनने से पहले, एक्सटेंशन अनुरोध बॉडी और ऑर्डर के साथ OpenCart इवेंट datatrans_p_init_request ट्रिगर करता है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Datatrans Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटा देता है: Enable/Disable, Sort Order, Geo Zone, Total, और Payment processing सेक्शन के चार ऑर्डर स्टेटस, जो पुनः इंस्टॉल पर अपने डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप ऐक्शन, जो मेंटेनेंस मोड में Datatrans को आगे जाने देता है)। यदि Delete data on uninstall चालू है, तो बाकी मॉड्यूल सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, क्रेडेंशियल, auto settle, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो उन्हें बाद में पुनः इंस्टॉल के लिए रखा जाता है। Datatrans के लेन-देन और रिफ़ंड हमेशा बने रहते हैं, इसलिए पहले भुगतान किए गए ऑर्डर पुनः इंस्टॉल के बाद भी रिफ़ंड या कैप्चर किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट बनाए रखते हैं।

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

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