VibeFox PayU LATAM for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: ग्राहक की चेकआउट मुद्रा ARS, BRL, CLP, COP, MXN, PEN या USD होनी चाहिए, यानी वे मुद्राएँ जिन्हें PayU Latam अर्जेंटीना, ब्राज़ील, चिली, कोलंबिया, मेक्सिको, पनामा और पेरू में संसाधित करता है। अन्य मुद्राओं में चेकआउट पर भुगतान का तरीका नहीं दिखता।

PayU Latam खाता: आपको अपने PayU कॉमर्स से तीन मान चाहिए: merchant ID, जिस देश में आप बेचते हैं उसका account ID, और API key। ये PayU मर्चेंट पैनल में Settings > Technical configuration (merchant ID, API key) और Accounts (account ID) के अंतर्गत मिलते हैं। परीक्षण के लिए PayU अपने डेवलपर दस्तावेज़ में "Test your solution" पेज पर सार्वजनिक sandbox क्रेडेंशियल और टेस्ट कार्ड प्रकाशित करता है। API Login और अन्य API क्रेडेंशियल की ज़रूरत नहीं है, क्योंकि भुगतान PayU के होस्टेड पेज पर होता है और एक्सटेंशन कभी PayU API को कॉल नहीं करता।

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Sandbox क्रेडेंशियल और अपने लाइव क्रेडेंशियल दर्ज करें (देखें कॉन्फ़िगरेशन)। PayU में कोई पुष्टि URL कॉन्फ़िगर करने की ज़रूरत नहीं है।

5. Enable/Disable चालू करें और Save पर क्लिक करें। एक परीक्षण भुगतान करने तक Sandbox चालू रखें, फिर असली भुगतान लाइव क्रेडेंशियल से स्वीकार करने के लिए उसे बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox PayU LATAM Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, जब sandbox चालू होता है तब पेज Sandbox mode. Payments go to the PayU sandbox and no real money is charged. दिखाता है; जब वर्तमान वातावरण का merchant ID, account ID या API key गायब होता है तो एक त्रुटि (तब PayU Latam चेकआउट पर नहीं दिखाया जाता), और जब PayU Latam स्टोर की डिफ़ॉल्ट मुद्रा को संसाधित नहीं करता तो एक चेतावनी दिखाता है। एक्सटेंशन बदलने की अनुमति न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

PayU LATAM

Enable/Disable: Enable PayU LATAM से भुगतान विधि चालू या बंद होती है। डिफ़ॉल्ट: बंद।

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.

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

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

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

वातावरण

Sandbox: भुगतान sandbox क्रेडेंशियल के साथ PayU sandbox में जाते हैं, और कोई असली राशि नहीं काटी जाती। बंद होने पर लाइव क्रेडेंशियल और PayU का लाइव चेकआउट पेज इस्तेमाल होता है। डिफ़ॉल्ट: चालू। चालू रहने पर ग्राहक को Confirm Order चरण में 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 सूचनाओं को सत्यापित करने के लिए उपयोग होने वाली गुप्त कुंजी।

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

PayU अपने sandbox के लिए सार्वजनिक परीक्षण क्रेडेंशियल और टेस्ट कार्ड प्रकाशित करता है। यह सेक्शन PayU दस्तावेज़ के "Test your solution" पेज का लिंक देता है।

Sandbox merchant ID: PayU sandbox के लिए merchant ID।

Sandbox account ID: PayU sandbox के लिए account ID।

Sandbox API key: PayU sandbox के लिए API key।

सहेजी गई API keys दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना चाहें तो नया मान दर्ज करें। सहेजी गई key हटाने के लिए फ़ील्ड के नीचे Clear saved secret on save चुनें और Save पर क्लिक करें।

हर भुगतान प्रयास अपना वातावरण याद रखता है। sandbox भुगतान की पुष्टि sandbox API key और merchant ID से, और लाइव भुगतान की पुष्टि लाइव मानों से सत्यापित होती है, इसलिए वातावरण बदलने के बाद भी लंबित भुगतान काम करते रहते हैं। Sandbox भुगतान ऑर्डर नोट्स में sandbox के रूप में चिह्नित होते हैं।

पुष्टि URL

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

अन्य स्थितियाँ केवल एक नोट के रूप में जोड़ी जाती हैं। पुष्टि के बिना ऑर्डर को कोई स्टेटस नहीं मिलता।

ऑर्डर

OpenCart Confirm Order चरण में ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस केवल हस्ताक्षरित PayU पुष्टि के बाद मिलता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस की सूची दिखाता है।

Order Status After Payment: एक स्वीकृत भुगतान (PayU स्थिति 4) जिसकी राशि और मुद्रा अपेक्षित हों। डिफ़ॉल्ट: Processing।

Awaiting Payment Status: एक लंबित भुगतान (स्थिति 7, 10, 12, 14, 15, 18, जैसे कोई नकद या बैंक भुगतान जो अभी पूरा नहीं हुआ)। PayU की पुष्टि होने पर ऑर्डर को Order Status After Payment मिलता है। डिफ़ॉल्ट: Pending।

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

Failed Payment Status: आखिरी प्रयास का लंबित भुगतान, जिसे PayU ने बाद में अस्वीकृत, समाप्त या विफल बताया। डिफ़ॉल्ट: Failed।

Cancelled Order Status: वह स्टेटस जो आपका स्टोर रद्द किए गए ऑर्डरों के लिए उपयोग करता है। ऐसे ऑर्डर के लिए स्वीकृत भुगतान उसे भुगतान किया हुआ चिह्नित करने के बजाय On Hold (Review) Status पर ले जाता है। एक्सटेंशन यह स्टेटस कभी सेट नहीं करता। डिफ़ॉल्ट: Canceled।

उन्नत

Debug log: भुगतान अनुरोधों और PayU सूचनाओं को OpenCart लॉग फ़ोल्डर (storage/logs) में payu_lp_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB होने पर इसे payu_lp_debug.old.log.php में ले जाया जाता है। कुंजियाँ और व्यक्तिगत डेटा दर्ज नहीं होते। त्रुटियाँ और अस्वीकृत सूचनाएँ हमेशा दर्ज होती हैं, भले ही यह स्विच बंद हो। डिफ़ॉल्ट: बंद।

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

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

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

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

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

चेकआउट

Payment Method चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से PayU LATAM)। Confirm Order चरण में ग्राहक आपका विवरण देखता है; OpenCart इसी चरण में ऑर्डर बनाता है, फिर भी बिना स्टेटस के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन एक हस्ताक्षरित भुगतान फ़ॉर्म तैयार करता है, पेज You are being redirected to PayU LATAM to complete the payment... दिखाता है और फ़ॉर्म को अपने-आप PayU WebCheckout पेज पर भेज देता है। यदि ऐसा न हो, तो ग्राहक Pay with PayU LATAM पर क्लिक करता है।

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

Confirm Order पर हर क्लिक अपने संदर्भ (OC, ऑर्डर नंबर और समय-चिह्न) के साथ नया भुगतान प्रयास शुरू करता है। OpenCart 4 पर एक नया प्रयास चेकआउट के उसी ऑर्डर का भुगतान करता है। पिछले प्रयास भी याद रखे जाते हैं: यदि ग्राहक किसी पुराने PayU टैब में भुगतान करता है, तो भुगतान फिर भी पहचाना जाता है।

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब PayU हस्ताक्षरित पुष्टि से भुगतान की पुष्टि करे। उसके बाद ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल भेजे जाते हैं और स्टॉक अपडेट होता है। PayU से लौटा ग्राहक कभी ऑर्डर को भुगतान किया हुआ चिह्नित नहीं करता। जब ग्राहक लौटता है:

OpenCart 4 पर चेकआउट के ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, पर एक कार्ट का भुगतान केवल एक बार होता है: यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ, भुगतान की प्रतीक्षा में, या समीक्षा में है, तो Confirm Order सीधे सफलता पेज पर ले जाता है। कार्ट में कोई भी बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसके लिए अपना भुगतान ज़रूरी है। यदि वर्तमान वातावरण के क्रेडेंशियल गायब हैं, तो ग्राहक को PayU LATAM is not available right now. Please choose another payment method. दिखता है।

OpenCart 4 में ऑर्डर सफलता पेज दिखाए जाने तक चेकआउट में रखा जाता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका नकद भुगतान विफल हुआ, या आपने उसे रद्द किया), तो ग्राहक Your PayU LATAM payment was not approved और यदि हो तो PayU का कारण लेकर चेकआउट पर लौट जाता है। यदि वह भुगतान किया हुआ था और स्टोर ने उसे बाद में बंद किया, या वह किसी पिछले कार्ट के लिए भुगतान किया हुआ था और तब से कार्ट बदल गया है, तो संदेश Your previous order is already closed. Please confirm the order again: the cart will be paid with a new order. होता है। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। बंद किया गया ऑर्डर कभी भुगतान किया हुआ नहीं दिखाया जाता।

इस एक्सटेंशन का आपकी साइट पर कोई भुगतान फ़ॉर्म नहीं है, OpenCart से कोई रिफ़ंड नहीं होता, सेव किए गए कार्ड, सब्सक्रिप्शन और किस्त (installment) सेटिंग्स नहीं हैं (PayU अपने पेज पर किस्तें दिखाता है)। यह भुगतान स्थिति के लिए PayU API से पूछताछ नहीं करता: केवल हस्ताक्षरित पुष्टि ऑर्डर को अपडेट करती है।

ऑर्डर

ऑर्डर स्टेटस

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

Order Status After Payment (default Processing): PayU ने भुगतान की पुष्टि की और राशि तथा मुद्रा मेल खाती हैं। एक नोट लेन-देन, राशि, भुगतान विधि और यह दिखाता है कि यह sandbox भुगतान था या नहीं।

Awaiting Payment Status (default Pending): PayU भुगतान को लंबित बताता है (नकद या बैंक भुगतान)। PayU भुगतान की पुष्टि करने पर ऑर्डर Order Status After Payment पर जाता है, या विफल होने पर Failed Payment Status पर। OpenCart इन बदलावों की सूचना ग्राहक को देता है।

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

Failed Payment Status (default Failed): आखिरी प्रयास का लंबित भुगतान बाद में अस्वीकृत, समाप्त या त्रुटि के साथ खत्म हुआ। नोट में PayU का संदेश दिखता है। किसी पुराने प्रयास का अस्वीकृत होना, या ऐसे ऑर्डर का अस्वीकृत होना जिसमें पहले से स्वीकृत भुगतान हो, केवल नोट के रूप में जोड़ा जाता है।

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

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

VibeFox PayU LATAM Payment टैब

Sales > Orders में PayU LATAM से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox PayU LATAM Payment टैब में Reference, Transaction ID, PayU reference, Status और PayU स्थिति, Requested राशि, Amount reported by PayU, Payment method, PayU message, sandbox भुगतानों के लिए SANDBOX बैज, कार्ट के सभी Payment attempts की सूची, और ऑर्डर के PayU LATAM notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

रिफ़ंड OpenCart से नहीं होते। PayU मर्चेंट पैनल में लेन-देन का रिफ़ंड करें, फिर OpenCart में रिफ़ंड मैन्युअल रूप से दर्ज करें।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox PayU LATAM Payment, Extensions > Extensions > Payments > VibeFox PayU LATAM Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-payu-latam की पंक्ति और 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 LATAM चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी कोई भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग-इन एडमिन उपयोगकर्ता को भुगतान विधि स्टोर में (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक आता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, वे अब भी PayU पुष्टि और ग्राहक की वापसी से पुष्ट होते हैं।

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

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

PayU LATAM चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान वातावरण का merchant ID, account ID और API key भरे हुए हैं: Sandbox चालू होने पर sandbox क्रेडेंशियल, बंद होने पर लाइव क्रेडेंशियल। यह भी जाँचें कि ग्राहक की मुद्रा ARS, BRL, CLP, COP, MXN, PEN या USD है, भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: PayU की पुष्टि आपके स्टोर तक नहीं पहुँची या अस्वीकृत हुई। जाँचें कि सेटिंग्स में दिखाई गई पुष्टि URL इंटरनेट से पहुँच योग्य है (कोई लोकल साइट, फ़ायरवॉल या पासवर्ड सुरक्षा नहीं)। अस्वीकृत पुष्टियों के लिए एक्सटेंशन पेज पर Log फ़ील्ड देखें। PayU किसी भी त्रुटि उत्तर के बाद पुष्टि दोबारा भेजता है।

पुष्टि Invalid signature उत्तर देती है: पुष्टि भुगतान के वातावरण की API key से साइन नहीं हुई। लाइव भुगतानों के लिए API Key और sandbox भुगतानों के लिए Sandbox API key जाँचें।

पुष्टि Merchant mismatch उत्तर देती है: पुष्टि का merchant ID भुगतान के वातावरण के Merchant ID या Sandbox merchant ID से अलग है। उस PayU खाते का merchant ID दर्ज करें जो भुगतान संसाधित करता है।

पुष्टि Gateway not configured उत्तर देती है: भुगतान के वातावरण की API key या merchant ID गायब है, उदाहरण के लिए जब sandbox भुगतान लंबित था तब sandbox क्रेडेंशियल हटा दिए गए थे। उन्हें दोबारा दर्ज करें; PayU पुष्टि दोबारा भेजेगा।

पुष्टि Retry उत्तर देती है: उसी समय कार्ट को किसी दूसरे अनुरोध द्वारा संसाधित किया जा रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। PayU पुष्टि फिर से भेजेगा। कारण के लिए Log देखें।

पुष्टि Unknown reference उत्तर देती है: भुगतान संदर्भ इस स्टोर द्वारा जारी नहीं किया गया था।

पुष्टि URL ब्राउज़र में Method not allowed दिखाता है: यह सामान्य है। यह URL केवल PayU से आए अनुरोध स्वीकार करता है।

ग्राहक को This payment method is not available. Please reload the checkout page. दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच Enable/Disable बंद हो गया। ग्राहक को चेकआउट दोबारा लोड करना होगा।

ऑर्डर समीक्षा स्टेटस में है: VibeFox PayU LATAM Payment टैब के नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से अलग थी, या ऑर्डर रद्द होने के बाद भुगतान आया। PayU मर्चेंट पैनल में लेन-देन जाँचें।

अनइंस्टॉल

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

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

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