VibeFox Przelewy24 for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
मुद्रा: ऑर्डर PLN, EUR, GBP या CZK में होना चाहिए। अन्य मुद्राओं में चेकआउट पर यह भुगतान तरीक़ा छिपा रहता है। ऑर्डर उसकी अपनी मुद्रा में ही चार्ज होता है; प्लगइन मुद्राएँ परिवर्तित नहीं करता।
Przelewy24 खाता: आपको Przelewy24 मर्चेंट खाता और उसका API डेटा चाहिए: Merchant ID, API कुंजी (Przelewy24 पैनल में इसे report key कहा जाता है), CRC कुंजी और, यदि आपके स्टोर का अपना ID है, तो POS ID (Shop ID)। ये आपको panel.przelewy24.pl पर Przelewy24 मर्चेंट पैनल में My data > API data and configuration के अंतर्गत मिलेंगे। Sandbox कुंजियाँ sandbox.przelewy24.pl/panel पर एक अलग sandbox खाते से मिलती हैं। Przelewy24 पैनल में और कुछ सेट करने की ज़रूरत नहीं है: प्लगइन हर भुगतान के साथ अपना सूचना URL भेजता है। Przelewy24 भुगतान सूचनाएँ इसी पते पर भेजता है, इसलिए आपकी साइट इंटरनेट से पहुँच योग्य होनी चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_przelewy24_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Payments > Przelewy24 > Manage, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. Sandbox कुंजियाँ डालें (Merchant ID, API key, CRC key; POS ID केवल तब, जब वह Merchant ID से अलग हो), Enable/Disable चालू करें, सेव करें और sandbox मोड में एक परीक्षण भुगतान करें।
6. लाइव कुंजियाँ डालें, Test Mode का टिक हटाएँ और सेव करें, ताकि वास्तविक भुगतान स्वीकार हों।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Przelewy24। फ़ील्ड्स के ऊपर, कुछ छूट जाने पर, पेज चेतावनियाँ दिखाता है। Sandbox चालू होने पर: Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. जब वर्तमान मोड की कुंजियाँ अधूरी हों: Enter the Sandbox Merchant ID, API key and CRC key — until then Przelewy24 is not shown at checkout. (या लाइव कुंजियों के लिए वही)। जब Przelewy24 स्टोर की मुद्रा स्वीकार नहीं करता, तो चेतावनी में वह मुद्रा और समर्थित मुद्राएँ लिखी होती हैं। सेव करने के बाद चेतावनियाँ तुरंत नए मोड और कुंजियों के अनुसार बदल जाती हैं। Przelewy24 पैनल से कुंजियों के साथ कॉपी किए गए स्पेस और लाइन ब्रेक सेव करते समय हटा दिए जाते हैं।
चेकआउट
Enable/Disable: Enable Przelewy24 Payment इस भुगतान तरीक़े को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह नाम जो ग्राहक चेकआउट पर भुगतान तरीक़े के रूप में देखते हैं। डिफ़ॉल्ट: Przelewy24।
Description: चेकआउट पर भुगतान तरीक़े के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay with BLIK, online bank transfer or card via Przelewy24.
API क्रेडेंशियल
यह सेक्शन बताता है कि कुंजियाँ कहाँ मिलेंगी (Przelewy24 मर्चेंट पैनल में My data > API data and configuration) और panel.przelewy24.pl तथा sandbox.przelewy24.pl/panel के लिंक देता है।
Test Mode: Enable sandbox (test) mode। चालू होने पर नए भुगतान sandbox कुंजियों के साथ Przelewy24 sandbox (sandbox.przelewy24.pl) पर जाते हैं, और कोई वास्तविक राशि नहीं ली जाती। वास्तविक भुगतान लाइव कुंजियों के साथ secure.przelewy24.pl पर स्वीकार करने के लिए इसका टिक हटाएँ। डिफ़ॉल्ट: चालू।
लाइव कुंजियाँ
Live Merchant ID: आपका Przelewy24 मर्चेंट ID, केवल अंक।
Live POS ID (optional): Shop ID (posId)। यदि यह Merchant ID के समान है तो खाली छोड़ें।
Live API key (report key): Przelewy24 पैनल की API कुंजी। इसका उपयोग POS ID के साथ API प्रमाणीकरण के लिए होता है।
Live CRC key: Przelewy24 को भेजे गए अनुरोधों पर हस्ताक्षर करने और Przelewy24 सूचनाओं के हस्ताक्षर की जाँच के लिए उपयोग होती है।
Sandbox कुंजियाँ
Sandbox Merchant ID: आपके Przelewy24 sandbox खाते का Merchant ID।
Sandbox POS ID (optional): sandbox खाते का Shop ID (posId)। यदि यह Merchant ID के समान है तो खाली छोड़ें।
Sandbox API key (report key): sandbox खाते की API कुंजी।
Sandbox CRC key: sandbox खाते की CRC कुंजी, जो अनुरोधों पर हस्ताक्षर करने और sandbox सूचनाओं की जाँच के लिए उपयोग होती है।
लाइव और sandbox कुंजियाँ अलग-अलग होती हैं। Merchant ID और POS ID में केवल अंक होने चाहिए; वर्तमान मोड का Merchant ID, API key और CRC key दर्ज होने तक चेकआउट पर भुगतान तरीक़ा नहीं दिखता। एक मोड में शुरू किया गया भुगतान मोड बदलने के बाद भी हमेशा उसी मोड की कुंजियों से जाँचा और रिफ़ंड किया जाता है, इसलिए जब तक पुराने मोड के भुगतान खुले हैं या रिफ़ंड हो सकते हैं, तब तक उसकी कुंजियाँ रखें।
भुगतान सूचनाएँ
यह सेक्शन आपके स्टोर का सूचना URL दिखाता है। यह कुछ इस तरह दिखता है: https://your-site/wc-api/wc_p24_payment/। प्लगइन हर भुगतान के साथ यह URL Przelewy24 को भेजता है, इसलिए Przelewy24 पैनल में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। वही URL रिफ़ंड परिणाम भी प्राप्त करता है। यह URL इंटरनेट से पहुँच योग्य होना चाहिए: इसके सामने कोई फ़ायरवॉल, मेंटेनेंस मोड या HTTP प्रमाणीकरण नहीं होना चाहिए। सूचनाओं के बिना भी, ग्राहक के "ऑर्डर प्राप्त हुआ" पेज पर लौटने पर भुगतान की पुष्टि हो जाती है (देखें चेकआउट); यदि ग्राहक वापस नहीं लौटता, तो ऑर्डर "भुगतान लंबित" पर रहता है।
उन्नत
Debug Log: Enable logging तकनीकी घटनाएँ (ऑर्डर नंबर, P24 ट्रांज़ैक्शन ID, त्रुटियाँ) WooCommerce > Status > Logs में, स्रोत wcp_przelewy24_payment के रूप में लिखता है। त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। कुंजियाँ, अनुरोध के बॉडी और व्यक्तिगत डेटा कभी दर्ज नहीं होते। डिफ़ॉल्ट: बंद।
Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted। ऑर्डर और उनका भुगतान डेटा कभी नहीं हटाए जाते। प्लगइन को निष्क्रिय करने पर सब कुछ रहता है। डिफ़ॉल्ट: बंद।
चेकआउट
ग्राहक भुगतान तरीक़ा चुनता है (डिफ़ॉल्ट रूप से Przelewy24, Checkout ब्लॉक पर P24 लोगो के साथ) और ऑर्डर देता है। Sandbox मोड में Checkout ब्लॉक Sandbox mode — no real money is charged दिखाता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर कुल के लिए एक Przelewy24 ट्रांज़ैक्शन पंजीकृत करता है, जिसमें ग्राहक का ईमेल, नाम और बिलिंग देश शामिल होते हैं, और ऑर्डर में सेशन ID और मोड (sandbox या live) वाला एक ऑर्डर नोट जोड़ता है। हर भुगतान प्रयास को अपनी अलग सेशन ID मिलती है। ग्राहक Przelewy24 के भुगतान पेज पर भेजा जाता है और BLIK, ऑनलाइन बैंक ट्रांसफ़र, कार्ड या आपके Przelewy24 खाते में सक्षम किसी अन्य तरीक़े से भुगतान करता है। भुगतान पेज, यदि Przelewy24 समर्थन करता है, तो साइट की भाषा में दिखता है; अन्यथा अंग्रेज़ी में।
ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Przelewy24 उसकी पुष्टि करता है। Przelewy24 आपके स्टोर को एक हस्ताक्षरित सूचना भेजता है। प्लगइन CRC कुंजी, Merchant ID और POS ID से हस्ताक्षर जाँचता है; यह भी जाँचता है कि सेशन इसी ऑर्डर के लिए और उसी मोड में पंजीकृत हुआ था; और यह कि राशि और मुद्रा भुगतान प्रयास और ऑर्डर के वर्तमान कुल से मेल खाते हैं। इसके बाद ही वह Przelewy24 के साथ लेन-देन सत्यापित करता है (Przelewy24 केवल सत्यापित भुगतान क्रेडिट करता है) और ऑर्डर को भुगतान किया हुआ चिह्नित करता है। बिना वैध हस्ताक्षर वाले वेबहुक अस्वीकार किए जाते हैं।
भुगतान के बाद ग्राहक "ऑर्डर प्राप्त हुआ" पेज पर लौटता है। यदि सूचना अभी तक नहीं आई है, तो प्लगइन एक प्रमाणित सर्वर-से-सर्वर अनुरोध के जरिए Przelewy24 से लेन-देन की स्थिति पूछता है (प्रति ऑर्डर अधिकतम हर 10 सेकंड में एक बार) और वही जाँच लागू करता है। अकेला वापसी पेज कभी किसी ऑर्डर को भुगतान किया हुआ नहीं बनाता। जब तक भुगतान की पुष्टि नहीं होती, पेज We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: दिखाता है, साथ में एक Pay again बटन होता है जो Pay for order पेज खोलता है। यदि ऑर्डर होल्ड पर है, तो पेज Your payment is being verified. We will send you an e-mail as soon as it is confirmed. दिखाता है। उसी ऑर्डर के पुराने Przelewy24 पेज से बाद में किया गया भुगतान अब भी स्वीकार किया जाता है।
यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक को एक छोटा संदेश दिखता है: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (कारण लॉग में जाता है), Payment gateway is not configured properly. Please contact the administrator. (वर्तमान मोड की कुंजियाँ नहीं हैं), एक संदेश कि Przelewy24 ऑर्डर की मुद्रा में भुगतान स्वीकार नहीं कर सकता, या The order total must be greater than zero. जो ऑर्डर पहले से भुगतान किए गए या होल्ड पर हैं, उन्हें फिर से Przelewy24 को नहीं भेजा जाता (This order does not need a payment any more.)।
यह भुगतान तरीक़ा क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करता है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन में सेव किए गए कार्ड या वन-क्लिक भुगतान, सब्सक्रिप्शन या आवर्ती भुगतान, चेकआउट पेज पर P24 भुगतान तरीक़े (जैसे BLIK कोड फ़ील्ड) का चयन, किस्त विजेट नहीं हैं, और यह कार्ट की सामग्री Przelewy24 को नहीं भेजता।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
Pending payment: ग्राहक को Przelewy24 पर भेजा गया था और उसने अभी भुगतान नहीं किया है, या भुगतान की पुष्टि अभी नहीं हुई है।
Processing or Completed: भुगतान सत्यापित हो गया। WooCommerce "प्रक्रियाधीन" सेट करता है, या केवल डाउनलोड होने वाले वर्चुअल उत्पादों वाले ऑर्डरों के लिए "पूर्ण"। ऑर्डर नोट में P24 ऑर्डर ID, राशि और मोड दिखते हैं। ऑर्डर का ट्रांज़ैक्शन ID P24 ऑर्डर ID है। हर भुगतान एक बार ही लागू होता है।
On hold: Przelewy24 द्वारा बताई गई राशि या मुद्रा ऑर्डर से अलग है (उदाहरण के लिए, भुगतान शुरू होने के बाद ऑर्डर का कुल बदला गया था); भुगतान की पुष्टि नहीं हुई और नोट यही बताता है। या भुगतान आया और उस ऑर्डर के लिए सत्यापित हुआ जो रद्द हो चुका था; ऑर्डर चुपचाप फिर से नहीं खुलता, और नोट आपसे ऑर्डर भेजने या भुगतान रिफ़ंड करने को कहता है। Przelewy24 पैनल में भुगतान जाँचें।
यदि ऐसे ऑर्डर पर दूसरा भुगतान आता है जो पहले से भुगतान किया हुआ या रिफ़ंड किया हुआ है (पुराना भुगतान लिंक, ब्राउज़र के दो टैब), तो वह भुगतान पुष्ट नहीं होता, इसलिए Przelewy24 उसे क्रेडिट नहीं करता। ऑर्डर पर एक नोट आपसे उसे Przelewy24 पैनल में जाँचने और ज़रूरत हो तो खरीदार को लौटाने को कहता है।
रिफ़ंड
ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Przelewy24 पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उसी मोड (sandbox या live) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस मोड की कुंजियाँ सेट होनी चाहिए। Przelewy24 रिफ़ंड अतुल्यकालिक (asynchronously) रूप से संसाधित करता है: ऑर्डर नोट पहले बताता है कि रिफ़ंड का अनुरोध हुआ, और परिणाम बाद में सूचना URL पर आता है और नोट के रूप में जुड़ता है: Przelewy24: refund of … completed. या एक नोट जो बताता है कि रिफ़ंड अस्वीकार हुआ और पैसा वापस नहीं हुआ। यदि रिफ़ंड अस्वीकार होता है, तो Przelewy24 पैनल में जाँचें; ऑर्डर पर पहले से दर्ज WooCommerce रिफ़ंड अपने-आप नहीं हटता।
यदि Przelewy24 रिफ़ंड अनुरोध स्वीकार नहीं करता, तो WooCommerce कारण सहित Przelewy24 refund failed: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। Przelewy24 पैनल में सीधे किए गए रिफ़ंड ऑर्डर में नहीं जोड़े जाते।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > Przelewy24 के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उस डोमेन का स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना Przelewy24 चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू हो जाए, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। लॉग इन किए हुए स्टोर मैनेजरों को भुगतान तरीक़ा अब भी दिखता है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके परख सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान अब भी पुष्ट होते हैं, और रिफ़ंड काम करते हैं।
जब लाइसेंस की अवधि समाप्त होती है, तो प्लगइन चलता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Przelewy24 दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का Merchant ID, API key और CRC key दर्ज है (Test Mode चालू होने पर sandbox कुंजियाँ, अन्यथा लाइव कुंजियाँ; Merchant ID और POS ID केवल अंक), और ऑर्डर की मुद्रा PLN, EUR, GBP या CZK है। सेटिंग्स के ऊपर की चेतावनियाँ समस्या बताती हैं। डेवलपर wc_p24_supported_currencies फ़िल्टर से मुद्राओं की सूची बदल सकते हैं (केवल वे मुद्राएँ जो आपके Przelewy24 खाते में सक्षम हैं और जिनमें दशमलव के दो स्थान हैं)।
भुगतान हो गया, पर ऑर्डर Pending payment पर रहता है: Przelewy24 की सूचना आपके स्टोर तक नहीं पहुँची और ग्राहक "ऑर्डर प्राप्त हुआ" पेज पर वापस नहीं आया। जाँचें कि Payment notifications में दिखाया गया URL इंटरनेट से पहुँच योग्य है (/wc-api/wc_p24_payment/ के सामने मेंटेनेंस मोड, फ़ायरवॉल या HTTP प्रमाणीकरण नहीं है), और भुगतान के मोड का Merchant ID, POS ID और CRC key सही है। अस्वीकृत सूचनाएँ WooCommerce > Status > Logs में, स्रोत wcp_przelewy24_payment के रूप में दर्ज होती हैं, भले ही Debug Log बंद हो।
स्टोर सूचनाओं का उत्तर कैसे देता है: संसाधित, दोहराई गई या अज्ञात सूचना का उत्तर HTTP 200 से दिया जाता है। अन्यथा Przelewy24 उसे बाद में फिर भेजता है: 400 (डेटा गायब या ख़राब), 401 Invalid signature (गलत CRC कुंजी, अलग Merchant ID या POS ID, या भुगतान से अलग मोड की कुंजियों से हस्ताक्षरित सूचना), 405 (POST अनुरोध नहीं), 500 Verification failed (Przelewy24 के साथ सत्यापन विफल हुआ; ऑर्डर पर एक बार नोट जोड़ा जाता है) और 503 Busy, retry later (उसी समय कोई अन्य अनुरोध ऑर्डर अपडेट कर रहा था)।
ग्राहक को Payment error: Przelewy24 could not start the payment: दिखता है: Przelewy24 ने लेन-देन अस्वीकार किया, आमतौर पर वर्तमान मोड की गलत कुंजियों के कारण (sandbox कुंजियाँ केवल sandbox मोड में, और live कुंजियाँ केवल live मोड में काम करती हैं)। Przelewy24 की त्रुटि लॉग में है।
भुगतान के बाद ऑर्डर On hold है: ऑर्डर नोट पढ़ें। राशि या मुद्रा ऑर्डर से अलग थी, या रद्द हो चुके ऑर्डर के लिए भुगतान आया। Przelewy24 पैनल में भुगतान जाँचें, फिर ऑर्डर संसाधित करें या भुगतान रिफ़ंड करें।
रिफ़ंड विफल होता है: This order has no verified Przelewy24 payment. Cannot process refund. का अर्थ है कि ऑर्डर सत्यापित Przelewy24 भुगतान से नहीं चुकाया गया था। The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (या लाइव के लिए वही) का अर्थ है कि भुगतान के मोड की कुंजियाँ हटाई गई थीं; उन्हें फिर से दर्ज करें।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पा रही, तो प्लगइन अंतिम ज्ञात स्थिति के साथ चलता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करें और मिटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा वापसी पेज के अल्पकालिक चिह्न हमेशा हटाए जाते हैं। प्लगइन की सेटिंग्स और उसके लॉग (घुमाई गई लॉग फ़ाइलों सहित, और स्रोत wcp_przelewy24_payment की डेटाबेस लॉग प्रविष्टियाँ) केवल तभी हटाए जाते हैं जब Delete data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट, ट्रांज़ैक्शन ID और Przelewy24 भुगतान डेटा रखते हैं।
Przelewy24 उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Przelewy24 से संबद्ध नहीं है और Przelewy24 द्वारा समर्थित नहीं है।