VibeFox ifthenpay for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: केवल यूरो (EUR)। आपके स्टोर में EUR मुद्रा सक्षम होनी चाहिए, और भुगतान विधि केवल तभी दिखती है जब ग्राहक EUR में भुगतान करता है। ifthenpay 0.01 से 99,999.99 EUR तक की राशियाँ स्वीकार करता है।

ifthenpay खाता: ifthenpay.com पर साइन अप करें। आपको उस भुगतान विधि की कुंजी चाहिए जो आप प्रस्तुत करते हैं: Multibanco, MB WAY या Credit Card (प्रारूप ABC-123456)। कुंजियाँ ifthenpay बैकऑफ़िस (backoffice.ifthenpay.com) में दिखती हैं, या जब आपके खाते के लिए भुगतान विधि सक्रिय होती है तब ifthenpay उन्हें भेजता है। आपकी कुंजी के लिए ifthenpay को कॉलबैक भी सक्रिय करना होगा (देखें कॉन्फ़िगरेशन), और आपका स्टोर इंटरनेट से पहुँच योग्य होना चाहिए।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. Payment Method चुनें, उसकी ifthenpay कुंजी दर्ज करें और Save पर क्लिक करें, ताकि Callback URL चुनी गई भुगतान विधि से मेल खाए।

5. Callback सेक्शन से Anti-phishing Key और Callback URL कॉपी करें और ifthenpay से कहें कि आपकी कुंजी के लिए कॉलबैक सक्रिय करे (बैकऑफ़िस में या ifthenpay सहायता के माध्यम से)।

6. Enable/Disable चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox ifthenpay Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। चुनी हुई विधि की कुंजी के बिना, चेकआउट पर भुगतान विधि नहीं दिखाई जाती। जब तक गेटवे इस कुंजी के बिना सक्षम है, पेज ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय भुगतान विधि मान्य होनी चाहिए, शीर्षक 128 अक्षरों से अधिक नहीं हो सकता, Sort Order पूर्ण संख्या होनी चाहिए, Total 0 या उससे अधिक की संख्या होनी चाहिए, और जियो ज़ोन व ऑर्डर स्टेटस मौजूद होने चाहिए; नहीं तो कुछ भी सेव नहीं होता।

ifthenpay

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण पर, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay via Multibanco, MB WAY or Credit Card। इसे अपनी प्रस्तुत की गई विधि से मेल खाने के लिए बदलें।

Payment Method: चेकआउट पर प्रस्तुत की गई भुगतान विधि। केवल इसी विधि की कुंजी आवश्यक है।

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

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

Total: चेकआउट का वह कुल मूल्य, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही ifthenpay दिया जाता है। हर कुल राशि पर ifthenpay देने के लिए खाली छोड़ें। ifthenpay स्वयं तभी प्रस्तुत होता है जब ग्राहक EUR में भुगतान करे और राशि 0.01 से 99,999.99 EUR के बीच हो।

ifthenpay कुंजियाँ

कुंजियाँ (प्रारूप ABC-123456) ifthenpay बैकऑफ़िस में दिखती हैं (सेक्शन वहाँ का लिंक देता है), या जब आपके खाते के लिए भुगतान विधि सक्रिय होती है तब ifthenpay उन्हें भेजता है।

Multibanco Key: डायनामिक संदर्भों (references) के लिए आपकी ifthenpay Multibanco (MB) कुंजी।

MB WAY Key: आपकी ifthenpay MB WAY कुंजी।

Credit Card Key: आपकी ifthenpay Credit Card कुंजी। यह ग्राहक के कार्ड पेज से वापसी के हस्ताक्षर को भी सत्यापित करती है।

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

Callback

कॉलबैक आपके स्टोर को बताता है कि भुगतान हो गया है। जिस भी कुंजी का आप उपयोग करते हैं, उसके लिए ifthenpay से कहें कि इस सेक्शन की anti-phishing कुंजी और callback URL के साथ कॉलबैक सक्रिय करे। Multibanco और MB WAY के ऑर्डर केवल कॉलबैक से पक्के होते हैं; कार्ड भुगतान कार्ड पेज से हस्ताक्षरित वापसी से भी पक्के होते हैं।

Anti-phishing Key: एक्सटेंशन द्वारा बनाई जाती है और कॉपी करने के लिए दिखाई जाती है। ifthenpay इसे हर कॉलबैक में वापस भेजता है; इसके बिना कॉलबैक अस्वीकार कर दिए जाते हैं।

Callback URL: चुनी हुई भुगतान विधि का कॉलबैक URL, ifthenpay के प्लेसहोल्डर के साथ, कॉपी करने के लिए दिखाया गया। यह OpenCart 3 में https://your-store/index.php?route=extension/payment/wcp_ifthenpay_gateway/callback से और OpenCart 4 में https://your-store/index.php?route=extension/wcp_ifthenpay_gateway/payment/wcp_ifthenpay_gateway.callback से शुरू होता है, आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है, और फिर भुगतान विधि के पैरामीटर जुड़ते हैं। पूरा URL ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। यदि आप Payment Method बदलते हैं, तो सेव करें और नया URL कॉपी करें।

हर कॉलबैक की anti-phishing कुंजी आपकी कुंजी से मिलाई जाती है। गायब या गलत कुंजी का उत्तर 403 होता है, और ऑर्डर नहीं बदलता। कॉलबैक को इस एक्सटेंशन के किसी भुगतान से भी मेल खाना चाहिए: Multibanco के लिए इकाई और संदर्भ से, MB WAY के लिए ऑर्डर और उसके किसी MB WAY अनुरोध से, Credit Card के लिए ऑर्डर और उसके किसी कार्ड अनुरोध से। काम करने वाले कॉलबैक के बिना Multibanco और MB WAY के ऑर्डर कभी पक्के नहीं होते, और कार्ड भुगतान केवल हस्ताक्षरित वापसी से पक्के होते हैं। स्टोर मेंटेनेंस मोड में होने पर भी कॉलबैक काम करता है। OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 में एक्सटेंशन एक स्टार्टअप एक्शन जोड़ता है जो कॉलबैक और कार्ड पेज से ग्राहक की वापसी को जाने देता है।

Orders

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के (गायब ऑर्डर) बनाता है। Multibanco और MB WAY के लिए, जैसे ही ifthenpay संदर्भ या MB WAY अनुरोध जारी करता है, ऑर्डर को प्रतीक्षा स्टेटस मिल जाता है; Credit Card के लिए ऑर्डर को स्टेटस केवल कॉलबैक या हस्ताक्षरित वापसी से मिलता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब राशि ऑर्डर कुल से एक पैसे तक मेल खाए। नीचे के हर फ़ील्ड में आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध हैं।

Order Status After Payment: भुगतान पक्का होने पर सेट होने वाला स्टेटस। डिफ़ॉल्ट: प्रोसेसिंग।

Awaiting payment status: एक Multibanco संदर्भ या MB WAY अनुरोध जारी हुआ है, और ग्राहक को अभी भुगतान करना है। Multibanco विवरण इसी स्टेटस के साथ ऑर्डर ईमेल और ग्राहक के ऑर्डर इतिहास में भेजे जाते हैं। डिफ़ॉल्ट: लंबित।

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

उन्नत

Test Mode: Credit Card और Multibanco ifthenpay के सैंडबॉक्स एंडपॉइंट इस्तेमाल करते हैं; कोई वास्तविक राशि नहीं ली जाती, और आप ifthenpay द्वारा दी गई टेस्ट कुंजियाँ इस्तेमाल करते हैं। MB WAY का कोई सैंडबॉक्स नहीं है: इसे ifthenpay की टेस्ट कुंजी से परखें। Confirm Order चरण पर TEST MODE बैज दिखता है। डिफ़ॉल्ट: बंद।

Debug Log: API अनुरोध और कॉलबैक ifthenpay_p_debug.log.php में OpenCart लॉग फ़ोल्डर (storage/logs) में लिखे जाते हैं। यह फ़ाइल वेब से नहीं खोली जा सकती और 5 MB पर घुमा दी जाती है। त्रुटियाँ हमेशा दर्ज होती हैं। कुंजियाँ, anti-phishing कुंजी और पूरे फ़ोन नंबर कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से गेटवे सेटिंग्स, anti-phishing कुंजी और लॉग हट जाते हैं। ऑर्डर और ifthenpay भुगतान रिकॉर्ड हमेशा रहते हैं। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से ifthenpay)। Confirm Order चरण पर ग्राहक आपका विवरण और विधि का संकेत देखता है। OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्टेटस के।

OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

Multibanco. ग्राहक को You will receive a Multibanco reference to complete the payment. दिखता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर कुल के लिए एक डायनामिक Multibanco संदर्भ बनाता है, और ऑर्डर को Awaiting payment status मिल जाता है। ऑर्डर सफलता पेज पर Multibanco Payment Details दिखता है: इकाई, संदर्भ और राशि, साथ में Please use these details to pay at any Multibanco ATM or through your online banking. वही विवरण ऑर्डर ईमेल में भी भेजे जाते हैं और ग्राहक के ऑर्डर इतिहास में दिखते हैं। यदि उसी राशि के लिए ऑर्डर का संदर्भ पहले ही बन चुका है, तो वही दोबारा इस्तेमाल होता है। जब ifthenpay भुगतान कॉलबैक भेजता है, तब ऑर्डर का भुगतान हो जाता है।

MB WAY. ग्राहक MB WAY phone number दर्ज करता है (912 345 678, +351 912 345 678, या अन्य देशों के लिए 351#912345678); ऑर्डर का फ़ोन अपने-आप भरा होता है। एक्सटेंशन उस फ़ोन पर भुगतान अनुरोध भेजता है, और ऑर्डर को Awaiting payment status मिल जाता है। ऑर्डर सफलता पेज कहता है A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. जब ifthenpay कॉलबैक भेजता है, तब ऑर्डर का भुगतान हो जाता है। केवल मास्क किया हुआ फ़ोन नंबर सहेजा जाता है। डिफ़ॉल्ट रूप से OpenCart 4 चेकआउट पर फ़ोन नंबर नहीं माँगता; फ़ील्ड खाली रहता है और ग्राहक नंबर दर्ज करता है।

Credit Card. ग्राहक को You will be redirected to a secure page to enter your card details. दिखता है और वह ifthenpay के कार्ड पेज पर भेजा जाता है। ऑर्डर बिना स्टेटस के रहता है, और कार्ट सुरक्षित रहता है। सफल भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। वापसी केवल तभी स्वीकार होती है जब मान्य ifthenpay हस्ताक्षर, उस प्रयास का गुप्त मान और ऑर्डर का कार्ड अनुरोध मौजूद हो; तब ऑर्डर भुगतान किया हुआ चिह्नित होता है और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। यदि वापसी सत्यापित नहीं हो पाती, तो कुछ नहीं बदलता, और Payment confirmation पेज Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. दिखाता है, साथ में Check again और Back to checkout बटन; कॉलबैक आते ही भुगतान की पुष्टि हो जाती है। कार्ड भुगतान विफल होने या रद्द होने पर ग्राहक The card payment was not completed. You can try again or choose another payment method. या The card payment was cancelled. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। ऑर्डर के हर कार्ड प्रयास को रखा जाता है, इसलिए पुराने टैब में किया गया भुगतान भी स्वीकार होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

जब भुगतान पक्का हो जाता है, तब ऑर्डर को सामान्य OpenCart तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल के साथ। OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है; OpenCart 4 चेकआउट का ऑर्डर अपडेट करता है, इसलिए रद्द या विफल कार्ड भुगतान के बाद, या अस्वीकृत MB WAY अनुरोध के बाद, ग्राहक नए प्रयास से वही ऑर्डर चुकाता है। यदि उसी कार्ट का कोई भुगतान किया हुआ ऑर्डर या Multibanco या MB WAY भुगतान की प्रतीक्षा करने वाला ऑर्डर पहले से है, तो ग्राहक नया भुगतान शुरू करने के बजाय उस ऑर्डर के सफलता पेज पर चला जाता है। Multibanco विवरण और MB WAY संकेत सफलता पेज पर केवल तब तक दिखते हैं जब तक ऑर्डर भुगतान की प्रतीक्षा में है। कार्ट में बदलाव, जिसमें नई मात्रा भी शामिल है, एक नया कार्ट माना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर सफलता पेज दिखने तक चेकआउट में रहता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए, आपने Multibanco भुगतान की प्रतीक्षा वाला ऑर्डर रद्द कर दिया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है। यदि ऑर्डर पहले ही दर्ज हो चुका है और उसके बाद कार्ट बदला गया है, तो संदेश है Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर चुकाता है।

यदि भुगतान शुरू नहीं हो पाता, तो ग्राहक बटन के ऊपर एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, जैसे The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method., या The payment service is temporarily unavailable. Please try again in a few minutes. तकनीकी कारण लॉग में लिखा जाता है।

एक्सटेंशन एक समय में एक ifthenpay भुगतान विधि प्रस्तुत करता है। इसमें Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX या Pay-by-Link नहीं हैं, कोई सब्सक्रिप्शन या सहेजे गए कार्ड नहीं हैं, बिना भुगतान वाले Multibanco संदर्भों की स्वचालित समाप्ति या रद्दीकरण नहीं है, और भुगतान स्थिति की पोलिंग भी नहीं है।

ऑर्डर

ऑर्डर स्टेटस

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

Awaiting payment status (default Pending): एक Multibanco संदर्भ जारी हुआ या MB WAY अनुरोध भेजा गया। बिना भुगतान वाले संदर्भ और अस्वीकृत MB WAY अनुरोध ऑर्डर को अपने-आप रद्द नहीं करते; ज़रूरत हो तो ऐसे ऑर्डर स्वयं रद्द करें।

Order Status After Payment (default Processing): भुगतान की पुष्टि हुई। एक नोट Multibanco संदर्भ, MB WAY लेन-देन या कार्ड अनुरोध ID और पुष्टि के तरीके को दिखाता है।

Payment on hold status (default Pending): प्राप्त राशि ऑर्डर कुल से अलग थी (उदाहरण के लिए, कार्ड भुगतान शुरू होने के बाद कार्ट बदला गया), ऑर्डर रद्द होने के बाद भुगतान आया, या उसी कार्ट का कोई दूसरा ऑर्डर पहले ही भुगतान हो चुका था। नोट यह समझाता है, और ग्राहक से फिर से भुगतान करने को नहीं कहा जाता। ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें। ऐसे ऑर्डर के लिए बाद में आया सही भुगतान उसे नहीं बदलता।

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

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

VibeFox ifthenpay Gateway टैब

Sales > Orders में ifthenpay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox ifthenpay Gateway टैब ऑर्डर के भुगतान प्रयासों की सूची दिखाता है (तारीख, विधि, टेस्ट भुगतानों के लिए Sandbox लेबल, राशि, Multibanco इकाई और संदर्भ या मास्क किया गया MB WAY फ़ोन, ifthenpay अनुरोध ID और स्टेटस), ऑर्डर होल्ड पर होने तक Payment on hold चेतावनी, और ऑर्डर के ifthenpay notes। यह टैब केवल पढ़ने के लिए है और उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन तक पहुँच है।

रिफ़ंड

OpenCart से रिफ़ंड समर्थित नहीं हैं। ifthenpay बैकऑफ़िस में भुगतान रिफ़ंड करें और उसे OpenCart में मैन्युअली दर्ज करें। Sales > Returns में उत्पाद वापसी ifthenpay के ज़रिए पैसे वापस नहीं भेजती। रिफ़ंड हुआ (DEVOLVIDO) कॉलबैक केवल एक नोट जोड़ता है। ifthenpay द्वारा बताए गए अन्य स्टेटस भी केवल एक नोट जोड़ते हैं।

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

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

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

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

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

चेकआउट पर ifthenpay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुनी गई Payment Method की कुंजी भरी है, ग्राहक EUR में भुगतान करता है, और कुल राशि 0.01 से 99,999.99 EUR के बीच है। यह भी जाँचें कि भुगतान पता चुने हुए Geo Zone में है, और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

ग्राहक ने भुगतान किया, पर ऑर्डर प्रतीक्षा स्टेटस या बिना स्टेटस के रहा: कॉलबैक आपके स्टोर तक नहीं पहुँच रहा। जाँचें कि ifthenpay ने जिस कुंजी का आप उपयोग करते हैं उसके लिए कॉलबैक URL और anti-phishing कुंजी सक्रिय की है, और URL चुनी हुई विधि का है। स्टोर इंटरनेट से पहुँच योग्य होना चाहिए, localhost पर नहीं और लॉगिन के पीछे नहीं। Debug Log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

कॉलबैक 403 Forbidden का उत्तर देता है: कॉलबैक में anti-phishing कुंजी गायब है या सेटिंग्स की कुंजी से अलग है। सेटिंग्स में दिखाई गई कुंजी ifthenpay को फिर से भेजें।

कॉलबैक 503 Not configured का उत्तर देता है: anti-phishing कुंजी अभी तक नहीं बनी है। एक्सटेंशन सेटिंग्स एक बार खोलें; ifthenpay कॉलबैक फिर से भेजेगा।

कॉलबैक 503 Busy का उत्तर देता है: उसी समय यही ऑर्डर किसी दूसरे अनुरोध से संसाधित हो रहा था। ifthenpay कॉलबैक फिर से भेजेगा।

कॉलबैक Order not found का उत्तर देता है: संदर्भ या अनुरोध इस एक्सटेंशन के किसी भुगतान का नहीं है, या ऑर्डर किसी दूसरी भुगतान विधि से दिया गया था।

भुगतान किया हुआ ऑर्डर होल्ड पर क्यों गया? प्राप्त राशि ऑर्डर कुल से अलग थी, भुगतान ऑर्डर रद्द होने के बाद आया, या उसी कार्ट का कोई दूसरा ऑर्डर पहले ही भुगतान हो चुका था। VibeFox ifthenpay Gateway टैब के नोट पढ़ें, ifthenpay बैकऑफ़िस में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें।

MB WAY अनुरोध नहीं भेजा जा सका: फ़ोन नंबर MB WAY से लिंक नहीं है या उसका प्रारूप गलत है। 912 345 678 का उपयोग करें, या अन्य देशों के नंबरों के लिए 351#912345678 का।

टेस्ट मोड और MB WAY: ifthenpay के पास MB WAY के लिए सैंडबॉक्स नहीं है; ifthenpay द्वारा दी गई टेस्ट कुंजी का उपयोग करें।

अनइंस्टॉल

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

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

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