VibeFox Tpay for WooCommerce — सहायता

आवश्यकताएँ

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

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

PHP: 8.0 या उसके बाद का संस्करण। सूचनाओं के JWS हस्ताक्षर की जाँच के लिए OpenSSL एक्सटेंशन और secure.tpay.com तक आउटगोइंग HTTPS कनेक्शन ज़रूरी है।

स्टोर मुद्रा: केवल पोलिश złoty (PLN)। Tpay PLN में सेटलमेंट करता है और उसके Open API में मुद्रा का कोई फ़ील्ड नहीं है, इसलिए जब स्टोर (या भुगतान किया जा रहा ऑर्डर) किसी दूसरी मुद्रा का उपयोग करता है, तो भुगतान तरीका छिपा दिया जाता है।

आपकी साइट की इंटरनेट पहुँच: Tpay भुगतान सूचनाएँ आपके स्टोर को भेजता है, इसलिए सूचना पता इंटरनेट से पहुँच योग्य होना चाहिए (मेंटेनेंस मोड, फ़ायरवॉल या HTTP प्रमाणीकरण द्वारा अवरुद्ध नहीं)।

Tpay खाता: Tpay मर्चेंट पैनल से ये मान चाहिए: Merchant ID (आपकी Tpay खाता ID), Open API कुंजियाँ Client ID और Client secret (Integration, API) और सुरक्षा कोड (Settings, Notifications)। Sandbox कुंजियाँ एक अलग Tpay sandbox खाते से आती हैं।

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

इंस्टॉलेशन

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

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

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

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

5. Sandbox कुंजियाँ और Production कुंजियाँ दर्ज करें (देखें कॉन्फ़िगरेशन)। Tpay पैनल में सुरक्षा कोड के अलावा कुछ भी सेट करने की ज़रूरत नहीं है: सूचना पता हर लेन-देन के साथ भेजा जाता है।

6. Enable/Disable चालू करें, sandbox मोड में एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए Sandbox mode का निशान हटा दें।

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

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Tpay। फ़ील्ड्स के ऊपर, जब sandbox मोड चालू हो, पेज Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. दिखाता है। मौजूदा मोड की कुंजियाँ अधूरी होने पर (तब Tpay चेकआउट पर नहीं दिखता), स्टोर मुद्रा PLN न होने पर, और JWS जाँच चालू होने पर भी PHP OpenSSL एक्सटेंशन न होने पर (तब भुगतान की पुष्टि नहीं होगी) यह चेतावनी देता है। भुगतान तरीकों की सूची में, मौजूदा मोड की कुंजियाँ दर्ज होने तक Tpay को सेटअप की ज़रूरत वाला बताया जाता है। Merchant ID या Client ID में चिपकाए गए स्पेस सेव करते समय हटा दिए जाते हैं।

सामान्य

Enable/Disable: Enable Tpay payments भुगतान तरीका चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान तरीके का शीर्षक। डिफ़ॉल्ट: Tpay।

Description: चेकआउट पर ग्राहकों को दिखने वाला भुगतान तरीके का विवरण। डिफ़ॉल्ट: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: Use the Tpay sandbox (test payments, no real money)। Sandbox मोड, Sandbox कुंजियों और Tpay sandbox API का उपयोग करता है। Production कुंजियों से असली भुगतान स्वीकार करने के लिए इसे बंद करें। रिफ़ंड हमेशा उसी वातावरण में जाते हैं जिसमें ऑर्डर का भुगतान हुआ था। डिफ़ॉल्ट: चालू।

Production कुंजियाँ

कहाँ मिलेंगी: Tpay मर्चेंट पैनल में Integration, API के अंतर्गत (Open API कुंजियाँ: Client ID और Secret); Merchant ID आपकी Tpay खाता ID है; सुरक्षा कोड Settings, Notifications में है।

Merchant ID: आपकी Tpay खाता ID (अंक)। Tpay इसे हर सूचना में भेजता है।

Client ID: Open API Client ID।

Client secret: Open API Client secret।

Security code: Tpay सूचनाओं के MD5 चेकसम की जाँच के लिए उपयोग होता है।

Sandbox कुंजियाँ

Sandbox अपनी कुंजियों वाला एक अलग Tpay परीक्षण खाता है (देखें Tpay API दस्तावेज़)। इसका उपयोग केवल तभी होता है जब Sandbox mode चालू हो।

Sandbox Merchant ID: sandbox खाते का Merchant ID।

Sandbox Client ID: sandbox खाते का Open API Client ID।

Sandbox Client secret: sandbox खाते का Open API Client secret।

Sandbox Security code: sandbox खाते का सूचना सुरक्षा कोड।

भुगतान सूचनाएँ

Tpay भुगतानों की पुष्टि इस खंड में दिखाए गए पते पर करता है। यह कुछ इस तरह दिखता है: https://your-site/wc-api/wc_tp_payment/। यह पता हर लेन-देन के साथ अपने-आप भेजा जाता है; Tpay पैनल में सुरक्षा कोड के अलावा कुछ भी सेट करने की ज़रूरत नहीं है। ऑर्डर तभी भुगतान किया हुआ बनता है जब वैध चेकसम और हस्ताक्षर वाली, और मेल खाती राशि वाली सूचना आए। आपका स्टोर सूचना स्वीकार न करे तब तक Tpay उसे दोहराता है।

JWS हस्ताक्षर: Also verify the X-JWS-Signature of notifications with the Tpay certificate (recommended)। PHP OpenSSL एक्सटेंशन और secure.tpay.com तक आउटगोइंग HTTPS कनेक्शन ज़रूरी है। MD5 चेकसम हमेशा जाँचा जाता है। डिफ़ॉल्ट: चालू।

उन्नत

Debug log: Log payment events। केवल तकनीकी घटनाएँ (कुंजियाँ या ग्राहक का डेटा नहीं)। WooCommerce > Status > Logs में, स्रोत wcp_tpay_payment। डिफ़ॉल्ट: बंद।

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता। ऑर्डर और उनका Tpay भुगतान डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

संस्करण 1.0 की सेटिंग्स अपने-आप स्थानांतरित हो जाती हैं: टेस्ट मोड चालू होने पर उपयोग की गई कुंजियाँ Sandbox कुंजियाँ बन जाती हैं।

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Tpay) और ऑर्डर देता है। Sandbox मोड में चेकआउट पर Sandbox mode — no real money is charged. दिखता है। प्लगइन ऑर्डर की कुल राशि के लिए PLN में एक Tpay लेन-देन बनाता है, जिसका विवरण Order # और ऑर्डर नंबर होता है, ग्राहक का नाम, ईमेल, पता और फ़ोन भेजता है, और ग्राहक को Tpay भुगतान पेज पर भेज देता है। यह पेज साइट की भाषा के अनुसार पोलिश, अंग्रेज़ी या यूक्रेनी में दिखता है (अन्य भाषाओं को अंग्रेज़ी मिलती है)। वहाँ ग्राहक BLIK, बैंक ट्रांसफ़र, कार्ड या आपके Tpay खाते में सक्षम कोई और तरीका चुनकर भुगतान करता है।

ऑर्डर तभी भुगतान किया हुआ बनता है जब Tpay उसकी पुष्टि करे। Tpay आपके स्टोर को सूचना भेजता है; प्लगइन सुरक्षा कोड के साथ MD5 चेकसम, Merchant ID और (चालू होने पर) JWS हस्ताक्षर की जाँच करता है, फिर राशि की: वह इस भुगतान प्रयास के लिए माँगी गई राशि और ऑर्डर कुल के बराबर होनी चाहिए, और भुगतान की गई राशि कम नहीं हो सकती। वैध चेकसम या हस्ताक्षर के बिना सूचनाएँ अस्वीकार कर दी जाती हैं।

भुगतान के बाद ग्राहक ऑर्डर प्राप्त पेज पर लौटता है। केवल लौटने से ऑर्डर भुगतान किया हुआ नहीं बनता। अगर सूचना अभी नहीं आई है, तो पेज Tpay API से लेन-देन की स्थिति पूछता है (अधिकतम हर 10 सेकंड में) और वही जाँच लागू करता है। जब तक भुगतान की पुष्टि नहीं होती, पेज Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: दिखाता है, साथ में Pay again लिंक। Tpay द्वारा भुगतान विफल होने की सूचना मिलने पर पेज Tpay reports that the payment did not go through. You can try again: उसी लिंक के साथ दिखाता है। अगर Tpay पेज पर भुगतान विफल होता है, तो Tpay ग्राहक को उसी ऑर्डर के Pay for order पेज पर वापस भेज देता है।

हर भुगतान प्रयास का अपना संदर्भ होता है। जब ग्राहक दोबारा भुगतान करता है, तो ऑर्डर के पहले के बिना भुगतान वाले Tpay लेन-देन Tpay पर रद्द कर दिए जाते हैं; पहले के लिंक से पूरा हुआ भुगतान फिर भी स्वीकार होता है। यही रद्दीकरण तब भी होता है जब बिना भुगतान वाला ऑर्डर रद्द किया जाता है, जैसे WooCommerce के स्टॉक-होल्ड टाइमआउट के कारण।

अगर Tpay भुगतान शुरू नहीं कर पाता, तो ग्राहक को The Tpay payment could not be started. Please try again or choose another payment method. दिखता है और कारण लॉग में लिखा जाता है।

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

प्लगइन केवल PLN में काम करता है। स्टोर में बैंक या BLIK कोड का चयन नहीं है (ग्राहक Tpay पेज पर चुनता है), सेव किए गए कार्ड नहीं हैं, सब्सक्रिप्शन नहीं हैं, स्टोर में Apple Pay या Google Pay बटन नहीं हैं और किस्त कैलकुलेटर नहीं हैं।

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

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

Pending payment: Tpay लेन-देन बन गया है और भुगतान की अभी पुष्टि नहीं हुई है। ऑर्डर नोट में Tpay लेन-देन और वातावरण दिखता है।

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

On hold: भुगतान आया, लेकिन उसकी राशि माँगी गई राशि या ऑर्डर कुल से अलग थी, केवल आंशिक भुगतान हुआ, या ऑर्डर रद्द हो चुका था। ऑर्डर नोट इसे समझाता है। Tpay पैनल में भुगतान जाँचें और ऑर्डर पूरा करें या उसका रिफ़ंड करें।

Failed: Tpay ने बताया कि भुगतान विफल हुआ। केवल भुगतान लंबित वाला ऑर्डर ही विफल चिह्नित होता है। ग्राहक दोबारा भुगतान कर सकता है।

अगर Tpay पहले से भुगतान किए गए या रिफ़ंड किए गए ऑर्डर के लिए कोई और भुगतान बताता है, तो ऑर्डर नहीं बदलता; नोट आपसे ज़रूरत होने पर Tpay पैनल में अतिरिक्त भुगतान का रिफ़ंड करने को कहता है। Tpay द्वारा बताया गया चार्जबैक एक नोट जोड़ता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Tpay पर क्लिक करें (बटन पर आपका Title दिखता है)। Tpay से भुगतान प्राप्त होने वाले ऑर्डरों के लिए पूर्ण और आंशिक रिफ़ंड समर्थित हैं; बिना भुगतान वाले ऑर्डरों के लिए बटन नहीं दिखता। रिफ़ंड उस वातावरण (sandbox या production) में भेजा जाता है जहाँ ऑर्डर का भुगतान हुआ था, इसलिए उस वातावरण की कुंजियाँ सेट होनी चाहिए। रिफ़ंड तभी पूरा माना जाता है जब Tpay उसकी पुष्टि करे; Tpay द्वारा अस्वीकृत या पुष्ट न किया गया रिफ़ंड त्रुटि के रूप में दिखता है और WooCommerce में दर्ज नहीं होता। सफल रिफ़ंड, आपके दर्ज किए गए कारण के साथ ऑर्डर नोट्स में जुड़ता है (कारण Tpay को नहीं भेजा जाता)।

Tpay मर्चेंट पैनल में किए गए रिफ़ंड अपने-आप WooCommerce में नहीं जुड़ते।

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

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

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

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

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

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

चेकआउट पर Tpay नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड की चारों कुंजियाँ (Merchant ID, Client ID, Client secret, Security code) दर्ज हैं। जाँचें कि स्टोर मुद्रा (या Pay for order पेज पर ऑर्डर की मुद्रा) PLN है। सेटिंग्स पेज इनमें से हर समस्या के लिए चेतावनी दिखाता है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर रहता है: Tpay सूचना नहीं पहुँचा पाया, या सूचना अस्वीकार हुई। Debug log चालू करें और WooCommerce > Status > Logs में स्रोत wcp_tpay_payment देखें। आम कारण हैं: मौजूदा मोड के लिए गलत सुरक्षा कोड या Merchant ID, अवरुद्ध सूचना पता (मेंटेनेंस मोड, फ़ायरवॉल, HTTP प्रमाणीकरण), या ऐसा सर्वर जिसमें JWS जाँच के लिए OpenSSL या आउटगोइंग HTTPS नहीं है। ऑर्डर प्राप्त पेज भी ग्राहक के लौटने पर स्थिति जाँचता है।

Notification answered FALSE - invalid checksum: सेटिंग्स में Merchant ID या सुरक्षा कोड उस भुगतान के Tpay खाते (sandbox या production) से मेल नहीं खाता।

Notification answered FALSE - invalid JWS signature: हस्ताक्षर सत्यापित नहीं हो सका, उदाहरण के लिए OpenSSL नहीं है या Tpay प्रमाणपत्र डाउनलोड नहीं हो सकता। सर्वर ठीक करें या ज़रूरत हो तो JWS signature बंद करें; MD5 चेकसम फिर भी जाँचा जाता है।

ऑर्डर On hold है: ऑर्डर नोट पढ़ें। भुगतान की गई राशि ऑर्डर से मेल नहीं खाती थी, या रद्द किए गए ऑर्डर के लिए भुगतान आया। Tpay पैनल में भुगतान जाँचें और ऑर्डर पूरा करें या उसका रिफ़ंड करें।

ग्राहक ने The Tpay payment could not be started देखा: मौजूदा मोड की कुंजियाँ गलत हैं, या Tpay ने अनुरोध अस्वीकार किया। लॉग में Tpay की त्रुटि दिखती है।

रिफ़ंड विफल होता है: अगर संदेश कहता है कि कुंजियाँ नहीं हैं, तो उस वातावरण की कुंजियाँ दर्ज करें जहाँ ऑर्डर का भुगतान हुआ था। अगर Tpay ने रिफ़ंड की पुष्टि नहीं की, तो दोबारा कोशिश करने से पहले Tpay मर्चेंट पैनल में लेन-देन जाँचें।

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

अनइंस्टॉल

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

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