VibeFox 2C2P for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होगा।
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 से खरीदी जाती है। एक कुंजी केवल एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox 2C2P Payment खोजकर Configure पर क्लिक करें।
3. Configure पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी License key में दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. अपना सैंडबॉक्स Merchant ID और Secret Key दर्ज करें, Enable/Disable चालू करें, Save पर क्लिक करें और एक टेस्ट ऑर्डर दें।
5. तैयार होने पर लाइव क्रेडेंशियल दर्ज करें और Sandbox Mode बंद करें।
इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting 2C2P payment और 2C2P payment on hold। PrestaShop नई भुगतान मॉड्यूल को सभी मुद्राओं, देशों और ग्राहक समूहों के लिए सक्षम करता है। इसे Payment > Preferences में सीमित किया जा सकता है। वापसी और सूचना URL हर भुगतान के साथ भेजे जाते हैं। 2C2P पोर्टल में कुछ भी कॉन्फ़िगर नहीं करना पड़ता।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox 2C2P Payment > Configure। हर सेक्शन का अपना 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. दिखाता है। सेटिंग्स फिर भी सेव हो जाती हैं।
2C2P
Enable/Disable: Enable 2C2P Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सेव होता है। डिफ़ॉल्ट: 2C2P Payment।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P। सैंडबॉक्स मोड में इसमें (TEST MODE) जोड़ा जाता है।
टेस्ट मोड (सैंडबॉक्स)
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 Key दोबारा नहीं दिखाई जाती। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
सेव किए गए सीक्रेट हटाएँ: हटाने के लिए Sandbox Secret Key या Secret Key पर टिक लगाएँ और Save पर क्लिक करें। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।
परिणाम हमेशा उसी मोड के Merchant ID और Secret Key से जाँचे जाते हैं, जिसमें भुगतान किया गया था। सैंडबॉक्स मोड में शुरू किया गया भुगतान, लाइव पर स्विच करने के बाद भी सैंडबॉक्स कुंजी से जाँचा जाता है, और दूसरे मोड की कुंजी से हस्ताक्षरित परिणाम अस्वीकार किया जाता है।
भुगतान पेज
परिणाम URL: संदर्भ के लिए Frontend return URL और Backend notification URL दिखाता है। फ़्रेंडली URL के साथ ये इस रूप में दिखते हैं: https://your-shop/module/wcp_2c2p_payment/return और https://your-shop/module/wcp_2c2p_payment/notify, संभवतः /en/ जैसे भाषा कोड के साथ। ये हर भुगतान के साथ अपने आप भेजे जाते हैं।
Payment Page Language: 2C2P भुगतान पेज की भाषा। डिफ़ॉल्ट: English।
Redirect API version: 8.5 ही रखें, जब तक 2C2P ने यह न बताया हो कि आपका खाता अब भी पुराने संस्करण 7.0 (SHA-1 हस्ताक्षर) का उपयोग करता है। बदलाव से पहले शुरू हुए भुगतानों के परिणाम अब भी जाँचे जाते हैं।
Order ID prefix: वैकल्पिक, केवल अक्षर और अंक (अधिकतम 10), जैसे SHOP1। 2C2P ऐसा ऑर्डर ID अस्वीकार करता है जो वह पहले देख चुका है। जब कई दुकानें एक 2C2P खाता साझा करें, और सैंडबॉक्स में जहाँ टेस्ट मर्चेंट खाते साझा होते हैं, तब एक अनूठा उपसर्ग सेट करें। सेव करते समय अन्य अक्षर चेतावनी के साथ हटा दिए जाते हैं।
उन्नत सेटिंग्स
Enable Logging: 2C2P इवेंट्स को मॉड्यूल फ़ोल्डर में logs/tc2p_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कार्ड डेटा, Secret Key, ग्राहक ईमेल या भुगतान टोकन कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद। बंद रहने पर त्रुटियों समेत कुछ भी नहीं लिखा जाता।
Log: लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर मॉड्यूल हटाने पर गेटवे सेटिंग्स और लॉग हट जाते हैं। 2C2P लेन-देन, ऑर्डर और मॉड्यूल के ऑर्डर स्टेटस हमेशा बने रहते हैं, ताकि मॉड्यूल फिर से इंस्टॉल करने के बाद भी पुराने भुगतान का देर से आया परिणाम संभाला जा सके। डिफ़ॉल्ट: बंद।
चेकआउट
भुगतान के चरण में ग्राहक भुगतान विधि (डिफ़ॉल्ट रूप से 2C2P Payment) चुनता है और पुष्टि करता है। अगला पेज Thank you for your order. You will be redirected to 2C2P to complete your payment. दिखाता है और कुछ क्षण बाद ग्राहक को 2C2P के भुगतान पेज पर भेज देता है। यदि ऐसा न हो, तो ग्राहक Pay via 2C2P पर क्लिक करता है। पेज पर Back to checkout बटन भी है। इस समय तक कोई ऑर्डर मौजूद नहीं होता।
2C2P पेज पर ग्राहक आपके 2C2P खाते में सक्षम किसी भी विधि से भुगतान करता है, जैसे कार्ड, ई-वॉलेट, QR भुगतान, इंटरनेट बैंकिंग या नकद भुगतान। मॉड्यूल कार्ट का कुल योग (कार्ट मुद्रा में), ग्राहक का ईमेल और कार्ट में उत्पादों के नाम भेजता है। भुगतान 24 घंटे के भीतर पूरा किया जा सकता है। हर भुगतान प्रयास को अपना 2C2P ऑर्डर ID मिलता है (वैकल्पिक उपसर्ग के बाद कार्ट नंबर और प्रयास नंबर), क्योंकि 2C2P एक ही ऑर्डर ID दो बार स्वीकार नहीं करता।
2C2P परिणाम दो बार बताता है: ग्राहक का ब्राउज़र स्टोर पर लौटता है, और 2C2P सर्वर-से-सर्वर सूचना भेजता है। दोनों को एक ही तरह से संभाला जाता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब 2C2P मान्य हस्ताक्षर के साथ उसकी पुष्टि कर दे। परिणाम भुगतान का ही होना चाहिए: 2C2P ऑर्डर ID आपकी दुकान द्वारा जारी किया गया होना चाहिए, और Merchant ID तथा प्रयास का यादृच्छिक टोकन जाँचे जाते हैं। मान्य हस्ताक्षर के बिना आए परिणाम अस्वीकार कर दिए जाते हैं। स्टोर के मेंटेनेंस मोड में होने पर भी सूचना काम करती है, और आपके स्टोर के देश-प्रतिबंध से इसे नहीं रोका जाता।
सफल भुगतान के बाद ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है, जिसमें 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. दिखाता है। यदि लंबित भुगतान बाद में रद्द हो जाए, तो Your 2C2P payment was not completed. Please contact us about this order. दिखता है।
यदि भुगतान पूरा नहीं हुआ, तो कोई ऑर्डर नहीं बनता। ग्राहक 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. दिखता है। यदि भुगतान शुरू ही न हो सके, उदाहरण के लिए कार्ट की मुद्रा समर्थित न होने के कारण, तो संदेश This payment method is currently unavailable for this order. Please contact us or choose another payment method. होता है।
यदि कार्ट में पहले से कोई ऑर्डर है (भुगतान किया हुआ, या लंबित भुगतान की प्रतीक्षा में), तो दूसरा भुगतान फ़ॉर्म नहीं बनता। ग्राहक को ऑर्डर पुष्टि पेज पर भेजा जाता है।
मॉड्यूल में PrestaShop से रिफ़ंड, सेव किए गए कार्ड, आवर्ती भुगतान या सदस्यता, आपकी साइट पर कार्ड फ़ील्ड की सुविधा नहीं है, और 2C2P PGW 4.x API का समर्थन नहीं है।
ऑर्डर
ऑर्डर स्टेटस
No order yet: ग्राहक को 2C2P पर भेजा गया था और अभी तक कोई परिणाम नहीं आया, या भुगतान विफल हुआ। केवल कार्ट मौजूद है।
Payment accepted: 2C2P ने सफल भुगतान की सूचना दी (स्टेटस 000)। भुगतान को 2C2P लेन-देन संदर्भ के साथ लेन-देन ID के रूप में दर्ज किया जाता है। ऑर्डर पर एक निजी नोट में 2C2P लेन-देन, स्वीकृति कोड, तारीख और भुगतान चैनल दिखते हैं।
Awaiting 2C2P payment: भुगतान 2C2P पर लंबित है (स्टेटस 001), उदाहरण के लिए नकद भुगतान जिसे ग्राहक ने अभी तक नहीं किया है। जब 2C2P भुगतान की सूचना देता है, तो ऑर्डर Payment accepted में चला जाता है।
2C2P payment on hold: 2C2P ने ऑर्डर के कुल योग से अलग राशि या मुद्रा की सूचना दी। नोट में प्राप्त और अपेक्षित मान दिखते हैं। 2C2P पोर्टल में ऑर्डर और लेन-देन की जाँच करें।
Canceled: लंबित भुगतान बाद में अस्वीकार, रद्द या विफल हुआ (स्टेटस 002, 003, 999)। नोट में स्टेटस और कारण दिखते हैं। किसी पिछले प्रयास का विफल परिणाम, किसी दूसरे प्रयास से बने ऑर्डर को रद्द नहीं करता।
भुगतान किया हुआ ऑर्डर बाद के परिणाम से कभी नहीं बदलता, और दोहराया गया पुराना परिणाम रद्द किए गए ऑर्डर को फिर से नहीं खोलता। यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे इसकी जाँच करने और डुप्लिकेट राशि को 2C2P मर्चेंट पोर्टल में रिफ़ंड करने के लिए कहता है।
2C2P भुगतान ब्लॉक
ऑर्डर पेज पर एक 2C2P payment ब्लॉक दिखता है, जिसमें 2C2P ऑर्डर ID, लेन-देन, भुगतान स्टेटस, चैनल, स्वीकृति कोड, मास्क किया गया कार्ड नंबर, तारीख, चैनल का उत्तर और प्राप्त राशि होती है, और सैंडबॉक्स भुगतानों के लिए एक Sandbox बैज।
रिफ़ंड
PrestaShop से रिफ़ंड समर्थित नहीं हैं। भुगतान को 2C2P मर्चेंट पोर्टल में रिफ़ंड करें, फिर रिफ़ंड को PrestaShop में मैन्युअल रूप से दर्ज करें।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox 2C2P Payment नाम का लाइसेंस ब्लॉक Modules > Module Manager > VibeFox 2C2P Payment > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, साथ में स्टेटस (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन: Check now स्टेटस फिर से जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए और Remove key इस दुकान से कुंजी हटाने के लिए। इनके नीचे पंक्ति Product: presta-payment-2c2p और लिंक 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को 2C2P नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू किया जाता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।
लाइसेंस की अवधि समाप्त होने पर मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्टेटस अपने आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर सप्ताह एक बार। कोई cron जॉब आवश्यक नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर 2C2P दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड में Merchant ID और Secret Key भरे हुए हैं: सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, लाइव मोड में लाइव फ़ील्ड। जाँचें कि कार्ट की मुद्रा समर्थित है। दोनों स्थितियों में सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक समूह के लिए अनुमति प्राप्त है।
भुगतान हो गया, लेकिन ऑर्डर नहीं बना: आपके स्टोर तक कोई मान्य परिणाम नहीं पहुँचा। जाँचें कि जिस मोड में भुगतान हुआ था, उसका Merchant ID और Secret Key आपके 2C2P खाते से मेल खाते हैं, और Redirect API version आपके खाते से मेल खाता है। गलत हस्ताक्षर वाला या किसी अन्य Merchant ID का परिणाम अस्वीकार होता है। Enable Logging चालू करें और Log फ़ील्ड में hash या Merchant ID से जुड़े संदेश देखें। यह भी जाँचें कि आपका सर्वर 2C2P से backend सूचना URL पर आने वाले अनुरोध स्वीकार करता है।
Backend सूचना 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 सेट करें।
भुगतान हुआ, लेकिन ऑर्डर Awaiting 2C2P payment या 2C2P payment on hold में है: या तो भुगतान अब भी 2C2P पर लंबित है (उदाहरण के लिए नकद भुगतान जिसे ग्राहक ने अभी तक नहीं किया), या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती। ऑर्डर नोट और 2C2P पोर्टल में लेन-देन की जाँच करें।
ग्राहक को This payment method is currently unavailable for this order दिखता है: कार्ट की मुद्रा समर्थित नहीं है, वर्तमान मोड का Merchant ID या Secret Key खाली है, या कार्ट का कुल योग शून्य है।
सेव करते समय Please enter your live Merchant ID या Please enter your live Secret Key दिखता है: सैंडबॉक्स मोड बंद है और एक लाइव फ़ील्ड खाली है। लाइव क्रेडेंशियल दर्ज करें, या Sandbox Mode चालू रखें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox 2C2P Payment के बगल का मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। यदि Delete Data on Uninstall चालू है, तो गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। यदि यह बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। 2C2P लेन-देन और ऑर्डर स्टेटस Awaiting 2C2P payment तथा 2C2P payment on hold हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।
2C2P उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल 2C2P से संबद्ध नहीं है और इसे 2C2P का समर्थन प्राप्त नहीं है।