VibeFox Tranzila for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 6.0 या उसके बाद का संस्करण।
WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
स्टोर की मुद्रा: ILS, USD, EUR या GBP। अन्य मुद्राओं के लिए चेकआउट पर भुगतान विधि छिपा दी जाती है।
Tranzila टर्मिनल: आपको टर्मिनल का नाम चाहिए। टर्मिनल पासवर्ड (TranzilaPW) handshake और WooCommerce से रिफ़ंड के लिए ज़रूरी है। कुछ टर्मिनलों को रिफ़ंड के लिए अलग क्रेडिट पासवर्ड (CreditPass) भी चाहिए। टर्मिनल का नाम और पासवर्ड Tranzila देता है: अपनी टर्मिनल सेटिंग्स देखें या Tranzila सपोर्ट से पूछें। Tranzila के पास कोई सार्वजनिक sandbox नहीं है। परीक्षण के लिए Tranzila एक अलग टेस्ट टर्मिनल देता है; उसका नाम टर्मिनल नाम के रूप में दर्ज करें।
विज़िटर का असली IP: भुगतान सूचनाओं की जाँच Tranzila सर्वर के IP पते से की जाती है। यदि आपकी साइट Cloudflare जैसे proxy या CDN के पीछे है, तो वेब सर्वर को असली विज़िटर IP PHP को (REMOTE_ADDR) भेजना होगा।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_tranzila_payment_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Tranzila > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. Terminal name (supplier) भरें, और यदि आप handshake या रिफ़ंड उपयोग करते हैं तो Terminal password (TranzilaPW) भी भरें।
6. Notifications चालू रखें और Trusted IP जाँचें: उसमें वे IP पते होने चाहिए जिनसे Tranzila सूचनाएँ भेजता है। सूची की पुष्टि Tranzila सपोर्ट से करें।
7. सुझाव: Tranzila टर्मिनल में handshake सक्षम करें, वहाँ अपने सर्वर का IP पता अनुमति दें, फिर प्लगइन में Handshake चालू करें।
8. Enable/Disable चालू करें और Tranzila टेस्ट टर्मिनल से एक भुगतान आज़माएँ।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Tranzila। फ़ील्ड्स के ऊपर पेज आपको चेतावनी देता है जब टर्मिनल नाम खाली हो (तब चेकआउट पर भुगतान विधि छिप जाती है), जब सूचनाएँ बंद हों या Trusted IP खाली हो (तब भुगतान किए गए ऑर्डर मैनुअल समीक्षा के लिए होल्ड पर रखे जाते हैं), जब टर्मिनल पासवर्ड के बिना handshake चालू हो (तब भुगतान पेज नहीं खुल सकता) और जब स्टोर की मुद्रा समर्थित न हो। सेव करते समय अमान्य टर्मिनल नाम या अमान्य Trusted IP प्रविष्टि सेव नहीं होती: पेज एक त्रुटि दिखाता है और पिछला मान बना रहता है। अनुमत सीमा से बाहर की संख्याएँ निकटतम अनुमत मान तक सुधार दी जाती हैं।
General
Enable/Disable: Enable Tranzila Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह नाम जो ग्राहक चेकआउट पर भुगतान विधि के लिए देखते हैं। डिफ़ॉल्ट: Credit Card (Tranzila)।
Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card on the Tranzila payment page.
Terminal
Terminal name (supplier): आपके Tranzila टर्मिनल का नाम, उदाहरण के लिए myshop। केवल अक्षर, अंक, "-" और "_"। जब तक यह दर्ज नहीं होता, चेकआउट पर भुगतान विधि नहीं दिखती। परीक्षण के लिए अपने Tranzila टेस्ट टर्मिनल का नाम दर्ज करें।
Terminal password (TranzilaPW): टर्मिनल का API पासवर्ड। यह handshake और WooCommerce से रिफ़ंड के लिए ज़रूरी है।
Refund password (CreditPass): केवल तभी भरें जब आपके टर्मिनल को क्रेडिट (रिफ़ंड) लेन-देन के लिए अलग पासवर्ड चाहिए। अन्यथा खाली छोड़ें।
Payment page
Payment page version: iframe में दिखने वाला Tranzila पेज।
Payment page language: Tranzila पेज की भाषा: Site language, Hebrew, English, Russian, Spanish, German, French या Japanese। डिफ़ॉल्ट: Hebrew। Site language विज़िटर के WordPress locale की भाषा का उपयोग करता है, यदि वह इनमें से कोई हो; अन्यथा English।
iFrame width (px): 300 से 1200। डिफ़ॉल्ट: 600। छोटी स्क्रीन पर फ़्रेम पेज से कभी चौड़ा नहीं होता।
iFrame height (px): 400 से 1500। डिफ़ॉल्ट: 650।
Max installments: भुगतान पेज पर ग्राहक जितनी अधिकतम किश्तें (tashlumim) चुन सकता है, अधिकतम 36। 0 या 1 का अर्थ है कोई किश्त नहीं। डिफ़ॉल्ट: 0। टर्मिनल को किश्तों की प्रोसेसिंग की अनुमति होनी चाहिए।
Handshake: Lock the amount with a handshake token (recommended)। भुगतान पेज खोलने से पहले स्टोर Tranzila से एक एक-बार का टोकन माँगता है, जो ऑर्डर राशि से बँधा होता है, ताकि ब्राउज़र में राशि बदली न जा सके। इसके लिए टर्मिनल पासवर्ड, Tranzila टर्मिनल में handshake का सक्षम होना, और वहाँ आपके सर्वर IP की अनुमति ज़रूरी है। डिफ़ॉल्ट: बंद।
Payment confirmation
Tranzila की सूचनाएँ साइन नहीं की जातीं। किसी ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब सूचना किसी Trusted IP से आई हो और उसकी ऑर्डर कुंजी, टर्मिनल, राशि और मुद्रा ऑर्डर से मेल खाते हों। handshake चालू होने पर टोकन भी ऑर्डर के भुगतान पेज से मेल खाना चाहिए। ग्राहक का भुगतान पेज से वापस आना कभी किसी ऑर्डर को भुगतान किया हुआ नहीं बनाता।
Notifications: Confirm payments automatically with Tranzila notifications (notify URL)। डिफ़ॉल्ट: चालू। सूचना URL हर भुगतान के साथ Tranzila को भेजा जाता है, इसलिए आपको उसे Tranzila टर्मिनल में दर्ज करने की ज़रूरत नहीं है। यह ऐसा दिखता है: https://your-site/wc-api/tranzila_p_callback/ और फ़ील्ड के नीचे दिखाया जाता है। जब सूचनाएँ बंद होती हैं, तो सफल भुगतान पेज से लौटे ग्राहक का ऑर्डर होल्ड पर रहता है, और Tranzila टर्मिनल में जाँच के बाद आप भुगतान की पुष्टि मैनुअली करते हैं।
Trusted IP: Tranzila सर्वरों के IP पते या CIDR रेंज जो सूचनाएँ भेजते हैं, कॉमा से अलग किए हुए। डिफ़ॉल्ट: 80.244.170.7। मौजूदा सूची की पुष्टि Tranzila सपोर्ट से करें। अन्य पतों से आई सूचनाएँ अस्वीकार की जाती हैं। यदि फ़ील्ड खाली है, तो सूचनाओं की पुष्टि नहीं हो सकती: रिपोर्ट किया गया सफल भुगतान ऑर्डर को मैनुअल समीक्षा के लिए होल्ड पर रखता है, और रिपोर्ट की गई अस्वीकृति ऑर्डर नहीं बदलती।
Advanced
Debug log: Log payment page, notification and refund events WooCommerce > Status > Logs में, स्रोत wcp_tranzila_payment_gateway के साथ लिखता है। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा दर्ज होती हैं। पासवर्ड, टोकन और ग्राहक डेटा कभी नहीं लिखे जाते। डिफ़ॉल्ट: बंद।
Delete data on uninstall: Delete the settings, logs and Tranzila order data when the plugin is deleted। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (Tranzila)) और Continue to payment पर क्लिक करता है। ऑर्डर Pending payment स्थिति के साथ बनता है, और ग्राहक आपके स्टोर के ऑर्डर भुगतान पेज पर पहुँचता है। वहाँ 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 पेज पर उनकी संख्या चुनता है।
सफल भुगतान के बाद Tranzila ग्राहक को वापस भेजता है और पूरी विंडो आपके स्टोर के ऑर्डर प्राप्त पेज पर चली जाती है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Tranzila सूचना से पुष्टि कर दे। तब तक पेज दिखाता है 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. यदि ऑर्डर समीक्षा के लिए होल्ड पर है, तो दिखता है Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed.
यदि भुगतान अस्वीकृत या रद्द हो जाता है, तो ग्राहक संदेश The payment was not completed. You have not been charged — please try again or choose another payment method. के साथ ऑर्डर भुगतान पेज पर लौट आता है। जब Tranzila कोई प्रतिक्रिया कोड भेजता है, तो कारण और कोड जोड़ दिए जाते हैं, उदाहरण के लिए कि कार्ड की समय-सीमा समाप्त हो चुकी है। ग्राहक फिर से भुगतान कर सकता है या कोई दूसरी भुगतान विधि चुन सकता है।
यदि भुगतान पेज नहीं खुल पाता, उदाहरण के लिए handshake विफल होने पर, तो ग्राहक को Could not connect to Tranzila. Please try again in a moment. जैसा एक छोटा संदेश और Choose another payment method लिंक दिखता है। तकनीकी कारण लॉग में लिखा जाता है।
यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। Pay for order पेज पर यह तब दी जाती है जब ऑर्डर की मुद्रा समर्थित हो। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल Tranzila पेज पर एक-बार के कार्ड भुगतान स्वीकार करता है। इसमें सेव किए गए कार्ड या टोकन, सब्सक्रिप्शन, अलग से ऑथोराइज़ और कैप्चर (J5), अपने Bit, Apple Pay या Google Pay बटन (आपके Tranzila भुगतान पेज पर जो भी उपलब्ध हो, वह iframe के अंदर दिखता है) या Tranzila इनवॉइस नहीं हैं।
ऑर्डर और रिफ़ंड
Order statuses
Pending payment: ग्राहक को भुगतान पेज पर भेजा गया है और उसने अभी तक भुगतान नहीं किया है, या Tranzila की सूचना अभी तक नहीं आई है।
Processing or Completed: भुगतान एक सत्यापित सूचना से पुष्ट हुआ है। WooCommerce Processing सेट करता है, या उन ऑर्डरों के लिए Completed जिन्हें शिपिंग की ज़रूरत नहीं होती। ऑर्डर नोट में राशि, Tranzila लेन-देन और ऑथोराइज़ेशन नंबर दिखता है, और किश्तें हों तो उनकी संख्या भी। ट्रांज़ैक्शन ID Tranzila का ट्रांज़ैक्शन इंडेक्स है।
On hold: भुगतान प्राप्त हुआ, लेकिन स्वचालित रूप से स्वीकार नहीं हुआ: राशि, मुद्रा या handshake टोकन ऑर्डर से मेल नहीं खाए; Trusted IP खाली होने के कारण सूचना की पुष्टि नहीं हो सकी; या सूचनाएँ बंद हैं और ग्राहक सफल भुगतान पेज से लौटा। ऑर्डर नोट कारण बताता है। Tranzila टर्मिनल में भुगतान जाँचें और स्थिति मैनुअली बदलें।
Failed: Tranzila ने एक लंबित ऑर्डर के लिए अस्वीकृत भुगतान की सूचना दी। नोट में प्रतिक्रिया कोड और उसका अर्थ दिखता है। जो ऑर्डर पहले से भुगतान किया हुआ है, उसे कभी Failed नहीं किया जाता।
यदि रद्द किए गए ऑर्डर के लिए भुगतान आता है, तो ऑर्डर फिर से खुल जाता है और एक नोट के साथ आपसे शिपिंग से पहले स्टॉक जाँचने को कहा जाता है। यदि ग्राहक ने Pay for order पेज पर भुगतान विधि बदल दी थी, लेकिन अभी भी खुले Tranzila पेज पर भुगतान कर दिया, तो ऑर्डर की भुगतान विधि वापस Tranzila कर दी जाती है। यदि पहले से भुगतान किए गए, पूरे हो चुके या रिफ़ंड किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे उसे जाँचने और Tranzila टर्मिनल में डुप्लिकेट राशि रिफ़ंड करने को कहता है। एक ही लेन-देन की दोहराई गई सूचनाएँ अनदेखी की जाती हैं।
Refunds
ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit Card (Tranzila) पर क्लिक करें (बटन पर भुगतान विधि का शीर्षक दिखता है)। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड मूल भुगतान का Tranzila क्रेडिट लेन-देन बनकर होता है। यह बटन तब उपलब्ध होता है जब टर्मिनल पासवर्ड सेट हो और ऑर्डर में ऑथोराइज़ेशन नंबर वाला पुष्ट Tranzila लेन-देन हो। सफल रिफ़ंड Tranzila क्रेडिट लेन-देन के साथ ऑर्डर नोट्स में जोड़ा जाता है।
यदि Tranzila रिफ़ंड स्वीकार नहीं करता, तो WooCommerce कोड सहित त्रुटि दिखाता है, उदाहरण के लिए Tranzila declined the refund, और कोई रिफ़ंड दर्ज नहीं होता। जो ऑर्डर अभी की सेटिंग्स वाले टर्मिनल के अलावा किसी और टर्मिनल (जैसे टेस्ट टर्मिनल) पर भुगतान हुआ था, उसे WooCommerce से रिफ़ंड नहीं किया जा सकता; उसे उसी Tranzila टर्मिनल में रिफ़ंड करें। Tranzila टर्मिनल में किए गए रिफ़ंड स्टोर को रिपोर्ट नहीं होते। ज़रूरत हो तो Tranzila बटन के बिना WooCommerce में मैनुअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Tranzila के ऊपर है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का उपयोग करें, कोई दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। उसे अपने vibefox.net खाते में मुक्त करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Tranzila नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन किए हुए स्टोर मैनेजरों को भुगतान विधि अब भी (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके परीक्षण कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि होती रहती है, और रिफ़ंड भी काम करते हैं।
जब लाइसेंस समाप्त हो जाता है, तब भी प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप दोबारा जाँची जाती है।
समस्या निवारण
Tranzila does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, Terminal name (supplier) भरा है, और स्टोर की मुद्रा (Pay for order पेज पर ऑर्डर की मुद्रा) ILS, USD, EUR या GBP है। टर्मिनल नाम गायब होने या मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है।
The payment went through, but the order stays Pending payment: सूचना नहीं आई या अस्वीकार कर दी गई। जाँचें कि Notifications चालू है और Trusted IP में वे पते हैं जिनसे Tranzila सूचनाएँ भेजता है। त्रुटियाँ हमेशा WooCommerce > Status > Logs में, स्रोत wcp_tranzila_payment_gateway के साथ लिखी जाती हैं। यह संदेश कि कोई IP Trusted IP सूची में नहीं है, का अर्थ है कि Trusted IP सेटिंग या आपकी proxy कॉन्फ़िगरेशन ठीक करनी होगी: proxy या CDN के पीछे वेब सर्वर को असली विज़िटर IP PHP को भेजना होगा।
Notification answers Forbidden: यह ऐसे IP पते से आई जो Trusted IP में नहीं है।
Notification answers Bad request or Not found: सूचना में दिया गया ऑर्डर, उसकी ऑर्डर कुंजी, टर्मिनल या ट्रांज़ैक्शन इंडेक्स इस स्टोर के किसी ऑर्डर से मेल नहीं खाता।
Notification answers Accepted for manual review: Trusted IP खाली है, इसलिए सूचना की पुष्टि नहीं हो सकी। सफल भुगतान ऑर्डर को होल्ड पर रखता है। भुगतान अपने-आप पुष्ट करने के लिए Trusted IP भरें।
Notification answers Busy, retry: उसी समय ऑर्डर किसी दूसरे अनुरोध द्वारा प्रोसेस किया जा रहा था, इसलिए सूचना लागू नहीं हुई। Tranzila टर्मिनल में भुगतान जाँचें; यदि ऑर्डर अब भी भुगतान का इंतज़ार कर रहा है और वहाँ भुगतान मंज़ूर है, तो स्थिति मैनुअली बदलें।
Some paid orders are On hold: ऑर्डर नोट पढ़ें। राशि, मुद्रा या handshake टोकन मेल नहीं खाए, या सूचना की पुष्टि नहीं हो सकी (Trusted IP खाली या सूचनाएँ बंद)। Tranzila टर्मिनल में भुगतान जाँचें और स्थिति मैनुअली बदलें।
The payment page does not open with the handshake on: टर्मिनल नाम और टर्मिनल पासवर्ड जाँचें, यह भी कि Tranzila टर्मिनल में handshake सक्षम है और आपके सर्वर का IP पता वहाँ अनुमत है। लॉग कारण दिखाता है।
Refunds fail: रिफ़ंड के लिए Terminal password (TranzilaPW) ज़रूरी है। कुछ टर्मिनलों को अलग क्रेडिट पासवर्ड भी चाहिए; उसे Refund password (CreditPass) में दर्ज करें। किसी अन्य टर्मिनल पर भुगतान किए गए ऑर्डर उसी टर्मिनल में रिफ़ंड करने होंगे।
Other currencies: प्लगइन ILS, USD, EUR और GBP का समर्थन करता है। डेवलपर tranzila_p_currency_map फ़िल्टर से सूची बदल सकते हैं।
The license block shows an error: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को डीएक्टिवेट करने से सारा डेटा बना रहता है। पूरी तरह हटाने के लिए उसे डीएक्टिवेट करें और Plugins पेज से डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स, ऑर्डरों पर सहेजा गया Tranzila डेटा और प्लगइन के लॉग (घुमाई गई लॉग फ़ाइलों सहित) केवल तब हटाए जाते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।
Tranzila उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Tranzila से संबद्ध नहीं है और Tranzila द्वारा समर्थित नहीं है।