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

आवश्यकताएँ

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

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

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

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

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

Internet access to your site: PayU अपने सर्वर से आपके स्टोर को भुगतान का परिणाम भेजता है, इसलिए साइट इंटरनेट से सुलभ होनी चाहिए (स्थानीय साइट नहीं होनी चाहिए और पासवर्ड सुरक्षा या रखरखाव पेज से अवरुद्ध नहीं होनी चाहिए)।

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

इंस्टॉलेशन

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

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

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

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

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

6. Enable/Disable चालू करें और सेव करें। टेस्ट भुगतान पूरा होने तक Sandbox चालू रखें, फिर लाइव क्रेडेंशियल से असली भुगतान स्वीकार करने के लिए उसका चयन हटाएँ।

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

सभी सेटिंग एक पेज पर हैं: WooCommerce > Settings > Payments > PayU LATAM। फ़ील्ड के ऊपर पेज चेतावनी देता है जब सैंडबॉक्स मोड चालू हो (Sandbox mode. भुगतान PayU सैंडबॉक्स में जाते हैं और असली पैसे नहीं लिए जाते।), जब वर्तमान वातावरण की मर्चेंट ID, खाता ID या API कुंजी गायब हो, और जब PayU LATAM स्टोर की मुद्रा प्रोसेस न करता हो। अंतिम दो स्थितियों में चेकआउट पर PayU LATAM नहीं दिखता। भुगतान तरीकों की सूची में PayU LATAM को सेटअप आवश्यक के रूप में चिह्नित किया जाता है, जब तक वर्तमान वातावरण के तीनों क्रेडेंशियल नहीं भरे जाते। क्रेडेंशियल के आरंभ या अंत के रिक्त स्थान अनदेखे किए जाते हैं।

सामान्य

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

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: Enable the PayU sandbox (test mode)। भुगतान नीचे दिए सैंडबॉक्स क्रेडेंशियल से PayU सैंडबॉक्स में जाते हैं और असली पैसे नहीं लिए जाते। बंद होने पर लाइव क्रेडेंशियल और PayU का लाइव चेकआउट इस्तेमाल होता है। डिफ़ॉल्ट: on।

लाइव क्रेडेंशियल

इन्हें PayU मॉड्यूल में पाएँ: Settings > Technical configuration (मर्चेंट ID, API कुंजी) और Accounts (जिस देश में आप बेचते हैं उसकी खाता 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 कुंजी और मर्चेंट ID से, और लाइव भुगतान की पुष्टि लाइव मानों से जाँची जाती है, इसलिए बदलने के बाद भी लंबित भुगतान काम करते रहते हैं। संस्करण 1.0 से अपडेट करते समय, जिसमें क्रेडेंशियल का एक ही सेट था, सैंडबॉक्स चालू होने पर पुराने मान सैंडबॉक्स फ़ील्ड में कॉपी हो जाते हैं। अपडेट के बाद सेटिंग जाँचें।

पुष्टि URL

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

4 (approved): भुगतान हो गया। राशि और मुद्रा मेल खाने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है।

6 (declined), 5 (expired), 104 (error): भुगतान विफल हुआ। नवीनतम प्रयास से संबंधित अवैतनिक ऑर्डर विफल चिह्नित होता है।

7 and other pending states: भुगतान प्रतीक्षा में है, जैसे नकद या बैंक भुगतान जो ग्राहक ने अभी पूरा नहीं किया है। ऑर्डर होल्ड पर रखा जाता है।

अन्य राज्य केवल ऑर्डर नोट के रूप में जुड़ते हैं। पुष्टि के बिना ऑर्डर कभी भुगतान किया हुआ चिह्नित नहीं होता: वह भुगतान लंबित रहता है।

उन्नत

Debug log: Log payment requests and PayU notifications विवरण को WooCommerce > Status > Logs में, स्रोत wcp_payu_latam_payment के अंतर्गत, कुंजियों या व्यक्तिगत डेटा के बिना लिखता है। त्रुटियाँ और अस्वीकृत सूचनाएँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: off।

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

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट PayU LATAM) और ऑर्डर देता है। सैंडबॉक्स मोड में Checkout ब्लॉक पर ग्राहक Sandbox mode: no real payment is made. देखता है। ऑर्डर भुगतान लंबित रहता है और ग्राहक आपके स्टोर के भुगतान पेज पर जाता है जहाँ Thank you for your order. You are being redirected to PayU LATAM to complete the payment… लिखा होता है। पेज PayU WebCheckout पेज को हस्ताक्षरित फ़ॉर्म अपने-आप भेजता है। ऐसा न होने पर ग्राहक Pay with PayU LATAM पर, या ऑर्डर रद्द करने के लिए Cancel order पर क्लिक करता है।

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

भुगतान पेज पर हर बार जाने से अपने अलग संदर्भ (ऑर्डर नंबर और टाइमस्टैम्प) वाला नया भुगतान प्रयास शुरू होता है। ऑर्डर के अंतिम 30 प्रयास याद रखे जाते हैं: यदि ग्राहक किसी पुराने PayU टैब में भुगतान करता है तो भी उसे स्वीकार किया जाता है।

ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब PayU हस्ताक्षरित पुष्टि से इसकी पुष्टि करता है। ग्राहक के PayU से लौटने से ऑर्डर कभी भुगतान किया हुआ चिह्नित नहीं होता। ग्राहक के लौटने पर:

हस्ताक्षरित अस्वीकृति, समय-सीमा समाप्ति या त्रुटि के बाद: ऑर्डर तुरंत विफल चिह्नित होता है और WooCommerce अपना मानक विफल भुगतान पेज दिखाता है, जिसमें दोबारा भुगतान का विकल्प होता है।

PayU लेन-देन न होने पर (ग्राहक ने PayU पेज छोड़ दिया): ग्राहक Pay for order पेज पर जाता है और Your PayU LATAM payment was not completed. You can try again or choose another payment method. संदेश देखता है।

अन्यथा: ग्राहक को ऑर्डर प्राप्त होने का पेज दिखता है। ऑर्डर भुगतान लंबित रहने तक We are waiting for PayU LATAM to confirm your payment. You will receive an e-mail as soon as it is confirmed. लिखा होता है। होल्ड पर रखे ऑर्डर के लिए Your PayU LATAM payment is pending (for example, a cash or bank payment that has not been completed yet). We will process the order as soon as PayU confirms the payment. लिखा होता है।

वर्तमान वातावरण के क्रेडेंशियल गायब होने पर ग्राहक PayU LATAM is not available right now. Please choose another payment method. देखता है। असमर्थित ऑर्डर मुद्रा के लिए संदेश PayU LATAM does not accept payments in होता है, जिसके बाद मुद्रा आती है। पहले से भुगतान किए गए ऑर्डर का दोबारा भुगतान नहीं होता: भुगतान पेज This order has already been paid. दिखाता है।

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

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

ऑर्डर

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

Pending payment: ग्राहक को PayU पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या PayU ने अभी पुष्टि नहीं भेजी है।

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

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

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

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

रिफ़ंड

रिफ़ंड WooCommerce से नहीं किए जाते। PayU मॉड्यूल में लेन-देन रिफ़ंड करें और ज़रूरत होने पर WooCommerce में रिफ़ंड मैन्युअल रूप से दर्ज करें।

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

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

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

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

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

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

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

भुगतान हो गया, पर ऑर्डर Pending payment रहता है: PayU की पुष्टि आपके स्टोर तक नहीं पहुँची या अस्वीकार हुई। जाँचें कि सेटिंग में दिखा पुष्टि URL इंटरनेट से सुलभ है (स्थानीय साइट, रखरखाव मोड, फ़ायरवॉल या पासवर्ड सुरक्षा से अवरुद्ध न हो)। अस्वीकृत पुष्टियों के लिए WooCommerce > Status > Logs में स्रोत wcp_payu_latam_payment देखें। किसी भी त्रुटि उत्तर के बाद 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 पुष्टि का पुनः प्रयास करता है।

पुष्टि का उत्तर Busy, retry later है: उसी समय कोई अन्य अनुरोध ऑर्डर अपडेट कर रहा था। कुछ बदला नहीं गया और PayU पुष्टि फिर भेजता है।

पुष्टि का उत्तर Unknown reference है: भुगतान संदर्भ इस स्टोर के PayU LATAM ऑर्डर का नहीं है; उदाहरण के लिए, ऑर्डर किसी अन्य भुगतान तरीके पर बदल दिया गया या हटा दिया गया।

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

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

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

अनइंस्टॉल करना

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

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