VibeFox Tap for WooCommerce — सहायता

आवश्यकताएँ

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

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

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_ से शुरू होती हैं। secret key हमेशा आवश्यक है; publishable key केवल चेकआउट पॉपअप के लिए। कौन-सी भुगतान विधियाँ दी जाती हैं (mada, KNET, Benefit और अन्य) और Apple Pay डोमेन सत्यापन, ये आपके Tap खाते में सेट होते हैं।

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

इंस्टॉलेशन

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

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

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

4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।

5. अपनी Tap परीक्षण और लाइव कुंजियाँ डालें, भुगतान क्रिया, चेकआउट प्रकार और Tap पेज की भाषा चुनें (देखें कॉन्फ़िगरेशन)।

6. Enable / Disable चालू करें और सहेजें। Tap परीक्षण कार्ड से जाँच करें, फिर Test mode का निशान हटा दें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Tap Payments। फ़ील्ड्स के ऊपर यह पेज, जब तक टेस्ट मोड चालू है, Test mode is on: payments use your Tap test keys and no real money is charged. दिखाता है। यह यह भी बताता है कि जब वर्तमान मोड की कुंजियाँ गायब हैं (तब चेकआउट पर गेटवे नहीं दिखता), और जब स्टोर मुद्रा Tap पर उपलब्ध नहीं है। भुगतान विधियों की सूची में Tap Payments को तब तक सेटअप की ज़रूरत वाला चिह्नित किया जाता है जब तक वर्तमान मोड में secret key (और पॉपअप के लिए publishable key) न हो।

सहेजते समय, जिस फ़ील्ड के लिए जो प्रीफ़िक्स सही है उससे अलग प्रीफ़िक्स वाली कुंजी सहेजी नहीं जाती: एक त्रुटि दिखती है और पिछला मान बना रहता है। उदाहरण के लिए, टेस्ट फ़ील्ड में लाइव कुंजी अस्वीकार हो जाती है।

सामान्य

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

Title: चेकआउट पर दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: Tap Payments।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay।

Tap API कुंजियाँ

अपनी कुंजियाँ Tap डैशबोर्ड (goSell, API क्रेडेंशियल) में खोजें। परीक्षण कुंजियाँ pk_test_ / sk_test_ से और लाइव कुंजियाँ pk_live_ / sk_live_ से शुरू होती हैं।

Test mode: Use the test keys (no real money is charged)। भुगतान, स्टेटस जाँच और रिफ़ंड हमेशा उसी मोड की कुंजियों से होते हैं जिसमें भुगतान हुआ था; इसलिए लाइव पर स्विच करने के बाद भी टेस्ट भुगतान की जाँच और रिफ़ंड टेस्ट कुंजी से ही होते हैं। डिफ़ॉल्ट: चालू।

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 ने आपसे भुगतान किसी विशेष मर्चेंट खाते पर भेजने को कहा हो।

भुगतान

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

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

Tap page language: English (डिफ़ॉल्ट) या Arabic।

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

Tap भुगतान का परिणाम इस खंड में दिखाए गए URL पर भेजता है। यह इस रूप का होता है: https://your-site/wc-api/tap_p_webhook/। यह URL हर भुगतान के साथ भेजा जाता है, इसलिए Tap डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। बस यह सुनिश्चित करें कि यह इंटरनेट से पहुँच योग्य है (फ़ायरवॉल, मेंटेनेंस मोड या HTTP ऑथेंटिकेशन से अवरुद्ध नहीं)। हर सूचना hashstring हस्ताक्षर (भुगतान के मोड की secret key के साथ HMAC-SHA256) से जाँची जाती है। वैध हस्ताक्षर के बिना वेबहुक अस्वीकार होते हैं। हस्ताक्षरित सूचना को भी अपने-आप भरोसेमंद नहीं माना जाता: प्लगइन ऑर्डर बदलने से पहले Tap API से भुगतान फिर से पढ़ता है। काम करने वाले वेबहुक के बिना, ऑर्डर तभी अपडेट होता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है।

एडवांस्ड

Debug log: Log payment events (WooCommerce → Status → Logs, source "wcp_tap_payment_gateway")। त्रुटियाँ हमेशा लॉग होती हैं। लॉग में कभी कुंजियाँ, कार्ड या ग्राहक का डेटा नहीं होता। डिफ़ॉल्ट: बंद।

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Tap Payments) और ऑर्डर देता है। टेस्ट मोड में चेकआउट पर Test mode: no real payment will be made. दिखता है।

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

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

भुगतान के बाद ग्राहक ऑर्डर प्राप्ति पेज पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Tap पुष्टि करे: प्लगइन भुगतान के मोड की कुंजी से Tap API पर भुगतान पढ़ता है, जाँचता है कि वह इसी ऑर्डर का है और इसके चेकआउट से शुरू हुआ था, और राशि व मुद्रा की ऑर्डर से तुलना करता है। वापसी के पते में केवल Tap ID किसी ऑर्डर को कभी भुगतान किया हुआ नहीं बनाता। वेबहुक पृष्ठभूमि में यही जाँच करता है। बार-बार आने वाले वेबहुक और वापसी के अनुरोध किसी ऑर्डर को कभी दो बार नहीं बदलते (हर ऑर्डर पर एक समय में एक ही बदलाव)।

यदि भुगतान अभी पुष्ट नहीं हुआ है, तो ऑर्डर प्राप्ति पेज 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. दिखाता है। अधिकृत भुगतान के लिए यह Your payment has been authorized. We will process the order as soon as the payment is captured. दिखाता है।

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

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

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

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

ऑर्डर स्टेटस

Pending payment: ग्राहक को Tap पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या Tap ने अभी भुगतान की पुष्टि नहीं की है।

Processing: Tap ने एक कैप्चर किए गए भुगतान की पुष्टि की है। यह भुगतान के बाद का मानक WooCommerce स्टेटस है (केवल डाउनलोड योग्य वर्चुअल उत्पादों वाले ऑर्डर सीधे Completed हो जाते हैं)। ऑर्डर नोट में राशि, Tap चार्ज ID (chg_...), भुगतान विधि और (टेस्ट मोड में) परीक्षण भुगतान का संकेत दिखता है। लेन-देन ID, Tap चार्ज ID ही है।

On hold: भुगतान केवल अधिकृत हुआ है और कैप्चर का इंतज़ार कर रहा है; या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (Tap: amount/currency mismatch — manual review required.); या ऑर्डर रद्द होने के बाद भुगतान आया। ऑर्डर नोट इसका कारण बताता है।

Failed: भुगतान अस्वीकार हुआ, छोड़ा गया, रद्द हुआ या समय सीमा समाप्त हो गई। केवल वह ऑर्डर Failed चिह्नित होता है जो अभी भी भुगतान का इंतज़ार कर रहा है; विफल प्रयास भुगतान किए गए, अधिकृत या रद्द ऑर्डर को कभी नहीं बदलता। ग्राहक फिर से भुगतान कर सकता है।

Cancelled: Void Tap authorization से अधिकृति रद्द की गई, इसलिए रोकी गई राशि जारी हो गई।

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

कैप्चर और void

Authorize only मोड में, होल्ड पर चल रहा ऑर्डर खोलें और Order actions में चुनें: Capture Tap payment ऑर्डर कुल कैप्चर करता है; फिर ऑर्डर भुगतान किया हुआ बन जाता है। Void Tap authorization राशि जारी करता है और ऑर्डर रद्द करता है। यदि Tap क्रिया अस्वीकार करता है, तो एक त्रुटि दिखती है और ऑर्डर नोट्स में जुड़ती है। यदि अधिकृति सीधे Tap डैशबोर्ड में कैप्चर की गई है, तो वेबहुक ऑर्डर को भुगतान किया हुआ चिह्नित करता है; ऐसे भुगतान के रिफ़ंड Tap डैशबोर्ड में करने होंगे।

रिफ़ंड

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

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

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

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

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

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

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

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

भुगतान हो गया, पर ऑर्डर Pending payment पर ही है: वेबहुक आपकी साइट तक नहीं पहुँच पा रहा। जाँचें कि सेटिंग्स में दिखाया गया URL (/wc-api/tap_p_webhook/) इंटरनेट से पहुँच योग्य है (कोई फ़ायरवॉल, मेंटेनेंस मोड या HTTP ऑथेंटिकेशन नहीं), और WooCommerce > Status > Logs में स्रोत wcp_tap_payment_gateway देखें। जब ग्राहक Tap से लौटता है, तब भी ऑर्डर अपडेट होता है।

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

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

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

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

ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान केवल अधिकृत हुआ है (उसे ऑर्डर क्रियाओं से कैप्चर करें), भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई, या ऑर्डर रद्द होने के बाद भुगतान आया।

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

डेवलपर हुक: फ़िल्टर tap_p_supported_currencies, tap_p_currency_decimals, tap_p_charge_payload, tap_p_icon, tap_p_checkout_sdk_url और tap_p_payment_page_hosts उपलब्ध हैं।

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

अनइंस्टॉल

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

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