VibeFox Redsys for OpenCart — सहायता

आवश्यकताएँ

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

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

Redsys मर्चेंट खाता: आपका बैंक (वह acquirer जिसने आपको Redsys वर्चुअल POS दिया है) आपको मर्चेंट कोड (FUC), टर्मिनल नंबर और Redsys प्रशासन पैनल तक पहुँच देता है, जहाँ हर वातावरण की SHA-256 सीक्रेट कुंजी दिखाई देती है। परीक्षण वातावरण की कुंजी असली कुंजी से अलग होती है। आपके टर्मिनल के लिए ऑनलाइन सूचना (HTTP) सक्रिय होनी चाहिए। यदि आप निश्चित नहीं हैं, तो अपने बैंक से पूछें।

मुद्रा: एक्सटेंशन द्वारा समर्थित मुद्राओं में से एक (कॉन्फ़िगरेशन देखें), और आपका Redsys टर्मिनल उस मुद्रा के लिए बैंक द्वारा सक्षम होना चाहिए। अधिकांश टर्मिनल केवल EUR स्वीकार करते हैं।

पहुँच योग्य स्टोर: भुगतान सूचनाएँ पहुँचाने के लिए Redsys को इंटरनेट से आपके स्टोर तक पहुँचना होगा, बिना लॉगिन या फ़ायरवॉल ब्लॉक के।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपना मर्चेंट कोड, टर्मिनल और हर वातावरण की सीक्रेट कुंजी दर्ज करें (कॉन्फ़िगरेशन देखें)।

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

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Redsys Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। एक्सटेंशन में बदलाव करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेटिंग्स के ऊपर पेज चेतावनी देता है जब मर्चेंट कोड गायब हो या केवल अंकों से न बना हो, जब कोई सीक्रेट कुंजी वैध Redsys SHA-256 कुंजी न हो, जब वर्तमान मोड की कुंजी खाली हो (तब चेकआउट पर भुगतान विधि छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा समर्थित न हो। टेस्ट मोड चालू रहते हुए यह Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. दिखाता है।

सेव करते समय Title 1 से 128 अक्षरों का होना चाहिए (Enter a title for the payment method (1 to 128 characters).), Sort Order पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ मान्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और जियो ज़ोन तथा हर ऑर्डर स्थिति मौजूद होनी चाहिए। अन्यथा कुछ भी सेव नहीं होता।

Redsys

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

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

Description: ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit or debit card via Redsys.

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

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

Total: चेकआउट की वह राशि, जो स्टोर की डिफ़ॉल्ट मुद्रा में होती है और जिस तक पहुँचने पर ही ऑर्डर के लिए Redsys दिया जाता है: 0 या उससे बड़ी संख्या। किसी भी राशि पर Redsys देने के लिए इसे खाली छोड़ें।

Redsys खाता

आपका बैंक आपको मर्चेंट कोड (FUC), टर्मिनल और Redsys प्रशासन पैनल तक पहुँच देता है, जहाँ हर वातावरण की SHA-256 सीक्रेट कुंजी दिखाई देती है। यह सेक्शन Redsys प्रशासन पैनल का लिंक देता है।

Merchant Code (FUC): आपका Redsys मर्चेंट कोड, अधिकतम 9 अंक। जो भी अंक नहीं है, वह सेव करते समय हटा दिया जाता है।

Terminal Number: आपके बैंक द्वारा दिया गया टर्मिनल नंबर, अधिकतम 3 अंक। डिफ़ॉल्ट: 1। खाली फ़ील्ड 1 के रूप में सेव होता है।

Secret Key (SHA-256) — live: असली (प्रोडक्शन) वातावरण की Base64 SHA-256 सीक्रेट कुंजी, आमतौर पर 32 अक्षरों की। यह तब उपयोग होती है जब टेस्ट मोड बंद हो।

टेस्ट मोड (SIS-T)

Redsys टेस्ट वातावरण की अपनी सीक्रेट कुंजी होती है। यह सेक्शन Redsys का सार्वजनिक टेस्ट डेटा दिखाता है: मर्चेंट कोड 999008881, टर्मिनल 1, कुंजी sq7HjrUOBfKmC576ILgskD5srU870gJ7, कार्ड 4548 8100 0000 0003, समाप्ति 12/49, CVV 123। टेस्ट मोड में कोई असली पैसा नहीं काटा जाता।

Test Mode: भुगतान और रिफ़ंड Redsys टेस्ट वातावरण (SIS-T) में जाते हैं और टेस्ट कुंजी से साइन होते हैं। डिफ़ॉल्ट: चालू। असली भुगतान स्वीकार करने के लिए इसे बंद करें। चालू रहते हुए ग्राहक Confirm Order चरण पर TEST MODE: Redsys test environment, no real money is charged. देखते हैं।

Secret Key (SHA-256) — test: टेस्ट वातावरण की Base64 SHA-256 कुंजी। अपनी टेस्ट कुंजी या ऊपर दी गई सार्वजनिक टेस्ट कुंजी का उपयोग करें।

सहेजी गई कुंजियाँ फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलना हो तो ही नया मान दर्ज करें। सहेजी गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear saved secret on save पर टिक करें और Save पर क्लिक करें।

भुगतान पेज और ऑर्डर

Commerce Name: Redsys भुगतान पेज पर दिखने वाला स्टोर का नाम, अधिकतम 25 अक्षर। डिफ़ॉल्ट: आपके स्टोर का नाम, 25 अक्षरों तक काटा हुआ।

Order Status After Payment: भुगतान किए गए ऑर्डर को कौन-सी स्थिति मिलती है।

राशि या मुद्रा का मेल न होना, गेटवे के लाइव मोड में होने पर टेस्ट भुगतान, और रद्द किए गए प्रयासों के भुगतान हमेशा On hold (review) status पाते हैं।

OpenCart Confirm Order चरण पर बिना स्थिति के ऑर्डर बनाता है (लापता ऑर्डर)। यह स्थिति तभी पाता है जब हस्ताक्षरित Redsys सूचना मिल जाए। अस्वीकृत या रद्द भुगतान ऑर्डर को बिना स्थिति के छोड़ता है; ग्राहक कार्ट सुरक्षित रखकर चेकआउट पर लौट जाता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करता है।

Processing status: तब उपयोग होता है जब Order Status After Payment Processing हो। डिफ़ॉल्ट: प्रसंस्करण में।

Completed status: तब उपयोग होता है जब Order Status After Payment Completed हो। डिफ़ॉल्ट: पूर्ण।

On hold (review) status: आपकी समीक्षा वाले भुगतान (ऊपर देखें), या जब Order Status After Payment On hold (review) हो तब हर भुगतान किया गया ऑर्डर। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है; ऑर्डर पर एक नोट कारण समझाता है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Refunded status: ऑर्डर पेज से Redsys भुगतान पूरी तरह रिफ़ंड होने पर सेट होती है। डिफ़ॉल्ट: वापस किया गया।

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

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

उन्नत

Debug log: भुगतान, सूचनाओं और रिफ़ंड का विवरण OpenCart के लॉग फ़ोल्डर (storage/logs) में rdsg_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती, और 5 MB पर इसे पुरानी प्रति में ले जाया जाता है। त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। कुंजियाँ, सिग्नेचर और कार्ड डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

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

Delete Data: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर के Redsys भुगतान रिकॉर्ड (रिफ़ंड के लिए ज़रूरी) हमेशा बने रहते हैं। डिफ़ॉल्ट: बंद।

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

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

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

समर्थित मुद्राएँ

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD। ग्राहक की मुद्रा इस सूची में न हो, तो भुगतान विधि छिप जाती है।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card (Redsys))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन एक हस्ताक्षरित भुगतान फ़ॉर्म तैयार करता है, ग्राहक Redirecting to Redsys for payment. Please wait... देखता है और आपके बैंक के Redsys भुगतान पेज पर चला जाता है। यदि ब्राउज़र अपने-आप आगे न बढ़े, तो ग्राहक Pay via Redsys पर क्लिक करता है। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

Redsys पेज पर ग्राहक 3-D Secure के माध्यम से कार्ड से भुगतान करता है, या Bizum या किसी अन्य तरीके से, जिसे आपके बैंक ने टर्मिनल के लिए सक्षम किया है। पेज ग्राहक की भाषा (स्पेनिश, अंग्रेज़ी, कैटलन, फ़्रेंच, जर्मन, इतालवी, पुर्तगाली और अन्य) का उपयोग करता है, बाकी भाषाओं के लिए अंग्रेज़ी। राशि ऑर्डर मुद्रा की सबसे छोटी इकाई में कुल ऑर्डर राशि होती है, उदाहरण के लिए EUR 43.45 को 4345 के रूप में, और JPY या CLP बिना दशमलव के। भुगतान को ऑर्डर नंबर और आपके स्टोर के नाम के साथ Order के रूप में वर्णित किया जाता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। लौटने भर से कुछ भी भुगतान किया हुआ चिह्नित नहीं होता। ऑर्डर तभी भुगतान किया हुआ माना जाता है जब Redsys हस्ताक्षरित सूचना से उसकी पुष्टि करे। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक को Your payment with Redsys has been received. के साथ OpenCart ऑर्डर सफलता पेज दिखता है। यदि ऑर्डर को On hold (review) status मिला है, तो पेज Your payment with Redsys has been received and is being reviewed by the store. दिखाता है। यदि सूचना अभी नहीं पहुँची है, तो एक Payment confirmation पेज Redsys is confirming your payment. If you completed the payment, your order will be confirmed in a few moments — please do not pay again. के साथ दिखता है, जिसमें Check again और Back to checkout बटन होते हैं।

यदि ग्राहक रद्द करता है या भुगतान अस्वीकार हो जाता है, तो Redsys ग्राहक को The Redsys payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर वापस भेज देता है। कार्ट सुरक्षित रहता है, और ग्राहक फिर से भुगतान कर सकता है। हर नए प्रयास को नया Redsys ऑर्डर नंबर मिलता है, और उनमें से किसी से भी किया गया भुगतान (जैसे दूसरे ब्राउज़र टैब से) फिर भी पहचाना जाता है। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है; यदि उसी कार्ट का कोई दूसरा ऑर्डर पहले ही भुगतान हो चुका है, तो ग्राहक सीधे सफलता पेज पर पहुँच जाता है, और दूसरे ऑर्डर का देर से आया भुगतान लागू नहीं होता।

OpenCart 4 पर भुगतान पूरा न होने का संदेश चेकआउट पेज के ऊपर दिखता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए रद्द करने या भुगतान अस्वीकार होने के बाद ग्राहक उसी ऑर्डर का नए Redsys ऑर्डर नंबर के साथ भुगतान करता है। यदि वह ऑर्डर इस बीच बंद हो गया हो, तो ग्राहक Your previous order was closed without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर वापस भेज दिया जाता है, या, यदि उसका Redsys भुगतान हुआ था, तो Your order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. के साथ। अगला Confirm Order एक नए ऑर्डर का भुगतान करता है। यदि चेकआउट का ऑर्डर पहले से भुगतान किया हुआ है, पर उसके बाद कार्ट बदल गया है, जिसमें नई मात्रा भी शामिल है, तो ग्राहक चेकआउट पर वापस भेज दिया जाता है और नए कार्ट का भुगतान एक नए ऑर्डर से होता है।

यदि भुगतान Redsys को भेजा नहीं जा सकता, तो ग्राहक एक छोटे संदेश के साथ Confirm Order चरण पर ही रहता है: Redsys payments are not configured correctly. Please choose another payment method or contact us., उस मुद्रा में भुगतान स्वीकार न होने का संदेश, या The order total must be greater than zero.

सूचना और ग्राहक की वापसी तब भी काम करती है जब स्टोर मेंटेनेंस मोड में हो: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन इनके लिए एक स्टार्टअप क्रिया जोड़ता है।

यह एक्सटेंशन केवल एकल भुगतान लेता है, जो Redsys पेज पर तुरंत अधिकृत और कैप्चर होते हैं। इसमें आपकी अपनी साइट पर कार्ड फ़ॉर्म (InSite या iframe) नहीं है, सेव किए गए कार्ड नहीं हैं, वन-क्लिक भुगतान या टोकनाइज़ेशन नहीं है, सदस्यता या आवर्ती भुगतान नहीं हैं, बाद में कैप्चर वाली प्री-ऑथराइज़ेशन नहीं है, और एडमिन में बनाए गए ऑर्डर के लिए भुगतान लिंक नहीं हैं।

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

ऑर्डर स्थितियाँ

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

Processing, Completed या On hold (review): भुगतान की पुष्टि हो गई है। स्थिति Order Status After Payment के अनुसार होती है। एक नोट में Redsys ऑर्डर नंबर (Ds_Order), प्राधिकरण कोड और प्रतिक्रिया कोड दिखते हैं; टेस्ट भुगतान पर [TEST] चिह्न होता है।

भुगतान के बाद On hold (review): Redsys ने ऑर्डर कुल से अलग राशि या मुद्रा बताई, गेटवे के लाइव मोड में होने पर टेस्ट भुगतान आया (कोई असली पैसा नहीं काटा गया), या ग्राहक ने Redsys पेज पर उस भुगतान को रद्द करने के बाद फिर भुगतान किया। नोट इसे समझाता है। Redsys प्रशासन पैनल में भुगतान जाँचें, फिर ऑर्डर को पूरा करें या भुगतान रिफ़ंड करें।

Refunded status: एक्सटेंशन के माध्यम से भुगतान पूरी तरह रिफ़ंड हुआ है।

अस्वीकृत भुगतान कभी उस ऑर्डर को नहीं बदलता जिसकी पहले से कोई स्थिति है। सामान्य प्रतिक्रिया कोडों के लिए लॉग और नोट्स में Insufficient funds, Card expired या Cancelled by the customer जैसा संक्षिप्त कारण होता है। यदि किसी पहले से भुगतान किए गए ऑर्डर या कार्ट के लिए दूसरा, अलग भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे डुप्लिकेट भुगतान Redsys प्रशासन पैनल में रिफ़ंड करने को कहता है। यदि Redsys बताता है कि कोई भुगतान अभी प्रक्रिया में है, तो नोट जोड़ा जाता है और ऑर्डर अंतिम परिणाम का इंतज़ार करता है।

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

VibeFox Redsys Gateway टैब

Sales > Orders में Redsys से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Redsys Gateway टैब Redsys order number (Ds_Order), Authorisation code / response, टेस्ट भुगतानों पर Test mode लेबल के साथ Environment (लाइव या टेस्ट), भुगतान की Status, Paid / refunded, होल्ड वाले ऑर्डरों के लिए समीक्षा संकेत, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, ऑर्डर के Redsys notes और Redsys order numbers issued for this cart दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी Redsys के ज़रिए पैसे वापस नहीं भेजती।

Redsys प्रशासन पैनल में किए गए रिफ़ंड इस एक्सटेंशन के रिफ़ंड के रूप में दर्ज नहीं होते। जब Redsys उनके लिए सूचना भेजता है, तो ऑर्डर में एक नोट जोड़ा जाता है। ऑर्डर की स्थिति अपने-आप नहीं बदलती।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। License — VibeFox Redsys Gateway लाइसेंस ब्लॉक Extensions > Extensions > Payments > VibeFox Redsys Gateway > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन दिखाता है: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-redsys की पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

Redsys चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मर्चेंट कोड और टर्मिनल भरे हैं, और वर्तमान मोड में एक वैध कुंजी है: टेस्ट मोड में Secret Key (SHA-256) — test, लाइव मोड में Secret Key (SHA-256) — live। जाँचें कि ग्राहक की मुद्रा समर्थित मुद्राओं की सूची में है। सेटिंग्स पेज इनमें से हर समस्या के लिए चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: Redsys की सूचना आपके स्टोर तक नहीं पहुँची। बैंक से पूछें कि क्या आपके टर्मिनल के लिए ऑनलाइन सूचना (HTTP) सक्रिय है। जाँचें कि Notification URL में दिखाया गया पता लॉगिन या फ़ायरवॉल ब्लॉक के बिना इंटरनेट से पहुँच योग्य है। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

सूचना Forbidden उत्तर देती है: सिग्नेचर उस वातावरण की सीक्रेट कुंजी से मेल नहीं खाया जिसमें भुगतान शुरू हुआ था, या सूचना में मर्चेंट कोड आपका नहीं है। जाँचें कि सेटिंग्स की सीक्रेट कुंजियाँ और मर्चेंट कोड आपके टर्मिनल के हैं।

सूचना Order not found उत्तर देती है: सूचना सही तरीके से साइन की गई थी, लेकिन इस स्टोर का कोई ऑर्डर उस Redsys ऑर्डर नंबर का उपयोग नहीं करता।

सूचना Busy उत्तर देती है: उसी समय कार्ट को किसी दूसरी सूचना द्वारा प्रोसेस किया जा रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। Redsys सूचना को फिर से भेजता है। लॉग में कारण दिखता है।

सूचना Bad request उत्तर देती है: अनुरोध में Redsys पैरामीटर नहीं थे या वे खराब थे। वह अपेक्षित प्रारूप में Redsys से नहीं आया।

भुगतान के बाद ऑर्डर on hold स्थिति में है: VibeFox Redsys Gateway टैब के नोट्स पढ़ें (ऑर्डर स्थितियाँ देखें), फिर ऑर्डर को पूरा करें या भुगतान रिफ़ंड करें।

लाइव मोड में टेस्ट भुगतान ऑर्डर की पुष्टि नहीं करते: जब Test Mode बंद हो, तो टेस्ट भुगतान कभी ऑर्डर का भुगतान नहीं करता। इसके बजाय ऑर्डर एक नोट के साथ होल्ड पर रख दिया जाता है। टेस्ट भुगतानों के लिए टेस्ट मोड और टेस्ट कुंजी का उपयोग करें।

रिफ़ंड विफल होता है: त्रुटि पढ़ें। Redsys refund: the merchant code or the TEST secret key is not configured. (या LIVE) का अर्थ है कि भुगतान के वातावरण की कुंजी गायब है। Redsys त्रुटि कोड संदेश में समझाए गए हैं, जैसे SIS0057 (राशि भुगतान में बची राशि से अधिक है), SIS0056 (मूल भुगतान नहीं मिला: दूसरा वातावरण या टर्मिनल), SIS0042 (सिग्नेचर त्रुटि, इस वातावरण की कुंजी जाँचें), SIS0026 (अज्ञात मर्चेंट कोड या टर्मिनल) और SIS0027 (टर्मिनल के लिए मुद्रा कॉन्फ़िगर नहीं है)। यदि Redsys तक पहुँच नहीं हो पाती, तो रिफ़ंड नहीं होता। बाद में फिर कोशिश करें।

टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है, जैसे ऑर्डर में कोई पुष्ट Redsys भुगतान नहीं है, वह पूरी तरह रिफ़ंड हो चुका है, या आपके उपयोगकर्ता समूह के पास ऑर्डर बदलने का अधिकार नहीं है।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wcp_redsys_gateway/merchant_parameters (भुगतान पैरामीटर और ऑर्डर) और wcp_redsys_gateway/currency_codes (समर्थित मुद्राओं की सूची) ट्रिगर करता है। कोई मुद्रा तभी जोड़ें जब आपके बैंक ने उसे टर्मिनल के लिए सक्षम किया हो।

अनइंस्टॉल

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

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

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