VibeFox PayU for OpenCart — सहायता

आवश्यकताएँ

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

PHP: 8.0 या उसके बाद का संस्करण, cURL एक्सटेंशन के साथ।

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

आपके स्टोर तक इंटरनेट पहुँच: 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 से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. Enable/Disable चालू करें और Save पर क्लिक करें। जब तक आप एक परीक्षण भुगतान न कर लें, Test Mode चालू रहने दें; फिर इसे बंद करके Live कुंजियों से असली भुगतान स्वीकार करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayU Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, पेज आपको चेतावनी देता है जब सैंडबॉक्स मोड चालू हो (सैंडबॉक्स (टेस्ट) मोड चालू है: भुगतान PayU सैंडबॉक्स पर जाते हैं और कोई असली पैसा नहीं काटा जाता। टेस्ट मोड में भुगतान किए गए ऑर्डर न भेजें।), जब वर्तमान मोड की चार कुंजियों में से कोई एक गायब हो (तब चेकआउट पर PayU नहीं दिखता), और जब PayU स्टोर की डिफ़ॉल्ट मुद्रा स्वीकार नहीं करता (तब उस मुद्रा के ऑर्डरों के लिए PayU छिप जाता है)। एक्सटेंशन बदलने का अधिकार न हो तो पेज सेटिंग्स दिखाता है पर उन्हें सेव नहीं कर सकता।

सेव करने पर सभी कुंजियों से स्पेस और लाइन ब्रेक हटा दिए जाते हैं, क्योंकि PayU पैनल से कॉपी करते समय ये अक्सर जुड़ जाते हैं। Title खाली नहीं हो सकता और 128 अक्षरों से लंबा नहीं हो सकता (पेज दिखाता है Enter a title for the payment method (at most 128 characters).), Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और geo zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। अन्यथा कुछ भी सेव नहीं होता। सेटिंग्स सेव करने पर कैश्ड PayU एक्सेस टोकन भी साफ़ हो जाते हैं।

PayU

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

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely via PayU।

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

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

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

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

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

Test Mode: PayU सैंडबॉक्स और नीचे की Sandbox कुंजियों का उपयोग करता है। कोई असली पैसा नहीं काटा जाता। चालू होने पर, ग्राहक Confirm Order चरण में सैंडबॉक्स मोड: कोई असली भुगतान नहीं लिया जाता। देखते हैं। Live कुंजियों से असली भुगतान स्वीकार करने के लिए इसे बंद करें। डिफ़ॉल्ट: चालू।

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।

सेव किए गए Second Keys और client secrets कभी दोबारा नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सहेजा गया — रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलना हो तो नया मान दर्ज करें। POS IDs और client IDs वैसे ही दिखते हैं जैसे सेव किए गए थे।

Clear saved secrets: किसी गुप्त मान पर टिक करें और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान बनाए रखता है।

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

ऑर्डर स्टेटस

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के (एक लापता ऑर्डर) बनाता है। ऑर्डर को स्टेटस तभी मिलता है जब PayU हस्ताक्षरित सूचना से, या ग्राहक के लौटने पर स्थिति जाँच से भुगतान की पुष्टि कर दे। OpenCart में On hold स्टेटस नहीं है: प्रतीक्षा वाले स्टेटस डिफ़ॉल्ट रूप से Pending होते हैं, और ऑर्डर का PayU टैब तथा उसके नोट कारण समझाते हैं। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है; अपने स्टेटस System > Localisation > Order Statuses में बना सकते हैं।

Order Status After Payment: जब PayU भुगतान की पुष्टि करे (COMPLETED) और राशि व मुद्रा मेल खाएँ, तब सेट होता है। डिफ़ॉल्ट: Processing।

Awaiting PayU Payment Confirmation: भुगतान अधिकृत है और प्राप्त होने की प्रतीक्षा में है (स्वचालित प्राप्ति बंद है या विफल रही)। ऑर्डर के PayU टैब में Receive PayU payment या Cancel PayU payment का उपयोग करें। डिफ़ॉल्ट: Pending।

PayU Payment On Hold: चुकाई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या रद्द किए गए ऑर्डर के लिए भुगतान पूरा हुआ है। ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता; नोट कारण बताता है। डिफ़ॉल्ट: Pending।

Payment Error Status: पुष्टि की प्रतीक्षा कर रहे ऑर्डर का भुगतान रद्द या अस्वीकार हो गया। डिफ़ॉल्ट: Failed।

Cancelled Order Status: इस स्टेटस वाले ऑर्डर के लिए पूरा हुआ PayU भुगतान ऑर्डर को चुपचाप दोबारा खोलने के बजाय होल्ड पर रखता है। एक्सटेंशन यह स्टेटस कभी सेट नहीं करता। डिफ़ॉल्ट: Canceled।

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

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

Notification URL: वह पता दिखाता है जहाँ PayU सूचनाएँ भेजता है। OpenCart 3 में यह https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify जैसा दिखता है, और OpenCart 4 में https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। एक्सटेंशन हर भुगतान के साथ इसे PayU को भेजता है, इसलिए PayU पैनल में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। सुनिश्चित करें कि यह इंटरनेट से पहुँच योग्य हो (फ़ायरवॉल या HTTP प्रमाणीकरण से अवरुद्ध न हो)। स्टोर मेंटेनेंस मोड में होने पर भी सूचनाएँ काम करती हैं (OpenCart 4 पर एक्सटेंशन इसके लिए अपनी स्टार्टअप ऐक्शन के ज़रिए, जो ग्राहक की PayU से वापसी को भी जाने देती है, काम करता है)। वैध हस्ताक्षर के बिना आई सूचनाएँ अस्वीकार की जाती हैं।

उन्नत

Receive payments automatically: पुष्टि की प्रतीक्षा कर रहे भुगतान अपने-आप प्राप्त करता है। यह तभी मायने रखता है जब PayU पैनल में आपके बिक्री बिंदु के लिए स्वचालित प्राप्ति बंद हो: तब भुगतान पुष्टि की प्रतीक्षा करते हैं (WAITING_FOR_CONFIRMATION)। यह विकल्प चालू होने पर एक्सटेंशन ऐसे भुगतान तुरंत प्राप्त करता है, और जब PayU भुगतान पूरा होने की सूचना देता है तब ऑर्डर को भुगतान किए गए स्टेटस मिलता है। बंद होने पर, या प्राप्ति विफल होने पर, ऑर्डर को Awaiting PayU Payment Confirmation मिलता है और आप ऑर्डर के PayU टैब के बटनों से भुगतान प्राप्त या रद्द करते हैं। डिफ़ॉल्ट: चालू।

Logging: तकनीकी घटनाएँ (ऑर्डर नंबर, PayU ऑर्डर ID, स्टेटस, त्रुटियाँ; कोई कुंजी या व्यक्तिगत डेटा नहीं) OpenCart लॉग फ़ोल्डर (storage/logs) में wc_pu_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा दर्ज होती हैं; अन्य घटनाएँ केवल तब जब यह चालू हो। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

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

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

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

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

यदि ग्राहक के लौटने तक PayU ने भुगतान की पुष्टि नहीं की है, तो Payment confirmation पेज दिखाता है PayU से अभी तक भुगतान की पुष्टि नहीं मिली है। यदि भुगतान बीच में रुक गया था, तो आप दोबारा प्रयास कर सकते हैं: (या, जब PayU ने त्रुटि बताई हो, तो भुगतान पूरा नहीं हुआ। आप दोबारा प्रयास कर सकते हैं:) साथ में Pay again (चेकआउट पर वापस) और Check again बटन। सूचना आते ही ऑर्डर स्टेटस सेट हो जाता है। यदि भुगतान रद्द हुआ, तो ग्राहक भुगतान पूरा नहीं हुआ। आप दोबारा प्रयास कर सकते हैं या कोई और भुगतान विधि चुन सकते हैं। के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है।

OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए इसका प्रतीक्षारत भुगतान रद्द हुआ, या आपने उसे रद्द या लौटाया), तो ग्राहक संदेश Your previous order was closed (not paid, cancelled or refunded). Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौट जाता है। जब ग्राहक PayU से ऐसे ऑर्डर पर लौटता है जो बिना भुगतान के बंद हो चुका है, तो संदेश The payment was not completed. You can try again or choose another payment method. होता है। यदि वह ऑर्डर किसी पिछले कार्ट के लिए पहले ही भुगतान किया हुआ था और तब से कार्ट बदल गया है, तो ग्राहक चेकआउट पर वापस ले जाया जाता है। हर स्थिति में अगला Confirm Order मौजूदा कार्ट का नया ऑर्डर चुकाता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखता।

यदि PayU भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर रहता है और देखता है भुगतान में त्रुटि। कृपया दोबारा प्रयास करें या कोई और भुगतान विधि चुनें। तकनीकी कारण लॉग में लिखा जाता है। यदि वर्तमान मोड की कुंजियाँ गायब हैं, तो संदेश है भुगतान गेटवे ठीक से कॉन्फ़िगर नहीं है। कृपया व्यवस्थापक से संपर्क करें।

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

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

ऑर्डर स्टेटस

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

Order Status After Payment (डिफ़ॉल्ट Processing): भुगतान की पुष्टि हुई। एक नोट PayU ऑर्डर ID, राशि और वातावरण (सैंडबॉक्स या लाइव) दिखाता है।

Awaiting PayU Payment Confirmation (डिफ़ॉल्ट Pending): भुगतान अधिकृत है और आपकी प्रतीक्षा में है (स्वचालित प्राप्ति बंद है, या प्राप्ति विफल हुई)।

PayU Payment On Hold (डिफ़ॉल्ट Pending): चुकाई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती थी, पुष्टि की प्रतीक्षा वाले भुगतान की राशि अलग थी, या रद्द किए गए ऑर्डर के लिए भुगतान पूरा हुआ। नोट बताता है कि कौन-सी स्थिति थी। ऑर्डर की जाँच करें और उसे पूरा करें, या भुगतान रिफ़ंड करें।

Payment Error Status (डिफ़ॉल्ट Failed): पुष्टि की प्रतीक्षा कर रहे ऑर्डर का भुगतान रद्द या अस्वीकार हुआ।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड हुआ।

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

नोट ऑर्डर के History की प्रविष्टियाँ हैं, जो ग्राहक को नहीं दिखतीं।

VibeFox PayU Payment टैब

Sales > Orders में PayU से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayU Payment टैब PayU order ID दिखाता है (सैंडबॉक्स भुगतानों पर Sandbox लेबल के साथ), extOrderId, PayU status, Payment amount, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, Refunds इतिहास, ऑर्डर के PayU payment attempts और PayU notes। यह टैब एक्सटेंशन की पहुँच रखने वाले उपयोगकर्ताओं को दिखता है; इसकी कार्रवाइयों के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

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

जिस ऑर्डर में पुष्टि की प्रतीक्षा वाला भुगतान है, उसके टैब में Receive PayU payment और Cancel PayU payment दिखते हैं। प्रश्न की पुष्टि करने के बाद, कार्रवाई भुगतान के वातावरण की कुंजियों से PayU को भेजी जाती है, आपके उपयोगकर्ता नाम के साथ नोट में जुड़ती है, और नया PayU स्टेटस तुरंत लागू होता है: प्राप्त भुगतान Order Status After Payment सेट करता है, और रद्द भुगतान Payment Error Status।

रिफ़ंड

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

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

Sales > Returns में उत्पाद वापसी PayU के ज़रिए पैसे वापस नहीं भेजती।

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

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

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

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

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

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

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

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

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

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

सूचना Ignored: unknown PayU order का उत्तर देती है: वह PayU ऑर्डर इस स्टोर ने नहीं बनाया, उदाहरण के लिए उसी बिक्री बिंदु पर कोई दूसरा स्टोर। PayU दोबारा प्रयास बंद कर देता है।

सूचना Busy, retry later का उत्तर देती है: उसी समय कोई दूसरा अनुरोध वह कार्ट पुष्ट कर रहा था। PayU सूचना दोहराता है। कारण देखने के लिए Logging चालू करें।

ब्राउज़र में सूचना URL POST expected दिखाता है: यह सामान्य है। यह URL केवल PayU की सूचनाएँ स्वीकार करता है।

ग्राहक Confirm Order के बाद Payment error देखता है: Logging चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। लॉग HTTP कोड और PayU स्टेटस दिखाता है। Could not authenticate with PayU (check the OAuth client ID / secret). का अर्थ है कि वर्तमान मोड की OAuth कुंजियाँ गलत हैं। This payment method is not available. का अर्थ है कि चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई: ग्राहक को चेकआउट दोबारा लोड करना होगा।

ऑर्डर PayU Payment On Hold में है: VibeFox PayU Payment टैब के नोट पढ़ें (देखें ऑर्डर स्टेटस), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

ऑर्डर Awaiting PayU Payment Confirmation में है: आपके बिक्री बिंदु के लिए स्वचालित प्राप्ति बंद है और भुगतान आपकी प्रतीक्षा में है। टैब में Receive PayU payment या Cancel PayU payment का उपयोग करें।

रिफ़ंड विफल है या रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है। Refunds are available once PayU has completed the payment. का अर्थ है कि PayU ने ऑर्डर के लिए अभी तक भुगतान पूरा नहीं किया है। Sandbox या Live कुंजियाँ गायब होने का संदेश बताता है कि भुगतान उस वातावरण में हुआ था और उसकी कुंजियाँ सेट नहीं हैं। उन्हें दर्ज करें और दोबारा प्रयास करें। एक्सटेंशन बदलने का अधिकार न हो तो टैब दिखाता है You do not have permission to refund (modify this extension).

अनइंस्टॉल

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

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

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