VibeFox PayU for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय होने से मना कर देता है; यदि WooCommerce बाद में बंद कर दिया जाता है, तो प्लगइन कुछ नहीं करता और व्यवस्थापक क्षेत्र में एक सूचना दिखाता है।

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

स्टोर मुद्रा: PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH में से एक। मुद्रा PayU में आपके बिक्री केंद्र के लिए भी सक्षम होनी चाहिए। अन्य मुद्राओं के लिए भुगतान विधि चेकआउट पर छिपी रहती है।

आपकी साइट तक इंटरनेट पहुँच: PayU आपके स्टोर पर भुगतान सूचनाएँ भेजता है, इसलिए साइट इंटरनेट से सुलभ होनी चाहिए (HTTP प्रमाणीकरण या रखरखाव पेज के पीछे नहीं)। सूचनाएँ न मिलने पर भी ग्राहक के PayU से लौटने पर ऑर्डरों की जाँच की जाती है।

PayU खाता: आपको अपने बिक्री केंद्र (POS) की चार कुंजियों की आवश्यकता होती है: POS ID, Second key (MD5), OAuth client_id और OAuth client_secret। ये PayU मर्चेंट पैनल में Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys के अंतर्गत मिलती हैं। सैंडबॉक्स कुंजियाँ एक अलग PayU सैंडबॉक्स खाते से आती हैं।

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

इंस्टॉलेशन

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

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

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

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

5. चार Sandbox कुंजियाँ और चार Live कुंजियाँ दर्ज करें (कॉन्फ़िगरेशन देखें)। PayU में कोई सूचना URL कॉन्फ़िगर करने की आवश्यकता नहीं है।

6. Enable/Disable चालू करें। जब तक आप टेस्ट भुगतान न कर लें, Test Mode चालू रखें, फिर Live कुंजियों से वास्तविक भुगतान स्वीकार करने के लिए इसका निशान हटाएँ।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > PayU। जब सैंडबॉक्स मोड चालू हो, वर्तमान मोड की चार कुंजियों में से कोई गायब हो या PayU स्टोर मुद्रा स्वीकार न करे, तो फ़ील्ड के ऊपर पेज आपको चेतावनी देता है। बाद के दो मामलों में PayU चेकआउट पर नहीं दिखाया जाता।

सहेजते समय सभी कुंजियों से स्पेस और लाइन ब्रेक हटा दिए जाते हैं, क्योंकि PayU पैनल से कॉपी करते समय वे अक्सर जुड़ जाते हैं।

सामान्य

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

Title: ग्राहक को प्रदर्शित भुगतान विधि का शीर्षक। डिफ़ॉल्ट: PayU।

Description: ग्राहक को प्रदर्शित भुगतान विधि का विवरण। डिफ़ॉल्ट: Pay securely via PayU।

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

PayU मर्चेंट पैनल में कुंजियाँ ढूँढें: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys। सैंडबॉक्स कुंजियाँ एक अलग PayU सैंडबॉक्स खाते से आती हैं। किसी मोड की चारों कुंजियाँ भरी होनी चाहिए।

Test Mode: Enable sandbox (test) mode। PayU सैंडबॉक्स और नीचे दी गई Sandbox कुंजियों का उपयोग करता है। कोई वास्तविक पैसा नहीं काटा जाता। क्लासिक चेकआउट और Checkout ब्लॉक पर ग्राहक को Sandbox mode — no real money is charged दिखता है। Live कुंजियों से वास्तविक भुगतान स्वीकार करने के लिए इसे बंद करें। डिफ़ॉल्ट: on।

Live POS ID: आपके प्रोडक्शन बिक्री केंद्र का POS ID (merchantPosId)।

Live Second Key (MD5): PayU सूचनाओं के हस्ताक्षर को सत्यापित करने के लिए उपयोग किया जाता है।

Live OAuth Client ID: बिक्री केंद्र का OAuth client_id।

Live OAuth Client Secret: बिक्री केंद्र का OAuth client_secret।

Sandbox POS ID: आपके PayU सैंडबॉक्स बिक्री केंद्र का POS ID।

Sandbox Second Key (MD5): PayU सैंडबॉक्स सूचनाओं के हस्ताक्षर को सत्यापित करने के लिए उपयोग किया जाता है।

Sandbox OAuth Client ID: सैंडबॉक्स बिक्री केंद्र का OAuth client_id।

Sandbox OAuth Client Secret: सैंडबॉक्स बिक्री केंद्र का OAuth client_secret।

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

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

यह अनुभाग सूचना URL दिखाता है, जो https://your-site/wc-api/wc_pu_payment/ जैसा दिखता है। प्लगइन इसे प्रत्येक भुगतान के साथ PayU को भेजता है, इसलिए PayU पैनल में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। सुनिश्चित करें कि यह इंटरनेट से सुलभ हो (फ़ायरवॉल, रखरखाव मोड या HTTP प्रमाणीकरण द्वारा अवरुद्ध न हो)।

उन्नत

Receive payments automatically: Automatically receive payments waiting for confirmation। यह केवल तभी मायने रखता है जब PayU पैनल में आपके POS के लिए स्वचालित प्राप्ति बंद हो: तब भुगतान पुष्टि की प्रतीक्षा करते हैं (WAITING_FOR_CONFIRMATION)। जब यह विकल्प चालू होता है, तो प्लगइन ऐसे भुगतानों को तुरंत प्राप्त कर लेता है। जब यह बंद होता है, तो ऐसे ऑर्डरों को On hold पर रख दिया जाता है और आप ऑर्डर एक्शन Receive PayU payment और Cancel PayU payment के साथ भुगतान प्राप्त या रद्द करते हैं। डिफ़ॉल्ट: on।

Logging: Enable logging तकनीकी घटनाओं (ऑर्डर नंबर, PayU ऑर्डर ID, स्थितियाँ, त्रुटियाँ; कोई कुंजी या व्यक्तिगत डेटा नहीं) को WooCommerce > Status > Logs, source wcp_payu_payment में लिखता है। डिफ़ॉल्ट: off।

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PayU) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए Order # विवरण, ऑर्डर नंबर और आपके स्टोर नाम के साथ, तथा PayU पेज पर प्रदर्शित करने के लिए ऑर्डर आइटम, शिपिंग और शुल्क के साथ एक PayU ऑर्डर बनाता है। PayU पेज की भाषा स्टोर की भाषा का अनुसरण करती है यदि PayU इसका समर्थन करता है, अन्यथा अंग्रेज़ी। ग्राहक को PayU भुगतान पेज पर भेजा जाता है, वह वहाँ एक विधि चुनता है और भुगतान करता है।

प्रत्येक भुगतान प्रयास को अपना PayU ऑर्डर मिलता है। जब ग्राहक दोबारा भुगतान करता है (विफल या रद्द किए गए भुगतान के बाद, या Pay for order पेज से), तो ऑर्डर का पिछला अधूरा PayU भुगतान PayU पर रद्द कर दिया जाता है, जिससे पुराने भुगतान लिंक से दोबारा भुगतान नहीं किया जा सकता।

केवल आपके स्टोर पर वापस आना कभी भी ऑर्डर का भुगतान नहीं करता। ऑर्डर केवल PayU द्वारा पुष्टि किए जाने के बाद ही भुगतान किया हुआ चिह्नित होता है: भुगतान के वातावरण की Second Key से हस्ताक्षरित सूचना द्वारा, या ग्राहक के लौटने पर सर्वर पर PayU ऑर्डर की स्थिति जाँच द्वारा (यदि सूचना में देरी हो तो उपयोगी)। PayU ऑर्डर इसी ऑर्डर के लिए बनाया गया होना चाहिए, और राशि व मुद्रा मेल खानी चाहिए। प्लगइन इन PayU स्थितियों को संभालता है:

ऑर्डर प्राप्त पेज पर, जब तक ऑर्डर Pending payment पर रहता है, ग्राहक को We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: या विफल भुगतान के बाद The payment was not completed. You can try again: दिखता है, प्रत्येक Pay again बटन के साथ। On hold ऑर्डर के लिए संदेश होता है: Your payment is being verified. We will send you an e-mail as soon as it is confirmed.

यदि PayU भुगतान शुरू नहीं कर सकता, तो ग्राहक को Payment error. Please try again or choose another payment method. दिखता है। तकनीकी कारण (HTTP कोड और PayU स्थिति) लॉग में और एक ऑर्डर नोट PayU payment could not be started: में लिखा जाता है। यदि वर्तमान मोड की कुंजियाँ गायब हैं, तो संदेश होता है: Payment gateway is not configured properly. Please contact the administrator.

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

ग्राहक भुगतान विधि PayU पेज पर चुनता है, आपके चेकआउट में नहीं। प्लगइन में आपके स्टोर पर कोई कार्ड फ़ॉर्म नहीं है, कोई सहेजे गए कार्ड या एक-क्लिक भुगतान नहीं हैं, कोई सब्सक्रिप्शन नहीं हैं और कोई PayU किश्त या क्रेडिट विजेट नहीं हैं। यह प्रति वातावरण एक बिक्री केंद्र का उपयोग करता है (प्रति मुद्रा कोई बिक्री केंद्र नहीं)।

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

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

Pending payment: ग्राहक को PayU पर भेजा गया था और उसने अभी भुगतान नहीं किया है। ऑर्डर नोट PayU ऑर्डर ID और वातावरण (sandbox या live) दिखाता है।

Processing: भुगतान की पुष्टि हो गई। ऑर्डर नोट PayU ऑर्डर ID, राशि और वातावरण दिखाता है। लेन-देन ID वही PayU ऑर्डर ID है जिसका भुगतान किया गया था। केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर Completed बन जाते हैं, जैसा कि WooCommerce डिफ़ॉल्ट रूप से करता है।

On hold: भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती थी, किसी रद्द किए गए ऑर्डर के लिए भुगतान पूरा हो गया था, या भुगतान आपकी पुष्टि की प्रतीक्षा कर रहा है (स्वचालित प्राप्ति बंद, या प्राप्ति विफल)। ऑर्डर नोट बताता है कि कौन सा मामला है और क्या करना है।

Failed: नवीनतम PayU भुगतान रद्द या अस्वीकार कर दिया गया था। ग्राहक दोबारा भुगतान करने का प्रयास कर सकता है।

प्रत्येक सूचना को प्रति-ऑर्डर लॉक के तहत एक बार संसाधित किया जाता है: बार-बार आने वाली सूचनाएँ नोट नहीं जोड़तीं, स्टॉक को दो बार कम नहीं करतीं या दोबारा ई-मेल नहीं भेजतीं। यदि किसी ऐसे ऑर्डर के लिए दूसरा भुगतान पूरा होता है जो पहले से भुगतान या रिफ़ंड किया जा चुका है, तो एक नोट आपसे PayU पैनल में इसे रिफ़ंड करने का अनुरोध करता है। पहले से भुगतान किए गए या बंद ऑर्डर पर पुष्टि की प्रतीक्षा वाले भुगतान को स्वचालित रूप से रद्द कर दिया जाता है, ताकि पैसे दो बार न लिए जाएँ।

पुष्टि की प्रतीक्षा वाले भुगतान

पुष्टि की प्रतीक्षा वाले भुगतान वाले unpaid ऑर्डर के लिए, ऑर्डर स्क्रीन दो ऑर्डर एक्शन प्रदान करती है: Receive PayU payment (waiting for confirmation) और Cancel PayU payment (release the funds)। एक चुनें और अपडेट बटन पर क्लिक करें। यह एक्शन आपके उपयोगकर्ता नाम के साथ ऑर्डर नोट में जुड़ जाता है, और नई PayU स्थिति तुरंत लागू हो जाती है।

रिफ़ंड

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

PayU पर रिफ़ंड अतुल्यकालिक (asynchronous) होते हैं। प्लगइन तुरंत PayU रिफ़ंड ID और स्थिति के साथ एक नोट जोड़ता है; अंतिम स्थिति बाद में PayU सूचना के रूप में आती है और एक नोट के रूप में जुड़ती है। यदि PayU रिफ़ंड रद्द करता है, तो नोट बताता है कि ग्राहक को पैसे वापस नहीं किए गए।

राशि या मुद्रा बेमेल होने के कारण On hold पर रखे गए ऑर्डर PayU ऑर्डर ID को अपने लेन-देन ID के रूप में रखते हैं, जिससे भुगतान को WooCommerce के साथ-साथ PayU पैनल में भी रिफ़ंड किया जा सकता है।

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

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

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

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

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

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

PayU चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है और वर्तमान मोड की चारों कुंजियाँ भरी हुई हैं: सैंडबॉक्स मोड में Sandbox कुंजियाँ, लाइव मोड में Live कुंजियाँ। जाँचें कि स्टोर मुद्रा (या Pay for order पेज पर ऑर्डर मुद्रा) समर्थित मुद्राओं में से एक है। सेटिंग्स पेज इनमें से प्रत्येक समस्या के लिए चेतावनी दिखाता है।

भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: PayU ने अभी तक सूचना नहीं दी है, और वापसी पेज पर स्थिति जाँच में पूरा भुगतान नहीं दिखा। जाँचें कि सेटिंग्स में दिखाया गया सूचना URL इंटरनेट से सुलभ है या नहीं। क्या आ रहा है यह देखने के लिए Logging चालू करें।

सूचना Invalid signature उत्तर देती है: सूचना पर किसी भी वातावरण की Second Key से हस्ताक्षर नहीं किए गए थे। Live Second Key (MD5) और Sandbox Second Key (MD5) की जाँच करें। उत्तर Invalid signature for this payment का अर्थ है कि सूचना पर भुगतान वाले वातावरण से भिन्न वातावरण की कुंजी से हस्ताक्षर किए गए थे।

सूचना Ignored उत्तर देती है: PayU ऑर्डर इस स्टोर के PayU से भुगतान किए गए किसी ऑर्डर से संबंधित नहीं है, उदाहरण के लिए उसी POS पर किसी अन्य दुकान से। PayU दोबारा प्रयास करना बंद कर देता है।

भुगतान नहीं बनता: Logging चालू करें और WooCommerce > Status > Logs, स्रोत wcp_payu_payment देखें। लॉग HTTP कोड और PayU स्थिति दिखाता है। Could not authenticate with PayU (check the OAuth client ID / secret). का अर्थ है वर्तमान मोड की गलत OAuth कुंजियाँ।

ऑर्डर On hold है: ऑर्डर नोट पढ़ें। कारण राशि या मुद्रा बेमेल, रद्दीकरण के बाद भुगतान या पुष्टि की प्रतीक्षा वाला भुगतान है। अंतिम मामले के लिए ऑर्डर एक्शन Receive PayU payment या Cancel PayU payment का उपयोग करें।

रिफ़ंड विफल होता है: This order has no completed PayU payment. Cannot process refund. का अर्थ है कि ऑर्डर में कोई भुगतान किया हुआ PayU ऑर्डर नहीं है। Sandbox कुंजियाँ या Live कुंजियाँ गायब होने का संदेश दर्शाता है कि भुगतान उस वातावरण में किया गया था और उसकी कुंजियाँ सेट नहीं हैं। उन्हें दर्ज करें और पुन: प्रयास करें।

अन्य मुद्राएँ: डेवलपर wc_pu_supported_currencies फ़िल्टर के साथ मुद्रा सूची और wc_pu_icon फ़िल्टर के साथ चेकआउट आइकन बदल सकते हैं।

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

अनइंस्टॉल

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

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