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

आवश्यकताएँ

WordPress: 6.0 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय।

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

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप wcp_epaybg_gateway फ़ोल्डर को FTP से /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें। WooCommerce सक्रिय होना चाहिए।

3. सेटिंग खोलें: WooCommerce > Settings > Payments > ePay.bg > Manage, या प्लगइन पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

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

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

7. Enable/Disable चालू करें। टेस्ट मोड में एक टेस्ट ऑर्डर दें, फिर Test Mode का चयन हटा दें।

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

सभी सेटिंग एक ही पेज पर हैं: WooCommerce > Settings > Payments > ePay.bg। फ़ील्ड के ऊपर पेज एक त्रुटि दिखाता है जब स्टोर की मुद्रा 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: Enable test mode (use demo.epay.bg and the test credentials)। चालू होने पर ग्राहकों को 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 हस्ताक्षर के लिए उपयोग होती है।

यदि आप संस्करण 1.0 से अपडेट करते हैं, तो टेस्ट मोड चालू होने की स्थिति में उस संस्करण के क्रेडेंशियल का एकमात्र सेट टेस्ट फ़ील्ड में ले जाया जाता है।

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

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

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

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

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

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: सफल भुगतान के बाद सेट की जाने वाली ऑर्डर की स्थिति। स्थिति तुरंत सेट होती है, दूसरी बार स्थिति बदले बिना।

उन्नत

Logging: Enable logging भुगतान अनुरोधों और सूचनाओं को WooCommerce > Status > Logs में, स्रोत wcp_epaybg_gateway, लिखता है, गुप्त कुंजियों या कार्ड के डेटा के बिना। डिफ़ॉल्ट: बंद।

Delete Data on Uninstall: Remove all plugin data when uninstalled। चयनित होने पर, प्लगइन अनइंस्टॉल करने पर गेटवे की सेटिंग, ऑर्डर में सहेजा गया ePay.bg डेटा और प्लगइन के लॉग हटा दिए जाते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर के ऑर्डर प्राप्त हुआ पेज पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब हस्ताक्षरित ePay.bg सूचना आती है। कार्ट केवल ऑर्डर प्राप्त हुआ पेज पर ही खाली होता है।

यदि ग्राहक ePay.bg पर रद्द करता है, तो ऑर्डर WooCommerce के मानक तरीके से रद्द हो जाता है और कार्ट बना रहता है, ताकि ग्राहक कोई दूसरी भुगतान विधि चुन सके।

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

भुगतान विधि क्लासिक चेकआउट, Checkout ब्लॉक और Pay for order पेज पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।

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

ऑर्डर

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

Pending payment: ग्राहक को ePay.bg पर भेजा गया था और उसने अभी तक भुगतान नहीं किया है, या सूचना अभी तक नहीं आई है। ऑर्डर नोट में Awaiting ePay.bg payment. लिखा होता है।

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

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

Cancelled: ePay.bg ने भुगतान अनुरोध को अस्वीकृत या समाप्त बताया, या ग्राहक ने ePay.bg पर रद्द कर दिया। WooCommerce स्टॉक बहाल कर देता है। रद्द किया गया ऑर्डर दोबारा नहीं चुकाया जा सकता, क्योंकि ePay.bg इनवॉइस नंबर उपसर्ग और ऑर्डर ID को मिलाकर बनता है। ग्राहक नया ऑर्डर देता है।

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

रिफ़ंड

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

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

प्लगइन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Payments > ePay.bg के शीर्ष पर है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

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

लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति की जाँच बैकग्राउंड में अपने-आप दोबारा होती है।

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

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

भुगतान हो गया, पर ऑर्डर भुगतान लंबित ही है: ऑर्डर केवल ePay.bg की सूचना से भुगतान किया हुआ चिह्नित होता है। जाँचें कि सूचना URL आपके उपयोग वाले मोड (डेमो या लाइव) की ePay.bg मर्चेंट प्रोफ़ाइल में दर्ज है और सक्रिय मोड की गुप्त कुंजी सही है। Logging चालू करें और WooCommerce > Status > Logs, स्रोत wcp_epaybg_gateway, देखें।

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

सूचना ERR=Not configured उत्तर देती है: चुने गए मोड की गुप्त कुंजी खाली है। उसे दर्ज करें।

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

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

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

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

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।

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

अनइंस्टॉल

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

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