VibeFox Tap for OpenCart — सहायता

आवश्यकताएँ

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

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

ऑर्डर की मुद्रा: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR या USD। अन्य मुद्राओं के ऑर्डर के लिए चेकआउट पर भुगतान विधि नहीं दिखाई जाती।

आपके स्टोर तक इंटरनेट पहुँच: Tap भुगतान का परिणाम आपके स्टोर पर एक वेबहुक को भेजता है, इसलिए साइट इंटरनेट से पहुँच योग्य होनी चाहिए। हर भुगतान के साथ वेबहुक URL भेजा जाता है; Tap डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।

Tap खाता: आपको अपने Tap डैशबोर्ड (goSell, API क्रेडेंशियल) से API कुंजियाँ चाहिए। टेस्ट कुंजियाँ pk_test_ / sk_test_ से और लाइव कुंजियाँ pk_live_ / sk_live_ से शुरू होती हैं। गुप्त कुंजी हमेशा आवश्यक है; प्रकाशन योग्य कुंजी केवल चेकआउट पॉपअप के लिए चाहिए। कौन-सी भुगतान विधियाँ दी जाएँगी (mada, KNET, Benefit और अन्य) और Apple Pay डोमेन सत्यापन, ये आपके Tap खाते में सेट किए जाते हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी Tap टेस्ट और लाइव कुंजियाँ दर्ज करें, भुगतान क्रिया, चेकआउट प्रकार और Tap पेज की भाषा चुनें (देखें Configuration)।

5. Enable / Disable चालू करें और Save पर क्लिक करें। Tap टेस्ट कार्ड से परीक्षण करें, फिर Test mode बंद करें।

OpenCart 4

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

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

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

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

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

Configuration

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Tap Payments > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज यह दिखाता है: Test mode is on: payments use your Tap test keys and no real money is charged. या Live mode: real payments are accepted. वर्तमान मोड की कुंजियाँ गायब होने पर (तब चेकआउट पर भुगतान विधि नहीं दिखाई जाती) और स्टोर की डिफ़ॉल्ट मुद्रा Tap के साथ उपलब्ध न होने पर भी यह चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता और 128 अक्षरों से अधिक नहीं हो सकता, Sort Order पूर्ण संख्या होना चाहिए (ऋणात्मक मान स्वीकार्य हैं), Total 0 या उससे अधिक की संख्या होना चाहिए, और ऑर्डर स्टेटस मौजूद होने चाहिए; अन्यथा कुछ भी सेव नहीं होता। अपने फ़ील्ड के लिए गलत उपसर्ग वाली कुंजी सेव नहीं होती: पिछला मान रहता है, बाकी सेटिंग्स सेव होती हैं और Test secret key was not saved: a Tap key for this field starts with "sk_test_". जैसा संदेश दिखता है। उदाहरण के लिए, टेस्ट फ़ील्ड में लाइव कुंजी अस्वीकार हो जाती है।

Tap Payments

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

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

Description: वह पाठ जो ग्राहक Confirm Order चरण में पुष्टि बटन के ऊपर देखते हैं। डिफ़ॉल्ट: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

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

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

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

Tap API कुंजियाँ

अपनी कुंजियाँ Tap डैशबोर्ड (goSell, API क्रेडेंशियल) में खोजें। इस सेक्शन में Tap डेवलपर दस्तावेज़ का लिंक है।

Test mode: टेस्ट कुंजियों का उपयोग करता है, कोई वास्तविक राशि नहीं ली जाती। भुगतान, स्थिति जाँच, कैप्चर और रिफ़ंड हमेशा उसी मोड की कुंजियों का उपयोग करते हैं जिसमें भुगतान हुआ था, इसलिए लाइव पर स्विच करने के बाद भी टेस्ट भुगतान की जाँच और रिफ़ंड टेस्ट कुंजी से होता है। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक Confirm Order चरण और पॉपअप भुगतान पेज पर Test mode: no real payment will be made. देखते हैं।

Test publishable key: pk_test_ से शुरू होती है। पॉपअप के लिए आवश्यक।

Test secret key: sk_test_ से शुरू होती है।

Live publishable key: pk_live_ से शुरू होती है। पॉपअप के लिए आवश्यक।

Live secret key: sk_live_ से शुरू होती है।

Merchant ID: वैकल्पिक। आपकी Tap मर्चेंट ID; केवल तभी चाहिए जब Tap ने आपसे भुगतान किसी विशेष मर्चेंट खाते पर भेजने को कहा हो।

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

भुगतान

Payment action: ग्राहक के भुगतान करने पर पैसे का क्या होता है।

Checkout type: ग्राहक कहाँ भुगतान करता है।

Tap page language: Tap भुगतान पेज और पॉपअप की भाषा: English (डिफ़ॉल्ट) या Arabic।

भुगतान सूचनाएँ (वेबहुक)

Tap भुगतान का परिणाम इस सेक्शन में Webhook URL पर दिखाए गए URL पर भेजता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के storefront पते से बनता है। यह URL हर भुगतान के साथ भेजा जाता है, इसलिए Tap डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। बस यह सुनिश्चित करें कि यह इंटरनेट से पहुँच योग्य हो (फ़ायरवॉल या HTTP प्रमाणीकरण से अवरुद्ध न हो); मेंटेनेंस मोड इसे अवरुद्ध नहीं करता (OpenCart 4 पर एक्सटेंशन की एक स्टार्टअप क्रिया webhook और ग्राहक की वापसी को आगे जाने देती है)। हर सूचना hashstring हस्ताक्षर से जाँची जाती है (भुगतान वाले मोड की गुप्त कुंजी से HMAC-SHA256)। वैध हस्ताक्षर के बिना वेबहुक अस्वीकार होते हैं। हस्ताक्षरित सूचना पर भी अपने-आप भरोसा नहीं किया जाता: एक्सटेंशन ऑर्डर बदलने से पहले Tap API से भुगतान दोबारा पढ़ता है। कार्यरत वेबहुक के बिना, ऑर्डर को तभी स्थिति मिलती है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

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

Paid Order Status: कैप्चर किए गए भुगतान के बाद की स्थिति। डिफ़ॉल्ट: प्रोसेसिंग।

Authorized Status: Authorize only: राशि रोकी गई है, अभी कैप्चर नहीं हुई। डिफ़ॉल्ट: लंबित।

On Hold (Review) Status: भुगतान को आपकी समीक्षा चाहिए (देखें Order statuses)। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Voided Status: Void Tap authorization के रोकी गई राशि छोड़ने के बाद सेट होता है। डिफ़ॉल्ट: रद्द।

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

उन्नत

Debug log: भुगतान घटनाएँ OpenCart लॉग फ़ोल्डर (storage/logs, OpenCart 4 पर system/storage/logs) में tap_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती, और 5 MB होने पर tap_p_debug.old.log.php में ले जाई जाती है। त्रुटियाँ और चेतावनियाँ हमेशा लॉग होती हैं; हर भुगतान घटना भी लॉग करने के लिए इसे चालू करें। लॉग में कभी कुंजियाँ, कार्ड या ग्राहक का डेटा नहीं होता। डिफ़ॉल्ट: बंद।

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

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

आयात / निर्यात

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Tap Payments)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। फिर ग्राहक Confirm Order पर क्लिक करता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

Tap payment page: एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर की कुल राशि के लिए Tap चार्ज (या Authorize only मोड में प्राधिकरण) बनाता है, विवरण के रूप में Order # और ऑर्डर नंबर के साथ, और ग्राहक को Tap भुगतान पेज पर भेजता है। ग्राहक का नाम, ईमेल और फ़ोन नंबर Tap को दिए जाते हैं। वहाँ ग्राहक कार्ड, mada, KNET, Benefit, Apple Pay या Google Pay में से चुनता है (जो आपके Tap खाते में सक्षम हैं) और भुगतान करता है। यदि Tap भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और The Tap payment could not be started. Please try again or choose another payment method. देखता है, और कारण लॉग में जाता है।

Tap checkout popup: ग्राहक एक्सटेंशन के Tap payment पेज पर जाता है, जहाँ Tap भुगतान फ़ॉर्म खुलता है। पेज पर Pay on the Tap payment page instead लिंक भी दिखता है। यदि विंडो बंद हो गई हो, तो Pay now बटन उसे फिर से खोल देता है। यदि फ़ॉर्म लोड न हो सके, तो ग्राहक से Tap भुगतान पेज का उपयोग करने को कहा जाता है। पेज रीलोड करने पर वही भुगतान प्रयास फिर से उपयोग होता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Tap भुगतान की पुष्टि करता है: एक्सटेंशन भुगतान मोड की कुंजी से Tap API से भुगतान दोबारा पढ़ता है, जाँचता है कि वह इसी ऑर्डर से संबंधित है और इसके चेकआउट से शुरू हुआ था, और राशि व मुद्रा की ऑर्डर से तुलना करता है। वापसी पते में अकेला Tap ID कभी ऑर्डर नहीं बदलता। वेबहुक भी पृष्ठभूमि में यही जाँच करता है। फिर ऑर्डर OpenCart के सामान्य तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। OpenCart 4 पर, जब ग्राहक Tap भुगतान पेज से लौटता है, तो एक छोटा मध्यवर्ती पेज आपके स्टोर का वापसी पता फिर से खोलता है, ताकि कार्ट और ग्राहक का लॉगिन बना रहे। अधिकृत भुगतान के लिए पेज पर Your payment has been authorized. We will process the order as soon as the payment is captured. भी दिखता है। समीक्षाधीन भुगतान के लिए Your payment is being reviewed. We will contact you if anything else is needed. दिखता है।

यदि ग्राहक के लौटने तक Tap ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. दिखाता है, साथ में Check again और Back to checkout बटन होते हैं। वेबहुक आते ही ऑर्डर स्थिति सेट कर देता है।

यदि भुगतान अस्वीकार, छोड़ा या रद्द हुआ, तो ऑर्डर बिना स्थिति के रहता है। ग्राहक Your payment was not completed. Please try again or choose another payment method. (यदि Tap कारण बताता है तो उसके साथ) दिखाते हुए चेकआउट पर लौट आता है। अधूरा भुगतान The payment was not completed. You can try again or choose another payment method. दिखाता है। कार्ट सुरक्षित रहता है और उसे फिर से भुगतान किया जा सकता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है। यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले ही भुगतान किया जा चुका है, तो ग्राहक दोबारा भुगतान करने के बजाय सीधे सफलता पेज पर जाता है। नया भुगतान शुरू करने से पहले, ऑर्डर और कार्ट के पिछले 24 घंटों के खुले Tap भुगतान पेज Tap से जाँचे जाते हैं, ताकि दूसरे टैब में किया गया भुगतान दोबारा चार्ज होने के बजाय पुष्ट हो जाए। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसे अपना अलग भुगतान चाहिए।

OpenCart 4 सफलता पेज दिखाए जाने तक ऑर्डर को चेकआउट में रखता है। अस्वीकृत या रद्द भुगतान के बाद अगला Confirm Order उसी ऑर्डर के लिए एक नया Tap भुगतान शुरू करता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए आपने उसे रद्द किया, या उसका प्राधिकरण रद्द (void) कर दिया गया हो), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. संदेश के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है।

चेकआउट पर अन्य संदेश: जब ऑर्डर की मुद्रा समर्थित न हो, तब Tap does not accept payments in और उसके बाद मुद्रा, और The order total must be greater than zero to pay with Tap.

इस एक्सटेंशन में सेव किए गए कार्ड या टोकनाइज़ेशन, सब्सक्रिप्शन, या आपके चेकआउट पेज में एम्बेड किए गए कार्ड फ़ील्ड नहीं हैं। Capture Tap payment हमेशा ऑर्डर की कुल राशि कैप्चर करता है; आंशिक कैप्चर समर्थित नहीं है।

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

ऑर्डर स्टेटस

कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक को Tap पर भेजा गया और उसने भुगतान नहीं किया, या Tap ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो। OpenCart 4.1 पर ऐसे ऑर्डर की स्थिति Voided भी हो सकती है, जो OpenCart तब सेट करता है जब पुष्टि चरण फिर से दिखाया जाता है; एक्सटेंशन उसे बिना स्थिति वाला ऑर्डर मानता है।

Paid Order Status (default Processing): Tap ने कैप्चर किए गए भुगतान की पुष्टि की। एक नोट राशि, Tap चार्ज ID (chg_...), भुगतान विधि और (टेस्ट मोड में) टेस्ट भुगतानों के लिए यह दिखाता है।

Authorized Status (default Pending): भुगतान केवल अधिकृत हुआ है और कैप्चर या void की प्रतीक्षा में है।

On Hold (Review) Status (default Pending): भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (Tap: amount/currency mismatch — manual review required.), या ऑर्डर रद्द होने के बाद भुगतान आया। नोट इसे समझाता है। ऑर्डर जाँचें और पूरा करें, या भुगतान रिफ़ंड करें।

Voided Status (default Canceled): Void Tap authorization से प्राधिकरण रद्द हुआ, इसलिए रोकी गई राशि छोड़ दी गई।

Refunded Status (default Refunded): एक्सटेंशन के माध्यम से भुगतान का पूरा रिफ़ंड हुआ।

विफल प्रयास कभी ऐसे ऑर्डर को नहीं बदलता जिसकी पहले से स्थिति है। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा सफल भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट बताता है कि यह दोहरा भुगतान है और आपसे Tap डैशबोर्ड में उसे रिफ़ंड करने को कहता है। पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर का भुगतान उस ऑर्डर को बिना स्थिति के छोड़ देता है और भुगतान किए गए ऑर्डर पर नोट होता है। ऐसा भुगतान जो ऑर्डर से संबंधित है पर उसके चेकआउट से शुरू नहीं हुआ, उसे केवल नोट किया जाता है।

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

VibeFox Tap Payments टैब

Sales > Orders में Tap से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Tap Payments टैब Tap ID, Authorization और Charge, Mode (टेस्ट भुगतानों के लिए Test लेबल), भुगतान का Status और विधि, Charged / refunded, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, ऑर्डर के Payment attempts और Tap notes दिखाता है। यह टैब एक्सटेंशन की पहुँच वाले उपयोगकर्ताओं को दिखता है; कैप्चर, void और रिफ़ंड के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर और void

Authorize only मोड में, अधिकृत ऑर्डर खोलें। Capture Tap payment (बटन पर ऑर्डर की कुल राशि के साथ) प्रश्न Capture the reserved funds of this order through Tap? की पुष्टि के बाद ऑर्डर की कुल राशि कैप्चर करता है; ऑर्डर को फिर Paid Order Status मिलता है। Void Tap authorization पूछता है Release the reserved funds? The order will be canceled., रोकी गई राशि छोड़ता है और Voided Status सेट करता है। 2 मिनट के भीतर दूसरा कैप्चर क्लिक अवरुद्ध होता है। यदि Tap क्रिया अस्वीकार करता है, तो टैब में त्रुटि दिखती है और नोट्स में जुड़ती है। ये स्थिति बदलाव ग्राहक को सूचित किए बिना और स्टॉक बदले बिना होते हैं, मैन्युअल स्थिति बदलाव की तरह। यदि प्राधिकरण सीधे Tap डैशबोर्ड में कैप्चर किया गया हो, तो वेबहुक ऑर्डर को भुगतान किया हुआ चिह्नित करता है; ऐसे भुगतान के रिफ़ंड Tap डैशबोर्ड में करने होते हैं।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी से Tap के माध्यम से पैसे वापस नहीं जाते। Tap डैशबोर्ड में किए गए रिफ़ंड OpenCart में नहीं दिखते।

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

यह एक्सटेंशन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Tap Payments, Extensions > Extensions > Payments > VibeFox Tap Payments > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-tap पंक्ति और आपके vibefox.net खाते को खोलने वाला Manage licenses and domains in your account लिंक है। केवल उन एडमिन उपयोगकर्ताओं के पास, जिनके पास एक्सटेंशन पर Modify अधिकार है, कुंजी बदलने की शक्ति है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या आपके खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर से संपर्क नहीं हो पाता, तो एक्सटेंशन अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

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

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

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

Tap Payments चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, और वर्तमान मोड में गुप्त कुंजी है (और Checkout type पॉपअप होने पर प्रकाशन योग्य कुंजी भी)। जाँचें कि ऑर्डर की मुद्रा AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD में से एक है, कि भुगतान पता चुने गए Geo Zone में है, और कि ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है। सेटिंग्स पेज गायब कुंजियों और असमर्थित स्टोर मुद्रा के लिए चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: वेबहुक आपके स्टोर तक नहीं पहुँच पा रहा है। जाँचें कि Webhook URL में दिखाया गया URL इंटरनेट से पहुँच योग्य है (कोई फ़ायरवॉल या HTTP प्रमाणीकरण नहीं), और Log फ़ील्ड में उत्तर देखने के लिए Debug log चालू करें। ग्राहक के Tap से लौटने पर भी ऑर्डर को स्थिति मिल जाती है।

Webhook answers invalid signature: सूचना भुगतान मोड की गुप्त कुंजी से हस्ताक्षरित नहीं थी। सेटिंग्स में गुप्त कुंजियाँ जाँचें।

Webhook answers gateway not configured: भुगतान मोड (टेस्ट या लाइव) की गुप्त कुंजी खाली है। उसे दर्ज करें।

Webhook answers verification failed: भुगतान जाँचने के लिए Tap API तक पहुँच नहीं हो सकी। Tap बाद में वेबहुक फिर से भेजेगा।

Webhook answers order not found: सूचना ऐसे ऑर्डर का उल्लेख करती है जिसका इस स्टोर में कोई Tap भुगतान प्रयास नहीं है।

Webhook answers busy, retry later or order could not be updated, retry later: उसी समय ऑर्डर की पुष्टि किसी दूसरे अनुरोध से हो रही थी, या ऑर्डर की स्थिति सेट नहीं हो सकी। Tap वेबहुक फिर से भेजेगा। कारण के लिए Log फ़ील्ड देखें।

कोई कुंजी सेव नहीं हुई: कुंजी को अपने फ़ील्ड के उपसर्ग से शुरू होना चाहिए: pk_test_, sk_test_, pk_live_ या sk_live_।

ग्राहक को The Tap payment could not be started दिखता है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। गलत कुंजी या अस्वीकृत अनुरोध वहीं दर्ज होता है।

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

ग्राहक को We could not match this payment to an order दिखता है: यह भुगतान इस ऑर्डर का नहीं है या इसके चेकआउट से शुरू नहीं हुआ था। यदि पैसे कट चुके हैं, तो Tap डैशबोर्ड में भुगतान जाँचें।

ऑर्डर समीक्षा स्थिति में है: VibeFox Tap Payments टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई, या ऑर्डर रद्द होने के बाद भुगतान आया।

मोड से संबंधित संदेश के साथ रिफ़ंड विफल होता है: भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की गुप्त कुंजी सेट नहीं है। कुंजी दर्ज करें और फिर कोशिश करें। यदि टैब बताता है कि कैप्चर किया गया Tap चार्ज नहीं मिला, तो भुगतान Tap डैशबोर्ड में रिफ़ंड करें।

डेवलपर्स के लिए: OpenCart इवेंट tap_p_charge_payload, tap_p_supported_currencies और tap_p_currency_decimals भुगतान अनुरोध, समर्थित मुद्राओं और मुद्रा के दशमलव अंकों को बदलने देते हैं।

अनइंस्टॉल

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

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

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