VibeFox Tpay for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण। सूचनाओं के JWS हस्ताक्षर की जाँच के लिए OpenSSL एक्सटेंशन और secure.tpay.com तक आउटगोइंग HTTPS आवश्यक हैं।
मुद्रा: केवल पोलिश ज़्लॉटी (PLN)। Tpay PLN में सेटलमेंट करता है और उसके Open API में मुद्रा का फ़ील्ड नहीं है। यदि आपके स्टोर में PLN नहीं है, तो उसे System > Localisation > Currencies में जोड़ें: Tpay केवल तब दिखाया जाता है जब ग्राहक PLN में भुगतान करता है।
आपके स्टोर तक इंटरनेट पहुँच: Tpay भुगतान सूचनाएँ आपके स्टोर को भेजता है, इसलिए सूचना पता इंटरनेट से पहुँच योग्य होना चाहिए (फ़ायरवॉल या HTTP प्रमाणीकरण से अवरुद्ध न हो)।
Tpay खाता: Tpay मर्चेंट पैनल से आपको ये मान चाहिए: Merchant ID (आपकी Tpay खाता ID), Open API कुंजियाँ Client ID और Client secret (Integration, API), और सुरक्षा कोड (Settings, Notifications)। सैंडबॉक्स कुंजियाँ एक अलग Tpay सैंडबॉक्स खाते से आती हैं।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_tpay_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_tpay_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_tpay_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Tpay Payment ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. सैंडबॉक्स कुंजियाँ और प्रोडक्शन कुंजियाँ दर्ज करें (देखें Configuration)। सुरक्षा कोड के अलावा Tpay पैनल में कुछ भी सेट करने की ज़रूरत नहीं है: हर लेन-देन के साथ सूचना पता भेजा जाता है।
5. Enable/Disable चालू करें और Save पर क्लिक करें। सैंडबॉक्स मोड में एक भुगतान का परीक्षण करें, फिर वास्तविक भुगतान स्वीकार करने के लिए Sandbox mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_tpay_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में पैकेज उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Tpay Payment ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और Tpay की कुंजियाँ वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल सूचना URL अलग है (देखें भुगतान सूचनाएँ)।
नई इंस्टॉलेशन भुगतान विधि बंद और सैंडबॉक्स मोड चालू के साथ शुरू होती है।
Configuration
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज यह दिखाता है: Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. जब तक सैंडबॉक्स मोड चालू है। वर्तमान मोड की कुंजियाँ अधूरी होने पर (तब चेकआउट पर Tpay नहीं दिखता), स्टोर की डिफ़ॉल्ट मुद्रा PLN न होने पर (Tpay केवल तब दिखता है जब ग्राहक PLN में भुगतान करता है), और JWS जाँच चालू होने पर भी OpenSSL PHP एक्सटेंशन न होने पर (तब भुगतान पुष्ट नहीं होंगे) यह चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं हो सकता, Sort Order पूर्ण संख्या होना चाहिए (ऋणात्मक मान स्वीकार्य हैं), Total 0 या उससे अधिक की संख्या होना चाहिए, और ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा कुछ भी सेव नहीं होता। गायब कुंजियाँ सेव होने से नहीं रोकतीं। Merchant ID या Client ID के साथ चिपकाए गए स्पेस हटा दिए जाते हैं, और गुप्त मानों के आगे-पीछे के स्पेस काट दिए जाते हैं।
Tpay
Enable/Disable: Enable Tpay payments भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का शीर्षक। यही नाम ऑर्डर में भुगतान विधि के रूप में सेव होता है। डिफ़ॉल्ट: Tpay। अनिवार्य, अधिकतम 128 अक्षर।
Description: वह पाठ जो ग्राहक Confirm Order चरण पर पुष्टि बटन के ऊपर देखते हैं। डिफ़ॉल्ट: Pay with BLIK, online bank transfer or card on the secure Tpay page.
Sandbox mode: Tpay सैंडबॉक्स (टेस्ट भुगतान, कोई वास्तविक राशि नहीं) को सैंडबॉक्स कुंजियों और openapi.sandbox.tpay.com के साथ उपयोग करता है। वास्तविक भुगतान प्रोडक्शन कुंजियों से स्वीकार करने के लिए इसे बंद करें। रिफ़ंड हमेशा उसी वातावरण में होते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: चालू।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Tpay की स्थिति। खाली छोड़ें या पूर्ण संख्या दर्ज करें (ऋणात्मक मान स्वीकार्य हैं)।
Geo Zone: Tpay केवल चुने गए भौगोलिक क्षेत्र के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। भौगोलिक क्षेत्र System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह राशि, जिस तक पहुँचने पर ही Tpay दिया जाए। किसी भी राशि पर Tpay देने के लिए खाली छोड़ें।
प्रोडक्शन कुंजियाँ
कहाँ मिलेंगी: Tpay मर्चेंट पैनल में (यह सेक्शन वहाँ का लिंक देता है), Integration, API के अंतर्गत (Open API कुंजियाँ: Client ID और Secret); Merchant ID आपकी Tpay खाता ID है; सुरक्षा कोड Settings, Notifications में है।
Merchant ID: आपकी Tpay खाता ID (अंक)। Tpay इसे हर सूचना में भेजता है।
Client ID: Open API का Client ID।
Client secret: Open API का Client secret।
Security code: Tpay सूचनाओं के MD5 चेकसम की जाँच के लिए उपयोग होता है।
सैंडबॉक्स कुंजियाँ
सैंडबॉक्स अपनी कुंजियों वाला एक अलग Tpay टेस्ट खाता है (यह सेक्शन Tpay API दस्तावेज़ से लिंक करता है)। यह केवल तब उपयोग होता है जब Sandbox mode चालू हो।
Sandbox Merchant ID: सैंडबॉक्स खाते का Merchant ID।
Sandbox Client ID: सैंडबॉक्स खाते का Open API Client ID।
Sandbox Client secret: सैंडबॉक्स खाते का Open API Client secret।
Sandbox Security code: सैंडबॉक्स खाते का सूचना सुरक्षा कोड।
सेव किए गए गुप्त मान (दोनों वातावरणों के Client secret और Security code) दोबारा नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया गया गुप्त मान हटाने के लिए फ़ील्ड के नीचे Clear the saved value चुनें और Save पर क्लिक करें।
भुगतान सूचनाएँ
Notification URL: Tpay यहाँ दिखाए गए पते पर भुगतानों की पुष्टि करता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_tpay_payment/notify जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_tpay_payment/payment/wcp_tpay_payment.notify जैसा। यह आपके OpenCart इंस्टॉलेशन के storefront पते से बनता है। यह पता हर लेन-देन के साथ अपने-आप भेजा जाता है; सुरक्षा कोड के अलावा Tpay पैनल में कुछ भी सेट करने की ज़रूरत नहीं है। ऑर्डर को तभी स्थिति मिलती है जब मान्य चेकसम और हस्ताक्षर वाली, और मेल खाती राशि वाली सूचना आए (या ग्राहक के लौटने पर मेल खाती स्थिति जाँच हो)। Tpay तब तक सूचना दोहराता है जब तक आपका स्टोर उसे स्वीकार न करे। मेंटेनेंस मोड यह पता अवरुद्ध नहीं करता (OpenCart 4 पर एक्सटेंशन सूचनाओं और ग्राहक की वापसी के लिए एक स्टार्टअप क्रिया जोड़ता है)।
JWS signature: Tpay प्रमाणपत्र से सूचनाओं के X-JWS-Signature को भी सत्यापित करता है (अनुशंसित)। इसके लिए PHP OpenSSL एक्सटेंशन और secure.tpay.com तक आउटगोइंग HTTPS चाहिए। प्रमाणपत्र एक दिन के लिए कैश होते हैं। MD5 चेकसम हमेशा सत्यापित होता है। डिफ़ॉल्ट: चालू।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब Tpay भुगतान की पुष्टि कर दे (सूचना या स्थिति जाँच से)। नीचे हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।
Paid Order Status: पुष्ट भुगतान के बाद की स्थिति। डिफ़ॉल्ट: प्रोसेसिंग।
On Hold (Review) Status: भुगतान को आपकी समीक्षा चाहिए (देखें Order statuses)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Order Status: एक्सटेंशन यह स्थिति कभी सेट नहीं करता। इस स्थिति वाले ऑर्डर के लिए भुगतान ऑर्डर को चुपचाप दोबारा खोलने के बजाय समीक्षा में डाल देता है। डिफ़ॉल्ट: रद्द।
Refunded Status: ऑर्डर पेज से भुगतान का पूरा रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: रिफ़ंड किया गया।
उन्नत
Debug log: भुगतान घटनाएँ लॉग करता है: केवल तकनीकी घटनाएँ (कोई कुंजी नहीं, कोई ग्राहक डेटा नहीं) OpenCart लॉग फ़ोल्डर (storage/logs) में wc_tp_debug.log.php में। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB होने पर एक पुरानी प्रति में ले जाई जाती है। डिफ़ॉल्ट: बंद। बंद रहने पर त्रुटियों सहित कुछ भी नहीं लिखा जाता, इसलिए किसी समस्या का कारण खोजने से पहले इसे चालू करें।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनका Tpay भुगतान डेटा हमेशा रहता है। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। Client secret और Security code निर्यात नहीं होते।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए Client secret और Security code बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Tpay)। Confirm Order चरण पर ग्राहक आपका विवरण और नोट You will be redirected to the secure Tpay page to complete the payment. देखता है। सैंडबॉक्स मोड में यह Sandbox mode - no real money is charged. भी दिखाता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।
जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन PLN में ऑर्डर की कुल राशि के लिए Tpay लेन-देन बनाता है, विवरण के रूप में Order # और ऑर्डर नंबर के साथ, ग्राहक का नाम, ईमेल, भुगतान पता और फ़ोन पास करता है, और ग्राहक को Tpay भुगतान पेज पर भेजता है। यह पेज ऑर्डर की भाषा के अनुसार पोलिश, अंग्रेज़ी या यूक्रेनी में दिखता है (अन्य भाषाओं को अंग्रेज़ी मिलती है)। वहाँ ग्राहक BLIK, बैंक ट्रांसफ़र, कार्ड या आपके Tpay खाते में सक्षम कोई अन्य विधि चुनता है और भुगतान करता है।
ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Tpay उसकी पुष्टि करता है। Tpay आपके स्टोर को एक सूचना भेजता है; एक्सटेंशन भुगतान शुरू हुए वातावरण की कुंजियों से सुरक्षा कोड, Merchant ID और (चालू होने पर) JWS हस्ताक्षर के साथ MD5 चेकसम जाँचता है, फिर राशि: वह इस भुगतान प्रयास के लिए माँगी गई राशि और ऑर्डर की कुल राशि के बराबर होनी चाहिए, और भुगतान की गई राशि कम नहीं हो सकती। मान्य चेकसम या हस्ताक्षर के बिना सूचनाएँ अस्वीकार होती हैं। फिर ऑर्डर OpenCart के सामान्य तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। केवल लौटने से कुछ भी भुगतान किया हुआ नहीं माना जाता। यदि सूचना अभी नहीं आई है, तो एक्सटेंशन Tpay API से लेन-देन की स्थिति माँगता है (अधिकतम हर 10 सेकंड में एक बार) और वही जाँच लागू करता है। भुगतान पुष्ट होने पर ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। पुष्टि होने तक एक Payment confirmation पेज Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: दिखाता है, साथ में Refresh बटन और एक Pay again बटन जो चेकआउट पर वापस ले जाता है। सूचना आते ही ऑर्डर स्थिति सेट कर देती है। यदि ऑर्डर समीक्षा में गया हो, तो सफलता पेज पर Your payment is being verified. We will contact you as soon as it is confirmed. भी दिखता है।
यदि Tpay रिपोर्ट करता है कि भुगतान नहीं हुआ, तो ग्राहक Tpay reports that the payment did not go through. Please try again or choose another payment method. दिखाते हुए चेकआउट पर लौट आता है। यदि भुगतान Tpay पेज पर विफल होता है, तो Tpay ग्राहक को चेकआउट पेज पर वापस भेज देता है। दोनों स्थितियों में कार्ट सुरक्षित रहता है।
OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए Pay again उसी ऑर्डर का एक नया भुगतान प्रयास शुरू करता है। हर भुगतान प्रयास का अपना संदर्भ होता है। जब ग्राहक दोबारा भुगतान करता है, तो उस ऑर्डर और उसी कार्ट के अन्य ऑर्डरों के पिछले बिना भुगतान वाले Tpay लेन-देन Tpay पर रद्द कर दिए जाते हैं; पिछले लिंक से पहले ही पूरा हुआ भुगतान फिर भी स्वीकार होता है। यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले ही भुगतान किया जा चुका है, तो ग्राहक नए भुगतान के बजाय सफलता पेज पर जाता है।
OpenCart 4 पर, यदि चेकआउट का ऑर्डर इस बीच स्टोर द्वारा बंद कर दिया गया हो, या वह पहले ही भुगतान हो चुका हो पर कार्ट बदल गया हो (नई मात्रा सहित), तो ग्राहक Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. संदेश के साथ चेकआउट पर लौटा दिया जाता है। जिस ऑर्डर को स्टोर ने किसी भुगतान से पहले रद्द किया हो, उसके लिए संदेश है Order #… was cancelled by the store before the payment was completed. No Tpay payment was received for it. Please place a new order or contact us. अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। OpenCart 4 पर ये संदेश, विफल भुगतान का संदेश और We could not match this payment to an order. If you were charged, please contact us. चेकआउट पेज के ऊपर दिखाए जाते हैं।
यदि Tpay भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और The Tpay payment could not be started. Please try again or choose another payment method. देखता है, और कारण (यदि Debug log चालू है) लॉग में जाता है। अन्य संदेश: Tpay accepts payments in Polish złoty (PLN) only. Please choose another payment method. और The order total must be greater than zero.
यह एक्सटेंशन केवल PLN में काम करता है। स्टोर में बैंक या BLIK कोड का चयन नहीं है (ग्राहक यह Tpay पेज पर चुनता है), सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन नहीं हैं, स्टोर में Apple Pay या Google Pay बटन नहीं हैं, और किस्त कैलकुलेटर नहीं हैं।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Tpay पर भेजा गया और उसने भुगतान नहीं किया, या Tpay ने अभी भुगतान की पुष्टि नहीं की है। विफल भुगतान भी ऑर्डर को बिना स्थिति के छोड़ता है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Paid Order Status (default Processing): Tpay ने भुगतान की पुष्टि की है। एक नोट Tpay लेन-देन का शीर्षक (TR-...), भुगतान की गई राशि, पुष्टि सूचना से हुई या स्थिति जाँच से, वातावरण, और कोई अधिक भुगतान हो तो वह दिखाता है।
On Hold (Review) Status (default Pending): भुगतान आया, पर ऑर्डर की मुद्रा PLN नहीं है, उसकी राशि माँगी गई राशि या ऑर्डर की कुल राशि से मेल नहीं खाती (जैसे भुगतान शुरू होने के बाद ऑर्डर बदला गया), केवल आंशिक भुगतान हुआ, या भुगतान Cancelled Order Status वाले ऑर्डर के लिए आया। नोट इसे समझाता है। Tpay पैनल में भुगतान जाँचें और ऑर्डर पूरा करें या रिफ़ंड करें। यदि ग्राहक बाद में किसी दूसरे प्रयास से सही राशि चुकाता है, तो ऑर्डर Paid Order Status पर चला जाता है।
Refunded Status (default Refunded): एक्सटेंशन के माध्यम से भुगतान का पूरा रिफ़ंड हुआ।
यदि Tpay किसी ऐसे ऑर्डर के लिए कोई और भुगतान रिपोर्ट करता है जो पहले से भुगतान किया या रिफ़ंड किया हुआ है, तो ऑर्डर नहीं बदलता; एक नोट आवश्यकता होने पर अतिरिक्त भुगतान Tpay पैनल में रिफ़ंड करने को कहता है। पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर का भुगतान उस ऑर्डर को बिना स्थिति के छोड़ देता है और भुगतान किए गए ऑर्डर पर नोट होता है। जिस ऑर्डर की पहले से स्थिति है उसके लिए विफल भुगतान, चार्जबैक और अज्ञात Tpay स्थिति केवल नोट जोड़ते हैं।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Tpay Payment टैब
Sales > Orders में Tpay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Tpay Payment टैब Tpay transaction शीर्षक और Transaction ID, भुगतान संदर्भ (CRC), Environment (सैंडबॉक्स भुगतानों के लिए Sandbox लेबल), भुगतान का Status और उसकी पुष्टि का तरीका, भुगतान की गई राशि, Order total / refunded, ऑर्डर की कुल राशि से अलग होने पर Refundable (paid through Tpay), रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, ऑर्डर के Payment attempts (रद्द लिंक के लिए link cancelled) और Payment notes दिखाता है। यह टैब एक्सटेंशन की पहुँच वाले उपयोगकर्ताओं को दिखता है।
रिफ़ंड
टैब में Amount दर्ज करें (अभी तक रिफ़ंड न हुई राशि भर जाती है), वैकल्पिक रूप से Reason (optional, kept in the note), और Refund via Tpay पर क्लिक करें। प्रश्न Refund this amount through Tpay? This cannot be undone. की पुष्टि करें। Tpay के माध्यम से भुगतान प्राप्त ऑर्डरों (समीक्षाधीन ऑर्डर सहित) के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। आप भुगतान करने वाले Tpay लेन-देन द्वारा ली गई राशि तक रिफ़ंड कर सकते हैं, पर ऑर्डर की कुल राशि से अधिक नहीं। रिफ़ंड उस वातावरण (सैंडबॉक्स या प्रोडक्शन) को भेजा जाता है जहाँ ऑर्डर का भुगतान हुआ था, इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए। रिफ़ंड तभी पूरा माना जाता है जब Tpay उसकी पुष्टि करे; Tpay द्वारा अस्वीकृत या अपुष्ट रिफ़ंड त्रुटि के रूप में दिखता है और दर्ज नहीं होता। सफल रिफ़ंड आपके दिए कारण के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है (कारण Tpay को नहीं भेजा जाता)। रिफ़ंड योग्य पूरी राशि का रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस किए बिना, मैन्युअल स्थिति बदलाव की तरह, ऑर्डर को Refunded Status पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता।
Sales > Returns में उत्पाद वापसी से Tpay के माध्यम से पैसे वापस नहीं जाते। Tpay मर्चेंट पैनल में किए गए रिफ़ंड OpenCart में अपने-आप नहीं जुड़ते।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Tpay Payment, Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-tpay पंक्ति और आपके vibefox.net खाते को खोलने वाला Manage licenses and domains in your account लिंक है। केवल उन एडमिन उपयोगकर्ताओं के पास, जिनके पास एक्सटेंशन पर Modify अधिकार है, कुंजी बदलने की शक्ति है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या आपके खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर से संपर्क नहीं हो पाता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, Tpay चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को 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 की ज़रूरत नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
Tpay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड की सभी चार कुंजियाँ (Merchant ID, Client ID, Client secret, Security code) दर्ज हैं। जाँचें कि ग्राहक PLN में भुगतान करता है, कि भुगतान पता चुने गए Geo Zone में है, और कि ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है। सेटिंग्स पेज गायब कुंजियों और गैर-PLN स्टोर मुद्रा के लिए चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: Tpay सूचना नहीं पहुँचा सका या उसे अस्वीकार किया गया। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण हैं: भुगतान के वातावरण के लिए गलत सुरक्षा कोड या Merchant ID, अवरुद्ध सूचना पता (फ़ायरवॉल, HTTP प्रमाणीकरण), या JWS जाँच के लिए OpenSSL या आउटगोइंग HTTPS के बिना सर्वर। भुगतान के बाद ग्राहक स्टोर पर लौटता है तो ऑर्डर को भी स्थिति मिल जाती है।
Notification answered FALSE - invalid checksum: सेटिंग्स का Merchant ID या सुरक्षा कोड भुगतान के Tpay खाते (सैंडबॉक्स या प्रोडक्शन) से मेल नहीं खाता।
Notification answered FALSE - invalid JWS signature: हस्ताक्षर सत्यापित नहीं हो सका, उदाहरण के लिए OpenSSL नहीं है या Tpay प्रमाणपत्र डाउनलोड नहीं हो सकता। सर्वर ठीक करें या ज़रूरत हो तो JWS signature बंद करें; MD5 चेकसम फिर भी जाँचा जाता है।
Notification answered FALSE - busy, retry later या FALSE - order could not be updated: कार्ट उसी समय किसी दूसरे अनुरोध द्वारा संसाधित हो रहा था, या ऑर्डर स्थिति सेट नहीं हो सकी। Tpay सूचना अपने-आप दोबारा भेजता है। कारण देखने के लिए Debug log चालू करें।
सूचना URL पर FALSE - POST only in the browser दिखता है: यह सामान्य है। यह URL केवल Tpay की सूचनाएँ स्वीकार करता है।
ऑर्डर समीक्षा स्थिति में है: VibeFox Tpay Payment टैब के नोट पढ़ें (देखें Order statuses), Tpay पैनल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
ग्राहक ने The Tpay payment could not be started देखा: वर्तमान मोड की कुंजियाँ गलत हैं या Tpay ने अनुरोध अस्वीकार किया। Debug log चालू करें; लॉग में Tpay की त्रुटि दिखेगी।
ग्राहक ने This payment method is not available देखा: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद हो गई या उसकी कुंजियाँ चली गईं। ग्राहक चेकआउट रीलोड करता है।
ग्राहक ने We could not match this payment to an order देखा: वापसी लिंक इस ऑर्डर का नहीं था। यदि ग्राहक से पैसे कट चुके हैं, तो सूचना फिर भी ऑर्डर स्थिति सेट करती है; Tpay पैनल जाँचें।
रिफ़ंड विफल होता है: यदि संदेश कहता है कि कुंजियाँ गायब हैं, तो उस वातावरण की कुंजियाँ दर्ज करें जहाँ ऑर्डर का भुगतान हुआ था। यदि कहता है कि राशि बहुत अधिक है, तो केवल दिखाई गई राशि तक ही रिफ़ंड हो सकता है। यदि Tpay ने रिफ़ंड की पुष्टि नहीं की है, तो दोबारा कोशिश करने से पहले Tpay मर्चेंट पैनल में लेन-देन जाँचें। यदि टैब में Tpay transaction ID not found. दिखता है, तो ऑर्डर के पास रिफ़ंड करने योग्य पुष्ट Tpay भुगतान नहीं है।
डेवलपर्स के लिए: Tpay लेन-देन बनने से पहले एक्सटेंशन लेन-देन डेटा, ऑर्डर और वातावरण के साथ OpenCart इवेंट wc_tp_transaction_data ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Tpay Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन की OpenCart घटना (OpenCart 4 पर इसकी घटनाएँ और इसकी स्टार्टअप क्रिया भी) और कैश किए गए Tpay एक्सेस टोकन तथा प्रमाणपत्र भी हमेशा हटाए जाते हैं। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, कुंजियाँ, JWS हस्ताक्षर, डीबग लॉग स्विच) और लॉग भी हटते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। Tpay लेन-देन और रिफ़ंड हमेशा रहते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड हो सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Tpay Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Tpay उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Tpay से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।