VibeFox Tranzila for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का।
मुद्रा: ILS, USD, EUR या GBP। अन्य ग्राहक मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपी रहती है।
Tranzila टर्मिनल: आपको टर्मिनल का नाम चाहिए। हैंडशेक के लिए और ऑर्डर पेज से रिफ़ंड के लिए टर्मिनल पासवर्ड (TranzilaPW) ज़रूरी है। कुछ टर्मिनलों को रिफ़ंड के लिए अलग क्रेडिट पासवर्ड (CreditPass) भी चाहिए। टर्मिनल का नाम और पासवर्ड Tranzila देता है: अपनी टर्मिनल सेटिंग्स देखें या Tranzila सहायता से पूछें। परीक्षण के लिए Tranzila एक अलग टेस्ट टर्मिनल देता है; उसका नाम टर्मिनल नाम के रूप में दर्ज करें।
असली विज़िटर IP: भुगतान सूचनाएँ Tranzila सर्वर के IP पते से जाँची जाती हैं। यदि आपका स्टोर Cloudflare जैसे प्रॉक्सी या CDN के पीछे है, तो वेब सर्वर को असली विज़िटर IP PHP तक पहुँचाना होगा (REMOTE_ADDR)।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ही zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनपैक करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_tranzila_payment_gateway.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Tranzila Payment Gateway ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key के अंदर अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. यदि आप हैंडशेक या रिफ़ंड का उपयोग करते हैं तो Terminal name (supplier) और Terminal password (TranzilaPW) भरें।
5. Notifications चालू रखें और Trusted IP जाँचें: उसमें वे IP पते होने चाहिए जहाँ से Tranzila सूचनाएँ भेजता है। सूची Tranzila सहायता से पक्की करें। भुगतान सूचना URL हर भुगतान के साथ भेजा जाता है, इसलिए आपको उसे कहीं कॉपी करने की ज़रूरत नहीं है।
6. सुझाव: Tranzila टर्मिनल में हैंडशेक सक्षम करें, वहाँ अपने सर्वर का IP अनुमत करें, फिर एक्सटेंशन में Handshake चालू करें।
7. Enable/Disable चालू करें, Save पर क्लिक करें और Tranzila टेस्ट टर्मिनल से एक भुगतान का परीक्षण करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_tranzila_payment_gateway.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Tranzila Payment Gateway ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 7 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
नया इंस्टॉल भुगतान विधि बंद होने के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब टर्मिनल नाम खाली हो (तब भुगतान विधि चेकआउट पर छिपी रहती है), जब सूचनाएँ बंद हों या Trusted IP खाली हो (तब भुगतान किए गए ऑर्डर मैनुअल समीक्षा के लिए रोके जाते हैं), जब टर्मिनल पासवर्ड के बिना हैंडशेक चालू हो (भुगतान पेज नहीं खुल सकता), और जब स्टोर की डिफ़ॉल्ट मुद्रा समर्थित न हो। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
सेव करते समय पेज एक साथ सब कुछ अस्वीकार नहीं करता। खाली या 128 अक्षरों से लंबा Title, अमान्य टर्मिनल नाम, Trusted IP में अमान्य प्रविष्टि, पूर्ण संख्या न होने वाला संख्या फ़ील्ड, या अमान्य Sort Order, Total, Geo Zone या ऑर्डर स्टेटस सेव नहीं होते: पेज सेटिंग्स के ऊपर लाल ब्लॉक में संदेश दिखाता है और फ़ील्ड पिछला मान फिर से दिखाता है। अनुमत सीमा से बाहर की संख्या निकटतम अनुमत मान के रूप में सेव होती है, और पेज आपको बताता है, जैसे कि 5000, 400–1500 की सीमा से बाहर है और 1500 के रूप में सेव हुआ। बाकी सभी फ़ील्ड सेव होते हैं।
Tranzila
Enable/Disable: Enable Tranzila Payment Gateway भुगतान विधि चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम और भुगतान पेज का शीर्षक। यह ऑर्डर में भी भुगतान विधि के नाम के रूप में सेव होता है, इसलिए यह आवश्यक है और अधिकतम 128 अक्षर हो सकता है। डिफ़ॉल्ट: Credit Card (Tranzila)।
Description: Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay securely with your credit card on the Tranzila payment page।
Sort Order: चेकआउट पर भुगतान विधियों के बीच Tranzila की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें (ऋणात्मक मान स्वीकार्य हैं)।
Geo Zone: Tranzila केवल चुने गए geo zone के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक पहुँचने पर ही Tranzila दिया जाए। किसी भी राशि के लिए Tranzila देने हेतु खाली छोड़ें।
टर्मिनल
Terminal name (supplier): आपके Tranzila टर्मिनल का नाम, उदाहरण के लिए myshop। केवल अक्षर, अंक, "-" और "_"। जब तक यह दर्ज नहीं होता, चेकआउट पर भुगतान विधि नहीं दिखाई जाती। परीक्षण के लिए अपने Tranzila टेस्ट टर्मिनल का नाम दर्ज करें।
Terminal password (TranzilaPW): टर्मिनल का API पासवर्ड। हैंडशेक और ऑर्डर पेज से रिफ़ंड के लिए आवश्यक।
Refund password (CreditPass): केवल तभी जब आपका टर्मिनल क्रेडिट (रिफ़ंड) लेन-देन के लिए अलग पासवर्ड माँगे। अन्यथा खाली छोड़ें।
सेव किए गए पासवर्ड दोबारा नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव किया हुआ पासवर्ड हटाने के लिए फ़ील्ड के नीचे Clear saved password on save पर टिक करें और Save पर क्लिक करें।
भुगतान पेज
Payment page version: iFrame में दिखाया जाने वाला Tranzila पेज।
Payment page language: Tranzila पेज की भाषा: Site language, हिब्रू, अंग्रेज़ी, रूसी, स्पेनिश, जर्मन, फ़्रेंच या जापानी। डिफ़ॉल्ट: Hebrew। Site language ग्राहक की स्टोर भाषा का उपयोग करता है जब वह इनमें से एक हो, अन्यथा अंग्रेज़ी।
iFrame width (px): 300 से 1200। डिफ़ॉल्ट: 600। छोटी स्क्रीन पर फ़्रेम पेज से कभी चौड़ा नहीं होता।
iFrame height (px): 400 से 1500। डिफ़ॉल्ट: 650।
Max installments: भुगतान पेज पर ग्राहक जितनी अधिकतम किश्तें (tashlumim) चुन सकता है, 36 तक। 0 या 1 का अर्थ है कोई किश्त नहीं। डिफ़ॉल्ट: 0। टर्मिनल को किश्तों की प्रोसेसिंग की अनुमति होनी चाहिए।
Handshake: हैंडशेक टोकन से राशि लॉक करता है (अनुशंसित)। भुगतान पेज खोलने से पहले स्टोर Tranzila से राशि से बँधा एक बार उपयोग होने वाला टोकन माँगता है, ताकि ब्राउज़र में राशि बदली न जा सके। इसके लिए टर्मिनल पासवर्ड, Tranzila टर्मिनल में हैंडशेक सक्षम होना और वहाँ आपके सर्वर का IP अनुमत होना आवश्यक है। डिफ़ॉल्ट: off।
भुगतान पुष्टि
Tranzila सूचनाएँ हस्ताक्षरित नहीं होतीं। कोई ऑर्डर तभी भुगतान किया हुआ स्थिति पाता है जब सूचना Trusted IP से आए और उसका भुगतान पेज टोकन, ऑर्डर, टर्मिनल, राशि और मुद्रा भुगतान पेज से मेल खाएँ। Handshake के साथ टोकन भी मेल खाना चाहिए। ग्राहक का भुगतान पेज से लौटना कभी किसी ऑर्डर को भुगतान किया हुआ चिह्नित नहीं करता।
Notifications: Tranzila सूचनाओं (सूचना URL) से भुगतान अपने-आप पुष्ट करता है। डिफ़ॉल्ट: on। जब सूचनाएँ बंद हों, तो सफल भुगतान पेज से लौटा ग्राहक ऑर्डर को On hold status में डाल देता है, और Tranzila टर्मिनल जाँचने के बाद आप भुगतान मैनुअली पुष्ट करते हैं।
Notification URL: जानकारी के लिए दिखाया गया। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify जैसा दिखता है और OpenCart 4 में https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह URL हर भुगतान के साथ Tranzila को भेजा जाता है, इसलिए आपको उसे Tranzila टर्मिनल में दर्ज करने की ज़रूरत नहीं है। स्टोर मेंटेनेंस मोड में होने पर भी यह काम करता है (OpenCart 4 में एक्सटेंशन की एक स्टार्टअप एक्शन सूचना और ग्राहक की वापसी को आगे जाने देती है)।
Trusted IP: उन Tranzila सर्वरों के IP पते या CIDR रेंज जो सूचनाएँ भेजते हैं, कॉमा से अलग किए हुए। डिफ़ॉल्ट: 80.244.170.7। वर्तमान सूची Tranzila सहायता से पक्की करें। अन्य पतों से आई सूचनाएँ अस्वीकार होती हैं। यदि फ़ील्ड खाली है, तो सूचनाएँ सत्यापित नहीं हो सकतीं: रिपोर्ट किया गया सफल भुगतान मैनुअल समीक्षा के लिए ऑर्डर को On hold status में डालता है, और रिपोर्ट की गई अस्वीकृति कुछ नहीं बदलती।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक गायब ऑर्डर)। ऑर्डर को स्टेटस केवल सत्यापित Tranzila सूचना से मिलता है। OpenCart में On hold स्टेटस नहीं है, इसलिए यहाँ चुना गया स्टेटस उपयोग होता है, और एक ऑर्डर नोट कारण बताता है। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।
Order status after payment: भुगतान एक सत्यापित सूचना से पुष्ट हुआ (राशि, मुद्रा, टर्मिनल और टोकन मेल खाते हैं)। डिफ़ॉल्ट: Processing।
On hold status: भुगतान को आपकी समीक्षा चाहिए: राशि, मुद्रा या हैंडशेक टोकन अलग हैं, सूचना सत्यापित नहीं हो सकी (कोई Trusted IP नहीं), या सूचनाएँ बंद हैं और ग्राहक सफल भुगतान पेज से लौटा। डिफ़ॉल्ट: Pending। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Refunded status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने पर सेट होता है। डिफ़ॉल्ट: Refunded।
Cancelled order status: एक्सटेंशन इसे सेट नहीं करता। इस स्टेटस वाला ऑर्डर यदि बाद में भुगतान हो जाए, तो स्टॉक जाँचने के नोट के साथ फिर से खुलता है। डिफ़ॉल्ट: Canceled।
Payment error status: एक्सटेंशन इसे सेट नहीं करता। इस स्टेटस वाला ऑर्डर बाद के स्वीकृत Tranzila भुगतान से भुगतान होता है। डिफ़ॉल्ट: Failed।
एडवांस्ड
Debug log: भुगतान पेज, सूचना और रिफ़ंड की घटनाएँ OpenCart लॉग फ़ोल्डर (storage/logs; OpenCart 4 में system/storage/logs) में tranzila_p_debug.log.php में दर्ज करता है। फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे tranzila_p_debug.old.log.php में ले जाया जाता है। यह विकल्प बंद होने पर भी चेतावनियाँ और त्रुटियाँ हमेशा दर्ज होती हैं। पासवर्ड, टोकन और ग्राहक डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: off।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से सेटिंग्स और लॉग हट जाते हैं। Tranzila लेन-देन और रिफ़ंड हमेशा रहते हैं, क्योंकि पुराने ऑर्डरों को उनकी ज़रूरत है। डिफ़ॉल्ट: off।
इम्पोर्ट / एक्सपोर्ट
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। पासवर्ड एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव किए गए पासवर्ड बने रहते हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Tranzila))। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. OpenCart इस चरण पर ऑर्डर बनाता है, अब भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो वह आपके स्टोर के एक भुगतान पेज पर जाता है। वहाँ Tranzila भुगतान पेज एक iFrame में खुलता है, जिसमें ऑर्डर की मुद्रा में ऑर्डर राशि, बिलिंग विवरण और उत्पादों की एक छोटी सूची होती है। पेज पर लिखा होता है Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". फ़्रेम के नीचे Choose another payment method लिंक है। यदि किश्तों की अनुमति है, तो ग्राहक Tranzila पेज पर उनकी संख्या चुनता है। OpenCart 4 में ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।
भुगतान पेज का हर प्रदर्शन अपने टोकन (और हैंडशेक टोकन) के साथ एक नया भुगतान प्रयास है। पेज को रीलोड करने पर उसी ग्राहक सत्र के ऑर्डर के लिए नया प्रयास खुलता है; दूसरे ब्राउज़र में खोला गया भुगतान पेज लिंक चेकआउट पर वापस ले जाता है।
सफल भुगतान के बाद Tranzila ग्राहक को वापस भेजता है और पूरी विंडो आगे बढ़ जाती है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Tranzila उसे सूचना से पुष्ट करे। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। जब होल्ड पर रखा गया ऑर्डर बाद में भुगतान होता है, तो ग्राहक को नए ऑर्डर स्टेटस के बारे में ईमेल मिलता है। यदि सूचना पहले ही आ चुकी है, तो ग्राहक को Your payment with Tranzila has been received. के साथ OpenCart ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर समीक्षा के लिए होल्ड पर है, तो पेज Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. दिखाता है। यदि सूचना अभी नहीं आई है, तो एक Payment confirmation पेज Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. दिखाता है, साथ में Check again और Back to checkout बटन।
यदि भुगतान अस्वीकृत या रद्द होता है, तो ग्राहक The payment was not completed. You have not been charged — please try again or choose another payment method. संदेश के साथ चेकआउट पर लौट आता है। जब Tranzila कोई प्रतिक्रिया कोड बताता है, तो कारण और कोड जोड़ दिए जाते हैं, उदाहरण के लिए कि कार्ड की समय सीमा समाप्त हो चुकी है। कार्ट बना रहता है, और ऑर्डर बिना स्टेटस के रहता है। OpenCart 4 में यह संदेश चेकआउट पेज के ऊपर दिखता है। OpenCart 3 हर बार Confirm Order चरण दिखने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है; इनमें से किसी ऑर्डर द्वारा पहले से भुगतान किए गए कार्ट से दोबारा शुल्क नहीं लिया जाता। कार्ट में कोई भी बदलाव, नई मात्रा सहित, नया कार्ट माना जाता है जिसका अपना भुगतान ज़रूरी है।
OpenCart 4 सफलता पेज दिखने तक ऑर्डर को चेकआउट में रखता है। अस्वीकृत भुगतान के बाद ग्राहक नए भुगतान प्रयास के साथ वही ऑर्डर फिर से चुकाता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया), या उस कार्ट के लिए भुगतान हुआ है जो तब से बदल चुका है, तो ग्राहक This order can no longer be paid. Please confirm your order again. के साथ चेकआउट पर लौटा दिया जाता है, और अगला Confirm Order एक नया ऑर्डर चुकाता है।
यदि भुगतान पेज नहीं खुल सकता, उदाहरण के लिए जब हैंडशेक विफल हो, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है, जैसे Could not connect to Tranzila. Please try again in a moment. तकनीकी कारण लॉग में लिखा जाता है।
एक्सटेंशन केवल Tranzila पेज पर होने वाले एकल कार्ड भुगतान स्वीकार करता है। इसमें सेव किए गए कार्ड या टोकन, सब्सक्रिप्शन, अलग प्राधिकरण और कैप्चर (J5), अपने Bit, Apple Pay या Google Pay बटन नहीं हैं (आपका Tranzila भुगतान पेज जो भी देता है, वह iFrame के अंदर दिखता है), और न ही Tranzila इनवॉइस।
ऑर्डर और रिफ़ंड
ऑर्डर स्टेटस
कोई स्टेटस नहीं (गायब ऑर्डर): ग्राहक को भुगतान पेज पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान अस्वीकृत हुआ, या Tranzila सूचना अभी नहीं आई है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। OpenCart 4.1 में ऐसे ऑर्डर का स्टेटस Voided भी हो सकता है, जो OpenCart तब सेट करता है जब कन्फर्म स्टेप फिर से दिखाया जाता है; एक्सटेंशन इसे बिना स्टेटस वाला ऑर्डर गिनता है।
Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान एक सत्यापित सूचना से पुष्ट हुआ। एक नोट राशि, Tranzila लेन-देन (index), प्राधिकरण संख्या और, यदि हों, किश्तों की संख्या दिखाता है।
On hold status (डिफ़ॉल्ट Pending): भुगतान की रिपोर्ट मिली, पर अपने-आप स्वीकार नहीं हुआ: राशि, मुद्रा या हैंडशेक टोकन मेल नहीं खाए, या Trusted IP खाली होने के कारण सूचना सत्यापित नहीं हो सकी, या सूचनाएँ बंद थीं और ग्राहक सफल भुगतान पेज से लौटा। नोट कारण बताता है। Tranzila टर्मिनल में भुगतान जाँचें और स्टेटस मैनुअली बदलें।
Refunded status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।
यदि किसी ऐसे ऑर्डर के लिए भुगतान आता है जो on-hold, cancelled या payment error स्टेटस में है, तो ऑर्डर को Order status after payment मिलता है; रद्द ऑर्डर को अतिरिक्त रूप से एक नोट मिलता है जो शिपिंग से पहले स्टॉक जाँचने को कहता है। यदि किसी ऐसे ऑर्डर के लिए दूसरा भुगतान आता है जो पहले से भुगतान या रिफ़ंड हो चुका है, या किसी पहले से भुगतान किए गए कार्ट के दूसरे ऑर्डर के लिए, तो ऑर्डर नहीं बदला जाता। भुगतान किए गए ऑर्डर का नोट आपसे उसे जाँचने और Tranzila टर्मिनल में डुप्लिकेट रिफ़ंड करने को कहता है। एक ही लेन-देन की दोहराई गई सूचनाएँ अनदेखी की जाती हैं।
नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को नहीं दिखतीं।
VibeFox Tranzila Payment Gateway टैब
Sales > Orders में Tranzila से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Tranzila Payment Gateway टैब Transaction (index), Authorization, Terminal, Status, Paid / refunded राशियाँ, Installments की संख्या, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, परिणाम सहित सभी Payment pages of the cart और ऑर्डर के Tranzila notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।
रिफ़ंड
VibeFox Tranzila Payment Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई वह भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Tranzila पर क्लिक करें। Refund this amount via Tranzila? This cannot be undone. प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको ऑर्डर बदलने का अधिकार चाहिए (System > Users > User Groups में sale/order)। रिफ़ंड मूल भुगतान के लिए Tranzila का क्रेडिट लेन-देन होता है, उसी टर्मिनल पर जिसने भुगतान लिया था, उसी राशि और मुद्रा में जो Tranzila ने वास्तव में काटी थी। इसलिए राशि या मुद्रा में अंतर होने पर आप ऑर्डर कुल तक नहीं, बल्कि ग्राहक ने वास्तव में जो भुगतान किया, उतना ही रिफ़ंड कर सकते हैं।
फ़ॉर्म तब उपलब्ध होता है जब टर्मिनल पासवर्ड सेट हो और ऑर्डर में पुष्ट Tranzila लेन-देन हो। अन्यथा टैब कारण बताता है, जैसे Refunds need the terminal password (TranzilaPW) in the gateway settings. जो भुगतान सेटिंग्स में अभी के टर्मिनल से अलग टर्मिनल (जैसे टेस्ट टर्मिनल) पर हुआ, उसे ऑर्डर पेज से रिफ़ंड नहीं किया जा सकता; उसे उसी Tranzila टर्मिनल में रिफ़ंड करें।
यदि Tranzila रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है, जैसे कोड और उसके अर्थ के साथ Tranzila declined the refund, और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Tranzila क्रेडिट लेन-देन के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और मैनुअल स्टेटस बदलने की तरह उत्पादों को स्टॉक में वापस रखे बिना ऑर्डर को Refunded status पर सेट करता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता।
Sales > Returns में उत्पाद वापसी Tranzila के ज़रिए पैसे वापस नहीं भेजती। Tranzila टर्मिनल में किए गए रिफ़ंड स्टोर को रिपोर्ट नहीं होते। ज़रूरत हो तो ऑर्डर को मैनुअली अपडेट करें।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Tranzila Payment Gateway, Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और बटन: Check now (स्टेटस फिर से जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। इनके नीचे Product: opencart-payment-tranzila वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Tranzila चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट कर और परख सकें। OpenCart 4 में यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू किए गए भुगतान तब भी Tranzila सूचना और ग्राहक के स्टोर पर लौटने से पुष्ट होते हैं, और रिफ़ंड काम करते हैं।
जब लाइसेंस की अवधि समाप्त होती है, तो एक्सटेंशन चलता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर सप्ताह एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
Tranzila चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, Terminal name (supplier) भरा है, और ग्राहक की मुद्रा ILS, USD, EUR या GBP है। सेटिंग्स पेज चेतावनी दिखाता है जब टर्मिनल नाम गायब हो या डिफ़ॉल्ट मुद्रा समर्थित न हो। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: सूचना नहीं पहुँची या अस्वीकृत हुई। जाँचें कि Notifications चालू है और Trusted IP में वे पते हैं जहाँ से Tranzila सूचनाएँ भेजता है। त्रुटियाँ हमेशा लॉग में लिखी जाती हैं; एक्सटेंशन पेज पर Log फ़ील्ड देखें। यह संदेश कि कोई IP Trusted IP सूची में नहीं है, इसका अर्थ है कि Trusted IP सेटिंग या आपकी प्रॉक्सी कॉन्फ़िगरेशन सुधारनी होगी: प्रॉक्सी या CDN के पीछे वेब सर्वर को असली विज़िटर IP PHP तक पहुँचाना होगा। उन डेवलपर्स के लिए जिनका स्टोर किसी भरोसेमंद रिवर्स प्रॉक्सी के पीछे है, एक्सटेंशन IP सेट करने के लिए OpenCart इवेंट wcp_tranzila_payment_gateway/remote_ip ट्रिगर करता है।
सूचना Forbidden उत्तर देती है: वह ऐसे IP पते से आई है जो Trusted IP में नहीं है।
सूचना Bad request या Not found उत्तर देती है: सूचना में दिए ऑर्डर, भुगतान पेज टोकन, टर्मिनल या लेन-देन इंडेक्स इस स्टोर के किसी भुगतान पेज से मेल नहीं खाते।
सूचना Accepted for manual review उत्तर देती है: Trusted IP खाली है, इसलिए सूचना सत्यापित नहीं हो सकी। सफल भुगतान ऑर्डर को होल्ड पर डालता है। भुगतान अपने-आप पुष्ट करने के लिए Trusted IP भरें।
सूचना Busy, retry उत्तर देती है: उसी समय कार्ट को किसी दूसरे अनुरोध द्वारा प्रोसेस किया जा रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। लॉग कारण दिखाता है। Tranzila टर्मिनल में भुगतान जाँचें।
कुछ ऑर्डर on-hold स्टेटस में हैं: VibeFox Tranzila Payment Gateway टैब के नोट पढ़ें। राशि, मुद्रा या हैंडशेक टोकन मेल नहीं खाए, या सूचना सत्यापित नहीं हो सकी (Trusted IP खाली या सूचनाएँ बंद)। Tranzila टर्मिनल में भुगतान जाँचें और स्टेटस मैनुअली बदलें।
हैंडशेक चालू होने पर भुगतान पेज नहीं खुलता: टर्मिनल नाम और टर्मिनल पासवर्ड जाँचें, कि Tranzila टर्मिनल में हैंडशेक सक्षम है और आपके सर्वर का IP वहाँ अनुमत है। लॉग कारण दिखाता है।
रिफ़ंड विफल होते हैं: रिफ़ंड के लिए Terminal password (TranzilaPW) चाहिए। कुछ टर्मिनलों को अलग क्रेडिट पासवर्ड भी चाहिए; उसे Refund password (CreditPass) में दर्ज करें। किसी दूसरे टर्मिनल पर भुगतान किए गए ऑर्डर उसी टर्मिनल में रिफ़ंड करने होंगे। यदि Tranzila का उत्तर अप्रत्याशित है, तो टैब बताता है कि रिफ़ंड की पुष्टि नहीं हुई: दोबारा कोशिश करने से पहले Tranzila टर्मिनल जाँचें। ऑर्डर बदलने का अधिकार न होने पर टैब You do not have permission to refund orders. दिखाता है।
अन्य मुद्राएँ: एक्सटेंशन केवल ILS, USD, EUR और GBP समर्थित करता है।
डेवलपर्स के लिए: भुगतान पेज दिखाने से पहले एक्सटेंशन भुगतान पेज और ऑर्डर के फ़ील्ड के साथ OpenCart इवेंट wcp_tranzila_payment_gateway/payment_page_params ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Tranzila Payment Gateway के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 में उसके इवेंट और स्टार्टअप एक्शन भी, जो मेंटेनेंस मोड में सूचना और ग्राहक की वापसी को आगे जाने देता है)। यदि Delete data on uninstall चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, टर्मिनल, पासवर्ड, भुगतान पेज, भुगतान पुष्टि, लॉगिंग) और लॉग हटा दिए जाते हैं। बंद होने पर वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Tranzila लेन-देन और रिफ़ंड हमेशा रखे जाते हैं, इसलिए पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट बनाए रखते हैं।
OpenCart 4 में एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Tranzila Payment Gateway के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Tranzila उसके संबंधित मालिक का ट्रेडमार्क है। यह एक्सटेंशन Tranzila से संबद्ध नहीं है और Tranzila द्वारा समर्थित नहीं है।