VibeFox 2C2P for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 6.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन एडमिन क्षेत्र में एक सूचना दिखाता है, और भुगतान विधि लोड नहीं होती।
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 से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP द्वारा wcp_2c2p_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > 2C2P > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. सैंडबॉक्स Merchant ID और Secret Key दर्ज करें, Enable/Disable चालू करें और एक टेस्ट ऑर्डर दें।
6. तैयार होने पर लाइव क्रेडेंशियल दर्ज करें और Sandbox Mode का निशान हटाएँ।
रिटर्न और सूचना URL हर भुगतान के साथ भेजे जाते हैं। 2C2P पोर्टल में कुछ भी कॉन्फ़िगर करना आवश्यक नहीं है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > 2C2P। सैंडबॉक्स मोड चालू होने पर फ़ील्ड के ऊपर पेज Sandbox mode is active. No real transactions will be processed. दिखाता है। यह तब भी चेतावनी देता है जब गेटवे चालू हो पर मौजूदा मोड का Merchant ID या Secret Key खाली हो, और जब स्टोर मुद्रा समर्थित न हो। दोनों स्थितियों में चेकआउट पर भुगतान विधि छिपी रहती है। जब Sandbox Mode बंद करके सेटिंग्स सहेजते हैं और लाइव Merchant ID या Secret Key खाली हों, तो प्लगइन उन्हें माँगता है।
सामान्य
Enable/Disable: Enable 2C2P Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। डिफ़ॉल्ट: 2C2P Payment।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P। सैंडबॉक्स मोड में इसमें (TEST MODE) जोड़ा जाता है।
टेस्ट मोड (सैंडबॉक्स)
Sandbox Mode: Enable sandbox / test mode भुगतान को नीचे दिए सैंडबॉक्स क्रेडेंशियल के साथ 2C2P सैंडबॉक्स (demo2.2c2p.com) पर भेजता है। डिफ़ॉल्ट: on। असली भुगतान लेने के लिए निशान हटाएँ।
Sandbox Merchant ID: आपका सैंडबॉक्स 2C2P Merchant ID।
Sandbox Secret Key: आपकी सैंडबॉक्स 2C2P Secret Key।
लाइव API क्रेडेंशियल
सैंडबॉक्स मोड बंद होने पर उपयोग होते हैं।
Merchant ID: आपका लाइव 2C2P Merchant ID। सैंडबॉक्स मोड बंद होने पर आवश्यक।
Secret Key: आपकी लाइव 2C2P Secret Key। सैंडबॉक्स मोड बंद होने पर आवश्यक। कुंजी वैसे ही सहेजी जाती है जैसी दर्ज की गई हो, जिसमें उद्धरण चिह्न और बैकस्लैश भी शामिल हैं।
भुगतान पेज
यह सेक्शन संदर्भ के लिए फ़्रंटएंड रिटर्न URL (https://your-site/?wc-api=tc2p_p) और बैकएंड सूचना URL (https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1) दिखाता है। ये हर भुगतान के साथ अपने-आप भेजे जाते हैं।
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: Log 2C2P events WooCommerce > Status > Logs में, source wcp_2c2p_payment के साथ लिखता है। कार्ड डेटा या Secret Key कभी लॉग नहीं होते। डिफ़ॉल्ट: off।
Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted। डिफ़ॉल्ट: off।
चेकआउट
ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से 2C2P Payment) और ऑर्डर देता है। अगला पेज Thank you for your order. You will be redirected to 2C2P to complete your payment. दिखाता है और कुछ क्षण बाद ग्राहक को 2C2P भुगतान पेज पर भेज देता है। अगर ऐसा न हो, तो ग्राहक Pay via 2C2P पर क्लिक करता है। पेज पर एक Cancel order बटन भी होता है।
2C2P पेज पर ग्राहक आपके 2C2P खाते में सक्षम किसी भी विधि से भुगतान करता है, जैसे कार्ड, ई-वॉलेट, QR भुगतान, इंटरनेट बैंकिंग या नकद भुगतान। प्लगइन ऑर्डर की कुल राशि ऑर्डर की मुद्रा में, ग्राहक का बिलिंग ईमेल और ऑर्डर किए गए उत्पादों के नाम भेजता है। भुगतान 24 घंटे के भीतर पूरा किया जा सकता है।
2C2P परिणाम दो बार बताता है: ग्राहक का ब्राउज़र दुकान पर लौटता है, और 2C2P सर्वर-से-सर्वर सूचना भेजता है। दोनों को एक ही तरह से संभाला जाता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब 2C2P वैध हस्ताक्षर के साथ उसकी पुष्टि करे। परिणाम ऑर्डर का ही होना चाहिए: मर्चेंट ID, ऑर्डर कुंजी, ऑर्डर ID और भुगतान विधि की जाँच होती है। बिना वैध हस्ताक्षर वाले परिणाम अस्वीकार होते हैं।
सफल या लंबित भुगतान के बाद ग्राहक ऑर्डर प्राप्त पेज पर पहुँचता है और कार्ट खाली हो जाता है। यदि भुगतान पूरा नहीं हुआ, तो ग्राहक संदेश 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. दिखता है।
यह भुगतान विधि क्लासिक चेकआउट और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन में WooCommerce से रिफ़ंड नहीं है, कोई सेव किए गए कार्ड नहीं हैं, कोई आवर्ती भुगतान या WooCommerce Subscriptions नहीं हैं, आपकी साइट पर कोई कार्ड फ़ील्ड नहीं हैं, और 2C2P PGW 4.x API का समर्थन नहीं है।
ऑर्डर
ऑर्डर की स्थितियाँ
Pending payment: ग्राहक को 2C2P भेजा गया और अभी तक कोई परिणाम नहीं आया।
Processing or Completed: 2C2P ने सफल भुगतान की सूचना दी (स्थिति 000)। WooCommerce प्रोसेसिंग सेट करता है, या केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर के लिए पूर्ण। ऑर्डर नोट में 2C2P लेन-देन, अनुमोदन कोड, तारीख और भुगतान चैनल दिखता है। लेन-देन ID 2C2P लेन-देन संदर्भ है।
On hold: 2C2P पर भुगतान लंबित है (स्थिति 001), उदाहरण के लिए नकद भुगतान जो ग्राहक ने अभी नहीं किया। जब 2C2P भुगतान की सूचना देता है, तब ऑर्डर भुगतान किया हुआ बन जाता है। ऑर्डर होल्ड पर तब भी जाता है जब 2C2P ऑर्डर की कुल राशि से अलग राशि या मुद्रा की सूचना दे। ऑर्डर नोट में प्राप्त और अपेक्षित मान दिखते हैं। 2C2P पोर्टल में ऑर्डर और लेन-देन जाँचें।
Cancelled: भुगतान अस्वीकार हुआ, ग्राहक ने रद्द किया या वह विफल हुआ (स्थितियाँ 002, 003, 999)। ऑर्डर नोट में स्थिति और कारण दिखते हैं।
भुगतान किए गए या रिफ़ंड किए गए ऑर्डर को बाद के किसी परिणाम से कभी नहीं बदला जाता, और दोहराया गया पुराना परिणाम आपके रद्द किए गए ऑर्डर को दोबारा नहीं खोलता।
रिफ़ंड
WooCommerce से रिफ़ंड समर्थित नहीं हैं। भुगतान 2C2P मर्चेंट पोर्टल में रिफ़ंड करें, फिर WooCommerce में मैनुअल रिफ़ंड बनाएँ।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > 2C2P के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key का उपयोग करें। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। स्लॉट अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर 2C2P ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग-इन स्टोर मैनेजर भुगतान विधि अब भी देखते हैं, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर और जाँच सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।
समस्या-निवारण
2C2P चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मौजूदा मोड में Merchant ID और Secret Key हैं: सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, लाइव मोड में लाइव फ़ील्ड। जाँचें कि स्टोर मुद्रा समर्थित है। सेटिंग्स पेज दोनों स्थितियों में चेतावनी दिखाता है।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: आपके स्टोर तक कोई वैध परिणाम नहीं पहुँचा। जाँचें कि मौजूदा मोड का Merchant ID और Secret Key उसी 2C2P खाते के हैं जिससे भुगतान हुआ, और Redirect API version आपके खाते से मेल खाता है। गलत हस्ताक्षर या किसी दूसरे Merchant ID वाला परिणाम अस्वीकार होता है। Enable Logging चालू करें और WooCommerce > Status > Logs में hash या merchant ID संदेश खोजें। यह भी जाँचें कि आपका सर्वर बैकएंड सूचना URL पर 2C2P के अनुरोध स्वीकार करता है।
2C2P कहता है कि ऑर्डर ID पहले से मौजूद है: 2C2P एक ही ऑर्डर ID दो बार स्वीकार नहीं करता। यह तब होता है जब कई दुकानें एक 2C2P खाता साझा करती हैं, या सैंडबॉक्स में, जहाँ डेमो मर्चेंट खाते कई डेवलपर साझा करते हैं। एक अनोखा Order ID prefix सेट करें।
भुगतान हुआ, पर ऑर्डर On hold है: या तो भुगतान 2C2P पर अब भी लंबित है (उदाहरण के लिए नकद भुगतान जो ग्राहक ने अभी नहीं किया), या भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई। ऑर्डर नोट और 2C2P पोर्टल में लेन-देन जाँचें।
ग्राहक को This payment method is currently unavailable for this order दिखता है: ऑर्डर की मुद्रा समर्थित नहीं है, या मौजूदा मोड का Merchant ID या Secret Key खाली है।
Please enter your live Merchant ID or Please enter your live Secret Key on save: सैंडबॉक्स मोड बंद है और लाइव फ़ील्ड खाली है। लाइव क्रेडेंशियल दर्ज करें, या Sandbox Mode चालू रखें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करें और फिर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स, ऑर्डरों पर संग्रहीत 2C2P डेटा और लॉग फ़ाइलें केवल तभी हटती हैं जब Delete Data on Uninstall चालू था। अन्यथा ये बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।
2C2P उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन 2C2P से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।