VibeFox 2C2P for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित)।
PHP: 8.0 या उसके बाद का संस्करण।
2C2P खाता: आपको अपने 2C2P मर्चेंट खाते का Merchant ID और Secret Key चाहिए। ये मर्चेंट खाता खुलने पर 2C2P द्वारा जारी किए जाते हैं। सैंडबॉक्स और लाइव खातों की कुंजियाँ अलग होती हैं। डेवलपर दस्तावेज़ और सैंडबॉक्स टेस्ट कार्ड developer.2c2p.com पर उपलब्ध हैं।
मुद्रा: चेकआउट की मुद्रा एक्सटेंशन द्वारा समर्थित होनी चाहिए और आपके 2C2P खाते में सक्षम होनी चाहिए। समर्थित मुद्राओं में, अन्य के साथ, THB, SGD, MYR, PHP, IDR, VND, MMK, KHR, LAK, CNY, HKD, TWD, JPY, KRW, INR, AUD, NZD, USD, EUR और GBP शामिल हैं। यदि ग्राहक की मुद्रा समर्थित नहीं है, तो चेकआउट पर भुगतान विधि छिपा दी जाती है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_2c2p_payment-oc3-(संस्करण).ocmod.zip और OpenCart 4 का पैकेज wcp_2c2p_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_2c2p_payment-oc3-(संस्करण).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप आर्काइव के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox 2C2P Payment ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें License key)।
4. अपना सैंडबॉक्स Merchant ID और Secret Key दर्ज करें, Enable/Disable चालू करें, Save पर क्लिक करें और एक परीक्षण ऑर्डर दें।
5. जब आप तैयार हों, तो लाइव क्रेडेंशियल दर्ज करें और Sandbox Mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_2c2p_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में पैकेज उसी पेज पर दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और एक्सटेंशन का प्रकार Payments चुनें। VibeFox 2C2P Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी और सेटिंग्स वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Result URLs अलग हैं (देखें Payment page)।
नया इंस्टॉल भुगतान विधि बंद और सैंडबॉक्स मोड चालू के साथ शुरू होता है। हर भुगतान के साथ वापसी और सूचना URL भेजे जाते हैं। 2C2P पोर्टल में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox 2C2P Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सैंडबॉक्स मोड चालू होने पर सेटिंग्स के ऊपर पेज Sandbox mode is active. No real transactions will be processed. दिखाता है। यदि गेटवे सक्षम है, लेकिन वर्तमान मोड का Merchant ID या Secret Key खाली है, या स्टोर की डिफ़ॉल्ट मुद्रा समर्थित नहीं है, तो यह चेतावनी देता है। दोनों ही स्थितियों में चेकआउट पर भुगतान विधि छिपी रहती है। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।
Sandbox Mode बंद होने पर सेव करते समय, यदि कोई लाइव फ़ील्ड खाली है, तो पेज Please enter your live Merchant ID. या Please enter your live Secret Key. दिखाता है। फिर भी सेटिंग्स सेव हो जाती हैं। Sort Order एक पूर्ण संख्या होना चाहिए, Total 0 या उससे अधिक की संख्या, और Title अधिकतम 128 अक्षरों का; साथ ही geo zone और ऑर्डर स्टेटस मौजूद होने चाहिए। अन्यथा कुछ भी सेव नहीं होता और पेज वह फ़ील्ड बताता है।
2C2P
Enable/Disable: Enable 2C2P Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यह ऑर्डर में भी भुगतान विधि के नाम के रूप में सहेजा जाता है, इसलिए यह अधिकतम 128 अक्षरों का हो सकता है। यदि खाली है, तो डिफ़ॉल्ट उपयोग होता है। डिफ़ॉल्ट: 2C2P Payment।
Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखाया जाता है। डिफ़ॉल्ट: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P। सैंडबॉक्स मोड में इसके अंत में (TEST MODE) जुड़ जाता है।
Sort Order: चेकआउट पर भुगतान विधियों के बीच 2C2P की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।
Geo Zone: 2C2P केवल चुने गए geo zone में स्थित भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।
Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट की वह कुल राशि, जिस तक पहुँचने पर ही 2C2P दिखाया जाता है। किसी भी राशि के लिए 2C2P दिखाने हेतु खाली छोड़ें।
टेस्ट मोड (सैंडबॉक्स)
Sandbox Mode: भुगतान नीचे दिए गए सैंडबॉक्स क्रेडेंशियल के साथ 2C2P सैंडबॉक्स (demo2.2c2p.com) पर भेजता है। डिफ़ॉल्ट: चालू। असली भुगतान लेने के लिए इसे बंद करें।
Sandbox Merchant ID: आपका 2C2P सैंडबॉक्स Merchant ID।
Sandbox Secret Key: आपकी 2C2P सैंडबॉक्स Secret Key।
लाइव API क्रेडेंशियल
सैंडबॉक्स मोड बंद होने पर उपयोग होते हैं।
Merchant ID: आपका 2C2P लाइव Merchant ID।
Secret Key: आपकी 2C2P लाइव Secret Key। कुंजी वैसे ही सेव होती है जैसे दर्ज की गई है, जिसमें उद्धरण चिह्न और बैकस्लैश भी शामिल हैं।
सेव की गई Secret Keys फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। नया मान केवल तभी दर्ज करें जब आप उसे बदलना चाहते हों। सेव की गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved value on save चुनें और Save पर क्लिक करें।
भुगतान पेज
Result URLs: संदर्भ के लिए Frontend return URL और Backend notification URL दिखाता है। ये कुछ इस तरह दिखते हैं: https://your-store/index.php?route=extension/payment/wcp_2c2p_payment/back और https://your-store/index.php?route=extension/payment/wcp_2c2p_payment/notify OpenCart 3 पर, और https://your-store/index.php?route=extension/wcp_2c2p_payment/payment/wcp_2c_2p_payment.back और https://your-store/index.php?route=extension/wcp_2c2p_payment/payment/wcp_2c_2p_payment.notify OpenCart 4 पर। ये आपकी OpenCart इंस्टॉलेशन के storefront पते से बनते हैं। ये हर भुगतान के साथ अपने-आप भेजे जाते हैं। परिणाम हमेशा उसी मोड के Merchant ID और Secret Key से जाँचे जाते हैं जिसमें भुगतान हुआ था: सैंडबॉक्स में शुरू किया गया भुगतान लाइव पर स्विच करने के बाद भी सैंडबॉक्स कुंजी से जाँचा जाता है, और दूसरे मोड की कुंजी से हस्ताक्षरित परिणाम अस्वीकार किया जाता है।
Payment Page Language: 2C2P भुगतान पेज की भाषा। डिफ़ॉल्ट: English।
Redirect API version: 8.5 ही रखें, जब तक 2C2P ने न बताया हो कि आपका खाता अब भी पुराने संस्करण 7.0 (SHA-1 हस्ताक्षर) का उपयोग करता है। स्विच से पहले शुरू हुए भुगतानों के परिणाम फिर भी जाँचे जाते हैं।
Order ID prefix: वैकल्पिक, केवल अक्षर और अंक (अधिकतम 10), जैसे SHOP1। 2C2P वह ऑर्डर ID अस्वीकार करता है जो उसने पहले देखा है। जब कई स्टोर एक 2C2P खाता साझा करते हैं, और सैंडबॉक्स में, जहाँ टेस्ट मर्चेंट खाते साझा होते हैं, एक अनूठा प्रीफ़िक्स सेट करें। 2C2P ऑर्डर ID में प्रीफ़िक्स, OpenCart ऑर्डर नंबर और प्रयास नंबर होता है, जैसे SHOP1123A1। सेव करते समय अन्य अक्षर चेतावनी के साथ हटा दिए जाते हैं।
ऑर्डर
OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब 2C2P मान्य हस्ताक्षर के साथ परिणाम की पुष्टि कर दे। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।
Order Status After Payment: सफल भुगतान (2C2P स्टेटस 000)। डिफ़ॉल्ट: प्रक्रियाधीन।
Awaiting Payment Status: लंबित भुगतान (स्टेटस 001), उदाहरण के लिए नकद या बैंक भुगतान जो ग्राहक ने अभी तक नहीं किया। डिफ़ॉल्ट: भुगतान लंबित।
On Hold (Review) Status: 2C2P ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई। डिफ़ॉल्ट: भुगतान लंबित, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।
Cancelled Payment Status: लंबित भुगतान बाद में अस्वीकृत, रद्द या विफल हो गया (स्टेटस 002, 003, 999)। डिफ़ॉल्ट: रद्द।
उन्नत सेटिंग्स
Enable Logging: 2C2P इवेंट्स को OpenCart के लॉग फ़ोल्डर (storage/logs) में tc2p_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे tc2p_p_debug.old.log.php में ले जाया जाता है। कार्ड डेटा, Secret Keys, ग्राहकों के ईमेल या भुगतान टोकन कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद। बंद रहते हुए कुछ भी नहीं लिखा जाता, त्रुटियाँ भी नहीं।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। 2C2P के लेन-देन हमेशा रहते हैं, ताकि पुराने भुगतान का देर से आया परिणाम दोबारा इंस्टॉल करने के बाद भी संभाला जाए। डिफ़ॉल्ट: बंद।
आयात / निर्यात
Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। Secret Keys निर्यात नहीं होतीं।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई Secret Keys बनी रहती हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से 2C2P Payment)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, फिर भी बिना स्टेटस के। जब ग्राहक Confirm Order पर क्लिक करता है, तो पेज Thank you for your order. You will be redirected to 2C2P to complete your payment. दिखाता है और कुछ देर बाद ग्राहक को 2C2P भुगतान पेज पर भेज देता है। यदि ऐसा नहीं होता, तो ग्राहक Pay via 2C2P पर क्लिक करता है।
2C2P पेज पर ग्राहक आपके 2C2P खाते में सक्षम किसी भी विधि से भुगतान कर सकता है, जैसे कार्ड, ई-वॉलेट, QR भुगतान, इंटरनेट बैंकिंग या नकद भुगतान। एक्सटेंशन ऑर्डर की मुद्रा में ऑर्डर की कुल राशि, ग्राहक का ईमेल और ऑर्डर में मौजूद उत्पादों के नाम भेजता है। भुगतान 24 घंटे के भीतर पूरा किया जा सकता है। Confirm Order पर हर क्लिक एक नया प्रयास शुरू करता है, जिसका अपना 2C2P ऑर्डर ID होता है, क्योंकि 2C2P एक ही ऑर्डर ID को दो बार स्वीकार नहीं करता।
2C2P परिणाम दो बार बताता है: ग्राहक का ब्राउज़र स्टोर पर लौटता है, और 2C2P सर्वर-से-सर्वर सूचना भेजता है। दोनों को एक ही तरीके से संभाला जाता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब 2C2P उसे मान्य हस्ताक्षर के साथ पुष्टि कर दे। परिणाम भुगतान से भी मेल खाना चाहिए: 2C2P ऑर्डर ID आपके स्टोर द्वारा जारी किया गया होना चाहिए, और प्रयास के Merchant ID और यादृच्छिक टोकन की जाँच होती है। बिना मान्य हस्ताक्षर वाले परिणाम अस्वीकार किए जाते हैं। स्टोर मेंटेनेंस मोड में होने पर भी सूचना काम करती है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है। OpenCart 4 पर एक्सटेंशन इसके लिए एक startup action जोड़ता है, जो 2C2P के हस्ताक्षरित परिणामों को आगे जाने देता है।
सफल भुगतान के बाद ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है, जिसमें Your 2C2P payment has been received. लिखा होता है। लंबित भुगतान के लिए पेज Your 2C2P payment is pending (for example a cash or bank payment that is not made yet). The order will be processed as soon as 2C2P confirms the payment. दिखाता है। समीक्षाधीन ऑर्डर के लिए यह Your payment was received and is being reviewed by the shop. दिखाता है।
यदि भुगतान 2C2P पेज पर पूरा नहीं हुआ या रद्द हो गया, तो ऑर्डर बिना स्टेटस के रहता है। ग्राहक Payment was not completed. Please try again or choose a different payment method. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है, और ग्राहक दोबारा भुगतान कर सकता है या कोई दूसरी भुगतान विधि चुन सकता है। यदि परिणाम की पुष्टि नहीं हो सकती, तो ग्राहक को We could not confirm the payment result. If your account was charged, please contact us before paying again. दिखता है। यदि भुगतान शुरू ही नहीं हो सकता, उदाहरण के लिए ऑर्डर की मुद्रा समर्थित न होने या ऑर्डर की कुल राशि शून्य होने के कारण, तो ग्राहक Confirm Order चरण पर ही रहता है और उसे This payment method is currently unavailable for this order. Please contact us or choose another payment method. दिखता है।
यदि ऑर्डर का पहले से कोई स्टेटस है (भुगतान किया हुआ, या लंबित भुगतान की प्रतीक्षा में), तो दूसरा भुगतान फ़ॉर्म नहीं बनता। ग्राहक को ऑर्डर सफलता पेज पर भेज दिया जाता है।
OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जो संदेश बताते हैं कि भुगतान पूरा नहीं हुआ या उसकी पुष्टि नहीं हो सकी, वे चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है: विफल भुगतान के बाद ग्राहक उसी ऑर्डर का नए प्रयास के साथ भुगतान करता है (जैसे SHOP1123A2 जैसा नया 2C2P ऑर्डर ID)। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए लंबित भुगतान रद्द हुआ, या आपने ऑर्डर रद्द किया), तो ग्राहक Payment was not completed. Please try again or choose a different payment method. के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि ऑर्डर किसी भुगतान के बाद बंद हुआ, या उसका पहले से कोई स्टेटस है जो किसी दूसरी कार्ट के भुगतान से आया है, तो संदेश This order can no longer be paid. Please confirm your order again. होता है। भुगतान किया हुआ ऑर्डर किसी दूसरी कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नई कार्ट माना जाता है, जिसे अपना अलग भुगतान चाहिए।
इस एक्सटेंशन में OpenCart से रिफ़ंड, सेव किए गए कार्ड, आवर्ती भुगतान या सब्सक्रिप्शन, आपकी साइट पर कार्ड फ़ील्ड, और 2C2P PGW 4.x API का समर्थन नहीं है।
ऑर्डर
ऑर्डर स्टेटस
No status (missing order): ग्राहक को 2C2P पर भेजा गया और अभी तक कोई परिणाम नहीं आया, या भुगतान विफल हो गया। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Order Status After Payment (default Processing): 2C2P ने सफल भुगतान बताया। नोट में 2C2P लेन-देन, अनुमोदन कोड, तारीख और भुगतान चैनल दिखता है।
Awaiting Payment Status (default Pending): भुगतान 2C2P पर लंबित है, उदाहरण के लिए नकद भुगतान जो ग्राहक ने अभी तक नहीं किया। जब 2C2P भुगतान बताता है, तो ऑर्डर Order Status After Payment पर चला जाता है। OpenCart इस बदलाव की सूचना ग्राहक को देता है।
On Hold (Review) Status (default Pending): 2C2P ने ऑर्डर की कुल राशि से अलग राशि या मुद्रा बताई। नोट में प्राप्त और अपेक्षित मान दिखते हैं। 2C2P पोर्टल में ऑर्डर और लेन-देन जाँचें।
Cancelled Payment Status (default Canceled): लंबित भुगतान बाद में अस्वीकृत, रद्द या विफल हो गया। नोट में स्टेटस और कारण दिखते हैं। किसी पुराने प्रयास का विफल परिणाम उस ऑर्डर को रद्द नहीं करता जो किसी दूसरे प्रयास की प्रतीक्षा कर रहा है।
भुगतान किया हुआ ऑर्डर बाद के परिणाम से कभी नहीं बदलता, और दोहराया गया पुराना परिणाम रद्द हुए ऑर्डर को फिर से नहीं खोलता। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदला जाता। एक नोट आपसे उसकी जाँच करने और 2C2P मर्चेंट पोर्टल में डुप्लिकेट राशि रिफ़ंड करने के लिए कहता है। OpenCart 3 हर बार नया ऑर्डर बनाता है जब ग्राहक Confirm Order चरण पर पहुँचता है, इसलिए एक ही कार्ट के कई ऑर्डर हो सकते हैं (OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है, लेकिन कोई पिछला ऑर्डर या दूसरा ब्राउज़र टैब फिर भी वही कार्ट रख सकता है)। उनमें से कोई एक भुगतान किया हुआ या लंबित भुगतान की प्रतीक्षा वाला बनते ही, उसी कार्ट के लिए कोई नया भुगतान शुरू नहीं होता, और उसी कार्ट के किसी दूसरे ऑर्डर के लिए अभी भी आने वाला भुगतान उसे नहीं बदलता। भुगतान किए गए ऑर्डर को डुप्लिकेट रिफ़ंड करने का नोट मिलता है।
OpenCart 4 पर चेकआउट का बिना भुगतान वाला ऑर्डर Voided स्टेटस पा सकता है, जिसे OpenCart 4 तब सेट करता है जब ग्राहक Confirm Order चरण पर वापस आता है। एक्सटेंशन ऐसे ऑर्डर को बिना स्टेटस वाला ऑर्डर मानता है, और बाद में आया भुगतान उसकी पुष्टि कर देता है।
नोट्स ऑर्डर के History की प्रविष्टियाँ हैं, जिन्हें ग्राहक नहीं देखता।
VibeFox 2C2P Payment टैब
Sales > Orders में 2C2P से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox 2C2P Payment टैब में 2C2P ऑर्डर ID दिखता है (सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ), साथ ही लेन-देन, भुगतान स्टेटस, प्राप्त राशि, चैनल, अनुमोदन कोड, मास्क्ड कार्ड नंबर, तारीख, चैनल प्रतिक्रिया, API संस्करण और ऑर्डर के 2C2P notes। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
OpenCart से रिफ़ंड समर्थित नहीं हैं। 2C2P मर्चेंट पोर्टल में भुगतान रिफ़ंड करें, फिर OpenCart में रिफ़ंड को मैन्युअली दर्ज करें, उदाहरण के लिए ऑर्डर स्टेटस बदलकर।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox 2C2P Payment, Extensions > Extensions > Payments > VibeFox 2C2P Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क्ड कुंजी, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन दिखाता है: Check now (स्टेटस दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-payment-2c2p वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। केवल इस एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो एक्सटेंशन अंतिम ज्ञात स्टेटस पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन का स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को 2C2P नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में भुगतान विधि अब भी दिखती है, जिस पर (unlicensed — visible to admins only) का चिह्न होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट करके परख सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू किए गए भुगतान अब भी पुष्ट होते हैं।
लाइसेंस समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्टेटस अपने-आप दोबारा जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक दिन में एक बार, और उसके बाद हफ़्ते में एक बार। cron जॉब की ज़रूरत नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर 2C2P दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में Merchant ID और Secret Key हैं: सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, लाइव मोड में लाइव फ़ील्ड। जाँचें कि ग्राहक की मुद्रा समर्थित है। जब क्रेडेंशियल गायब हों या डिफ़ॉल्ट मुद्रा समर्थित न हो, तो सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रह गया: आपके स्टोर तक कोई मान्य परिणाम नहीं पहुँचा। जाँचें कि जिस मोड में भुगतान हुआ, उसका Merchant ID और Secret Key 2C2P खाते से मेल खाते हैं, और Redirect API version आपके खाते से मेल खाता है। गलत हस्ताक्षर वाला या किसी दूसरे Merchant ID का परिणाम अस्वीकार किया जाता है। Enable Logging चालू करें और Log फ़ील्ड में hash या Merchant ID संदेश खोजें। यह भी जाँचें कि आपका सर्वर 2C2P से बैकएंड सूचना URL पर आने वाले अनुरोध स्वीकार करता है।
बैकएंड सूचना 400 FAIL का उत्तर देती है: परिणाम में फ़ील्ड गायब हैं, हस्ताक्षर गलत है, Merchant ID दूसरा है, या टोकन गलत है। 404 FAIL का अर्थ है कि 2C2P ऑर्डर ID इस स्टोर द्वारा जारी नहीं किया गया था। 503 RETRY का अर्थ है कि उसी समय कोई दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था, या प्रसंस्करण विफल हो गया; 2C2P बाद में फिर प्रयास करेगा। कारण देखने के लिए Enable Logging चालू करें।
सूचना URL ब्राउज़र में FAIL दिखाता है: यह सामान्य है। यह URL केवल 2C2P के POST अनुरोध स्वीकार करता है।
2C2P कहता है कि ऑर्डर ID पहले से मौजूद है: 2C2P एक ही ऑर्डर ID को दो बार स्वीकार नहीं करता। यह तब होता है जब कई स्टोर एक 2C2P खाता साझा करते हैं, या सैंडबॉक्स में, जहाँ डेमो मर्चेंट खाते कई डेवलपर साझा करते हैं। एक अनूठा Order ID prefix सेट करें।
भुगतान हुआ है, लेकिन ऑर्डर लंबित भुगतान या समीक्षा स्टेटस में है: या तो भुगतान 2C2P पर अब भी लंबित है (उदाहरण के लिए नकद भुगतान जो ग्राहक ने अभी नहीं किया), या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई। VibeFox 2C2P Payment टैब के नोट और 2C2P पोर्टल का लेन-देन जाँचें।
ग्राहक को This payment method is currently unavailable for this order दिखता है: ऑर्डर की मुद्रा समर्थित नहीं है, वर्तमान मोड का Merchant ID या Secret Key खाली है, या ऑर्डर की कुल राशि शून्य है।
ग्राहक को This payment method is not available. Please reload the checkout page.: दिखता है: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई। ग्राहक चेकआउट पेज रीलोड करे।
सेव करते समय Please enter your live Merchant ID या Please enter your live Secret Key on save दिखता है: सैंडबॉक्स मोड बंद है और कोई लाइव फ़ील्ड खाली है। लाइव क्रेडेंशियल दर्ज करें या Sandbox Mode चालू रखें।
डेवलपर्स के लिए: भुगतान फ़ॉर्म पर हस्ताक्षर करने से पहले एक्सटेंशन फ़ॉर्म फ़ील्ड और ऑर्डर के साथ OpenCart इवेंट tc2p_p_payment_fields ट्रिगर करता है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox 2C2P Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट्स और उसका startup action, जो maintenance mode में 2C2P के परिणामों को आगे जाने देता है)। यदि Delete Data on Uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, सैंडबॉक्स मोड, क्रेडेंशियल, भुगतान पेज सेटिंग्स, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। 2C2P लेन-देन हमेशा रखे जाते हैं, ताकि पुराने भुगतान का देर से आया परिणाम दोबारा इंस्टॉल करने के बाद भी संभाला जाए। मौजूदा ऑर्डर अपने भुगतान नोट बनाए रखते हैं।
OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox 2C2P Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
2C2P उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन 2C2P से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।