VibeFox ePay.bg for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: बल्गेरियाई लेव (BGN), यूरो (EUR) या अमेरिकी डॉलर (USD)। ऑर्डर अपनी ही मुद्रा में 2 दशमलव स्थानों के साथ चार्ज होता है। जब ग्राहक किसी दूसरी मुद्रा में चेकआउट करता है, तो भुगतान विधि छिपा दी जाती है।

ePay.bg खाता: आपको अपनी ePay.bg मर्चेंट प्रोफ़ाइल से ग्राहक नंबर (MIN) और सीक्रेट की चाहिए: लाइव वाले www.epay.bg से, और टेस्ट वाले demo.epay.bg से (टेस्ट खाता अलग से पंजीकृत किया जाता है)। आपको मर्चेंट प्रोफ़ाइल में अपने स्टोर का नोटिफ़िकेशन URL भी दर्ज करना होगा।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. टेस्ट और/या लाइव MIN तथा सीक्रेट की दर्ज करें (देखें कॉन्फ़िगरेशन)।

5. Payment notifications (IPN) सेक्शन में दिखाए गए URL को ePay.bg मर्चेंट प्रोफ़ाइल के फ़ील्ड URL for receiving notifications में कॉपी करें, डेमो और लाइव, दोनों प्रोफ़ाइल में। इसके बिना कोई भी ऑर्डर स्थिति नहीं पाएगा।

6. Enable/Disable चालू करें और Save पर क्लिक करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर Test Mode बंद करें।

OpenCart 4

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

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

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

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

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox ePay.bg Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, यदि स्टोर की डिफ़ॉल्ट मुद्रा BGN, EUR या USD नहीं है तो पेज एक त्रुटि दिखाता है; यदि भुगतान विधि चालू है लेकिन चुने गए मोड का MIN या सीक्रेट की खाली है, तो एक चेतावनी दिखाता है (तब वह चेकआउट पर छिपी रहती है, और सेव करते समय वही चेतावनी दिखती है); और टेस्ट मोड चालू रहते हुए Test mode is on: payments go to demo.epay.bg and no real money is charged. दिखाता है। एक्सटेंशन बदलने के अधिकार के बिना पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता (128 अक्षर तक), Sort Order पूर्ण संख्या होनी चाहिए और Total 0 या उससे अधिक संख्या होनी चाहिए; यदि कोई भी फ़ील्ड गलत है, तो कुछ भी सेव नहीं होता।

ePay.bg

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

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

Description: वह पाठ जो ग्राहक को Confirm Order चरण पर दिखता है। डिफ़ॉल्ट: Pay securely via ePay.bg with a bank card or your ePay.bg account.

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

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

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

ePay.bg खाता

ग्राहक नंबर (MIN) और सीक्रेट की आपकी मर्चेंट प्रोफ़ाइल में www.epay.bg (लाइव) और demo.epay.bg (टेस्ट खाता, अलग से पंजीकृत) पर दिखाई देते हैं।

Test Mode: टेस्ट मोड सक्षम करता है। ग्राहक ePay.bg के डेमो वातावरण पर भेजे जाते हैं, और अनुरोध टेस्ट क्रेडेंशियल से साइन किए जाते हैं। डिफ़ॉल्ट: चालू। चालू रहते हुए ग्राहक Confirm Order चरण पर Test mode (demo.epay.bg): no real payment is taken. देखते हैं।

Test Merchant ID (MIN): आपके demo.epay.bg मर्चेंट खाते का ग्राहक नंबर (MIN)।

Test Secret Key: आपके demo.epay.bg मर्चेंट खाते की सीक्रेट की (64 अक्षर)।

Live Merchant ID (MIN): आपके www.epay.bg मर्चेंट खाते का ग्राहक नंबर (MIN)।

Live Secret Key: आपके www.epay.bg मर्चेंट खाते की सीक्रेट की (64 अक्षर), जो HMAC-SHA1 हस्ताक्षर के लिए इस्तेमाल होती है।

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

भुगतान सूचनाएँ (IPN)

सूचना आपके स्टोर को बताती है कि कोई भुगतान अनुरोध चुकाया गया, अस्वीकार किया गया, या उसकी समय-सीमा समाप्त हो गई। Notification URL फ़ील्ड वह URL दिखाता है जिसे आपको ePay.bg मर्चेंट प्रोफ़ाइल में URL for receiving notifications के रूप में दर्ज करना है, लाइव और डेमो दोनों में। OpenCart 3 पर यह कुछ ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_epaybg_gateway/notify, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_epaybg_gateway/payment/wcp_epaybg_gateway.notify जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। यह URL ठीक वैसा ही कॉपी करें जैसा सेटिंग्स में दिखता है। ऑर्डर को स्थिति केवल इन साइन की गई सूचनाओं से मिलती है; ग्राहक का स्टोर पर लौटना किसी ऑर्डर का भुगतान नहीं करता।

ePay.bg हर इनवॉइस के लिए ये परिणाम सूचित करता है:

मान्य चेकसम के बिना सूचनाएँ अस्वीकार की जाती हैं, और ePay.bg उन्हें भेजता रहता है। चेकसम हर उस मोड की सीक्रेट की से जाँचा जाता है जिसकी कोई कुंजी है, इसलिए टेस्ट और लाइव के बीच बदलने से पहले शुरू हुए भुगतान भी पुष्ट होते रहते हैं। भुगतान उसी मोड में आना चाहिए जिसमें अनुरोध किया गया था; अन्यथा ऑर्डर on-hold स्थिति में चला जाता है। मर्चेंट प्रोफ़ाइल में नोटिफ़िकेशन URL न होने पर कोई भी ऑर्डर स्थिति नहीं पाता।

भुगतान अनुरोध

Invoice Prefix: केवल अंक (10 तक), जो OpenCart ऑर्डर ID के सामने लगकर ePay.bg इनवॉइस नंबर बनाते हैं, उदाहरण के लिए 00001 + 123 = 00001123। एक ही ePay.bg खाते पर अलग-अलग स्टोर के लिए अलग प्रीफ़िक्स इस्तेमाल करें। सेव करते समय बाकी अक्षर चेतावनी के साथ हटा दिए जाते हैं, जो सेव किया गया प्रीफ़िक्स दिखाती है। बाद में प्रीफ़िक्स बदलना सुरक्षित है: खुले भुगतान अनुरोध उनके लिए सेव किए गए इनवॉइस से मिल जाते हैं। डिफ़ॉल्ट: 00001।

Expiration Time: वह समय जिसके बाद बिना भुगतान वाला अनुरोध समाप्त हो जाता है; ePay.bg फिर उसे समाप्त बताता है और ऑर्डर को कोई स्थिति नहीं मिलती। 1, 3, 6, 12, 24, 48 या 72 घंटे चुनें। समय स्टोर के समय क्षेत्र से स्वतंत्र, बल्गेरियाई समय में भेजा जाता है। डिफ़ॉल्ट: 24 घंटे।

Language: ePay.bg भुगतान पेज की भाषा, अंग्रेज़ी या बल्गेरियाई। डिफ़ॉल्ट: English।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के (एक गायब ऑर्डर) बनाता है। ऑर्डर को स्थिति केवल तभी मिलती है जब ePay.bg भुगतान की सूचना दे। अस्वीकार, समाप्त या छोड़ा गया भुगतान ऑर्डर को बिना स्थिति के छोड़ देता है, और ग्राहक फिर से भुगतान कर सकता है। नीचे के स्थिति फ़ील्ड आपकी OpenCart ऑर्डर स्थितियाँ सूचीबद्ध करते हैं।

Order Status After Payment: सफल भुगतान के बाद कौन-सी स्थिति सेट होती है।

Processing status: Default और Processing के लिए OpenCart स्थिति। डिफ़ॉल्ट: Processing।

Completed status: Completed के लिए OpenCart स्थिति। डिफ़ॉल्ट: Complete।

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

उन्नत

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

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से ePay.bg)। Confirm Order चरण पर ग्राहक को आपका विवरण और यह नोट दिखता है: You will be redirected to ePay.bg to pay with a bank card or your ePay.bg account. OpenCart इसी चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ग्राहक को ePay.bg पर भेजता है, ऑर्डर की मुद्रा में ऑर्डर राशि के लिए एक साइन किए गए भुगतान अनुरोध के साथ, इनवॉइस नंबर और समय-सीमा सहित। ePay.bg पर भुगतान Order और ऑर्डर नंबर के रूप में दिखता है। ePay.bg पर ग्राहक बैंक कार्ड या ePay.bg खाते से भुगतान करता है। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान तरीका ब्लॉक के Choose बटन से भुगतान तरीका चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को भुगतान किया हुआ तभी चिह्नित किया जाता है जब ePay.bg साइन की गई सूचना से उसकी पुष्टि करे। फिर ऑर्डर को सामान्य OpenCart तरीके से स्थिति मिलती है, साथ में सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं। यदि सूचना पहले ही आ चुकी है, तो ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। यदि नहीं आई, तो Payment confirmation पेज कहता है: Thank you. Your payment is being confirmed by ePay.bg — your order is confirmed as soon as ePay.bg reports the payment. साथ में Check again और Back to checkout बटन।

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

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

यदि ऑर्डर ePay.bg से नहीं चुकाया जा सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश देखता है, जैसे ePay.bg payments are temporarily unavailable. Please choose another payment method. या यह कि ePay.bg ऑर्डर की मुद्रा में भुगतान स्वीकार नहीं करता।

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

यह एक्सटेंशन केवल ePay.bg पर एकमुश्त भुगतान लेता है। इसमें OpenCart से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या आवर्ती भुगतान, और EasyPay या B-Pay नकद भुगतान कोड नहीं हैं।

ऑर्डर

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

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

Processing, Completed या On Hold status: भुगतान की पुष्टि हुई। स्थिति Order Status After Payment के अनुसार होती है। एक नोट इनवॉइस नंबर, भुगतान की तिथि, STAN और BORICA कोड दिखाता है।

भुगतान के बाद On Hold status: भुगतान आ गया, लेकिन ऑर्डर अब जो कहता है उसके लिए नहीं: भुगतान अनुरोध के बाद ऑर्डर की राशि या मुद्रा बदल गई, सूचना अनुरोध से अलग मोड (टेस्ट या लाइव) में आई, या ऑर्डर की भुगतान विधि अब ePay.bg नहीं है। भुगतान को भुगतान किया हुआ दर्ज नहीं किया जाता। यही तब होता है जब आप ऑर्डर को पहले ही कोई और स्थिति दे चुके हों, जैसे रद्द करना। नोट कारण समझाता है। ePay.bg मर्चेंट पैनल में भुगतान जाँचें और ऑर्डर को मैन्युअली पूरा करें या रिफ़ंड करें।

यदि किसी ऐसे ऑर्डर के लिए भुगतान आता है जो पहले से भुगतान किया हुआ है, तो स्थिति नहीं बदलती, और एक नोट आपसे ePay.bg मर्चेंट पैनल में डबल पेमेंट जाँचने को कहता है। यदि ग्राहक ने एक ही कार्ट के दो ऑर्डर चुकाए हैं, तो दूसरे को संभावित डबल पेमेंट का नोट मिलता है। देर से आई अस्वीकृति या समाप्ति की सूचना कभी भी भुगतान किए गए ऑर्डर को नहीं बदलती; जिस ऑर्डर की पहले से कोई स्थिति है, उसे केवल एक नोट मिलता है।

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

VibeFox ePay.bg Gateway टैब

Sales > Orders में ePay.bg से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox ePay.bg Gateway टैब में इनवॉइस, वातावरण (टेस्ट या लाइव, टेस्ट भुगतानों के लिए Test mode लेबल के साथ), अनुरोधित राशि और मुद्रा, भुगतान अनुरोध की स्थिति, सूचना का परिणाम, भुगतान की तिथि, STAN, BORICA कोड, और ऑर्डर के ePay.bg notes दिखते हैं। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

ePay.bg WEB API में रिफ़ंड का कोई कॉल नहीं है, इसलिए OpenCart से रिफ़ंड उपलब्ध नहीं हैं। ePay.bg मर्चेंट पैनल में भुगतान रिफ़ंड करें और OpenCart में ऑर्डर की स्थिति मैन्युअली अपडेट करें। Sales > Returns में उत्पाद वापसी ePay.bg के ज़रिए पैसे वापस नहीं भेजती।

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

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

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

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

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

ePay.bg चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चुने गए मोड का MIN और सीक्रेट की सेट हैं, और ग्राहक BGN, EUR या USD में चेकआउट करता है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज एक चेतावनी दिखाता है। साथ ही जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्थिति के रहा: ऑर्डर को स्थिति केवल ePay.bg की सूचना से मिलती है। जाँचें कि आप जिस मोड (डेमो या लाइव) का उपयोग करते हैं, उसकी ePay.bg मर्चेंट प्रोफ़ाइल में नोटिफ़िकेशन URL Notification URL में दिखाए गए अनुसार ठीक से दर्ज है, और उस मोड की सीक्रेट की सही है। एक्सटेंशन पेज पर Log फ़ील्ड देखें; हर सूचना देखने के लिए Logging चालू करें।

सूचना ERR=Not valid CHECKSUM से उत्तर देती है: कोई सेव की गई सीक्रेट की उस मर्चेंट प्रोफ़ाइल से मेल नहीं खाती जिसने सूचना भेजी। ePay.bg बार-बार प्रयास करता रहता है, इसलिए कुंजी सही होते ही ऑर्डर को स्थिति मिल जाएगी।

सूचना ERR=Not configured से उत्तर देती है: कोई सीक्रेट की सेव नहीं है। उसे दर्ज करें।

सूचना किसी इनवॉइस के लिए STATUS=NO से उत्तर देती है: इनवॉइस इस स्टोर द्वारा जारी नहीं हुआ, उदाहरण के लिए उसी ePay.bg खाते पर किसी दूसरे स्टोर द्वारा। हर स्टोर को अपना Invoice Prefix दें।

सूचना STATUS=ERR से उत्तर देती है: एक अस्थायी त्रुटि, जैसे उसी समय एक ही ऑर्डर के लिए दो सूचनाएँ, या ऑर्डर की स्थिति सेट नहीं हो सकी। ePay.bg सूचना फिर से भेजता है। कारण लॉग में है।

सूचना URL में ERR=Method not allowed in the browser दिखता है: यह सामान्य है। यह URL केवल ePay.bg के अनुरोध स्वीकार करता है।

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

ग्राहक को This order has nothing to pay. दिखता है: ऑर्डर का कुल योग शून्य है, इसलिए ePay.bg को भेजने के लिए कुछ नहीं है।

भुगतान के बाद ऑर्डर On Hold स्थिति में है: VibeFox ePay.bg Gateway टैब के नोट पढ़ें (ऑर्डर स्थितियाँ देखें), ePay.bg मर्चेंट पैनल में भुगतान जाँचें, फिर ऑर्डर पूरा करें या वहीं भुगतान रिफ़ंड करें।

सेव करते समय इनवॉइस प्रीफ़िक्स बदल दिया गया: प्रीफ़िक्स में केवल अंक हो सकते हैं, 10 तक। बाकी अक्षर हटा दिए जाते हैं।

डेवलपर्स के लिए: भुगतान फ़ॉर्म ePay.bg को भेजे जाने से पहले, एक्सटेंशन फ़ॉर्म फ़ील्ड और ऑर्डर के साथ OpenCart इवेंट epay_bp_form_fields ट्रिगर करता है, उदाहरण के लिए सीधे कार्ड भुगतान पेज (PAGE=credit_paydirect) का उपयोग करने के लिए; साइन किए गए डेटा और चेकसम को इसके ज़रिए नहीं बदला जा सकता।

अनइंस्टॉल

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

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

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