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

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल नहीं होता।

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

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

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

इंस्टॉलेशन

1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox ePay.bg Gateway ढूँढकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

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

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

इंस्टॉल होने पर मॉड्यूल ePay.bg payment on hold ऑर्डर स्थिति बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।

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

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

ePay.bg

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely via ePay.bg with a bank card or your ePay.bg account.

ePay.bg खाता

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

Test Mode: टेस्ट मोड चालू करता है। ग्राहक ePay.bg के डेमो वातावरण पर भेजे जाते हैं और अनुरोध टेस्ट क्रेडेंशियल से हस्ताक्षरित होते हैं। डिफ़ॉल्ट: चालू।

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 saved secret keys: किसी कुंजी पर टिक लगाएँ और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजा गया मान बनाए रखता है।

Payment notifications (IPN)

सूचना आपके स्टोर को बताती है कि कोई भुगतान अनुरोध भुगतान हो गया, अस्वीकार हुआ, या समाप्त हो गया। Notification URL फ़ील्ड वह URL दिखाता है जिसे ePay.bg मर्चेंट प्रोफ़ाइल में URL for receiving notifications के रूप में दर्ज करना है, लाइव और टेस्ट दोनों के लिए। फ़्रेंडली URL चालू होने पर यह https://your-shop/module/wcp_epaybg_gateway/notify जैसा दिखता है, और संभव है कि इसमें /en/ जैसा भाषा कोड भी हो। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स में दिखता है। ऑर्डर केवल इन हस्ताक्षरित सूचनाओं से बनते हैं; ग्राहक के स्टोर में लौटने से कभी ऑर्डर नहीं बनता या भुगतान नहीं होता।

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

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

Payment request

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

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

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

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

Advanced

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

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

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

चेकआउट

भुगतान चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से ePay.bg) और पुष्टि करता है। ग्राहक को Redirecting to ePay.bg for payment... दिखता है और वह कार्ट की मुद्रा में कार्ट के कुल योग, इनवॉइस नंबर और समाप्ति समय के साथ हस्ताक्षरित भुगतान अनुरोध के साथ ePay.bg पर भेजा जाता है। ePay.bg पर भुगतान Cart और कार्ट नंबर के रूप में दिखता है। यदि रीडायरेक्ट शुरू न हो, तो पेज पर Pay via ePay.bg बटन और Cancel बटन भी होते हैं। ePay.bg पर ग्राहक बैंक कार्ड या ePay.bg खाते से भुगतान करता है। इस समय तक ऑर्डर मौजूद नहीं होता।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। ऑर्डर तभी बनता है जब हस्ताक्षरित ePay.bg सूचना आती है। यदि वह पहले ही आ चुकी है, तो ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है। यदि नहीं आई है, तो Payment confirmation पेज पर Thank you. Your payment is being confirmed by ePay.bg — your order will be created as soon as ePay.bg confirms it, and you will receive an e-mail. लिखा होता है, साथ में 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. होता है। कार्ट बना रहता है। उसी कार्ट के लिए नया प्रयास उसी इनवॉइस नंबर का उपयोग करता है।

यदि कार्ट ePay.bg से नहीं चुकाया जा सकता, तो ग्राहक एक छोटे संदेश के साथ चेकआउट पर रहता है, उदाहरण के लिए ePay.bg payments are temporarily unavailable. Please choose another payment method. या यह कि ePay.bg कार्ट की मुद्रा में भुगतान स्वीकार नहीं करता।

सूचना तब भी काम करती है जब स्टोर मेंटेनेंस मोड में हो, और आपके स्टोर के देश-प्रतिबंध से अवरुद्ध नहीं होती।

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

ऑर्डर

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

No order yet: ग्राहक को ePay.bg पर भेजा गया और उसने भुगतान नहीं किया, सूचना अभी नहीं आई, या ePay.bg ने अनुरोध को अस्वीकृत या समाप्त बताया। केवल कार्ट मौजूद है।

Payment accepted, Delivered or ePay.bg payment on hold: भुगतान की पुष्टि हुई। स्थिति Order Status After Payment का पालन करती है। भुगतान STAN को लेनदेन ID के रूप में दर्ज होता है (STAN न हो तो इनवॉइस नंबर), और एक नोट में इनवॉइस नंबर, भुगतान की तिथि, STAN और BORICA कोड दिखते हैं।

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

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

ePay.bg भुगतान ब्लॉक

ऑर्डर पेज पर ePay.bg payment ब्लॉक दिखता है, जिसमें इनवॉइस, माँगी गई राशि और मुद्रा, सूचना का परिणाम, भुगतान की तिथि, STAN, BORICA कोड, टेस्ट भुगतानों के लिए Test mode बैज और ऑर्डर के ePay.bg notes शामिल होते हैं।

रिफ़ंड

PrestaShop से रिफ़ंड उपलब्ध नहीं हैं, क्योंकि ePay.bg WEB API में रिफ़ंड का कोई कॉल नहीं है। ePay.bg मर्चेंट पैनल में भुगतान रिफ़ंड करें और PrestaShop में ऑर्डर मैन्युअल रूप से अपडेट करें।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox ePay.bg Gateway Modules > Module Manager > VibeFox ePay.bg Gateway > Configure पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन) और ये बटन: Check now स्थिति दोबारा जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए, और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: presta-payment-epaybg वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। कुंजी केवल उन कर्मचारियों द्वारा बदली जा सकती है जिनके पास मॉड्यूल की Configure अनुमति है। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या तारीख के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।

एक कुंजी एक डोमेन पर काम करती है: मुख्य स्टोर का डोमेन, मल्टीस्टोर सेटअप में भी। स्टोर से कुंजी हटाने पर उसका डोमेन स्लॉट मुक्त नहीं होता। अपने vibefox.net खाते में स्लॉट मुक्त करें।

सक्रिय कुंजी के बिना, चेकआउट पर ePay.bg ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान तरीका आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: पहले से शुरू हुए भुगतान फिर भी पुष्ट होते हैं।

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

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

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

भुगतान हो गया, पर ऑर्डर नहीं बना: ऑर्डर केवल 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 के अनुरोध स्वीकार करता है।

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

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

डेवलपर्स के लिए, readme में हुक actionEpayBpFormFields (WooCommerce संस्करण का epay_bp_form_fields फ़िल्टर) का उल्लेख है, उदाहरण के लिए सीधे कार्ड पेज (PAGE=credit_paydirect) का उपयोग करने के लिए।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox ePay.bg Gateway के बगल वाला मेनू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। यदि Delete Data on Uninstall चालू है, तो गेटवे सेटिंग्स और लॉग हटा दिए जाते हैं। यदि बंद है, तो बाद में फिर से इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। ePay.bg भुगतान रिकॉर्ड और ऑर्डर स्थिति ePay.bg payment on hold हमेशा रखे जाते हैं, इसलिए दोबारा इंस्टॉल से पहले शुरू किया गया भुगतान फिर भी पुष्ट होता है। मौजूदा ऑर्डर अपने भुगतान नोट और लेनदेन ID बनाए रखते हैं।

ePay.bg उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल ePay.bg से संबद्ध नहीं है और इसका ePay.bg द्वारा समर्थन नहीं किया गया है।