VibeFox PayU LATAM for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होगा।
मुद्रा: कार्ट ARS, BRL, CLP, COP, MXN, PEN या USD में होना चाहिए, यानी वे मुद्राएँ जिन्हें PayU Latam अर्जेंटीना, ब्राज़ील, चिली, कोलंबिया, मेक्सिको, पनामा और पेरू में प्रोसेस करता है। अन्य मुद्राओं में चेकआउट पर भुगतान का तरीका नहीं दिखता।
PayU Latam खाता: आपको PayU कॉमर्स के तीन मान चाहिए: मर्चेंट ID, उस देश की खाता ID जहाँ आप बेचते हैं, और API कुंजी। ये PayU मॉड्यूल (PayU मर्चेंट पैनल) में Settings > Technical configuration (merchant ID, API key) और Accounts (account ID) के अंतर्गत मिलते हैं। परीक्षण के लिए PayU अपने डेवलपर दस्तावेज़ के "Test your solution" पेज पर सार्वजनिक सैंडबॉक्स क्रेडेंशियल और टेस्ट कार्ड प्रकाशित करता है। API Login और अन्य API क्रेडेंशियल की ज़रूरत नहीं है, क्योंकि भुगतान PayU के होस्ट किए गए पेज पर होता है और मॉड्यूल PayU API को कभी कॉल नहीं करता।
आपके स्टोर की इंटरनेट पहुँच: PayU अपने सर्वरों से भुगतान का परिणाम आपके स्टोर को भेजता है, इसलिए स्टोर इंटरनेट से सुलभ होना चाहिए (लोकल साइट या पासवर्ड-सुरक्षित साइट नहीं चलेगी)।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox PayU LATAM Payment ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. सैंडबॉक्स क्रेडेंशियल और अपने लाइव क्रेडेंशियल डालें (देखें कॉन्फ़िगरेशन)। PayU में कोई पुष्टि URL सेट करने की ज़रूरत नहीं है।
5. Enable/Disable चालू करें और Save पर क्लिक करें। जब तक आप एक परीक्षण भुगतान न कर लें, Sandbox चालू रखें; फिर उसे बंद करें, ताकि लाइव क्रेडेंशियल से असली भुगतान स्वीकार हों।
इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting PayU LATAM payment और PayU LATAM payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इसे Payment > Preferences में सीमित कर सकते हैं। बाद में सक्षम किए गए देश को भी वहाँ मॉड्यूल के लिए चिह्नित करना होगा।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox PayU LATAM Payment > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। फ़ील्ड्स के ऊपर पेज दिखाता है: सैंडबॉक्स चालू रहने पर Sandbox mode. Payments go to the PayU sandbox and no real money is charged.; मौजूदा वातावरण की मर्चेंट ID, खाता ID या API कुंजी न होने पर त्रुटि; और PayU LATAM द्वारा स्टोर की डिफ़ॉल्ट मुद्रा प्रोसेस न करने पर चेतावनी। जब तक क्रेडेंशियल नहीं हैं, चेकआउट पर PayU LATAM नहीं दिखता। क्रेडेंशियल की शुरुआत या अंत के स्पेस अनदेखे किए जाते हैं। खाली Title सेव नहीं होता और पेज Enter a title for the payment method. दिखाता है।
PayU LATAM
Enable/Disable: Enable PayU LATAM भुगतान का तरीका चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का शीर्षक। ऑर्डर में सेव होने वाला भुगतान तरीके का नाम भी यही है। डिफ़ॉल्ट: PayU LATAM। अनिवार्य।
Description: चेकआउट पर ग्राहक को दिखने वाला भुगतान तरीके का विवरण। डिफ़ॉल्ट: Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.
वातावरण
Sandbox: भुगतान नीचे दिए सैंडबॉक्स क्रेडेंशियल से PayU सैंडबॉक्स पर जाते हैं, और कोई असली राशि नहीं काटी जाती। बंद होने पर लाइव क्रेडेंशियल और PayU का लाइव चेकआउट पेज इस्तेमाल होते हैं। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहकों को भुगतान तरीके के नीचे Sandbox mode: no real money is charged. दिखता है।
लाइव क्रेडेंशियल
इन्हें PayU मॉड्यूल में ढूँढें: Settings > Technical configuration (merchant ID, API key) और Accounts (जिस देश में आप बेचते हैं उसकी account ID)। यह सेक्शन PayU मर्चेंट पैनल से लिंक करता है।
Merchant ID: आपके PayU कॉमर्स की संख्यात्मक पहचान।
Account ID: PayU खाते की पहचान। हर देश के लिए एक खाता होता है।
API Key: भुगतानों पर हस्ताक्षर करने और PayU सूचनाएँ सत्यापित करने के लिए उपयोग की जाने वाली गुप्त कुंजी।
सैंडबॉक्स क्रेडेंशियल
PayU अपने सैंडबॉक्स के लिए सार्वजनिक परीक्षण क्रेडेंशियल और टेस्ट कार्ड प्रकाशित करता है। यह सेक्शन PayU दस्तावेज़ के "Test your solution" पेज से लिंक करता है।
Sandbox merchant ID: PayU सैंडबॉक्स के लिए मर्चेंट ID।
Sandbox account ID: PayU सैंडबॉक्स के लिए खाता ID।
Sandbox API key: PayU सैंडबॉक्स के लिए API कुंजी।
सेव की गई API कुंजियाँ दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान डालें जब आप उसे बदलना चाहते हों।
Clear saved secrets: API Key या Sandbox API key पर टिक लगाएँ और सेव की गई कुंजी हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।
हर भुगतान प्रयास अपना वातावरण याद रखता है। सैंडबॉक्स भुगतान की पुष्टि सैंडबॉक्स API कुंजी और मर्चेंट ID से जाँची जाती है, और लाइव भुगतान की पुष्टि लाइव मानों से; इसलिए बदलाव के बाद भी लंबित भुगतान काम करते रहते हैं। बदलाव के बाद पुष्ट हुआ सैंडबॉक्स भुगतान ऑर्डर नोट्स में [sandbox] के रूप में चिह्नित होता है।
पुष्टि URL
इस सेक्शन में वह URL दिखता है जिस पर PayU हर भुगतान परिणाम की सूचना देता है। फ़्रेंडली URL चालू होने पर यह https://your-shop/module/wcp_payu_latam_payment/confirmation जैसा दिखता है, संभवतः /en/ जैसे भाषा कोड के साथ। मॉड्यूल इसे हर भुगतान के साथ PayU को भेजता है, इसलिए PayU में कुछ सेट करने की ज़रूरत नहीं है। यह URL इंटरनेट से सुलभ होना चाहिए। यह स्टोर के मेंटेनेंस मोड में भी काम करता है और स्टोर की देश-सीमा से अवरुद्ध नहीं होता। पुष्टि PayU आपकी API कुंजी से हस्ताक्षरित करता है। बिना वैध हस्ताक्षर वाली, किसी अन्य मर्चेंट ID वाली, या इस स्टोर द्वारा जारी न की गई भुगतान संदर्भ वाली पुष्टियाँ अस्वीकार होती हैं। मॉड्यूल PayU की इन लेनदेन स्थितियों को संभालता है:
अन्य स्थितियाँ केवल नोट के रूप में जोड़ी जाती हैं। पुष्टि के बिना कोई ऑर्डर नहीं बनता।
उन्नत
Debug log: भुगतान अनुरोधों और PayU सूचनाओं को मॉड्यूल फ़ोल्डर में logs/payu_lp_debug.log.php में लॉग करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ और व्यक्तिगत डेटा लॉग नहीं होते। त्रुटियाँ और अस्वीकृत सूचनाएँ हमेशा लॉग होती हैं, भले ही यह स्विच बंद हो। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete data: मॉड्यूल अनइंस्टॉल होने पर सेटिंग्स और लॉग हटा देता है। ऑर्डरों का PayU डेटा (भुगतान प्रयास) और ऑर्डर स्टेटस बने रहते हैं। डिफ़ॉल्ट: बंद।
चेकआउट
भुगतान के चरण में ग्राहक भुगतान का तरीका (डिफ़ॉल्ट रूप से PayU LATAM) चुनता है और पुष्टि करता है। आपके स्टोर का एक पेज You are being redirected to PayU LATAM to complete the payment... दिखाता है और एक हस्ताक्षरित फ़ॉर्म अपने-आप PayU WebCheckout पेज पर भेज देता है। ऐसा न होने पर ग्राहक Pay with PayU LATAM पर क्लिक करता है, या लौटने के लिए Back to checkout पर। इस समय तक कोई ऑर्डर मौजूद नहीं होता।
फ़ॉर्म में कार्ट का कुल योग और मुद्रा, कार्ट का टैक्स और टैक्स आधार (बिना टैक्स वाले कार्ट के लिए दोनों 0, ताकि PayU डिफ़ॉल्ट VAT न जोड़े), कार्ट नंबर और स्टोर के नाम के साथ विवरण Cart #, तथा ग्राहक का ईमेल, नाम, फ़ोन और बिलिंग पता होता है। PayU पेज कार्ट की भाषा के अनुसार स्पैनिश, पुर्तगाली या अंग्रेज़ी में खुलता है। PayU पेज पर ग्राहक अपने PayU खाते में सक्षम किसी भी तरीके से भुगतान करता है।
भुगतान पेज की हर विज़िट अपने संदर्भ (PS, कार्ट नंबर और टाइमस्टैम्प) के साथ नया भुगतान प्रयास शुरू करती है। पिछले प्रयास याद रखे जाते हैं: यदि ग्राहक पहले खुले PayU टैब में भुगतान करता है, तो भी भुगतान स्वीकार होता है।
ऑर्डर केवल PayU द्वारा हस्ताक्षरित पुष्टि भेजने के बाद भुगतान किया हुआ चिह्नित होता है। PayU से लौटा ग्राहक कभी ऑर्डर को भुगतान किया हुआ नहीं बनाता। ग्राहक के लौटने पर:
मौजूदा वातावरण के क्रेडेंशियल न होने पर ग्राहक को PayU LATAM is not available right now. Please choose another payment method. दिखता है। असमर्थित कार्ट मुद्रा के लिए संदेश PayU LATAM does not accept payments in होता है, उसके बाद मुद्रा। जिस कार्ट पर पहले से ऑर्डर है, उसका दोबारा भुगतान नहीं होता: ग्राहक उस ऑर्डर के पुष्टि पेज पर जाता है।
मॉड्यूल में स्टोर के भीतर भुगतान फ़ॉर्म, PrestaShop से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या किस्तों की सेटिंग नहीं हैं (PayU किस्तें अपने पेज पर दिखाता है)। यह भुगतान स्थिति के लिए PayU API से पूछताछ नहीं करता: केवल हस्ताक्षरित पुष्टि ऑर्डर को अपडेट करती है।
ऑर्डर
ऑर्डर स्टेटस
अभी कोई ऑर्डर नहीं: ग्राहक PayU पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान अस्वीकृत हुआ, या PayU ने अभी पुष्टि नहीं भेजी है। केवल कार्ट मौजूद है।
Payment accepted: PayU ने भुगतान की पुष्टि की और राशि तथा मुद्रा मेल खाते हैं। भुगतान PayU लेनदेन ID के साथ दर्ज होता है, और एक नोट में लेनदेन, राशि, भुगतान का तरीका और सैंडबॉक्स भुगतानों के लिए [sandbox] दिखता है।
Awaiting PayU LATAM payment: PayU भुगतान को लंबित बताता है (नकद या बैंक भुगतान)। PayU के भुगतान की पुष्टि करने पर ऑर्डर Payment accepted में चला जाता है।
PayU LATAM payment on hold: चुकाई गई राशि या मुद्रा कार्ट के कुल योग से मेल नहीं खाती, या रद्द किए गए ऑर्डर के लिए भुगतान स्वीकृत हुआ। यदि भुगतान ऑर्डर की मुद्रा में है तो वह दर्ज होता है। नोट बताता है कि मामला क्या है: PayU मॉड्यूल में भुगतान जाँचें, फिर ऑर्डर प्रोसेस करें, बहाल करें या भुगतान रिफ़ंड करें।
Payment error: नवीनतम प्रयास का कोई लंबित भुगतान बाद में अस्वीकृत हुआ, समय-सीमा समाप्त हुई, या त्रुटि के साथ समाप्त हुआ। नोट में PayU का संदेश दिखता है। इस कार्ट का दोबारा भुगतान नहीं हो सकता: ग्राहक नया ऑर्डर देता है। किसी पुराने प्रयास की अस्वीकृति, या ऐसे ऑर्डर की अस्वीकृति जिसका भुगतान पहले से स्वीकृत है, केवल नोट के रूप में जोड़ी जाती है।
हर सूचना कार्ट-वार लॉक के अंतर्गत एक बार प्रोसेस होती है: दोहराई गई PayU सूचनाएँ दूसरा ऑर्डर नहीं बनातीं और नोट दोबारा नहीं जोड़तीं। भुगतान किया हुआ ऑर्डर कभी दोबारा नहीं खुलता और उसका स्तर नहीं घटता। यदि पहले से भुगतान किए गए ऑर्डर के लिए एक और स्वीकृत भुगतान आता है, तो एक नोट इसकी सूचना देता है: यदि ग्राहक ने दो बार भुगतान किया है, तो PayU मॉड्यूल में डुप्लिकेट भुगतान रिफ़ंड करें।
PayU LATAM भुगतान ब्लॉक
ऑर्डर पेज पर PayU LATAM payment ब्लॉक दिखता है, जिसमें संदर्भ, लेनदेन ID, PayU संदर्भ, स्थिति और PayU स्थिति, माँगी गई राशि, PayU द्वारा बताई गई राशि, भुगतान का तरीका, PayU संदेश, सैंडबॉक्स भुगतानों के लिए SANDBOX बैज, कार्ट के सभी भुगतान प्रयासों की सूची, और ऑर्डर के PayU LATAM notes शामिल हैं।
रिफ़ंड
रिफ़ंड PrestaShop से नहीं किए जाते। PayU मॉड्यूल में लेनदेन का रिफ़ंड करें, फिर PrestaShop में रिफ़ंड मैन्युअली दर्ज करें।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। License — VibeFox PayU LATAM Payment लाइसेंस ब्लॉक Modules > Module Manager > VibeFox PayU LATAM Payment > Configure पेज पर सबसे पहला ब्लॉक है, सेटिंग्स के ऊपर। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्टेटस (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन) दिखाता है, साथ ही बटन: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-payment-payu-latam वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल की Configure अनुमति वाले कर्मचारी कुंजी बदल सकते हैं। ब्लॉक के पाठ बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या License expired on के साथ एक तारीख। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर के डोमेन पर, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना PayU LATAM चेकआउट पर ग्राहकों को नहीं दिखता। फिर भी यदि भुगतान शुरू हो जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop का स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी PayU की पुष्टि और ग्राहक की वापसी से पुष्ट होते हैं।
लाइसेंस समाप्त होने पर मॉड्यूल काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण आवश्यक है। बैक ऑफ़िस में काम करते समय स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़, फिर हर हफ़्ते। cron जॉब की ज़रूरत नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर PayU LATAM नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा वातावरण की मर्चेंट ID, खाता ID और API कुंजी भरी हुई हैं: Sandbox चालू होने पर सैंडबॉक्स क्रेडेंशियल, बंद होने पर लाइव क्रेडेंशियल। जाँचें कि कार्ट की मुद्रा ARS, BRL, CLP, COP, MXN, PEN या USD है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक समूह के लिए अनुमत है।
भुगतान हो गया, पर ऑर्डर नहीं बना: PayU की पुष्टि आपके स्टोर तक नहीं पहुँची या अस्वीकार हुई। जाँचें कि सेटिंग्स में दिखाई गई पुष्टि URL इंटरनेट से सुलभ है (कोई लोकल साइट, फ़ायरवॉल या पासवर्ड सुरक्षा नहीं)। अस्वीकृत पुष्टियों के लिए मॉड्यूल पेज पर Log फ़ील्ड देखें। किसी भी त्रुटि उत्तर के बाद PayU पुष्टि फिर से भेजता है।
पुष्टि Invalid signature बताती है: पुष्टि भुगतान के वातावरण की API कुंजी से हस्ताक्षरित नहीं थी। लाइव भुगतानों के लिए API Key और सैंडबॉक्स भुगतानों के लिए Sandbox API key जाँचें।
पुष्टि Merchant mismatch बताती है: पुष्टि की मर्चेंट ID भुगतान के वातावरण की Merchant ID या Sandbox merchant ID से अलग है। भुगतान प्रोसेस करने वाले PayU खाते की मर्चेंट ID डालें।
पुष्टि Gateway not configured बताती है: भुगतान के वातावरण की API कुंजी या मर्चेंट ID गायब है, उदाहरण के लिए जब सैंडबॉक्स भुगतान लंबित था तब सैंडबॉक्स क्रेडेंशियल हटा दिए गए थे। उन्हें फिर से डालें; PayU पुष्टि दोबारा भेजेगा।
पुष्टि Retry बताती है: उसी समय कार्ट किसी अन्य अनुरोध द्वारा प्रोसेस हो रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद है)। कुछ नहीं बदला गया, और PayU पुष्टि फिर से भेजेगा। कारण के लिए Log देखें।
पुष्टि Unknown reference बताती है: भुगतान संदर्भ इस स्टोर ने जारी नहीं किया था।
पुष्टि URL ब्राउज़र में Method not allowed दिखाता है: यह सामान्य है। यह URL केवल PayU के अनुरोध स्वीकार करता है।
ग्राहक को This payment method is not available दिखता है: Payment > Preferences में मॉड्यूल ग्राहक के देश, मुद्रा या समूह के लिए अनुमत नहीं है, या Enable/Disable बंद है।
ऑर्डर PayU LATAM payment on hold है: PayU LATAM payment ब्लॉक के नोट पढ़ें। चुकाई गई राशि या मुद्रा कार्ट से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। PayU मॉड्यूल में लेनदेन जाँचें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox PayU LATAM Payment के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। यदि Delete data चालू है, तो सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। भुगतान प्रयास और ऑर्डर स्टेटस Awaiting PayU LATAM payment व PayU LATAM payment on hold हमेशा रखे जाते हैं, ताकि पुराने प्रयास की देर से आई PayU पुष्टि दोबारा इंस्टॉल के बाद भी पहचानी जाए। मौजूदा ऑर्डर अपने भुगतान नोट्स, PayU संदर्भ और लेनदेन ID रखते हैं।
PayU अपने-अपने स्वामी का ट्रेडमार्क है। यह मॉड्यूल PayU से संबद्ध नहीं है और न ही PayU द्वारा समर्थित है।
