VibeFox Przelewy24 for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।

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

मुद्रा: ऑर्डर PLN, EUR, GBP या CZK में होना चाहिए। अन्य मुद्राओं में चेकआउट पर भुगतान विधि नहीं दिखती। ऑर्डर उसकी अपनी मुद्रा में चार्ज होता है; एक्सटेंशन मुद्राएँ परिवर्तित नहीं करता।

Przelewy24 खाता: आपको एक Przelewy24 मर्चेंट खाता और उसका API डेटा चाहिए: Merchant ID, API कुंजी (Przelewy24 पैनल में इसे report key कहा जाता है), CRC key और, यदि आपके स्टोर का अपना ID है, तो POS ID (Shop ID)। ये आपको panel.przelewy24.pl पर Przelewy24 मर्चेंट पैनल में, My data > API data and configuration के अंतर्गत मिलेंगे। सैंडबॉक्स कुंजियाँ sandbox.przelewy24.pl/panel पर एक अलग सैंडबॉक्स खाते से आती हैं। Przelewy24 पैनल में और कुछ सेट करने की ज़रूरत नहीं है: एक्सटेंशन हर भुगतान के साथ अपना नोटिफ़िकेशन URL भेजता है। आपके स्टोर का इंटरनेट से पहुँच योग्य होना ज़रूरी है, क्योंकि Przelewy24 उसे भुगतान की सूचनाएँ भेजता है।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। उसे अपने कंप्यूटर पर अनज़िप करें। उसमें README.txt, OpenCart 3 का पैकेज wcp_przelewy24_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_przelewy24_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_przelewy24_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Przelewy24 Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास पेमेंट एक्सटेंशन सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। अपनी VibeFox लाइसेंस कुंजी पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. सैंडबॉक्स कुंजियाँ दर्ज करें (Merchant ID, API कुंजी, CRC key; POS ID केवल तभी जब वह Merchant ID से अलग हो), Enable/Disable चालू करें, Save पर क्लिक करें और सैंडबॉक्स मोड में एक परीक्षण भुगतान करें।

5. लाइव कुंजियाँ दर्ज करें, Test Mode बंद करें और असली भुगतान स्वीकार करने के लिए Save पर क्लिक करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_przelewy24_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. इंस्टॉल किया गया पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Przelewy24 Payment ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी और Przelewy24 कुंजियाँ वैसे ही डालें जैसे OpenCart 3 के चरण 3 से 5 में बताया गया है। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल नोटिफ़िकेशन URL अलग है (देखें भुगतान सूचनाएँ)।

नई इंस्टॉलेशन में भुगतान विधि बंद रहती है और टेस्ट मोड चालू रहता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। सेटिंग्स के ऊपर, कुछ छूटने पर पेज चेतावनियाँ दिखाता है। सैंडबॉक्स चालू होने पर: 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 आपके स्टोर की डिफ़ॉल्ट मुद्रा स्वीकार नहीं करता, तो चेतावनी मुद्रा और समर्थित मुद्राएँ बताती है। सहेजने के बाद चेतावनियाँ तुरंत नए मोड और कुंजियों के अनुसार बदल जाती हैं। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

सहेजते समय, यदि कोई फ़ील्ड गलत है तो कुछ भी सहेजा नहीं जाता: Title खाली नहीं हो सकता (Enter a title for the payment method (at most 128 characters).), Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक मान स्वीकार्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और Geo Zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। गायब कुंजियाँ सहेजने को नहीं रोकतीं। Przelewy24 पैनल से कुंजियों के साथ कॉपी किए गए स्पेस और लाइन ब्रेक सहेजते समय हटा दिए जाते हैं।

Przelewy24

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

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। यही नाम ऑर्डर में भी सहेजा जाता है। डिफ़ॉल्ट: Przelewy24। आवश्यक, अधिकतम 128 अक्षर।

Description: Confirm Order चरण पर, पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay with BLIK, online bank transfer or card via Przelewy24।

Sort Order: चेकआउट पर भुगतान विधियों के बीच Przelewy24 की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

Geo Zone: Przelewy24 केवल चुने गए geo zone के भुगतान पते वाले ग्राहकों को दें। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट होते हैं।

Total: स्टोर की डिफ़ॉल्ट मुद्रा में चेकआउट कुल राशि, जिस तक पहुँचने पर ही Przelewy24 दिया जाएगा। किसी भी राशि पर Przelewy24 देने के लिए खाली छोड़ें।

API क्रेडेंशियल

यह सेक्शन बताता है कि कुंजियाँ कहाँ मिलेंगी (Przelewy24 मर्चेंट पैनल में My data > API data and configuration) और Przelewy24 पैनल तथा सैंडबॉक्स पैनल के लिंक देता है।

Test Mode: Przelewy24 सैंडबॉक्स और Sandbox कुंजियों का उपयोग करता है। कोई असली पैसा नहीं लिया जाता। असली भुगतान स्वीकार करने के लिए Live कुंजियों के साथ इसे बंद करें। डिफ़ॉल्ट: on। चालू रहने पर ग्राहक Confirm Order चरण पर Sandbox mode - no real money is charged देखते हैं।

लाइव कुंजियाँ

Live Merchant ID: आपका Przelewy24 मर्चेंट ID, केवल अंक।

Live POS ID (optional): Shop ID (posId)। यदि यह Merchant ID के समान है तो खाली छोड़ें।

Live API key (report key): Przelewy24 पैनल की API कुंजी। इसका उपयोग API प्रमाणीकरण के लिए होता है।

Live CRC key: Przelewy24 को भेजे गए अनुरोधों पर हस्ताक्षर करने और Przelewy24 की सूचनाओं के हस्ताक्षर की जाँच के लिए उपयोग होती है।

सैंडबॉक्स कुंजियाँ

Sandbox Merchant ID: आपके Przelewy24 सैंडबॉक्स खाते का Merchant ID।

Sandbox POS ID (optional): सैंडबॉक्स खाते का Shop ID (posId)। यदि यह Merchant ID के समान है तो खाली छोड़ें।

Sandbox API key (report key): सैंडबॉक्स खाते की API कुंजी।

Sandbox CRC key: सैंडबॉक्स खाते की CRC key, जो अनुरोधों पर हस्ताक्षर करने और सैंडबॉक्स सूचनाओं की जाँच के लिए उपयोग होती है।

सहेजी गई API कुंजियाँ और CRC key फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब आप उसे बदलना चाहते हों। सहेजी गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear the saved value पर निशान लगाएँ और Save पर क्लिक करें।

लाइव और सैंडबॉक्स कुंजियाँ अलग-अलग हैं। Merchant ID और POS ID में केवल अंक होने चाहिए; वर्तमान मोड का Merchant ID, API कुंजी और CRC key दर्ज होने तक चेकआउट पर भुगतान विधि नहीं दिखती। किसी एक मोड में शुरू हुए भुगतान की जाँच और रिफ़ंड हमेशा उसी मोड की कुंजियों से होते हैं, मोड बदलने के बाद भी। इसलिए जब तक पुराने मोड के भुगतान खुले हैं या उनका रिफ़ंड हो सकता है, तब तक उस मोड की कुंजियाँ रखें।

भुगतान सूचनाएँ

Notification URL: वह पता जो Przelewy24 से भुगतान सूचनाएँ प्राप्त करता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify जैसा और आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। एक्सटेंशन हर भुगतान और हर रिफ़ंड के साथ यह URL Przelewy24 को भेजता है, इसलिए Przelewy24 पैनल में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। यह URL इंटरनेट से पहुँच योग्य होना चाहिए: इसके सामने कोई फ़ायरवॉल या HTTP प्रमाणीकरण न हो। स्टोर मेंटेनेंस मोड में होने पर भी यह काम करता रहता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन सूचना URL और ग्राहक की वापसी के लिए एक स्टार्टअप एक्शन जोड़ता है। सूचनाओं के बिना भी, जब ग्राहक स्टोर पर लौटता है तो भुगतान की पुष्टि हो जाती है (देखें चेकआउट); यदि ग्राहक नहीं लौटता, तो ऑर्डर बिना स्टेटस के रहता है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Przelewy24 भुगतान की पुष्टि कर दे और एक्सटेंशन उसकी जाँच कर ले। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Paid Order Status: सत्यापित भुगतान के बाद का स्टेटस। डिफ़ॉल्ट: Processing।

On Hold (Review) Status: ऐसे भुगतान जिनकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती (सत्यापित नहीं), या जो ऑर्डर रद्द होने के बाद आते हैं, उन्हें यह स्टेटस और कारण बताने वाला नोट मिलता है। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Cancelled Order Status: एक्सटेंशन इसे कभी सेट नहीं करता। इस स्टेटस वाले ऑर्डर के लिए सत्यापित भुगतान ऑर्डर को चुपचाप दोबारा खोलने के बजाय उसे होल्ड पर रखता है। डिफ़ॉल्ट: Canceled।

Refunded Status: ऑर्डर पेज से भुगतान का पूरा रिफ़ंड होने के बाद सेट होता है। डिफ़ॉल्ट: Refunded।

उन्नत

Debug Log: तकनीकी घटनाएँ (ऑर्डर नंबर, P24 लेन-देन ID, त्रुटियाँ) OpenCart के लॉग फ़ोल्डर (storage/logs) में wc_p24_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती, और 5 MB पर इसे wc_p24_debug.old.log.php में ले जाया जाता है। त्रुटियाँ और चेतावनियाँ, जैसे अस्वीकृत सूचनाएँ या विफल सत्यापन या रिफ़ंड, हमेशा दर्ज होती हैं; हर चरण भी दर्ज करने के लिए स्विच चालू करें। कुंजियाँ और व्यक्तिगत डेटा कभी दर्ज नहीं होते। डिफ़ॉल्ट: off।

Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनका Przelewy24 भुगतान डेटा कभी नहीं हटता। डिफ़ॉल्ट: off।

आयात / निर्यात

Export: Download JSON सेटिंग्स को JSON फ़ाइल में सहेजता है। API और CRC कुंजियाँ निर्यात नहीं होतीं।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजी गई API और CRC कुंजियाँ बनी रहती हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Przelewy24)। Confirm Order चरण पर ग्राहक आपका विवरण और यह नोट देखता है: You will be redirected to the secure Przelewy24 page to complete the payment. OpenCart इस चरण पर ऑर्डर बनाता है, जो अब भी बिना स्टेटस के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल के लिए Przelewy24 में एक लेन-देन दर्ज करता है, जिसमें ग्राहक का ईमेल, नाम और बिलिंग देश शामिल होते हैं, और विवरण Order # के साथ ऑर्डर नंबर और आपके स्टोर का नाम होता है। हर भुगतान प्रयास को अपना सेशन ID मिलता है। ग्राहक को Przelewy24 के भुगतान पेज पर भेजा जाता है, जहाँ वह BLIK, ऑनलाइन बैंक ट्रांसफ़र, कार्ड या आपके Przelewy24 खाते में सक्षम कोई अन्य तरीका चुनकर भुगतान करता है। भुगतान पेज ऑर्डर की भाषा में दिखता है यदि Przelewy24 उसे सपोर्ट करता है, नहीं तो अंग्रेज़ी में। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब Przelewy24 उसकी पुष्टि करता है। Przelewy24 आपके स्टोर को एक हस्ताक्षरित सूचना भेजता है। एक्सटेंशन CRC key, Merchant ID और POS ID से हस्ताक्षर जाँचता है; यह जाँचता है कि सेशन इसी ऑर्डर के लिए और उसी मोड में दर्ज हुआ था; और यह कि राशि और मुद्रा भुगतान प्रयास और ऑर्डर कुल से मेल खाती हैं। उसके बाद ही यह Przelewy24 के साथ लेन-देन सत्यापित करता है (Przelewy24 केवल सत्यापित भुगतान क्रेडिट करता है) और OpenCart के मानक तरीके से Paid Order Status सेट करता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ। वैध हस्ताक्षर के बिना आए वेबहुक अस्वीकार किए जाते हैं।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। यदि सूचना अभी तक नहीं आई है, तो एक्सटेंशन प्रमाणित सर्वर-से-सर्वर अनुरोध से Przelewy24 से लेन-देन की स्थिति माँगता है (प्रति प्रयास अधिकतम हर 10 सेकंड में एक बार) और वही जाँचें लागू करता है। अकेला वापसी पेज कभी भी ऑर्डर को भुगतान किया हुआ नहीं बनाता। जब भुगतान की पुष्टि हो जाती है, तो ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। जब तक पुष्टि नहीं होती, Payment confirmation पेज 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: दिखाता है, साथ में Check again बटन और Pay again बटन, जो चेकआउट खोलता है। कार्ट सुरक्षित रहता है, और पुराने Przelewy24 पेज पर बाद में किया गया भुगतान अब भी स्वीकार होता है। यदि ऑर्डर होल्ड पर है, तो सफलता पेज दिखाता है: Your payment is being verified. We will send you an e-mail as soon as it is confirmed. जब बाद का भुगतान ऑर्डर को होल्ड स्टेटस से Paid Order Status पर ले जाता है, तो ग्राहक को ईमेल से सूचना मिलती है। यदि आपने भुगतान से पहले ऑर्डर रद्द कर दिया था और Przelewy24 के पास उसके लिए कोई भुगतान नहीं है, तो लौटने वाला ग्राहक Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us. देखता है।

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है: 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. OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है; जो ऑर्डर या कार्ट पहले से भुगतान किया हुआ है, उसे Przelewy24 को दोबारा नहीं भेजा जाता, और ग्राहक सफलता पेज पर जाता है।

OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और हर बार Confirm Order चरण दिखने पर उसे अपडेट करता है, इसलिए Pay again उसी ऑर्डर के लिए एक नया Przelewy24 लेन-देन शुरू करता है। यदि वह ऑर्डर इस बीच स्टोर ने बंद कर दिया हो (उदाहरण के लिए रद्द या रिफ़ंड), तो ग्राहक चेकआउट पर लौटा दिया जाता है, Your previous order was closed by the store. Please confirm the order again to place and pay a new order. के साथ (रद्द ऑर्डर के लिए, जो ऊपर के संदेश के साथ दिखता है), और अगला Confirm Order एक नया ऑर्डर चुकाता है। यदि चेकआउट का ऑर्डर पहले से भुगतान हो चुका है, पर उसके बाद कार्ट बदल गया है (नई मात्रा सहित), तो ग्राहक को Your previous order #… has already been placed. Your cart has changed: please confirm the new order to pay for it. दिखता है और नया कार्ट एक नए ऑर्डर से भुगतान किया जाता है। OpenCart 4 पर ये संदेश, और We could not match this payment to an order. If you were charged, please contact us., चेकआउट पेज के ऊपर दिखाए जाते हैं।

इस एक्सटेंशन में सेव किए गए कार्ड या वन-क्लिक भुगतान, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, आपके चेकआउट पेज पर P24 भुगतान तरीके का चयन (जैसे BLIK कोड फ़ील्ड) नहीं है, किस्त विजेट नहीं हैं, और कार्ट की सामग्री Przelewy24 को नहीं भेजी जाती।

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

ऑर्डर स्टेटस

कोई स्टेटस नहीं (लापता ऑर्डर): ग्राहक को Przelewy24 पर भेजा गया और उसने भुगतान नहीं किया, या भुगतान की अभी पुष्टि नहीं हुई है। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।

Paid Order Status (डिफ़ॉल्ट Processing): भुगतान सत्यापित हो गया है। एक नोट P24 ऑर्डर ID, राशि और मोड दिखाता है। हर भुगतान एक बार ही लागू होता है।

On Hold (Review) Status (डिफ़ॉल्ट Pending): Przelewy24 द्वारा बताई गई राशि या मुद्रा ऑर्डर से अलग है; भुगतान की पुष्टि नहीं हुई और नोट यही बताता है। या भुगतान आया और रद्द स्टेटस वाले ऑर्डर के लिए सत्यापित हुआ; ऑर्डर चुपचाप दोबारा नहीं खुलता, नोट आपसे ऑर्डर भेजने या भुगतान रिफ़ंड करने को कहता है। Przelewy24 पैनल में भुगतान की जाँच करें। यदि किसी असंगति के बाद होल्ड पर पड़े ऑर्डर के लिए किसी दूसरे प्रयास का सही भुगतान बाद में आता है, तो ऑर्डर Paid Order Status पर चला जाता है।

Refunded Status (डिफ़ॉल्ट Refunded): भुगतान एक्सटेंशन के माध्यम से पूरी तरह रिफ़ंड कर दिया गया है।

यदि किसी ऐसे ऑर्डर या कार्ट के लिए दूसरा भुगतान आता है जो पहले से भुगतान या रिफ़ंड हो चुका है (पुराना भुगतान लिंक, दो ब्राउज़र टैब, उसी कार्ट का कोई दूसरा ऑर्डर), तो वह पुष्ट नहीं होता, इसलिए Przelewy24 उसे क्रेडिट नहीं करता। भुगतान किए गए ऑर्डर पर एक नोट आपसे Przelewy24 पैनल में उसकी जाँच करने और ज़रूरत हो तो खरीदार को लौटाने को कहता है।

नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।

VibeFox Przelewy24 Payment टैब

Sales > Orders में Przelewy24 से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Przelewy24 Payment टैब P24 ऑर्डर ID, Session, Environment (Sandbox या Live), भुगतान का Status और उसकी जाँच का तरीका (सूचना या वापसी), Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Payment notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Przelewy24 Payment टैब में Amount दर्ज करें (जो राशि अभी तक रिफ़ंड नहीं हुई है वह अपने-आप भर जाती है), वैकल्पिक रूप से Reason (optional) दर्ज करें, और Refund via Przelewy24 पर क्लिक करें। प्रश्न Refund this amount through Przelewy24? This cannot be undone. की पुष्टि करें। अभी तक रिफ़ंड न हुई राशि तक पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपको एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)। रिफ़ंड उसी मोड में भेजा जाता है जिसमें भुगतान हुआ था (सैंडबॉक्स या लाइव), इसलिए उस मोड की कुंजियाँ सेट होनी चाहिए। रिफ़ंड तभी उपलब्ध होते हैं जब Przelewy24 भुगतान सत्यापित कर चुका हो।

Przelewy24 रिफ़ंड अतुल्यकालिक (asynchronous) रूप से संसाधित करता है। टैब Refund of … requested at Przelewy24. The result will be added as an order note. दिखाता है, रिफ़ंड इतिहास में स्टेटस requested दिखता है, और एक नोट जोड़ा जाता है। परिणाम बाद में सूचना URL पर आता है: स्टेटस completed हो जाता है और नोट Przelewy24: refund of … completed. जुड़ता है, या स्टेटस rejected हो जाता है और नोट बताता है कि पैसा खरीदार को वापस नहीं हुआ। पूर्ण रिफ़ंड अनुरोध के समय ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में वापस लाए, जैसे मैन्युअल स्टेटस बदलना। आंशिक रिफ़ंड स्टेटस नहीं बदलता। यदि रिफ़ंड अस्वीकार हो जाए, तो Przelewy24 पैनल में जाँच करें; ऑर्डर स्टेटस अपने-आप वापस नहीं होता।

यदि Przelewy24 रिफ़ंड अनुरोध स्वीकार नहीं करता, तो टैब कारण के साथ Przelewy24 refund failed: दिखाता है, और कोई रिफ़ंड दर्ज नहीं होता। Sales > Returns में उत्पाद वापसी Przelewy24 के ज़रिए पैसा वापस नहीं करती, और Przelewy24 पैनल में सीधे किए गए रिफ़ंड ऑर्डर में नहीं जोड़े जाते।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Przelewy24 Payment लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक मास्क की हुई कुंजी, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्टेटस दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-przelewy24 पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल एक्सटेंशन के लिए Modify अधिकार वाले एडमिन उपयोगकर्ता ही कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो एक्सटेंशन आखिरी ज्ञात स्टेटस पर काम करता रहता है।

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

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

जब लाइसेंस की अवधि समाप्त हो जाती है, तब भी एक्सटेंशन काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तब स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर सप्ताह एक बार। कोई cron जॉब नहीं चाहिए। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।

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

Przelewy24 चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का Merchant ID, API कुंजी और CRC key दर्ज है (Test Mode चालू होने पर Sandbox कुंजियाँ, वरना Live कुंजियाँ; Merchant ID और POS ID केवल अंक), और ऑर्डर की मुद्रा PLN, EUR, GBP या CZK है। सेटिंग्स के शीर्ष की चेतावनियाँ समस्या बताती हैं। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: Przelewy24 की सूचना आपके स्टोर तक नहीं पहुँची और ग्राहक स्टोर पर वापस नहीं आया। जाँचें कि Notification URL इंटरनेट से पहुँच योग्य है (इसके सामने कोई फ़ायरवॉल या HTTP प्रमाणीकरण न हो), और भुगतान के मोड का Merchant ID, POS ID और CRC key सही हैं। अस्वीकृत सूचनाएँ Debug Log बंद होने पर भी लॉग में लिखी जाती हैं; एक्सटेंशन पेज पर Log फ़ील्ड देखें।

स्टोर सूचनाओं का उत्तर कैसे देता है: संसाधित, दोहराई गई या अज्ञात सूचना को HTTP 200 से उत्तर मिलता है। अन्यथा Przelewy24 उसे बाद में फिर भेजता है: 400 (डेटा गायब या गलत बना), 401 Invalid signature (गलत CRC key, दूसरा Merchant ID या POS ID), 401 Invalid signature for this payment (भुगतान के मोड से अलग मोड की कुंजियों से हस्ताक्षरित सूचना), 405 (POST अनुरोध नहीं), 500 Verification failed (Przelewy24 के साथ सत्यापन विफल; ऑर्डर पर एक बार नोट जुड़ता है), 500 Order could not be updated (ऑर्डर स्टेटस सेट नहीं हो सका; अगली सूचना उसे बिना नए सत्यापन के सेट करेगी), और 503 Busy, retry later (उसी समय कोई दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था)।

ग्राहक को Payment error: Przelewy24 could not start the payment दिखता है: Przelewy24 ने लेन-देन अस्वीकार किया, आमतौर पर वर्तमान मोड की गलत कुंजियों के कारण (सैंडबॉक्स कुंजियाँ केवल सैंडबॉक्स मोड में, और लाइव कुंजियाँ केवल लाइव मोड में काम करती हैं)। Przelewy24 की त्रुटि लॉग में है।

ग्राहक को We could not match this payment to an order दिखता है: Przelewy24 का वापसी लिंक स्टोर के किसी ऑर्डर से मेल नहीं खाया। यदि ग्राहक से शुल्क लिया गया है, तो Przelewy24 पैनल में भुगतान खोजें।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Przelewy24 Payment टैब के नोट पढ़ें। राशि या मुद्रा ऑर्डर से अलग थी, या ऐसे ऑर्डर के लिए भुगतान आया जो रद्द हो चुका था। 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. (या लाइव के लिए वही) का अर्थ है कि भुगतान के मोड की कुंजियाँ हटा दी गई थीं; उन्हें फिर से दर्ज करें। Invalid refund amount का अर्थ है कि राशि खाली है, संख्या नहीं है, या अभी तक रिफ़ंड न हुई राशि से अधिक है।

डेवलपर्स के लिए: मुद्राओं की सूची OpenCart इवेंट wc_p24_supported_currencies से बदली जा सकती है (केवल दो दशमलव स्थानों वाली मुद्राएँ)।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Przelewy24 Payment के आगे का Uninstall (लाल − बटन) क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन के ऑर्डर स्टेटस, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आते हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट और उसका स्टार्टअप एक्शन भी हटते हैं, जो मेंटेनेंस मोड में सूचनाओं और ग्राहक की वापसी को जाने देता है)। यदि Delete data on uninstall चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, कुंजियाँ, डीबग लॉग स्विच) और लॉग हटा दिए जाते हैं। यदि बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। ऑर्डर का Przelewy24 भुगतान डेटा (सेशन, P24 ऑर्डर ID, रिफ़ंड) हमेशा रखा जाता है, ताकि पहले भुगतान किए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड हो सकें। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox Przelewy24 Payment के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, और फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

Przelewy24 उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Przelewy24 से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।