VibeFox Quickpay for OpenCart — सहायता

आवश्यकताएँ

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

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

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Quickpay मैनेजर की API कुंजी और निजी कुंजी चिपकाएँ और Test API key पर क्लिक करें (देखें कॉन्फ़िगरेशन)।

5. कैप्चर मोड और भुगतान के बाद का ऑर्डर स्टेटस चुनें, Enable/Disable चालू करें और Save पर क्लिक करें। जब तक आपका Quickpay खाता टेस्ट मोड में है, Test payments चालू करें और किसी Quickpay टेस्ट कार्ड से भुगतान करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Quickpay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सहेजता है। जब तक API कुंजी और निजी कुंजी दोनों सहेजी न जाएँ, पेज Quickpay needs setup: enter the API key and the private key. Until both are saved the payment method is hidden at checkout. दिखाता है। जब Test payments चालू हो, तब पेज याद दिलाता है कि Quickpay खाता लाइव होने पर इसे बंद करें। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

सहेजते समय Title 1 से 128 अक्षरों का होना चाहिए, Sort Order एक पूर्ण संख्या होनी चाहिए (ऋणात्मक संख्याएँ स्वीकार्य हैं), Total 0 या उससे बड़ी संख्या होनी चाहिए, और geo zone तथा हर ऑर्डर स्टेटस मौजूद होने चाहिए। अन्यथा कुछ भी सहेजा नहीं जाता और पेज फ़ील्ड का नाम बताता है।

Quickpay

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

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

Description: Confirm Order चरण पर, पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely by card or MobilePay on the Quickpay payment page।

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

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

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

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

Quickpay मैनेजर में (manage.quickpay.net, पेज पर उसके लिंक हैं) Settings > Integration खोलें। किसी API उपयोगकर्ता की API कुंजी (Settings > Users) और खाते की निजी कुंजी कॉपी करें।

Callback URL: आपके स्टोर का कॉलबैक URL दिखाता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_quickpay_gateway/callback जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_quickpay_gateway/payment/wcp_quickpay_gateway.callback जैसा और आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। Quickpay हर भुगतान ऑपरेशन (authorize, capture, refund, cancel) के बाद इसे कॉल करता है। यह हर भुगतान, कैप्चर और रिफ़ंड के साथ अपने-आप भेजा जाता है, इसलिए Quickpay में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है।

API key: Quickpay API उपयोगकर्ता की API कुंजी। इससे भुगतान बनाए, कैप्चर किए और रिफ़ंड किए जाते हैं।

Private key: खाते की निजी कुंजी। इसका उपयोग Quickpay कॉलबैक के हस्ताक्षर (HMAC-SHA256) जाँचने के लिए होता है। इसके बिना कोई भुगतान पुष्ट नहीं हो सकता, और कॉलबैक अस्वीकार होते हैं।

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

Test API key: यह बटन API key फ़ील्ड में दर्ज कुंजी (या फ़ील्ड खाली होने पर सहेजी गई कुंजी) को Quickpay के साथ प्रमाणित अनुरोध से जाँचता है, बिना उसे सहेजे। यह Connection successful — the API key is valid., Quickpay rejected the API key., API key is not configured., या कारण के साथ Connection failed: में से कोई उत्तर देता है।

Test payments: Quickpay टेस्ट कार्ड से किए गए भुगतान स्वीकार करता है। Quickpay का अलग सैंडबॉक्स नहीं है: जब तक आपका Quickpay खाता टेस्ट मोड में है, भुगतान टेस्ट कार्ड से होते हैं और टेस्ट के रूप में चिह्नित होते हैं। इसे केवल परीक्षण के दौरान चालू करें। बंद होने पर कोई टेस्ट भुगतान ऑर्डर को भुगतान किया हुआ नहीं बनाता। चालू होने पर ग्राहक Confirm Order चरण पर Test mode: Quickpay test cards are accepted. देखते हैं। डिफ़ॉल्ट: off।

भुगतान

Capture: कार्ड से पैसा कब लिया जाता है।

Order status after payment: Quickpay द्वारा कैप्चर किए गए भुगतान की पुष्टि होने पर भुगतान किए गए ऑर्डर को कौन-सा स्टेटस मिलता है।

ऑर्डर स्टेटस

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब हस्ताक्षरित Quickpay कॉलबैक आ जाए। नीचे हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

"Payment accepted" status: कैप्चर किए गए भुगतान की पुष्टि हो गई है और राशि व मुद्रा मेल खाती हैं। डिफ़ॉल्ट: Processing।

"Delivered (completed)" status: जब Order status after payment Delivered (completed) हो, तब इसके बजाय उपयोग होता है। डिफ़ॉल्ट: Complete।

"Quickpay payment on hold" status: भुगतान केवल ऑथराइज़ हुआ है और कैप्चर की प्रतीक्षा में है, या राशि या मुद्रा मेल नहीं खाती, या कैप्चर विफल हो गया। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है; ऑर्डर पर एक नोट कारण बताता है। आप System > Localisation > Order Statuses में अपना स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Cancelled status: होल्ड पर रखे ऑर्डर का भुगतान Quickpay में रद्द होने पर सेट होता है। जब आप इस एक्सटेंशन के किसी ऑर्डर को इस स्टेटस पर सेट करते हैं, तो उसका बिना भुगतान वाला भुगतान लिंक Quickpay में हटा दिया जाता है (देखें ऑर्डर और रिफ़ंड)। डिफ़ॉल्ट: Canceled।

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

उन्नत

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

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

Delete data: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (Quickpay भुगतान, रिफ़ंड, नोट) हमेशा रखा जाता है। डिफ़ॉल्ट: off।

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

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। लौटने भर से कुछ भी भुगतान किया हुआ नहीं बनता। ऑर्डर केवल तभी भुगतान किया हुआ चिह्नित होता है जब Quickpay पुष्टि करे: हस्ताक्षरित कॉलबैक ऑर्डर का स्टेटस तब सेट करता है जब कैप्चर की गई राशि और मुद्रा ऑर्डर से मेल खाती हैं। फिर ऑर्डर OpenCart के मानक तरीके से अपना स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। Authorize only के साथ, ऑर्डर को इसके बजाय "Quickpay payment on hold" status मिलता है, और आप भुगतान बाद में कैप्चर करते हैं। यदि ग्राहक के लौटने तक कॉलबैक नहीं आया, तो Payment confirmation पेज Your payment is being confirmed by Quickpay. You will receive an e-mail as soon as the order is confirmed. दिखाता है, साथ में Check again और Back to checkout बटन। जब Quickpay का कॉलबैक बाद में किसी ऑर्डर को "Quickpay payment on hold" status से भुगतान किए गए स्टेटस या Cancelled status पर ले जाता है, तो ग्राहक को ईमेल से सूचना मिलती है।

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

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

यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर The Quickpay payment could not be started. Please try again or choose another payment method. दिखता है। तकनीकी कारण लॉग में लिखा जाता है। यदि कुंजियाँ गायब हैं, तो संदेश Quickpay is not available at the moment. Please choose another payment method. होता है।

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

यह एक्सटेंशन केवल एकल भुगतान लेता है। इसमें सब्सक्रिप्शन या आवर्ती भुगतान, सेव किए गए कार्ड, या आंशिक कैप्चर नहीं हैं, यह Quickpay को कार्ट या इनवॉइस की पंक्तियाँ नहीं भेजता, और इसमें अलग MobilePay, Apple Pay या Klarna विकल्प नहीं हैं: ग्राहक आपकी Quickpay भुगतान विंडो के तरीकों में से चुनता है।

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

ऑर्डर स्टेटस

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

"Payment accepted" या "Delivered (completed)" status: Quickpay ने सही राशि और मुद्रा के साथ कैप्चर किए गए भुगतान की पुष्टि की है। स्टेटस Order status after payment के अनुसार होता है। एक नोट Quickpay भुगतान ID दिखाता है (टेस्ट भुगतानों के लिए TEST चिह्नित)।

"Quickpay payment on hold" status (डिफ़ॉल्ट Pending): भुगतान केवल ऑथराइज़ है और Capture Quickpay payment की प्रतीक्षा में है; या Quickpay ने ऑर्डर कुल से अलग राशि या मुद्रा बताई (जैसे Quickpay मैनेजर में कोई दूसरी राशि कैप्चर की गई); या कैप्चर विफल हुआ और राशि अब भी केवल रोकी हुई है। नोट इसे समझाता है। जब अलग राशि कैप्चर हुई हो, तब एक्सटेंशन वह राशि दर्ज करता है जो Quickpay ने कैप्चर की, और रिफ़ंड उसी राशि तक होते हैं।

Cancelled status: होल्ड पर रखे ऑर्डर का भुगतान Quickpay मैनेजर में रद्द किया गया।

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

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

जब आप इस एक्सटेंशन के किसी बिना भुगतान वाले ऑर्डर को ऑर्डर History में Cancelled status पर सेट करते हैं, तो उसका भुगतान लिंक Quickpay में हटा दिया जाता है। ऑथराइज़ किए गए ऑर्डर को रद्द करने से रोकी गई राशि अपने-आप मुक्त नहीं होती: एक नोट आपको याद दिलाता है कि Quickpay मैनेजर में भुगतान रद्द करें; अन्यथा रोक ऑथराइज़ेशन समाप्त होने पर खत्म होती है।

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

VibeFox Quickpay Gateway टैब

Sales > Orders में Quickpay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Quickpay Gateway टैब टेस्ट भुगतानों के लिए Test payment लेबल के साथ Payment ID, भुगतान का Status, Amount / refunded, ऑर्डर के सभी Quickpay भुगतानों की सूची (जब एक से अधिक हों), कैप्चर बटन, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Quickpay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनके पास एक्सटेंशन तक पहुँच है। कैप्चर और रिफ़ंड के लिए एक्सटेंशन बदलने का अधिकार चाहिए (System > Users > User Groups में सेट)।

कैप्चर

Authorize only के साथ, टैब में Capture Quickpay payment पर क्लिक करें और Capture the order total through Quickpay? की पुष्टि करें। ऑर्डर कुल कैप्चर होता है; आंशिक कैप्चर उपलब्ध नहीं है। यदि Quickpay तुरंत पुष्टि करता है, तो ऑर्डर Order status after payment के भुगतान किए गए स्टेटस पर चला जाता है, बिना ग्राहक को सूचित किए और बिना स्टॉक बदले, जैसे मैन्युअल स्टेटस बदलना। अन्यथा एक नोट बताता है कि कैप्चर का अनुरोध किया गया है, और Quickpay कॉलबैक की पुष्टि होने पर ऑर्डर भुगतान किया हुआ चिह्नित होता है। अस्वीकृत कैप्चर टैब में दिखता है और ऑर्डर पर नोट होता है।

रिफ़ंड

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

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

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

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

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

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

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

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

Quickpay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और API key तथा Private key दोनों सहेजी गई हैं। दोनों के बिना भुगतान विधि छिपी रहती है, और सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: Quickpay कॉलबैक आपके स्टोर तक नहीं पहुँचा या अस्वीकार हुआ। जाँचें कि आपका स्टोर इंटरनेट से पहुँच योग्य है (पासवर्ड सुरक्षा न हो), और Private key उसी Quickpay खाते की निजी कुंजी है। अस्वीकृत कॉलबैक हमेशा एक्सटेंशन पेज के लॉग में लिखे जाते हैं। हर कॉलबैक देखने के लिए Debug log चालू करें।

लॉग में Callback rejected: invalid checksum. दिखता है: सेटिंग्स की निजी कुंजी उस खाते की नहीं है जिसने कॉलबैक भेजा। Quickpay मैनेजर में Settings > Integration से उसे फिर से कॉपी करें।

लॉग में Callback rejected: the private key is not configured. दिखता है: निजी कुंजी दर्ज करें। उसके बिना कॉलबैक कभी स्वीकार नहीं होते।

लॉग में Callback: no order found for payment … दिखता है: कॉलबैक ऐसे Quickpay भुगतान से जुड़ा है जो इस स्टोर ने नहीं बनाया, जैसे OpenCart के बाहर किया गया भुगतान।

लॉग दिखाता है कि कार्ट किसी और अनुरोध द्वारा लॉक है: उसी कार्ट का कोई दूसरा कॉलबैक उस समय लागू हो रहा था। कॉलबैक को त्रुटि मिलती है, इसलिए Quickpay उसे फिर भेजता है।

टेस्ट भुगतान ने ऑर्डर को भुगतान किया हुआ नहीं बनाया: Test payments बंद है। लॉग और ऑर्डर पर एक नोट बताते हैं कि टेस्ट भुगतान स्वीकार नहीं हुआ। परीक्षण के दौरान सेटिंग चालू करें, और खाता लाइव होने पर बंद कर दें।

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

Test API key में Quickpay rejected the API key. दिखता है: कुंजी गलत है या ऐसे उपयोगकर्ता की है जिसके पास API पहुँच नहीं है। Quickpay मैनेजर से किसी API उपयोगकर्ता की API कुंजी कॉपी करें।

ग्राहक को The Quickpay payment could not be started. दिखता है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। उसमें Quickpay की त्रुटि दिखती है, जैसे ऐसी मुद्रा जिसे आपका Quickpay खाता स्वीकार नहीं करता।

रिफ़ंड विफल होता है: ऑर्डर में कैप्चर किया गया Quickpay भुगतान होना चाहिए। संदेश The Quickpay payment of this order has not been captured — there is nothing to refund. का अर्थ है कि भुगतान केवल ऑथराइज़ है; उसे Quickpay मैनेजर में कैप्चर करें या रद्द करें। Invalid refund amount: at most … का अर्थ है कि राशि कैप्चर किए गए भुगतान में बची राशि से अधिक है।

डेवलपर्स के लिए: भुगतान लिंक बनाए जाने से पहले, एक्सटेंशन लिंक पैरामीटर और ऑर्डर के साथ OpenCart इवेंट qpg_quickpay_link_data ट्रिगर करता है।

अनइंस्टॉल

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

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

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