VibeFox Helcim for OpenCart — सहायता

आवश्यकताएँ

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

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

HTTPS और PCI DSS: कार्ड का विवरण आपके चेकआउट पर दर्ज किया जाता है और आपके सर्वर से Helcim को भेजा जाता है। इसे कभी संग्रहीत या लॉग नहीं किया जाता, लेकिन यह आपके सर्वर से होकर गुजरता है, इसलिए आपके स्टोर को चेकआउट के लिए SSL प्रमाणपत्र चाहिए और आपकी होस्टिंग को PCI DSS (SAQ D) का पालन करना होगा।

मुद्रा: Helcim CAD और USD में भुगतान प्रोसेस करता है। भुगतान विधि केवल तभी दिखाई जाती है जब चेकआउट की मुद्रा एक्सटेंशन में सेट की गई Account currencies में से कोई एक हो।

Helcim खाता: कनाडा या संयुक्त राज्य अमेरिका में एक Helcim मर्चेंट खाता और लेन-देन प्रोसेस करने के अधिकार वाला एक API टोकन (देखें Configuration)। परीक्षण के लिए Helcim टेस्ट (developer) खाता वैकल्पिक है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Helcim में All Tools > Integrations > API Access Configuration खोलें, लेन-देन प्रोसेसिंग के अधिकार (खरीद, प्री-ऑथराइज़ेशन, कैप्चर और रिफ़ंड) वाला API एक्सेस बनाएँ और उसका टोकन कॉपी करें।

5. टोकन को Live API token में चिपकाएँ, और अगर आपके पास Helcim टेस्ट खाता है तो उसका टोकन Test API token में चिपकाएँ।

6. Transaction type और Account currencies चुनें, Enable / Disable चालू करें और Save पर क्लिक करें। पहले परीक्षण करने के लिए Test mode चालू करें और अपने टेस्ट खाते से भुगतान करें; फिर उसे बंद कर दें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी, API टोकन और भुगतान सेटिंग्स OpenCart 3 के चरण 3 से 6 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड बंद होने के साथ शुरू होता है।

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

सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Payments > VibeFox Helcim Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर, यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा Account currencies में से कोई एक नहीं है तो पेज आपको चेतावनी देता है (तब Helcim केवल अनुमत मुद्रा के ऑर्डर के लिए दिखाया जाता है), और जब तक भुगतान विधि चालू है, यदि वर्तमान मोड का API टोकन खाली है तो भी चेतावनी देता है (तब भुगतान विधि चेकआउट पर छिपा दी जाती है)। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

Helcim

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

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

Description: Confirm Order चरण में कार्ड फ़ॉर्म के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit card.

Sort Order: चेकआउट पर भुगतान विधि की स्थिति। इसे खाली छोड़ें या एक पूर्ण संख्या डालें।

Geo Zone: चयनित भौगोलिक क्षेत्र (Geo Zone) के भुगतान पतों के लिए ही कार्ड फ़ॉर्म दिखाएँ। डिफ़ॉल्ट: All zones। Geo Zones System > Localisation > Geo Zones में सेट किए जाते हैं।

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

API क्रेडेंशियल

Helcim में All Tools > Integrations > API Access Configuration पर जाएँ, API एक्सेस बनाएँ और उसका टोकन कॉपी करें। इसे खरीद, प्री-ऑथराइज़ेशन, कैप्चर और रिफ़ंड के लिए लेन-देन प्रोसेसिंग का अधिकार दें। Helcim टेस्ट खाते लाइव खातों वाला ही API पता इस्तेमाल करते हैं, इसलिए टेस्ट मोड केवल आपके Helcim टेस्ट खाते का टोकन इस्तेमाल करता है। इस सेक्शन में Helcim API दस्तावेज़ का लिंक है।

Live API token: आपके लाइव Helcim खाते का API टोकन। यह तब इस्तेमाल होता है जब टेस्ट मोड बंद हो।

Test mode: Test API token (Helcim टेस्ट खाता) इस्तेमाल करता है। भुगतान, कैप्चर और रिफ़ंड आपके Helcim टेस्ट खाते में जाते हैं, और ग्राहकों को टेस्ट मोड की सूचना दिखती है। किसी ऑर्डर के कैप्चर और रिफ़ंड हमेशा उसी मोड के टोकन का इस्तेमाल करते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: बंद।

Test API token: आपके Helcim टेस्ट (developer) खाते का API टोकन। यह तब इस्तेमाल होता है जब टेस्ट मोड चालू हो।

सेव किए गए टोकन फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। बदलना हो तभी नया मान लिखें। सेव किया हुआ टोकन हटाने के लिए फ़ील्ड के नीचे Clear the saved token on save पर टिक करें और Save पर क्लिक करें।

भुगतान

Transaction type: कार्ड से शुल्क कैसे लिया जाता है।

Account currencies: वे मुद्राएँ जिन्हें आपका Helcim खाता प्रोसेस कर सकता है। ऑर्डर हमेशा ऑर्डर की मुद्रा में चार्ज होते हैं। अन्य मुद्राओं के लिए भुगतान विधि चेकआउट पर छिपी रहती है।

ऑर्डर

ऑर्डर Confirm Order चरण पर बिना स्टेटस के बनता है (एक लापता ऑर्डर), और Helcim द्वारा कार्ड स्वीकृत होने के बाद ही उसे स्टेटस मिलता है। हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: कार्ड से शुल्क लिया गया (खरीद, या प्री-ऑथराइज़ेशन का कैप्चर)। डिफ़ॉल्ट: Processing।

Authorized Status: प्री-ऑथराइज़ेशन: राशि केवल रोकी गई है, अभी चार्ज नहीं हुई है। ऑर्डर टैब में Capture payment से उसे कैप्चर करें। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है।

On Hold (Review) Status: Helcim का उत्तर ऑर्डर से मेल नहीं खाता (आंशिक स्वीकृति, दूसरी मुद्रा, कोई लेन-देन ID नहीं, या ऑर्डर का कुल चार्ज से अलग है)। ऑर्डर पूरा करने से पहले Helcim में लेन-देन जाँचें; एक नोट कारण बताता है। डिफ़ॉल्ट: Pending। अधिकृत और समीक्षा वाले ऑर्डर अलग पहचानने के लिए आप System > Localisation > Order Statuses में अपने स्टेटस बना सकते हैं।

Canceled Status: बिना कैप्चर किया गया प्री-ऑथराइज़ेशन ऑर्डर टैब से रिलीज़ किया गया (ग्राहक से शुल्क नहीं लिया गया)। डिफ़ॉल्ट: Canceled।

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

उन्नत

Debug log: API अनुरोध और उत्तर OpenCart लॉग फ़ोल्डर (storage/logs) में wc_hlg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। कार्ड नंबर केवल अंतिम 4 अंकों तक घटाए जाते हैं। CVC, एक्सपायरी, टोकन, नाम, पते, ईमेल और IP पते कभी लॉग नहीं होते। त्रुटियाँ (अस्वीकृत या विफल भुगतान, API त्रुटियाँ, विफल कैप्चर और रिफ़ंड) हमेशा लॉग होती हैं, भले ही यह बंद हो। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit card (Helcim))। Confirm Order चरण पर ग्राहक को एक कार्ड आइकन, आपका विवरण और Card Number, Expiry (MM/YY), CVC और Cardholder Name वाला फ़ॉर्म दिखता है। टेस्ट मोड में फ़ॉर्म TEST MODE — payments go to a Helcim test account, no real charges are made. दिखाता है। OpenCart इस चरण पर ऑर्डर बनाता है, पर अभी भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन कार्ड नंबर का चेकसम, यह कि एक्सपायरी तारीख मान्य और समाप्त नहीं हुई है, CVC 3 या 4 अंकों का है, और नाम भरा है, यह जाँचता है। त्रुटियाँ फ़ॉर्म के ऊपर दिखती हैं और Helcim को कुछ नहीं भेजा जाता।

OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, Payment method options विंडो में। इसके बाद कार्ड फ़ॉर्म चेकआउट पेज के नीचे ऑर्डर पुष्टि ब्लॉक में, Confirm Order बटन के ऊपर दिखता है। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं पूछता; तब एक्सटेंशन पते की पुष्टि के लिए शिपिंग पता कार्डधारक के नाम के साथ Helcim को भेजता है।

इसके बाद आपका सर्वर ऑर्डर की मुद्रा में ऑर्डर कुल के लिए कार्ड को खरीद या प्री-ऑथराइज़ेशन के रूप में Helcim को भेजता है। पते की पुष्टि के लिए कार्डधारक का नाम, भुगतान पता, फ़ोन और ईमेल भेजे जाते हैं। भुगतान Helcim में ऑर्डर नंबर, -OC और एक छोटे कोड से बने इनवॉइस नंबर के साथ दिखता है। Helcim उसी अनुरोध में उत्तर देता है। ऑर्डर को स्टेटस तभी मिलता है जब Helcim लेन-देन स्वीकृत कर देता है, OpenCart के सामान्य तरीके से, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। कार्ट तुरंत खाली हो जाता है और ग्राहक OpenCart के ऑर्डर सफलता पेज पर पहुँचता है।

प्रति कार्ट एक समय में केवल एक भुगतान प्रयास चलता है, और पहले से भुगतान किया गया कार्ट दोबारा कभी चार्ज नहीं होता, भले ही इस बीच OpenCart ने उसके लिए नया ऑर्डर बना दिया हो (OpenCart 3 में Confirm Order चरण हर बार दिखने पर वह नया ऑर्डर बनाता है; OpenCart 4 पर पहले का कोई ऑर्डर या दूसरा ब्राउज़र टैब अब भी वही कार्ट रख सकता है)। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए कार्ड अस्वीकृत होने के बाद ग्राहक उसी ऑर्डर का भुगतान करता है। यदि वह ऑर्डर इस बीच बंद हो गया हो (उदाहरण के लिए, आपने उसे रद्द किया हो), या वह पहले ही भुगतान हो चुका हो और कार्ट में अब नई खरीदारी हो, तो Confirm Order ग्राहक को चेकआउट पेज पर वापस ले जाता है, जिसके ऊपर Your previous order is already closed (cancelled or refunded by the store) or paid for another cart. Please confirm the order again: the cart will be paid with a new order. संदेश दिखता है, और अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत होती है। हर प्रयास एक idempotency कुंजी इस्तेमाल करता है। यदि Helcim उत्तर नहीं देता, तो ऑर्डर बिना स्टेटस के रहता है, और 5 मिनट के भीतर दोबारा प्रयास कार्ड को दो बार चार्ज करने के बजाय Helcim का मूल परिणाम लौटाता है। यदि भुगतान स्वीकृत हो गया पर ऑर्डर स्टेटस सेट नहीं हो सका, तो उसी कार्ट का अगला प्रयास कार्ड को दोबारा चार्ज किए बिना स्टेटस सेट करता है।

फ़ॉर्म के ऊपर ग्राहक को दिख सकने वाले संदेश: जब Helcim अस्वीकार करे तो Your card was declined. Please check the card details or use another card.; अन्य अस्वीकृत अनुरोधों पर Helcim के कारण सहित Payment failed:; जब Helcim उत्तर न दे तो We could not confirm your payment with the card processor. Please try again in a minute; if the problem persists, contact us before using another card.; जब API टोकन अस्वीकार हो तो This payment method is temporarily unavailable. Please choose another payment method.; डबल सबमिट पर Your payment is already being processed. Please wait a moment and check your e-mail before trying again.; जब भुगतान प्राप्त हो गया पर ऑर्डर अपने-आप पूरा न हो सका तो Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again.। ग्राहक उसी कार्ट के साथ Confirm Order चरण पर रहता है। तकनीकी विवरण लॉग में जाते हैं।

यह एक्सटेंशन HelcimPay.js या Helcim.js इस्तेमाल नहीं करता, इसलिए कार्ड का विवरण आपके सर्वर से होकर गुजरता है। इसमें सेव किए गए कार्ड, सब्सक्रिप्शन, ACH या बैंक भुगतान, Apple Pay, Google Pay या 3-D Secure नहीं हैं, और Helcim वेबहुक भी नहीं हैं।

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

ऑर्डर स्टेटस

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

Order Status After Payment (डिफ़ॉल्ट Processing): खरीद स्वीकृत हुई, या प्री-ऑथराइज़ेशन कैप्चर हुआ। एक नोट लेन-देन ID, अनुमोदन कोड, कार्ड का प्रकार, अंतिम 4 अंक और मोड दिखाता है।

Authorized Status (डिफ़ॉल्ट Pending): प्री-ऑथराइज़ेशन स्वीकृत हुआ। राशि केवल रोकी गई है। उसे कैप्चर करें या पूरे रिफ़ंड से रिलीज़ करें।

On Hold (Review) Status (डिफ़ॉल्ट Pending): Helcim ने लेन-देन स्वीकृत किया, लेकिन उसके उत्तर में राशि, मुद्रा या लेन-देन ID ऑर्डर से मेल नहीं खाते, जैसे आंशिक स्वीकृति के बाद, या भुगतान के दौरान ऑर्डर कुल बदल गया हो। नोट में Helcim response verification FAILED लिखा होता है। ऑर्डर पूरा करने से पहले Helcim में लेन-देन जाँचें।

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

Canceled Status (डिफ़ॉल्ट Canceled): बिना कैप्चर का प्री-ऑथराइज़ेशन रिलीज़ किया गया। ग्राहक से शुल्क नहीं लिया गया।

नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Helcim Gateway टैब

Sales > Orders में Helcim से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Helcim Gateway टैब Transaction ID (और कैप्चर के बाद प्री-ऑथराइज़ेशन ID) दिखाता है, टेस्ट भुगतानों के लिए Test mode लेबल के साथ, साथ ही Transaction type और कैप्चर की स्थिति, Invoice, Card और अनुमोदन कोड, Approved / order / refunded राशियाँ, कैप्चर बटन और रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Helcim notes। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है; कैप्चर और रिफ़ंड के लिए संशोधन का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर

बिना कैप्चर किए प्री-ऑथराइज़ेशन के लिए, टैब में Capture payment पर क्लिक करें (बटन पर राशि दिखती है) और Capture the pre-authorized amount through Helcim? की पुष्टि करें। रिफ़ंड घटाकर वर्तमान ऑर्डर कुल कैप्चर होता है। यह स्वीकृत राशि से कम हो सकता है, पर अधिक नहीं। कैप्चर उसी मोड के टोकन का इस्तेमाल करता है जिसमें ऑर्डर का भुगतान हुआ था। सफल कैप्चर के बाद ऑर्डर को Order Status After Payment मिलता है। यदि कैप्चर विफल हो, तो टैब कारण दिखाता है और उसे नोट्स में जोड़ता है।

रिफ़ंड

टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई, वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional), और Refund via Helcim पर क्लिक करें। Refund this amount through Helcim? This cannot be undone. की पुष्टि करें। खरीद या कैप्चर किए गए प्री-ऑथराइज़ेशन का पूरा और आंशिक रिफ़ंड समर्थित है, पर उस राशि तक जो Helcim ने वास्तव में चार्ज की थी; इसलिए आंशिक स्वीकृति के बाद आप ग्राहक द्वारा भुगतान की गई राशि से अधिक रिफ़ंड नहीं कर सकते। बिना कैप्चर किए प्री-ऑथराइज़ेशन के लिए बटन Release pre-authorization होता है: केवल पूरी राशि रिलीज़ हो सकती है, रोक हटा दी जाती है और ऑर्डर को Canceled Status मिलता है।

रिफ़ंड उसी मोड में भेजा जाता है जिसमें ऑर्डर का भुगतान हुआ था, इसलिए उस मोड का टोकन सेट होना चाहिए। यह तभी मान्य होता है जब Helcim उसे स्वीकृत करे। यदि Helcim अस्वीकार करे, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड Helcim रिफ़ंड लेन-देन ID के साथ रिफ़ंड इतिहास और नोट्स में जुड़ता है। पूरा रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में लौटाए, जैसे मैनुअल स्टेटस बदलने पर होता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता। टाइमआउट के बाद का पुनः प्रयास दो बार रिफ़ंड नहीं करता।

Sales > Returns में उत्पाद रिटर्न Helcim के ज़रिए पैसे वापस नहीं भेजते। यह एक्सटेंशन Helcim वेबहुक प्राप्त नहीं करता: Helcim डैशबोर्ड में किए गए कैप्चर, रिफ़ंड और वॉइड OpenCart में नहीं दिखते, इसलिए उन्हें ऑर्डर पेज से करें।

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

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

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

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

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

Helcim चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड का API टोकन सेट है (Live API token, या टेस्ट मोड में Test API token), और चेकआउट की मुद्रा Account currencies में से एक है। यदि टोकन नहीं है या स्टोर की मुद्रा अनुमत नहीं है, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चयनित Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

ग्राहक ने We could not confirm your payment देखा: Helcim ने उत्तर नहीं दिया, इसलिए कार्ड चार्ज हो गया हो सकता है। ऑर्डर नोट और लॉग Helcim इनवॉइस का नाम बताते हैं। ग्राहक से दोबारा शुल्क लेने से पहले Helcim में वह इनवॉइस जाँचें। 5 मिनट के भीतर पुनः प्रयास मूल परिणाम लौटाता है और दोबारा चार्ज नहीं करता।

ग्राहक This payment method is temporarily unavailable देखते हैं: Helcim ने API टोकन अस्वीकार किया। ऑर्डर नोट टोकन और उसकी अनुमतियाँ जाँचने को कहता है। सुनिश्चित करें कि API एक्सेस के पास लेन-देन प्रोसेसिंग का अधिकार है।

ग्राहक This payment method is not available. Please reload the checkout page. देखते हैं: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, इस बीच भुगतान विधि बंद हो गई हो सकती है, या टोकन या मुद्रा अब उपयुक्त नहीं है। ग्राहक चेकआउट पेज को रीलोड करता है।

Helcim कारण से भुगतान विफल: Helcim ने अनुरोध अस्वीकार किया, उदाहरण के लिए कार्ड या बिलिंग विवरण के कारण। ऑर्डर नोट और लॉग में विवरण हैं।

ग्राहक ने Your payment was received, but the order could not be completed देखा: Helcim ने भुगतान स्वीकृत कर दिया, पर OpenCart ऑर्डर स्टेटस सेट नहीं कर सका। कारण लॉग में है। जब ग्राहक वही कार्ट दोबारा सबमिट करता है, तो स्वीकृत भुगतान से स्टेटस बिना दूसरे चार्ज के सेट होता है।

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

कैप्चर संभव नहीं: कैप्चर की जाने वाली राशि 0 से अधिक होनी चाहिए और स्वीकृत राशि से ऊपर नहीं, और जिस मोड में ऑर्डर का भुगतान हुआ था उसका टोकन सेट होना चाहिए।

रिफ़ंड विफल: संदेश पढ़ें। बिना कैप्चर किया प्री-ऑथराइज़ेशन केवल पूरी तरह रिलीज़ हो सकता है। मोड से जुड़ा संदेश बताता है कि जिस मोड में ऑर्डर का भुगतान हुआ था उसका टोकन खाली है। अस्वीकृत रिफ़ंड दर्ज नहीं होता। You do not have permission to capture or refund (modify this extension). का अर्थ है कि आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है।

टेस्ट भुगतान: टेस्ट मोड भुगतान, कैप्चर और रिफ़ंड आपके Helcim टेस्ट खाते में भेजता है। ऑर्डर उसी मोड को रखते हैं जिसमें उनका भुगतान हुआ था, इसलिए बाद में मोड बदलने से उनके कैप्चर और रिफ़ंड दूसरे खाते में नहीं जाते।

अनइंस्टॉल

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

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

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