VibeFox Transbank for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का।

मुद्रा: चिली पेसो (CLP)। यदि आपके स्टोर में यह मुद्रा नहीं है, तो इसे System > Localisation > Currencies में 0 दशमलव स्थानों के साथ जोड़ें: Webpay Plus केवल पूर्ण पेसो लेता है। किसी दूसरी मुद्रा के ऑर्डर के लिए भुगतान विधि नहीं दिखाई जाती।

Transbank खाता: लाइव भुगतान के लिए आपको एक मानक Webpay Plus कॉमर्स (तत्काल कैप्चर) चाहिए, जिसके साथ उसका लाइव Commerce Code और API Key Secret हो। Transbank आपका Commerce Code तब देता है जब आपका अफ़िलिएशन स्वीकृत हो जाता है, और API Key Secret इंटीग्रेशन सत्यापन प्रक्रिया के बाद देता है (Transbank के डेवलपर दस्तावेज़ देखें)। परीक्षण के लिए किसी क्रेडेंशियल की ज़रूरत नहीं होती। Webpay Plus Mall, Oneclick और विलंबित कैप्चर वाले commerce codes समर्थित नहीं हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Enable / Disable चालू करें और Save पर क्लिक करें। Integration (test) mode चालू रखते हुए, Transbank डेवलपर दस्तावेज़ के टेस्ट कार्ड का उपयोग करके CLP में एक भुगतान का परीक्षण करें।

5. लाइव जाने के लिए, अपना Production Commerce Code और Production API Key Secret दर्ज करें, Integration (test) mode बंद करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Transbank Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब प्रोडक्शन चुना गया हो लेकिन प्रोडक्शन Commerce Code या API Key गायब या अमान्य हो (तब Webpay चेकआउट पर छिपा रहता है), जब स्टोर की डिफ़ॉल्ट मुद्रा CLP न हो (अन्य मुद्राओं के लिए भुगतान विधि छिपी रहती है), और जब CLP में दशमलव स्थान हों (कुल योग पूर्ण पेसो में गोल किए जाते हैं)। जब तक इंटीग्रेशन मोड चालू है, पेज दिखाता है कि भुगतान सार्वजनिक परीक्षण commerce code के साथ Transbank इंटीग्रेशन वातावरण में जाते हैं और कोई असली पैसा नहीं काटा जाता। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं हो सकता, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक मान स्वीकार्य हैं), Total 0 या उससे अधिक की संख्या होनी चाहिए, और ऑर्डर स्टेटस मौजूद होने चाहिए; नहीं तो कुछ भी सेव नहीं होता और पेज त्रुटि दिखाता है।

Transbank Webpay Plus

Enable / Disable: Enable Transbank Webpay Plus payments भुगतान विधि चालू या बंद करता है। डिफ़ॉल्ट: off।

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया गया पाठ। डिफ़ॉल्ट: Pay with credit, debit or prepaid card via Webpay।

Sort Order: चेकआउट पर भुगतान विधियों के बीच Webpay की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें (ऋणात्मक मान स्वीकार्य हैं)।

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

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

वातावरण और क्रेडेंशियल

इस सेक्शन का पाठ Transbank डेवलपर दस्तावेज़ से लिंक करता है और बताता है कि Transbank प्रोडक्शन क्रेडेंशियल कब देता है।

Integration (test) mode: भुगतान अपने सार्वजनिक परीक्षण commerce code (597055555532) के साथ Transbank इंटीग्रेशन वातावरण में जाते हैं, जो स्वतः उपयोग होता है। नीचे के प्रोडक्शन क्रेडेंशियल उपयोग नहीं होते और कोई असली पैसा नहीं काटा जाता। डिफ़ॉल्ट: on। लाइव जाने के लिए इसे बंद करें। चालू रहते हुए ग्राहक Confirm Order चरण पर TEST MODE — Integration environment. No real charges. देखते हैं।

Production Commerce Code: आपका प्रोडक्शन commerce code (Tbk-Api-Key-Id): 5970 से शुरू होने वाले 12 अंक। यदि आपका 8 अंकों का है, तो उसे जैसा है वैसा दर्ज करें; 5970 उपसर्ग सेव करते समय जोड़ा जाता है। स्पेस और अन्य वर्ण हटा दिए जाते हैं। Transbank के सार्वजनिक परीक्षण commerce codes प्रोडक्शन में काम नहीं करते: उनमें से किसी के साथ Webpay चेकआउट पर छिपा रहता है।

Production API Key Secret: आपके प्रोडक्शन commerce का Tbk-Api-Key-Secret। इसे गुप्त रखें। सेव करते समय स्पेस हटा दिए जाते हैं। सेव की गई कुंजी दोबारा नहीं दिखाई जाती: फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव की गई कुंजी हटाने के लिए Clear saved API key पर टिक करें और Save पर क्लिक करें।

Integration (test) mode तय करता है कि नए भुगतान कहाँ जाएँ। हर भुगतान अपना वातावरण याद रखता है: किसी भुगतान की पुष्टि और रिफ़ंड हमेशा उसी वातावरण (इंटीग्रेशन या प्रोडक्शन) और उन्हीं क्रेडेंशियल से होते हैं जिनसे वह बनाया गया था, भले ही आप बाद में मोड बदल दें।

रिटर्न URL

Return from Webpay: वह पता जहाँ Transbank ग्राहक को वापस भेजता है, जानकारी के लिए दिखाया गया। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_transbank_gateway/back, और OpenCart 4 पर: https://your-store/index.php?route=extension/wcp_transbank_gateway/payment/wcp_transbank_gateway.back। Transbank में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है: एक्सटेंशन हर लेन-देन के साथ यह URL भेजता है (Transbank में webhook नहीं है: ग्राहक के लौटने पर भुगतान की पुष्टि होती है)। यह इंटरनेट से पहुँच योग्य होना चाहिए; मेंटेनेंस मोड इसे नहीं रोकता (OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप क्रिया जोड़ता है)।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक गायब ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक के Webpay से लौटने पर स्टोर ने Transbank के साथ लेन-देन की पुष्टि (commit) कर दी हो। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।

Order Status After Payment: स्वीकृत और सत्यापित Webpay भुगतान के बाद सेट होने वाला स्टेटस। डिफ़ॉल्ट: Processing।

Transbank Payment On Hold Status: Transbank ने ऐसा भुगतान अधिकृत किया जो ऑर्डर से मेल नहीं खाता (राशि, buy order, session id): ऑर्डर मैनुअल समीक्षा के लिए रोका जाता है, और एक नोट कारण बताता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

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

एडवांस्ड

Debug log: API अनुरोध और प्रतिक्रियाओं को OpenCart लॉग फ़ोल्डर (storage/logs) में wc_tbk_debug.log.php में दर्ज करता है। फ़ाइल वेब से नहीं खोली जा सकती। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा दर्ज होती हैं। कार्ड डेटा, API कुंजियाँ या पूरे टोकन दर्ज नहीं होते। डिफ़ॉल्ट: off।

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

Delete data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और भुगतान का डेटा हमेशा रहता है। डिफ़ॉल्ट: off।

इम्पोर्ट / एक्सपोर्ट

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सेव करता है। API Key Secret एक्सपोर्ट नहीं होता।

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

चेकआउट

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

जब ग्राहक लौटता है, तो एक्सटेंशन सर्वर-से-सर्वर तरीके से Transbank के साथ लेन-देन की पुष्टि (commit) करता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Transbank पुष्टि करे: प्रतिक्रिया स्वीकृत होनी चाहिए, और राशि, buy order तथा session उस प्रयास के लिए स्टोर द्वारा भेजी गई जानकारी से मेल खाने चाहिए। इसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को Your Webpay payment has been received. के साथ OpenCart ऑर्डर सफलता पेज दिखता है। समीक्षाधीन ऑर्डर के लिए पेज Your Webpay payment was received and is being reviewed by the store. दिखाता है।

यदि पुष्टि कॉल विफल होती है, उदाहरण के लिए टाइमआउट पर, तो एक्सटेंशन Transbank से लेन-देन की स्थिति पूछता है। यदि स्थिति फिर भी ज्ञात नहीं हो सकती, तो ऑर्डर बिना स्टेटस के रहता है और ग्राहक We could not confirm your Webpay payment with Transbank. Please try again in a moment; if your card was charged, contact us before paying again. के साथ चेकआउट पर लौट आता है। यदि उसी समय कोई और अनुरोध उसी कार्ट की पुष्टि कर रहा है, या Transbank ने भुगतान स्वीकृत किया है पर ऑर्डर का स्टेटस अभी सेट नहीं हो सका है, तो ग्राहक को Payment confirmation पेज दिखता है, जिसमें Your Webpay payment is being confirmed. Please do not pay again — check again in a moment. लिखा होता है और Check again और Back to checkout बटन होते हैं। स्टेटस फिर सेव की गई प्रतिक्रिया से सेट होता है, बिना दूसरी पुष्टि के।

यदि ग्राहक Webpay पर रद्द करता है, या Webpay फ़ॉर्म की समय सीमा समाप्त हो जाती है या कोई त्रुटि बताता है, तो कुछ भी नहीं काटा जाता। ग्राहक You cancelled the Webpay payment. Nothing was charged — you can try again or choose another payment method. जैसे संदेश के साथ चेकआउट पर लौटता है। अस्वीकृत कार्ड पर Your Webpay payment was rejected and nothing was charged. Please try again or choose another payment method. दिखता है। कार्ट बना रहता है, और हर नया प्रयास एक नया Webpay लेन-देन होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए रद्द या अस्वीकृत भुगतान के बाद ग्राहक उसी ऑर्डर का नए Webpay लेन-देन से भुगतान करता है। यदि भुगतान शुरू होने के बाद ऑर्डर बदल गया (उसकी मुद्रा या कुल लेन-देन से मेल नहीं खाते), तो लेन-देन की पुष्टि नहीं होती, इसलिए Transbank उसे नहीं काटता, और ग्राहक को Your order changed after the Webpay payment was started. The payment was not confirmed, so it was not charged — please pay again. दिखता है। यदि ऑर्डर का पहले से स्टेटस है, या उसी कार्ट का कोई और ऑर्डर पहले से भुगतान किया हुआ है, तो देर से आया रिटर्न भी पुष्ट नहीं होता: ग्राहक भुगतान किए गए ऑर्डर के सफलता पेज पर जाता है, या This order can no longer be paid (it was cancelled or already paid). Your Webpay payment was not confirmed, so it was not charged. देखता है।

OpenCart 4 पर, यदि चेकआउट का ऑर्डर बिना Webpay भुगतान के स्टेटस पा गया या इस बीच स्टोर ने उसे बंद कर दिया, तो अगला Confirm Order ग्राहक को उसी संदेश के साथ चेकआउट पर वापस भेजता है, और उसी कार्ट का भुगतान नए ऑर्डर से किया जाता है। यदि चेकआउट का ऑर्डर पहले से भुगतान किया हुआ है, पर उसके बाद कार्ट बदल गया है (नई मात्रा सहित), तो ग्राहक चेकआउट पर वापस भेजा जाता है और नए कार्ट का भुगतान नए ऑर्डर से होता है।

यदि Webpay भुगतान शुरू नहीं कर पाता, तो ग्राहक एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, जैसे Could not connect to Webpay. Please try again in a moment. या Webpay could not start the payment. Please try again or choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।

Transbank में भुगतान का webhook नहीं है: परिणाम तब संसाधित होता है जब ग्राहक Webpay से लौटता है। यदि ग्राहक Webpay पर ब्राउज़र बंद कर दे और कभी न लौटे, तो लेन-देन की पुष्टि नहीं होती और ऑर्डर बिना स्टेटस के रहता है; Transbank के अनुसार पुष्टि न हुए लेन-देन का निपटान नहीं होता। इस एक्सटेंशन में Webpay Plus Mall, सेव किए गए Oneclick कार्ड, सब्सक्रिप्शन, विलंबित कैप्चर या मुद्रा रूपांतरण नहीं है।

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

ऑर्डर स्टेटस

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

Order Status After Payment (डिफ़ॉल्ट Processing): Transbank ने भुगतान स्वीकृत किया। एक नोट अधिकृति कोड, कार्ड के अंतिम चार अंक, buy order, राशि, भुगतान प्रकार और किस्तों की संख्या दिखाता है।

Transbank Payment On Hold Status (डिफ़ॉल्ट Pending): Transbank ने ऐसा भुगतान अधिकृत किया जो ऑर्डर से मेल नहीं खाता (राशि, buy order या session)। नोट अंतर सूचीबद्ध करता है। Transbank पोर्टल जाँचें और ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान इस एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।

यदि Webpay किसी ऐसे ऑर्डर के लिए भुगतान लौटाता है जिसका पहले से स्टेटस है, या किसी ऐसे कार्ट के लिए जिसे कोई दूसरा ऑर्डर पहले ही भुगतान कर चुका है, तो भुगतान की पुष्टि नहीं होती, और यदि ग्राहक किसी शुल्क की शिकायत करता है तो एक नोट आपसे Transbank पोर्टल जाँचने को कहता है। रद्दीकरण, समाप्त फ़ॉर्म, फ़ॉर्म त्रुटियाँ और अस्वीकृत कार्ड भी नोट किए जाते हैं। नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को नहीं दिखतीं।

VibeFox Transbank Gateway टैब

Sales > Orders में Webpay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Transbank Gateway टैब Buy order और उसका वातावरण (परीक्षण भुगतान के लिए Integration लेबल), भुगतान का Status, Authorization code, किस्तों की संख्या के साथ Card / payment type, Charged / refunded, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, Webpay attempts of the order और Transbank notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

टैब में CLP में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है वह भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Transbank पर क्लिक करें। Refund this amount via Transbank? प्रश्न की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड पूर्ण पेसो में समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। दशमलव वाली आंशिक राशि Webpay refunds are in whole Chilean pesos. Please enter an amount without decimals. के साथ अस्वीकार होती है। दशमलव वाले ऑर्डर कुल का अंतिम शेष चार्ज की तरह गोल होता है। रिफ़ंड Transbank द्वारा काटी गई राशि तक ही हो सकते हैं। रिफ़ंड उस वातावरण में जाता है जहाँ भुगतान हुआ था, इसलिए प्रोडक्शन भुगतान के लिए प्रोडक्शन क्रेडेंशियल सेट होने चाहिए।

Transbank या तो रिवर्सल (REVERSED) या निरस्तीकरण (NULLIFIED) के साथ जवाब देता है। सफल रिफ़ंड राशि, प्रकार, अधिकृति कोड और Transbank में बचे शेष के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूर्ण रिफ़ंड ग्राहक को सूचित किए बिना और उत्पादों को स्टॉक में वापस रखे बिना Refunded Status सेट करता है, जैसे मैनुअल स्टेटस परिवर्तन। आंशिक रिफ़ंड स्टेटस नहीं बदलता। यदि Transbank रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता।

Sales > Returns में उत्पाद वापसी Transbank के ज़रिए पैसे वापस नहीं भेजती। Transbank पोर्टल में किए गए रिफ़ंड OpenCart में आयात नहीं होते।

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

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

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

जब लाइसेंस की अवधि समाप्त होती है, तो एक्सटेंशन चलता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर सप्ताह एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

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

चेकआउट पर Webpay Plus नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, ग्राहक CLP में भुगतान करता है, और इंटीग्रेशन मोड बंद होने पर एक मान्य Production Commerce Code (12 अंक, 5970 से शुरू) और Production API Key Secret सेव हैं। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है। सेटिंग्स पेज क्रेडेंशियल गायब होने और गैर-CLP स्टोर मुद्रा पर चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: Transbank में webhook नहीं है, इसलिए ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक Webpay से लौटता है। यदि ग्राहक ने Webpay पर ब्राउज़र बंद कर दिया था, तो लेन-देन की पुष्टि नहीं हुई और Transbank के अनुसार उसका निपटान नहीं होता। Debug log चालू करें, Log फ़ील्ड देखें और Transbank पोर्टल में लेन-देन जाँचें।

ग्राहक को We could not confirm your Webpay payment with Transbank दिखता है: पुष्टि कॉल विफल रहा और स्टेटस जाँचा नहीं जा सका। ऑर्डर नहीं बदला गया और कारण लॉग में है। ग्राहक कुछ देर बाद फिर कोशिश कर सकता है। यदि Transbank पोर्टल लेन-देन को अधिकृत दिखाता है, तो ग्राहक के दोबारा भुगतान करने से पहले उससे संपर्क करें।

ग्राहक को Your order changed after the Webpay payment was started दिखता है: ऑर्डर का कुल या मुद्रा लेन-देन से अलग थी। कुछ नहीं काटा गया; ग्राहक फिर से भुगतान करता है।

Confirm Order के बाद ग्राहक को त्रुटि दिखती है: Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। Webpay payments are not available at the moment आम तौर पर गलत प्रोडक्शन क्रेडेंशियल का संकेत है। Could not connect to Webpay का अर्थ है कि Transbank तक पहुँच नहीं हो सकी। Transbank Webpay only supports payments in CLP (Chilean Peso) का अर्थ है कि ऑर्डर किसी दूसरी मुद्रा में है। This payment method is not available. Please reload the checkout page. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता: ग्राहक चेकआउट पेज रीलोड करता है।

कुल और रिफ़ंड कुछ पेसो अलग हैं: CLP मुद्रा के दशमलव स्थान होते हैं। Webpay पूर्ण पेसो लेता है, इसलिए कुल गोल होते हैं। System > Localisation > Currencies में CLP के दशमलव स्थान 0 पर सेट करें।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Transbank Gateway टैब के नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

रिफ़ंड The production Commerce Code / API Key are missing के साथ विफल: भुगतान प्रोडक्शन में हुआ था और प्रोडक्शन क्रेडेंशियल सेव नहीं हैं। उन्हें दर्ज करें और फिर कोशिश करें।

रिफ़ंड Transbank refused the refund या Transbank did not approve the refund के साथ विफल: Transbank ने उसे स्वीकार नहीं किया; संदेश में कारण, या उसके द्वारा लौटाया गया प्रकार और प्रतिक्रिया कोड दिखता है। कुछ रिफ़ंड नहीं हुआ। Transbank पोर्टल में लेन-देन जाँचें।

रिफ़ंड Another request is processing this order के साथ विफल: उसी समय ऑर्डर रिफ़ंड या पुष्टि किया जा रहा था। कुछ देर बाद फिर कोशिश करें।

अनइंस्टॉल

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

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

Transbank और Webpay उनके संबंधित मालिकों के ट्रेडमार्क हैं। यह एक्सटेंशन Transbank से संबद्ध नहीं है और Transbank द्वारा समर्थित नहीं है।