VibeFox Transbank for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 8.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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

स्टोर की मुद्रा: चिली पेसो (CLP)। Webpay Plus केवल पूर्ण पेसो चार्ज करता है, इसलिए WooCommerce > Settings > General में Number of decimals को 0 पर सेट करें। किसी अन्य मुद्रा वाले स्टोर में यह भुगतान विधि नहीं दिखती।

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_transbank_gateway फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. WooCommerce > Settings > General में स्टोर की मुद्रा चिली पेसो और Number of decimals को 0 पर सेट करें।

4. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Transbank Webpay Plus > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

5. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

6. Enable / Disable चालू करें और Integration (test) mode चालू रखते हुए Transbank डेवलपर दस्तावेज़ के टेस्ट कार्ड से एक भुगतान आज़माएँ।

7. लाइव होने के लिए Production Commerce Code और Production API Key Secret दर्ज करें, Integration (test) mode का चेकमार्क हटाएँ और सेव करें।

Transbank पर रिटर्न URL या वेबहुक सेट करने की ज़रूरत नहीं है। प्लगइन हर लेन-देन के साथ अपना रिटर्न URL भेजता है।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Transbank Webpay Plus। फ़ील्ड्स के ऊपर पेज चेतावनी देता है जब प्रोडक्शन चुना गया हो पर प्रोडक्शन Commerce Code या API Key गायब या अमान्य हो (तब Webpay चेकआउट पर छिपा रहता है), जब स्टोर की मुद्रा CLP न हो (भुगतान विधि छिप जाती है), और जब CLP कीमतों में दशमलव हों (कुल राशि पूर्ण पेसो में राउंड होती है)। इंटीग्रेशन मोड चालू होने पर पेज Integration (test) environment दिखाता है: कोई असली पैसा नहीं लिया जाता। सेव करने के बाद चेतावनियाँ नई सेटिंग्स के अनुसार होती हैं। भुगतान विधियों की सूची में, बिना वैध क्रेडेंशियल के प्रोडक्शन चुने होने पर गेटवे को सेटअप की ज़रूरत वाला दिखाया जाता है।

सामान्य

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

Title: वह नाम जो ग्राहक चेकआउट पर भुगतान विधि के रूप में देखते हैं। डिफ़ॉल्ट: Webpay Plus।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay with credit, debit or prepaid card via Webpay.

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

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

Integration (test) mode: Use the Transbank integration environment। भुगतान Transbank के इंटीग्रेशन वातावरण में जाते हैं, उसके सार्वजनिक टेस्ट कॉमर्स कोड (597055555532) के साथ, जो अपने-आप भर जाता है। नीचे के प्रोडक्शन क्रेडेंशियल उपयोग नहीं होते और कोई असली पैसा नहीं लिया जाता। डिफ़ॉल्ट: चालू। लाइव होने के लिए इसका चेकमार्क हटाएँ।

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

Production API Key Secret: आपके प्रोडक्शन कॉमर्स का Tbk-Api-Key-Secret। इसे गोपनीय रखें। सेव करते समय स्पेस हटा दिए जाते हैं।

उन्नत

Debug log: Log API requests and returns (errors are always logged)। विवरण WooCommerce > Status > Logs में, स्रोत wcp_transbank_gateway के नाम से लिखे जाते हैं; इस फ़ील्ड में view logs लिंक है। यह विकल्प बंद होने पर भी त्रुटियाँ और चेतावनियाँ लॉग होती हैं। कार्ड डेटा, API कुंजियाँ या पूरे टोकन लॉग नहीं होते। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (order data is kept)। डिफ़ॉल्ट: बंद।

परीक्षण और लाइव

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Webpay Plus) और ऑर्डर देता है। इंटीग्रेशन मोड में चेकआउट पर TEST MODE: Integration environment दिखता है। कोई असली शुल्क नहीं। प्लगइन ऑर्डर की कुल राशि के लिए पूर्ण पेसो में एक Transbank लेन-देन बनाता है (दशमलव वाली कुल राशि निकटतम पेसो तक राउंड होती है) और ग्राहक को एक छोटे पेज Redirecting to Webpay. Please wait... पर भेजता है, जो उसे Webpay फ़ॉर्म पर आगे बढ़ा देता है। JavaScript न होने पर ग्राहक Proceed to Webpay पर क्लिक करता है। Webpay पर ग्राहक क्रेडिट, डेबिट या प्रीपेड कार्ड से भुगतान करता है।

ग्राहक के लौटने पर प्लगइन सर्वर-से-सर्वर पर Transbank के साथ लेन-देन की पुष्टि (commit) करता है। Transbank द्वारा पुष्टि के बाद ही ऑर्डर भुगतान किया हुआ चिह्नित होता है: उत्तर स्वीकृत होना चाहिए, और राशि, buy order व सेशन उसी से मेल खाने चाहिए जो स्टोर ने इस प्रयास के लिए भेजा था। फिर ग्राहक को ऑर्डर प्राप्त होने वाला पेज दिखता है। यदि पुष्टि का अनुरोध विफल हो जाए, उदाहरण के लिए टाइमआउट पर, तो प्लगइन 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. दिखता है।

यदि ग्राहक Webpay पर रद्द करता है, Webpay फ़ॉर्म समाप्त हो जाता है या त्रुटि दिखाता है, तो कोई शुल्क नहीं लगता। ऑर्डर भुगतान की प्रतीक्षा में रहता है और ग्राहक एक संदेश के साथ Pay for order पेज पर लौट जाता है, उदाहरण के लिए 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 लेन-देन होता है।

हर Webpay प्रयास अधिकतम एक बार पुष्ट होता है। रिटर्न पेज को दोबारा लोड करने, ब्राउज़र के बैक बटन, या उसी समय दूसरी बार लौटने से कभी दो बार पुष्टि नहीं होती और ऑर्डर नहीं बदलता। यदि किसी ऑर्डर को अब भुगतान की ज़रूरत नहीं (किसी अन्य प्रयास से भुगतान हो चुका, रद्द हो चुका, या रिफ़ंड हो चुका), तो देर से आया रिटर्न पुष्ट नहीं होता, इसलिए Transbank उसका शुल्क नहीं लेता। ग्राहक को This order can no longer be paid (it was cancelled or already paid). Your Webpay payment was not confirmed, so it was not charged. दिखता है।

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

यह भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Webpay पर भेजा गया था और उसने अभी भुगतान नहीं किया, रद्द किया, फ़ॉर्म को समाप्त होने दिया, या भुगतान की अभी पुष्टि नहीं हो पाई। हर बंद हुए प्रयास का नोट उसके buy order के साथ दर्ज होता है।

Processing or Completed: Transbank ने भुगतान स्वीकृत किया है। स्टेटस WooCommerce सेट करता है: प्रोसेसिंग, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर के लिए Completed। ऑर्डर नोट में प्राधिकरण कोड, कार्ड के अंतिम चार अंक, buy order, राशि, भुगतान प्रकार और किस्तों की संख्या दिखती है। ट्रांज़ैक्शन ID Webpay टोकन है।

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

Failed: भुगतान अस्वीकृत हुआ। कोई शुल्क नहीं लगा। नोट में प्रतिक्रिया कोड और स्टेटस दिखते हैं।

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

रिफ़ंड

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

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

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

प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Transbank Webpay Plus पेज के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्टेटस दिखाता है, उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन। स्टेटस फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

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

जब लाइसेंस समाप्त होता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्टेटस बैकग्राउंड में अपने-आप फिर से जाँचा जाता है।

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

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

भुगतान हो गया, पर ऑर्डर Pending payment पर अटका है: Transbank में वेबहुक नहीं है, इसलिए ऑर्डर केवल तभी पुष्ट होता है जब ग्राहक Webpay से लौटता है। यदि ग्राहक ने Webpay पर ब्राउज़र बंद कर दिया था, तो लेन-देन पुष्ट नहीं हुआ और Transbank के अनुसार सेटल नहीं होगा। ऑर्डर नोट्स, लॉग और Transbank पोर्टल में लेन-देन जाँचें।

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

ऑर्डर देते समय ग्राहक को त्रुटि दिखती है: Debug log चालू करें और WooCommerce > Status > Logs देखें, स्रोत wcp_transbank_gateway। Webpay payments are not available at the moment आमतौर पर गलत प्रोडक्शन क्रेडेंशियल का संकेत है। Could not connect to Webpay का अर्थ है कि Transbank तक पहुँच नहीं बन सकी। CLP से अलग मुद्रा वाला ऑर्डर Webpay से भुगतान नहीं हो सकता।

कुल राशि और रिफ़ंड में कुछ पेसो का अंतर है: CLP कीमतों में दशमलव होते हैं। Webpay पूर्ण पेसो चार्ज करता है, इसलिए कुल राशि राउंड होती है। Number of decimals को 0 सेट करें।

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

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

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश के अनुसार चलें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं बनती, तो प्लगइन अंतिम ज्ञात स्टेटस पर काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा बना रहता है। हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करके डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। गेटवे सेटिंग्स, अन्य विकल्प और प्लगइन का अस्थायी डेटा, तथा उसके लॉग (लॉग फ़ाइलें, जिनमें रोटेट की गई फ़ाइलें भी शामिल हैं, और डेटाबेस लॉग एंट्री) केवल तभी हटते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। ऑर्डरों पर संग्रहीत Transbank डेटा हमेशा रखा जाता है, क्योंकि उसकी ज़रूरत लेखा और रिफ़ंड के लिए होती है। मौजूदा ऑर्डर अपने भुगतान नोट्स और लेन-देन ID बनाए रखते हैं।

Transbank और Webpay उनके संबंधित स्वामियों के ट्रेडमार्क हैं। यह प्लगइन Transbank से संबद्ध नहीं है और Transbank द्वारा अनुमोदित नहीं है।