VibeFox Eupago for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: यूरो (EUR)। Eupago केवल यूरो में शुल्क लेता है, इसलिए आपके स्टोर में यूरो सक्षम होना चाहिए; जब ग्राहक किसी दूसरी मुद्रा में भुगतान करता है, तो चेकआउट पर भुगतान विधि छिपा दी जाती है।

Eupago खाता: आपको अपने Eupago चैनल की API कुंजी और Eupago बैकऑफ़िस में आप जो Webhook 2.0 बनाते हैं उसकी कुंजी चाहिए (देखें कॉन्फ़िगरेशन)। लाइव बैकऑफ़िस clientes.eupago.pt है, सैंडबॉक्स बैकऑफ़िस sandbox.eupago.pt है। सैंडबॉक्स और लाइव अलग-अलग खाते हैं और उनकी कुंजियाँ भी अलग हैं।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपने Eupago चैनल की API कुंजी दर्ज करें, Eupago बैकऑफ़िस में Webhook 2.0 बनाएँ और उसकी कुंजी चिपकाएँ (देखें कॉन्फ़िगरेशन)।

5. Payment Method चुनें, Enable/Disable चालू करें और Save पर क्लिक करें। सैंडबॉक्स मोड में एक टेस्ट ऑर्डर दें, फिर Sandbox Mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Eupago Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। जब भुगतान विधि सक्षम हो, तब यदि वर्तमान मोड की API कुंजी खाली है (तब चेकआउट पर भुगतान विधि छिपी रहती है) तो पेज सेटिंग्स के ऊपर चेतावनी देता है, या सैंडबॉक्स मोड चालू होने पर Sandbox mode: no real payments are taken. दिखाता है। एक्सटेंशन को संशोधित करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।

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

Eupago

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

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

Description: Confirm Order चरण पर पुष्टि बटन के ऊपर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely via Eupago.

Payment Method: चेकआउट पर दी जाने वाली एकमात्र Eupago भुगतान विधि।

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

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

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

Eupago खाता

अपने चैनल की API कुंजी और Webhook 2.0 की कुंजी Eupago बैकऑफ़िस में प्राप्त करें: clientes.eupago.pt (लाइव) या sandbox.eupago.pt (सैंडबॉक्स)। सैंडबॉक्स और लाइव अलग-अलग खाते हैं और उनकी कुंजियाँ भी अलग हैं।

Sandbox Mode: sandbox.eupago.pt और सैंडबॉक्स कुंजियों का उपयोग करता है। कोई वास्तविक भुगतान नहीं लिया जाता। डिफ़ॉल्ट: चालू। लाइव कुंजियों से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर SANDBOX / TEST MODE देखते हैं।

Live API Key: आपके लाइव Eupago चैनल की API कुंजी (clientes.eupago.pt)।

Live Webhook Key: आपके लाइव Webhook 2.0 की एन्क्रिप्शन कुंजी। आवश्यक: वैध हस्ताक्षर के बिना नोटिफ़िकेशन अस्वीकार कर दिए जाते हैं।

Sandbox API Key: आपके सैंडबॉक्स चैनल की API कुंजी (sandbox.eupago.pt)।

Sandbox Webhook Key: आपके सैंडबॉक्स Webhook 2.0 की एन्क्रिप्शन कुंजी।

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

Webhook URL

वेबहुक आपके स्टोर को बताता है कि भुगतान किया गया है। Eupago बैकऑफ़िस में इस सेक्शन में दिखाए गए URL, मेथड POST और एन्क्रिप्शन सक्षम करके एक Webhook 2.0 बनाएँ। OpenCart 3 पर URL https://your-store/index.php?route=extension/payment/wcp_eupago_gateway/webhook जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_eupago_gateway/payment/wcp_eupago_gateway.webhook जैसा दिखता है और आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। सैंडबॉक्स बैकऑफ़िस में एक वेबहुक बनाएँ और लाइव बैकऑफ़िस में दूसरा।

हर वेबहुक की कुंजी को Sandbox Webhook Key या Live Webhook Key में कॉपी करें। बिना वैध हस्ताक्षर वाले वेबहुक अस्वीकार कर दिए जाते हैं। बिना एन्क्रिप्शन वाला वेबहुक तभी स्वीकार होता है जब Eupago उस पर हस्ताक्षर करता है, इसलिए एन्क्रिप्शन चालू रखें। नोटिफ़िकेशन पर उसी मोड की कुंजी से हस्ताक्षर होना चाहिए जिसमें भुगतान शुरू हुआ था, इसलिए सैंडबॉक्स नोटिफ़िकेशन कभी लाइव भुगतान का भुगतान नहीं करता। एक्सटेंशन इन नोटिफ़िकेशन स्थितियों पर प्रतिक्रिया देता है:

अन्य स्थितियों के लिए कोई कार्रवाई आवश्यक नहीं है। उसी URL पर Eupago का पुराना GET कॉलबैक भी स्वीकार किया जाता है; यह API कुंजी से प्रमाणित होता है और हमेशा एक भुगतान की सूचना देता है। नोटिफ़िकेशन के बिना ऑर्डर कभी भुगतान किए हुए चिह्नित नहीं होते: एक्सटेंशन Eupago से पूछताछ नहीं करता, और ग्राहक का लौटना किसी ऑर्डर का भुगतान नहीं करता। स्टोर मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है (ग्राहक की कार्ड पेज से वापसी के लिए भी)।

ऑर्डर

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

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

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

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

Cancelled status: Eupago ने प्रतीक्षारत ऑर्डर के वर्तमान भुगतान को रद्द या समाप्त बताया है। डिफ़ॉल्ट: Canceled।

Failed status: Eupago ने प्रतीक्षारत ऑर्डर के वर्तमान भुगतान को विफल (ERROR) बताया है। डिफ़ॉल्ट: Failed।

उन्नत

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

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने पर गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और उनके Eupago भुगतान रिकॉर्ड सुरक्षित रहते हैं। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Eupago)। OpenCart Confirm Order चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है तो क्या होता है, वह Payment Method पर निर्भर करता है।

Multibanco: ग्राहक को You will receive Multibanco payment details after placing the order. दिखता है। एक्सटेंशन ऑर्डर कुल राशि के लिए यूरो में एक Multibanco संदर्भ बनाता है, और ऑर्डर को Awaiting payment status मिलती है। ऑर्डर ईमेल और ग्राहक के ऑर्डर इतिहास को एंटिटी, संदर्भ और राशि के साथ Multibanco Payment Details की टिप्पणी मिलती है। ऑर्डर सफलता पेज भी वही विवरण दिखाता है। ग्राहक ATM या होम बैंकिंग में भुगतान करता है।

MB WAY: ग्राहक MB WAY Phone Number दर्ज करता है, जो ऑर्डर के फ़ोन से पहले से भरा होता है। पुर्तगाली नंबर +351 के बिना दर्ज किए जा सकते हैं। OpenCart 4 में फ़ोन डिफ़ॉल्ट रूप से नहीं माँगा जाता, इसलिए वहाँ फ़ील्ड आम तौर पर खाली होता है और ग्राहक नंबर दर्ज करता है। गलत नंबर पर Please enter a valid MB WAY phone number (e.g. 912 345 678 or +351 912 345 678). दिखता है। एक्सटेंशन MB WAY ऐप को भुगतान अनुरोध भेजता है, और ऑर्डर को Awaiting payment status मिलती है। सफलता पेज ग्राहक से कहता है कि वह मास्क किए गए फ़ोन नंबर पर MB WAY ऐप खोले और 5 मिनट के भीतर अनुरोध स्वीकृत करे। यदि Eupago अनुरोध अस्वीकार करता है, तो ग्राहक Confirm Order चरण पर रहता है और The MB WAY payment could not be started. Check that the phone number is associated with MB WAY and try again. देखता है।

Credit Card: ग्राहक को You will be redirected to a secure payment page to enter your card details. दिखता है। ग्राहक को स्टोर भाषा के अनुसार पुर्तगाली, स्पेनिश या अंग्रेज़ी में Eupago के कार्ड भुगतान पेज पर भेजा जाता है। ऑर्डर बिना स्थिति के रहता है, और कार्ट सुरक्षित रहता है। यदि ग्राहक के लौटने पर नोटिफ़िकेशन आ चुका है, तो वह OpenCart ऑर्डर सफलता पेज देखता है। अन्यथा एक Payment confirmation पेज Your card payment is being confirmed by Eupago. 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 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

हर विधि के लिए, ऑर्डर का भुगतान तभी चिह्नित होता है जब Eupago सत्यापित नोटिफ़िकेशन से उसकी पुष्टि करता है। फिर ऑर्डर को स्टॉक अपडेट के साथ OpenCart के मानक तरीके से स्थिति मिलती है। भुगतान विवरण सफलता पेज पर केवल तब तक दिखते हैं जब तक ऑर्डर भुगतान का इंतज़ार कर रहा है। यदि Eupago ने पहले ही भुगतान के रद्द, समाप्त या विफल होने की सूचना दे दी है, तो सफलता पेज Your Eupago payment was not completed. Please contact us about this order. दिखाता है।

OpenCart 3 हर बार जब Confirm Order चरण दिखाया जाता है, एक नया ऑर्डर बनाता है। OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए रद्द या विफल कार्ड भुगतान के बाद ग्राहक उसी ऑर्डर का नए Eupago भुगतान से भुगतान करता है। यदि उसी कार्ट का कोई पिछला ऑर्डर पहले ही Eupago से भुगतान हो चुका है, तो ग्राहक सफलता पेज पर जाता है और कोई नया भुगतान नहीं बनाया जाता।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखाया जाता। यदि वह ऑर्डर इस बीच बिना किसी भुगतान के बंद हो गया (उदाहरण के लिए उसका Multibanco संदर्भ समाप्त हो गया, MB WAY अनुरोध अस्वीकार हुआ या आपने ऑर्डर रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटता है, और अगला Confirm Order कार्ट के लिए नया ऑर्डर भुगतान करता है। यदि वह ऑर्डर पहले से भुगतान हो चुका है या अपने भुगतान की प्रतीक्षा कर रहा है, लेकिन इसके बाद कार्ट बदल गया है (नई मात्रा सहित), तो संदेश Your previous order is already paid or awaiting its payment. Please confirm the order again: the cart will be paid with a new order. होता है। भुगतान किया गया ऑर्डर किसी अलग कार्ट के लिए कभी भुगतान किया हुआ नहीं दिखाया जाता।

यदि Eupago भुगतान शुरू नहीं कर पाता, तो ग्राहक Confirm Order चरण पर एक छोटे संदेश के साथ रहता है, उदाहरण के लिए The payment could not be started because Eupago is temporarily unavailable. Please try again in a few minutes or choose another payment method. ऑर्डर बिना स्थिति के रहता है, और विवरण लॉग में होते हैं।

एक्सटेंशन प्रति इंस्टॉलेशन एक Eupago भुगतान विधि देता है। इसमें स्टोर से रिफ़ंड, सहेजे गए कार्ड, सब्सक्रिप्शन या प्री-ऑथराइज़ेशन, PayShop, Cofidis Pay, Bizum या अन्य Eupago विधियाँ, SMS रिमाइंडर, Multibanco की समाप्ति तिथि और स्थिति पोलिंग नहीं हैं।

ऑर्डर

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

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

Awaiting payment status (default Pending): एक Multibanco संदर्भ या MB WAY अनुरोध बनाया गया। नोट में एंटिटी और संदर्भ, या मास्क किया गया फ़ोन नंबर दिखता है।

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

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

Cancelled status (default Canceled): Eupago ने प्रतीक्षारत ऑर्डर के वर्तमान भुगतान प्रयास को रद्द या समाप्त बताया है।

Failed status (default Failed): Eupago ने प्रतीक्षारत ऑर्डर के वर्तमान भुगतान प्रयास में त्रुटि बताई है।

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

VibeFox Eupago Gateway टैब

Sales > Orders में Eupago से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Eupago Gateway टैब ऑर्डर के हर भुगतान प्रयास की सूची दिखाता है: Date, Method (सैंडबॉक्स भुगतानों के लिए Sandbox लेबल के साथ), Amount, Entity / reference / phone, Eupago transaction ID और Status। मैन्युअल समीक्षा वाले ऑर्डर के लिए टैब एक चेतावनी दिखाता है। उसके नीचे Eupago notes ऑर्डर पर एक्सटेंशन के नोट सूचीबद्ध करता है। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

इस एक्सटेंशन में रिफ़ंड उपलब्ध नहीं हैं। Eupago बैकऑफ़िस में ग्राहक को रिफ़ंड करें, फिर ज़रूरत हो तो OpenCart में ऑर्डर को मैन्युअल रूप से अपडेट करें। Sales > Returns में उत्पाद वापसी Eupago के माध्यम से पैसे वापस नहीं भेजती।

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

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

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

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

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

Eupago does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड की API कुंजी (सैंडबॉक्स मोड में Sandbox API Key, लाइव मोड में Live API Key) सेट है। ग्राहक को EUR में भुगतान करना होगा, और Multibanco के साथ ऑर्डर कुल राशि 1 € से 999 999.99 € के बीच होनी चाहिए। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में तय Total तक पहुँचता है।

The payment went through, but the order stays in the awaiting status or without a status: Eupago का नोटिफ़िकेशन नहीं पहुँचता या अस्वीकार हो जाता है। उस मोड के Eupago बैकऑफ़िस में जिसका आप उपयोग कर रहे हैं, जाँचें कि Webhook 2.0 मौजूद है, उसका URL ठीक वही है जो Webhook URL में दिखाया गया है, मेथड POST है और एन्क्रिप्शन चालू है। जाँचें कि उसकी कुंजी संबंधित फ़ील्ड (Sandbox Webhook Key या Live Webhook Key) में है। Debug Log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। यदि नोटिफ़िकेशन कभी नहीं आता, तो Eupago बैकऑफ़िस में भुगतान जाँचें।

Webhook answers Invalid signature or Missing signature: एक्सटेंशन में वेबहुक कुंजी वेबहुक की कुंजी से मेल नहीं खाती, या वेबहुक बिना एन्क्रिप्शन और बिना हस्ताक्षर का है। कुंजी दोबारा कॉपी करें और एन्क्रिप्शन चालू रखें।

Webhook answers Webhook key not configured: कोई वेबहुक कुंजी सेट नहीं है। कुंजी चिपकाने के बाद Eupago नोटिफ़िकेशन को दोबारा भेजता है।

Webhook answers Decryption failed: हस्ताक्षर वैध है, लेकिन बॉडी को डिक्रिप्ट नहीं किया जा सका। Eupago बैकऑफ़िस में Webhook 2.0 की सेटिंग जाँचें।

Webhook answers Environment mismatch: नोटिफ़िकेशन उस मोड के अलावा किसी दूसरे मोड की कुंजी से हस्ताक्षरित है जिसमें भुगतान शुरू हुआ था। सैंडबॉक्स नोटिफ़िकेशन कभी लाइव भुगतान को पूरा नहीं करता, और इसका उल्टा भी सही है। जाँचें कि सैंडबॉक्स और लाइव कुंजियाँ आपस में बदली तो नहीं गईं।

Webhook answers Order not found: नोटिफ़िकेशन ऐसे ऑर्डर के लिए है जिसका इस स्टोर का कोई Eupago भुगतान नहीं है, उदाहरण के लिए उसी Eupago चैनल वाले किसी दूसरे स्टोर से किया गया भुगतान।

Webhook answers Busy or Retry: ऑर्डर उसी समय दूसरे अनुरोध द्वारा प्रोसेस हो रहा था, या प्रोसेसिंग विफल हो गई। Eupago नोटिफ़िकेशन को दोबारा भेजता है। कारण लॉग में है।

Legacy callback answers Invalid API key: Eupago द्वारा भेजी गई API कुंजी Live API Key या Sandbox API Key से मेल नहीं खाती। वेबहुक URL को ब्राउज़र में खोलने पर भी यही उत्तर दिखता है; यह सामान्य है।

The customer sees This payment method is temporarily unavailable: वर्तमान मोड की API कुंजी गायब है। उसे सेटिंग्स में दर्ज करें।

The customer sees The MB WAY payment could not be started: जाँचें कि फ़ोन नंबर MB WAY से जुड़ा है और फिर से प्रयास करें।

Order is in the manual review status after payment: VibeFox Eupago Gateway टैब में Eupago notes पढ़ें। राशि या मुद्रा अलग थी, संदर्भ अज्ञात था, भुगतान ऑर्डर रद्द होने के बाद आया, या कार्ट पहले ही किसी दूसरे ऑर्डर से भुगतान हो चुका था। Eupago बैकऑफ़िस में भुगतान सत्यापित करें, फिर ऑर्डर पूरा करें या ग्राहक को रिफ़ंड करें।

अनइंस्टॉल

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

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

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