VibeFox PayPlug for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 6.0 या बाद का संस्करण।

WooCommerce: 7.0 या बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।

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

मुद्रा और राशियाँ: यूरो (EUR), प्रति भुगतान 0.99 से 20,000.00 तक, जो PayPlug की डिफ़ॉल्ट सीमाएँ हैं। किसी अन्य मुद्रा में या इन सीमाओं से बाहर होने पर भुगतान विधि छिपा दी जाती है।

PayPlug खाता: आपको अपने PayPlug खाते की सीक्रेट की चाहिए: टेस्ट की (sk_test_...) और/या लाइव की (sk_live_...)। कोई और की आवश्यकता नहीं है, और PayPlug में कोई सूचना सेट करनी नहीं पड़ती। सूचनाएँ प्राप्त करने के लिए आपकी साइट इंटरनेट से पहुँचने योग्य होनी चाहिए; अन्यथा ग्राहक के PayPlug से लौटने पर ऑर्डर अपडेट होते हैं।

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

इंस्टॉलेशन

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

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

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

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

5. PayPlug पोर्टल से अपनी सीक्रेट की कॉपी करके यहाँ डालें (देखें कॉन्फ़िगरेशन)।

6. Enable/Disable चालू करें और सहेजें। Test Mode चालू रखकर एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए उसे बंद करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > PayPlug। फ़ील्ड के ऊपर पेज चेतावनी देता है जब भुगतान विधि सक्रिय है लेकिन वर्तमान मोड की सीक्रेट की खाली है, और जब स्टोर की मुद्रा EUR नहीं है। दोनों स्थितियों में भुगतान विधि चेकआउट पर छिपा दी जाती है। भुगतान विधियों की सूची में PayPlug टेस्ट मोड में एक टेस्ट मोड बैज दिखाता है, और जब तक वर्तमान मोड में सीक्रेट की नहीं होती, तब तक उसे सेटअप की आवश्यकता वाला चिह्नित किया जाता है।

चेकआउट

Enable/Disable: Enable PayPlug Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: off।

Title: चेकआउट पर ग्राहकों को दिखने वाला भुगतान विधि का नाम। डिफ़ॉल्ट: PayPlug।

Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely by card via PayPlug।

API कुंजियाँ

अपनी सीक्रेट की PayPlug पोर्टल में Developers > API keys के अंतर्गत मिलेंगी। इस भाग में वह सूचना URL भी दिखता है जो प्लगइन हर भुगतान के साथ भेजता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/ppg_payplug_webhook/। PayPlug में कोई सूचना सेटअप करने की आवश्यकता नहीं है।

Test Mode: Enable test mode नए भुगतानों के लिए टेस्ट सीक्रेट की का उपयोग करता है। कोई असली भुगतान प्रोसेस नहीं होता। दूसरे मोड में किए गए भुगतान स्टेटस जाँच और रिफ़ंड के लिए अपने मोड की की का उपयोग करते रहते हैं। डिफ़ॉल्ट: on।

Test Secret Key: आपकी PayPlug टेस्ट सीक्रेट की। यह sk_test_ से शुरू होती है।

Live Secret Key: आपकी PayPlug लाइव सीक्रेट की। यह sk_live_ से शुरू होती है।

गलत प्रीफ़िक्स वाली की सहेजी नहीं जाती। पेज उदाहरण के लिए Test Secret Key "sk_test_" से शुरू होनी चाहिए। पिछला मान रखा गया। दिखाता है।

ऑर्डर

Order Status After Payment: सफल भुगतान के बाद सेट होने वाला ऑर्डर स्टेटस। स्टेटस एक ही बार में सेट होता है, किसी दूसरे स्टेटस बदलाव की आवश्यकता नहीं होती।

उन्नत

Logging: Enable debug logging API कॉल और सूचनाएँ WooCommerce > Status > Logs में लॉग करता है, स्रोत wcp_payplug_gateway। त्रुटियाँ हमेशा लॉग होती हैं। सीक्रेट की, कार्ड डेटा और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: off।

Delete Data on Uninstall: Remove all plugin data when uninstalling। चेक होने पर प्लगइन हटाते समय उसकी सेटिंग्स और लॉग हटा दिए जाते हैं। ऑर्डर पर सहेजे गए PayPlug भुगतान ID सुरक्षित रहते हैं। डिफ़ॉल्ट: off।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब PayPlug उसकी पुष्टि करता है: जब सूचना आती है और जब ग्राहक लौटता है, तब प्लगइन PayPlug API से भुगतान पढ़ता है। सफल भुगतान ग्राहक को ऑर्डर प्राप्ति पेज पर ले जाता है।

यदि ग्राहक PayPlug पेज पर रद्द कर देता है, तो भुगतान पेज PayPlug पर बंद हो जाता है, ताकि बाद में गलती से भुगतान न हो सके। ग्राहक एक संदेश के साथ Pay for order पेज पर लौटता है, जैसे आपने PayPlug भुगतान रद्द किया। आप फिर से प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं।, PayPlug भुगतान सत्र समाप्त हो गया है। कृपया फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें। या PayPlug भुगतान विफल हो गया। कृपया फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें।

जब ग्राहक वही ऑर्डर फिर से भुगतान करता है, तो प्लगइन पहले पिछले प्रयास की जाँच करता है। यदि इस बीच उसका भुगतान हो चुका है, तो बिना नए भुगतान के ऑर्डर पूरा हो जाता है। यदि वह उसी राशि के लिए अब भी खुला है, तो वही भुगतान पेज दोबारा इस्तेमाल होता है। अन्यथा पुराना पेज PayPlug पर बंद कर दिया जाता है और नया भुगतान बनाया जाता है।

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

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

भुगतान तुरंत कैप्चर किए जाते हैं। इस प्लगइन में Oney इंस्टॉलमेंट, Bancontact, Apple Pay या American Express, वन-क्लिक सेव्ड कार्ड, एम्बेडेड भुगतान फ़ॉर्म, सब्सक्रिप्शन और डिफ़र्ड कैप्चर नहीं हैं।

ऑर्डर और रिफ़ंड

Order statuses

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

Processing or Completed: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment का पालन करता है। ऑर्डर नोट में PayPlug भुगतान और उसका मोड दिखता है। लेन-देन ID PayPlug भुगतान ID (pay_...) है।

On hold: भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती (नोट amount/currency mismatch); या स्टोर लाइव मोड में होने पर टेस्ट भुगतान किया गया, इसलिए पैसे नहीं मिले; या जो ऑर्डर रद्द हो चुका था, उसके लिए भुगतान आया; या भुगतान ऑथराइज़ हुआ है लेकिन कैप्चर नहीं हुआ है (PayPlug पोर्टल में कैप्चर करें; जब PayPlug उसे भुगतान किया हुआ बताएगा, तब ऑर्डर भुगतान किया हुआ चिह्नित होगा)। ऑर्डर नोट बताता है कि क्या जाँचना है।

Failed: भुगतान लंबित ऑर्डर का नवीनतम भुगतान प्रयास विफल हुआ या रद्द हो गया। किसी पुराने प्रयास की विफलता ऑर्डर को नहीं बदलती। ग्राहक फिर से भुगतान कर सकता है।

यदि पहले से भुगतान किए हुए ऑर्डर का दूसरा प्रयास भी भुगतान हो जाता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे PayPlug पोर्टल में डुप्लिकेट भुगतान का रिफ़ंड करने के लिए कहता है।

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via PayPlug पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस भुगतान पर भेजा जाता है जिसने वास्तव में ऑर्डर का भुगतान किया था, और उस मोड (टेस्ट या लाइव) की सीक्रेट की से जिसमें वह किया गया था; इसलिए वह की सेट होनी चाहिए। यदि PayPlug रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड PayPlug रिफ़ंड ID के साथ ऑर्डर नोट्स में जुड़ता है।

PayPlug पोर्टल में किए गए रिफ़ंड सूचना के माध्यम से आते हैं और ऑर्डर नोट्स में जुड़ जाते हैं। वे WooCommerce में अपने-आप नहीं बनते। ज़रूरत हो तो उन्हें मैन्युअली दर्ज करें।

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

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

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

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

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

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

चेकआउट पर PayPlug नहीं दिखता:जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की सीक्रेट की (टेस्ट मोड में Test Secret Key, लाइव मोड में Live Secret Key) भरी है, स्टोर की मुद्रा EUR है, और ऑर्डर का कुल 0.99 से 20,000.00 EUR के बीच है। अन्य सीमाओं वाले खाते उन्हें ppg_amount_limits फ़िल्टर से बदल सकते हैं (सेंट में मान)।

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

सूचना का उत्तर Verification failed है:PayPlug API से भुगतान नहीं पढ़ा जा सका, उदाहरण के लिए इसलिए कि PayPlug ने उत्तर नहीं दिया। ऑर्डर नहीं बदलता, और PayPlug सूचना फिर से भेजेगा।

सूचना का उत्तर Busy, retry है:उसी समय ऑर्डर किसी दूसरे अनुरोध से अपडेट हो रहा था, जैसे ग्राहक की वापसी। PayPlug सूचना फिर से भेजेगा।

सूचना का उत्तर Unknown payment या Payment does not belong to the order है:भुगतान इस स्टोर द्वारा नहीं बनाया गया या इस ऑर्डर के लिए नहीं है, उदाहरण के लिए उसी PayPlug खाते पर किसी दूसरी दुकान का भुगतान। उसे अनदेखा किया जाता है।

ग्राहक को Payment could not be initiated दिखता है:ऑर्डर का पिछला भुगतान प्रयास इसी समय पुष्ट हो रहा है, या PayPlug ने अनुरोध अस्वीकार कर दिया। थोड़ी देर रुककर फिर से प्रयास करें; ऑर्डर नोट्स में PayPlug की त्रुटि दिखती है।

भुगतान के बाद ऑर्डर होल्ड पर है:ऑर्डर नोट पढ़ें। भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती थी, स्टोर लाइव होने पर टेस्ट भुगतान हुआ था, या ऑर्डर रद्द होने के बाद भुगतान आया। ऑर्डर प्रोसेस करें या भुगतान रिफ़ंड करें।

मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है:भुगतान टेस्ट या लाइव मोड में हुआ था, और उस मोड की सीक्रेट की कॉन्फ़िगर नहीं है। उसे दर्ज करें और फिर से प्रयास करें।

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

अनइंस्टॉल

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

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