VibeFox SimplePay for OpenCart — सहायता

आवश्यकताएँ

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

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

स्टोर की मुद्रा: HUF, EUR या USD। SimplePay अन्य मुद्राएँ स्वीकार नहीं करता, और जब ग्राहक ने कोई दूसरी मुद्रा चुनी हो, तब भुगतान विधि नहीं दी जाती।

SimplePay मर्चेंट खाते: SimplePay हर मुद्रा के लिए अलग मर्चेंट खाता देता है, और लाइव तथा सैंडबॉक्स के लिए अलग खाते। हर खाते के लिए आपको SimplePay मर्चेंट एडमिन से उसका MERCHANT और SECRET KEY चाहिए (लाइव के लिए admin.simplepay.hu, सैंडबॉक्स के लिए sandbox.simplepay.hu), account > Technical data में। यदि आप केवल HUF में बेचते हैं, तो HUF खाता पर्याप्त है। कोई और कुंजी आवश्यक नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. जिस हर मुद्रा में आप बेचते हैं, उसके लिए अपने SimplePay खातों का MERCHANT और SECRET KEY दर्ज करें: परीक्षण के लिए सैंडबॉक्स खाते और असली भुगतानों के लिए लाइव खाते (देखें Configuration)।

5. सेटिंग्स पेज पर दिखने वाला IPN URL SimplePay मर्चेंट एडमिन में हर मर्चेंट खाते (लाइव और सैंडबॉक्स) में कॉपी करें।

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

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox SimplePay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब स्टोर की डिफ़ॉल्ट मुद्रा SimplePay द्वारा समर्थित न हो, या जब वर्तमान मोड में उस मुद्रा के लिए कोई मर्चेंट खाता न हो। दोनों ही मामलों में उस मुद्रा के ऑर्डरों के लिए भुगतान विधि नहीं दी जाती। जब sandbox mode चालू हो, तो पेज Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. दिखाता है। एक्सटेंशन को संशोधित करने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

SimplePay (OTP)

Enable/Disable: Enable SimplePay Gateway भुगतान विधि को चालू या बंद करता है। Default: off.

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। Default: SimplePay (Card Payment). आवश्यक।

Description: वह पाठ जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। Default: Pay securely with your credit or debit card via SimplePay. हंगेरियन मर्चेंट यहाँ SimplePay का डेटा ट्रांसफ़र घोषणा-पत्र डाल सकते हैं।

Sandbox mode: सैंडबॉक्स खातों के साथ परीक्षण भुगतानों के लिए SimplePay सैंडबॉक्स का उपयोग करता है। यह API पता और मर्चेंट खाते दोनों बदल देता है। कोई असली धनराशि नहीं ली जाती। Default: on. असली भुगतान लाइव खातों से लेने के लिए इसे बंद करें। चालू होने पर ग्राहकों को Confirm Order चरण पर Sandbox mode: no real payment is taken. दिखता है। सैंडबॉक्स में शुरू किए गए ऑर्डर हमेशा सैंडबॉक्स में रिफ़ंड होते हैं।

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

Geo Zone: SimplePay केवल चुने गए geo zone में स्थित भुगतान पतों के लिए दें। Default: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।

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

लाइव मर्चेंट खाते

वे खाते जो तब उपयोग होते हैं जब Sandbox mode बंद हो। अपने स्टोर की बिक्री वाली मुद्राओं के खाते भरें। MERCHANT और SECRET KEY के मान SimplePay मर्चेंट एडमिन (admin.simplepay.hu, जहाँ सेक्शन के लिंक हैं) में account > Technical data में होते हैं। कोई खाता तभी उपयोग होता है जब उसके दोनों फ़ील्ड भरे हों।

HUF account — Merchant ID: आपके लाइव HUF खाते का MERCHANT।

HUF account — Secret key: आपके लाइव HUF खाते का SECRET KEY।

EUR account — Merchant ID और EUR account — Secret key: अपने लाइव EUR खाते के लिए भी यही।

USD account — Merchant ID और USD account — Secret key: अपने लाइव USD खाते के लिए भी यही।

सैंडबॉक्स मर्चेंट खाते

वे खाते जो तब उपयोग होते हैं जब Sandbox mode चालू हो। फ़ील्ड लाइव खातों जैसे ही हैं: HUF account — Merchant ID, HUF account — Secret key और EUR तथा USD के लिए वही जोड़े। मान SimplePay सैंडबॉक्स मर्चेंट एडमिन (sandbox.simplepay.hu) में account > Technical data से लें।

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

IPN URL

IPN वह संदेश है जो भुगतान की स्थिति बदलने पर SimplePay आपके स्टोर को भेजता है। ऑर्डर को स्टेटस मिलने का यह सामान्य तरीका है। यह सेक्शन आपके स्टोर का IPN URL दिखाता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_simplepay_gateway/ipn, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_simplepay_gateway/payment/wcp_simplepay_gateway.ipn। यह आपकी OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इस URL को SimplePay मर्चेंट एडमिन में हर मर्चेंट खाते (लाइव और सैंडबॉक्स) के लिए सेट करें। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स उसे दिखाती हैं, क्योंकि रीडायरेक्ट किया गया IPN खो जाता है।

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

अस्वीकृत, रद्द और समय-सीमा समाप्त स्टेटस केवल उस कार्ट के नवीनतम भुगतान प्रयास के लिए दर्ज होते हैं, जिसमें अभी कुछ भी भुगतान नहीं हुआ है। अन्य स्टेटस कुछ नहीं बदलते। IPN के बिना ऑर्डर को स्टेटस तभी मिलता है जब ग्राहक सफल भुगतान के बाद स्टोर पर लौटता है।

ऑर्डर

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

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

Paid Order Status: जब Order Status After Payment Processing हो, तब भुगतान किए गए ऑर्डर का स्टेटस। Default: Processing.

Complete Order Status: जब Order Status After Payment Completed हो, तब भुगतान किए गए ऑर्डर का स्टेटस। Default: Complete.

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

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

एडवांस्ड

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

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (SimplePay लेन-देन और रिफ़ंड) हमेशा रखा जाता है। Default: off.

इंपोर्ट / एक्सपोर्ट

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

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

चेकआउट

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

सफल भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। केवल लौटने से कोई ऑर्डर भुगतान नहीं होता: एक्सटेंशन हस्ताक्षरित अनुरोध से SimplePay से लेन-देन का स्टेटस पूछता है, इसलिए यदि IPN देर से भी आए, तो ऑर्डर को स्टेटस मिल जाता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब SimplePay उसकी पुष्टि करता है। इसके बाद ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को Successful transaction. SimplePay transaction ID: और ID के साथ OpenCart का ऑर्डर सफलता पेज दिखता है। यदि SimplePay ने अभी भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज ID के साथ Your payment is being confirmed by SimplePay. SimplePay transaction ID:, Your order will be confirmed as soon as SimplePay confirms the payment — please do not pay again. संदेश, और Check again तथा Back to checkout बटन दिखाता है; IPN आते ही ऑर्डर स्टेटस सेट कर देता है।

यदि भुगतान विफल होता है, रद्द होता है या समय-सीमा समाप्त हो जाती है, तो ग्राहक SimplePay के संदेश और लेन-देन ID के साथ चेकआउट पर लौट आता है, उदाहरण के लिए Cancelled payment. You cancelled the payment या Timeout. The time allowed to complete the payment has expired। विफल भुगतान पर ग्राहक से दर्ज डेटा जाँचने और कार्ड जारी करने वाले बैंक से संपर्क करने को कहा जाता है। ऑर्डर बिना स्टेटस के रहता है, कार्ट बना रहता है, और ग्राहक फिर से कोशिश कर सकता है। OpenCart 3 में जब भी Confirm Order चरण दिखाया जाता है, नया ऑर्डर बनता है। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए अगला प्रयास उसी ऑर्डर का भुगतान करता है। हर प्रयास को अपना SimplePay संदर्भ मिलता है: OC, ऑर्डर नंबर और प्रयास नंबर, उदाहरण के लिए OC123-1 और फिर OC123-2। यदि उसी कार्ट का कोई और ऑर्डर पहले ही भुगतान किया हुआ है या समीक्षा में है, तो ग्राहक दोबारा भुगतान करने के बजाय सीधे सफलता पेज पर जाता है।

यदि SimplePay भुगतान शुरू नहीं कर सकता, तो ग्राहक Confirm Order चरण पर रहता है और The SimplePay payment could not be started. Please try again or choose another payment method. देखता है। यदि ऑर्डर की मुद्रा का कोई मर्चेंट खाता नहीं है, तो संदेश SimplePay is not available for the currency of this order. Please choose another payment method. होता है। तकनीकी कारण लॉग में लिखा जाता है। कोई वापसी जिसे किसी भुगतान प्रयास से मिलाया नहीं जा सकता, We could not match this payment to an order. If you were charged, please contact us. दिखाती है।

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

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

एक्सटेंशन केवल SimplePay पेज पर कैप्चर किए गए एकमुश्त कार्ड भुगतान लेता है। इसमें सेव किए गए कार्ड या वन-क्लिक भुगतान, सब्सक्रिप्शन या आवर्ती भुगतान नहीं हैं, और अलग अधिकृतिकरण तथा कैप्चर भी नहीं है।

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

ऑर्डर स्टेटस

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

Paid Order Status or Complete Order Status: भुगतान की पुष्टि हो गई है। स्टेटस Order Status After Payment का अनुसरण करता है। एक नोट SimplePay लेन-देन ID और यह दिखाता है कि पुष्टि IPN ने की या स्टेटस क्वेरी ने।

On Hold (Review) Status (default Pending): भुगतान शुरू होने के बाद ऑर्डर का कुल या मुद्रा बदल दी गई, इसलिए भुगतान की गई राशि ऑर्डर से मेल नहीं खाती। नोट दोनों राशियाँ दिखाता है। ऑर्डर जाँचें और SimplePay मर्चेंट एडमिन में ऑर्डर पूरा करें या भुगतान रिफ़ंड करें। यदि उसी कार्ट का कोई और प्रयास बाद में सही राशि के साथ भुगतान होता है, तो उस भुगतान के ऑर्डर को भुगतान किए गए स्टेटस का स्टेटस मिलता है।

Refunded Status (default Refunded): भुगतान एक्सटेंशन के ज़रिए पूरी तरह रिफ़ंड किया गया।

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

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

VibeFox SimplePay Gateway tab

Sales > Orders में SimplePay से भुगतान किया गया एक ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox SimplePay Gateway टैब सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ Transaction ID, Order reference (orderRef), Merchant account और मोड, SimplePay का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास, एक से अधिक होने पर Payment attempts of the cart, और ऑर्डर के SimplePay notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी SimplePay के ज़रिए पैसे वापस नहीं भेजती। SimplePay मर्चेंट एडमिन में किए गए रिफ़ंड OpenCart के साथ सिंक नहीं होते। उन्हें मैन्युअली दर्ज करें।

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

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

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

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

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

SimplePay चेकआउट पर दिखाई नहीं दे रहा: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, ग्राहक की मुद्रा HUF, EUR या USD है, और उस मुद्रा के पास वर्तमान मोड में Merchant ID और Secret key दोनों हैं: Sandbox mode चालू होने पर सैंडबॉक्स खाते, और बंद होने पर लाइव खाते। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के है: IPN स्टोर तक नहीं पहुँचा। SimplePay मर्चेंट एडमिन में, जिस मर्चेंट खाते का आप उपयोग करते हैं (लाइव या सैंडबॉक्स, ऑर्डर की मुद्रा), उसका IPN URL जाँचें। वह सेटिंग्स में दिखाए गए URL से बिल्कुल मेल खाना चाहिए, और आपका सर्वर इंटरनेट से पहुँच योग्य होना चाहिए। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर को स्टेटस मिल जाता है।

IPN जवाब देता है Invalid signature.: IPN ऐसे मर्चेंट खाते का नाम लेता है जो सेटिंग्स में नहीं है, उसकी Secret key गलत है, या वह भुगतान से अलग मोड के खाते से हस्ताक्षरित है। MERCHANT और SECRET KEY को ठीक वैसे ही दर्ज करें जैसे SimplePay मर्चेंट एडमिन उन्हें दिखाता है। SimplePay अपुष्ट IPN दोबारा भेजता है।

IPN जवाब देता है Order not found. या Unknown transaction.: IPN ऐसे भुगतान के लिए है जिसे यह स्टोर शुरू नहीं कर पाया था। कुछ नहीं बदला जाता।

IPN जवाब देता है Busy, retry.: कार्ट उसी समय किसी दूसरे अनुरोध द्वारा प्रोसेस हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। SimplePay IPN को फिर से कोशिश करता है। कारण लॉग में लिखा जाता है।

ग्राहक को The SimplePay payment could not be started दिखता है: एक्सटेंशन पेज पर Log फ़ील्ड देखें। गलत गुप्त कुंजी से Invalid response signature from SimplePay. Check the secret key of the merchant account. आता है। SimplePay की त्रुटियाँ उनके त्रुटि कोड के साथ लॉग होती हैं।

ग्राहक को This payment method is not available. दिखता है: चेकआउट अब ऑर्डर से मेल नहीं खाता, या इस बीच भुगतान विधि बंद कर दी गई थी। ग्राहक चेकआउट को रीलोड करता है।

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

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox SimplePay Gateway टैब में नोट्स पढ़ें। भुगतान शुरू होने के बाद ऑर्डर का कुल या मुद्रा बदल दी गई थी। ऑर्डर पूरा करें या SimplePay मर्चेंट एडमिन में भुगतान रिफ़ंड करें।

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

रिफ़ंड विफल होता है: टैब में संदेश पढ़ें। SimplePay refunds in HUF must be whole amounts. का अर्थ है कि HUF राशि में दशमलव था। यदि संदेश कहता है कि इस भुगतान का मर्चेंट खाता कॉन्फ़िगर नहीं है, तो जिस मुद्रा और मोड में भुगतान हुआ था, वह खाता फिर से दर्ज करें। यदि SimplePay ने कोई अलग राशि रिफ़ंड की है, तो संदेश आपसे SimplePay एडमिन में रिफ़ंड जाँचने को कहता है।

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

अनइंस्टॉल

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

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

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