VibeFox Helcim for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, स्थापित और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय होने से मना कर देता है।

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

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

Helcim खाता: कनाडा या संयुक्त राज्य अमेरिका में एक Helcim मर्चेंट खाता और लेन-देन प्रसंस्करण अधिकारों के साथ एक API टोकन (कॉन्फ़िगरेशन देखें)। Helcim CAD और USD को प्रोसेस करता है। परीक्षण के लिए एक Helcim टेस्ट (डेवलपर) खाता वैकल्पिक है।

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

इंस्टॉलेशन

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

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

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

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

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

6. टोकन को Live API token में पेस्ट करें, और यदि आपके पास Helcim टेस्ट खाता है तो उसका टोकन Test API token में पेस्ट करें।

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

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

सभी सेटिंग्स एक पेज पर हैं: WooCommerce > Settings > Payments > Helcim। फ़ील्ड के ऊपर पेज आपको चेतावनी देता है जब स्टोर मुद्रा Account currencies में से एक नहीं होती है, और जब गेटवे सक्षम होने के दौरान वर्तमान मोड का API टोकन खाली होता है। दोनों मामलों में गेटवे चेकआउट पर छिप जाता है। भुगतान विधियों की सूची में गेटवे को तब तक सेटअप की आवश्यकता के रूप में चिह्नित किया जाता है जब तक कि वर्तमान मोड में टोकन न हो।

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

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

Description: चेकआउट पर दिखाया जाने वाला भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely with your credit card।

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

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

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

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

Test API token: आपके Helcim टेस्ट (डेवलपर) खाते का API टोकन। टेस्ट मोड चालू होने पर उपयोग किया जाता है।

भुगतान

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

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

उन्नत

Debug log: Log API requests and responses को WooCommerce > Status > Logs में रिकॉर्ड करें, स्रोत wcp_helcim_gateway। कार्ड नंबर अंतिम 4 अंकों तक सीमित कर दिए जाते हैं। CVC, समाप्ति तिथि, टोकन, नाम, पते, ई-मेल और IP पते कभी लॉग नहीं किए जाते हैं। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the gateway settings, its own options (wc_hlg_*) and its log files when the plugin is deleted. डिफ़ॉल्ट: बंद।

चेकआउट

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

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

प्रति ऑर्डर एक समय में केवल एक ही भुगतान प्रयास चलता है, और पहले से भुगतान किए जा चुके ऑर्डर पर कभी दोबारा शुल्क नहीं लिया जाता। प्रत्येक प्रयास में एक idempotency कुंजी का उपयोग होता है। यदि Helcim उत्तर नहीं देता है, तो ऑर्डर "भुगतान लंबित" स्थिति में बना रहता है, और 5 मिनट के भीतर दोबारा प्रयास करने पर कार्ड पर दो बार चार्ज करने के बजाय मूल 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. जब Helcim उत्तर नहीं देता है; This payment method is temporarily unavailable. Please choose another payment method. जब API टोकन गायब हो या अस्वीकार कर दिया गया हो; Your payment is already being processed. Please wait a moment and check your e-mail before trying again. दोहरा सबमिशन होने पर। तकनीकी विवरण ऑर्डर नोट और लॉग में दर्ज होते हैं।

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

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

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

ऑर्डर की स्थितियाँ

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

Processing: एक खरीद स्वीकृत हो गई थी, या एक पूर्व-प्राधिकरण कैप्चर कर लिया गया था। केवल वर्चुअल डाउनलोड करने योग्य उत्पादों वाले ऑर्डर "पूर्ण" स्थिति में चले जाते हैं, जो कि WooCommerce डिफ़ॉल्ट है। ऑर्डर नोट लेन-देन ID, अनुमोदन कोड, कार्ड का प्रकार, अंतिम 4 अंक और मोड दिखाता है। लेन-देन ID Helcim लेन-देन ID है।

On hold (pre-authorization): राशि केवल रोकी गई है। ऑर्डर एक्शन से उन्हें कैप्चर करें या पूर्ण रिफ़ंड के साथ उन्हें रिलीज़ करें।

On hold after payment: Helcim ने लेन-देन स्वीकृत कर दिया, लेकिन उसके उत्तर में राशि, मुद्रा या लेन-देन ID ऑर्डर से मेल नहीं खाते हैं। नोट कहता है Helcim response verification FAILED। पूर्ति करने से पहले Helcim में लेन-देन की जाँच करें।

कैप्चर

ऑर्डर खोलें (स्थिति "होल्ड पर"), ऑर्डर एक्शन Capture Helcim pre-authorization चुनें और Update पर क्लिक करें। रिफ़ंड घटाकर वर्तमान ऑर्डर कुल कैप्चर किया जाता है। यह प्राधिकृत राशि से कम हो सकता है, लेकिन अधिक नहीं। कैप्चर उस मोड के टोकन का उपयोग करता है जिसमें ऑर्डर का भुगतान किया गया था। एक सफल कैप्चर के बाद ऑर्डर "प्रोसेसिंग" स्थिति में चला जाता है, और लेन-देन ID बदलकर कैप्चर लेन-देन हो जाता है। यदि कैप्चर विफल हो जाता है, तो कारण दिखाया जाता है और ऑर्डर नोट्स में जोड़ दिया जाता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Credit card (Helcim) पर क्लिक करें (बटन आपका Title दिखाता है)। किसी खरीद या कैप्चर किए गए पूर्व-प्राधिकरण के पूर्ण और आंशिक रिफ़ंड समर्थित हैं। एक अनकैप्चर किए गए पूर्व-प्राधिकरण को केवल पूर्ण रूप से रिफ़ंड किया जा सकता है: रोक हटा दी जाती है और ग्राहक से कोई शुल्क नहीं लिया जाता है। रिफ़ंड उस मोड में भेजा जाता है जिसमें ऑर्डर का भुगतान किया गया था, इसलिए उस मोड का टोकन सेट होना चाहिए। यह तभी मान्य होता है जब Helcim इसे स्वीकृत करता है। यदि Helcim इसे अस्वीकार करता है, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं किया जाता है। एक सफल रिफ़ंड Helcim रिफ़ंड लेन-देन ID के साथ ऑर्डर नोट में जोड़ दिया जाता है। टाइमआउट के बाद दोबारा प्रयास करने पर दोहरा रिफ़ंड नहीं होता है।

प्लगइन को Helcim वेबहुक प्राप्त नहीं होते हैं। Helcim डैशबोर्ड में किए गए कैप्चर, रिफ़ंड और रद्दीकरण WooCommerce में परिलक्षित नहीं होते हैं, इसलिए उन्हें WooCommerce से करें।

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

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

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

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

जब कोई लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करना जारी रखता है, लेकिन अपडेट और समर्थन के लिए नवीनीकरण की आवश्यकता होती है। पृष्ठभूमि में स्थिति स्वचालित रूप से फिर से जाँची जाती है।

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

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

Helcim ने उत्तर नहीं दिया और ऑर्डर "भुगतान लंबित" स्थिति में बना रहता है: कार्ड से शुल्क लिया गया हो सकता है। ग्राहक से दोबारा शुल्क लेने से पहले ऑर्डर नोट पढ़ें और Helcim में इनवॉइस की जाँच करें। 5 मिनट के भीतर दोबारा प्रयास करने पर मूल परिणाम मिलता है और दो बार शुल्क नहीं लिया जाता है।

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

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

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

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

रिफ़ंड विफल रहता है: संदेश पढ़ें। एक अनकैप्चर किए गए पूर्व-प्राधिकरण को केवल पूर्ण रूप से रिफ़ंड किया जा सकता है। मोड के बारे में एक संदेश का अर्थ है कि जिस मोड में ऑर्डर का भुगतान किया गया था उसका टोकन खाली है। एक अस्वीकृत रिफ़ंड दर्ज नहीं किया जाता है।

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

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

डेवलपर्स के लिए: फ़िल्टर wc_hlg_supported_currencies मुद्राओं की सूची को बदलता है, और wc_hlg_card_brands चेकआउट पर कार्ड आइकन बदलता है।

अनइंस्टॉल

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

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