VibeFox EveryPay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

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

EveryPay खाता: आपको अपने स्टोर का API यूज़रनेम, API secret और प्रोसेसिंग खाते का नाम चाहिए। ये EveryPay Merchant Portal में, आपके स्टोर की सेटिंग्स में मिलते हैं: टेस्ट मोड के लिए डेमो पोर्टल, और असली भुगतान के लिए लाइव पोर्टल। टेस्ट और लाइव वातावरण के क्रेडेंशियल अलग-अलग होते हैं। आप अपने स्टोर का कॉलबैक URL दोनों पोर्टलों में भी सेट करते हैं (देखें कॉन्फ़िगरेशन)।

स्टोर की मुद्रा: प्रोसेसिंग खाता तय करता है कि किस मुद्रा में चार्ज होगा, उदाहरण के लिए EUR3D1 EUR में चार्ज करता है। यह भुगतान विधि केवल उसी मुद्रा के कार्ट के लिए दिखाई जाती है।

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

इंस्टॉलेशन

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

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox EveryPay Payment खोजकर Configure पर क्लिक करें।

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

4. डेमो Merchant Portal से टेस्ट API यूज़रनेम, टेस्ट API secret और प्रोसेसिंग खाते का नाम दर्ज करें। Test Mode चालू रखें।

5. सेटिंग्स पेज पर दिखाया गया कॉलबैक URL कॉपी करके Merchant Portal में अपने स्टोर के Callback notification URL में डालें।

6. Enable/Disable चालू करें, Save पर क्लिक करें और एक टेस्ट ऑर्डर दें। सब कुछ ठीक चलने पर लाइव क्रेडेंशियल दर्ज करें, लाइव पोर्टल में भी कॉलबैक URL सेट करें और Test Mode बंद करें।

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

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox EveryPay Payment > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। फ़ील्ड्स के ऊपर, जब तक टेस्ट मोड चालू है, पेज टेस्ट मोड चालू है: भुगतान EveryPay डेमो वातावरण में जाते हैं, कोई असली राशि चार्ज नहीं होती। दिखाता है। यदि भुगतान विधि सक्षम है, लेकिन वर्तमान मोड का API यूज़रनेम, API secret या प्रोसेसिंग खाता गायब है (तब भुगतान विधि चेकआउट पर छिपी रहती है), तो पेज चेतावनी देता है। यह चेतावनी तब भी देता है जब प्रोसेसिंग खाता स्टोर की डिफ़ॉल्ट मुद्रा से अलग मुद्रा में चार्ज करता है। क्रेडेंशियल्स के साथ चिपकाए गए स्पेस और लाइन ब्रेक सेव करते समय हटा दिए जाते हैं।

EveryPay

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely by card or bank link on the EveryPay payment page।

EveryPay खाता

API यूज़रनेम, API secret और प्रोसेसिंग खाते का नाम EveryPay Merchant Portal (स्टोर सेटिंग्स) में दिखाए जाते हैं: टेस्ट मोड के लिए डेमो पोर्टल, और असली भुगतान के लिए लाइव पोर्टल। इस सेक्शन में दोनों पोर्टल के लिंक हैं।

Test Mode: चालू होने पर, भुगतान टेस्ट क्रेडेंशियल्स के साथ EveryPay डेमो वातावरण में जाते हैं। कोई असली राशि चार्ज नहीं होती। डिफ़ॉल्ट: on। चालू रहने के दौरान ग्राहक भुगतान विधि के नीचे टेस्ट मोड: EveryPay डेमो वातावरण, कोई असली राशि चार्ज नहीं होती। देखते हैं।

Test API Username: डेमो वातावरण का API यूज़रनेम।

Test API Secret: डेमो वातावरण का API secret।

Live API Username: लाइव वातावरण का API यूज़रनेम।

Live API Secret: लाइव वातावरण का API secret।

सेव किए गए secrets फिर कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और सेव किया गया — इसे रखने के लिए खाली छोड़ें। दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Clear saved API secrets: किसी secret को चुनकर Save पर क्लिक करें, तो वह हट जाता है। खाली फ़ील्ड सेव किए गए मान को बनाए रखता है।

Processing Account Name: EveryPay प्रोसेसिंग खाता, उदाहरण के लिए EUR3D1। यह खाता तय करता है कि किस मुद्रा में चार्ज होगा: भुगतान विधि केवल उसी मुद्रा के कार्ट के लिए दी जाती है। दोनों मोड में एक ही खाते का नाम उपयोग होता है।

भुगतान सूचनाएँ (कॉलबैक)

कॉलबैक आपके स्टोर को बताता है कि भुगतान पूरा हो गया है, ताकि ग्राहक ब्राउज़र बंद कर दे तब भी ऑर्डर बन जाएँ। Callback notification URL में दिखाया गया URL कॉपी करके EveryPay Merchant Portal में अपने स्टोर के Callback notification URL में डालें, डेमो और लाइव दोनों के लिए। फ़्रेंडली URL के साथ यह ऐसा दिखता है: https://your-shop/module/wcp_everypay_payment/callback। URL को सेटिंग्स में दिखाए गए रूप में ही हूबहू कॉपी करें। भुगतान अनुरोध में कॉलबैक URL नहीं जाता, इसलिए इसे पोर्टल में सेट करना होगा।

कॉलबैक में केवल भुगतान संदर्भ होते हैं। जब यह आता है, मॉड्यूल उस वातावरण के क्रेडेंशियल्स से, जहाँ भुगतान बनाया गया था, EveryPay API से भुगतान की स्थिति पूछता है और जाँचता है कि उत्तर इसी कार्ट का है। ऐसे भुगतान के कॉलबैक, जिन्हें आपके स्टोर ने नहीं बनाया, EveryPay को बिना अनुरोध भेजे अस्वीकार कर दिए जाते हैं। कॉलबैक न होने पर, ऑर्डर तब बनता है जब ग्राहक भुगतान के बाद स्टोर पर लौटता है, या जब EveryPay कॉलबैक दोबारा भेजता है।

उन्नत

Debug log: भुगतान इवेंट्स को मॉड्यूल फ़ोल्डर में logs/wc_evp_debug.log.php में दर्ज करता है। यह फ़ाइल वेब से नहीं खोली जा सकती। एरर और चेतावनियाँ हमेशा दर्ज होती हैं, भले ही यह बंद हो। API secrets, कार्ड डेटा और ग्राहक के ईमेल कभी दर्ज नहीं होते। डिफ़ॉल्ट: off।

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

Uninstall: मॉड्यूल अनइंस्टॉल होने पर गेटवे सेटिंग्स और लॉग हटा देता है। ऑर्डरों का EveryPay भुगतान डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: off।

चेकआउट

भुगतान चरण में ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से EveryPay) और पुष्टि करता है। मॉड्यूल कार्ट की मुद्रा में कार्ट की कुल राशि के लिए, ग्राहक के ईमेल और बिलिंग पते के साथ, एक-बारी EveryPay भुगतान बनाता है और ग्राहक को EveryPay भुगतान पेज पर भेजता है। इस पेज की भाषा स्टोर की भाषा के अनुसार होती है (अंग्रेज़ी, एस्टोनियाई, रूसी, लातवियाई, लिथुआनियाई, फ़िनिश या जर्मन; अन्यथा अंग्रेज़ी)। वहाँ ग्राहक आपके EveryPay खाते के लिए सक्षम तरीकों में से किसी एक से भुगतान करता है। इस समय तक कोई ऑर्डर नहीं होता।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब EveryPay उसकी पुष्टि करे: मॉड्यूल लौटने पर और कॉलबैक पर EveryPay API से भुगतान की स्थिति पूछता है। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखाई देता है। यदि EveryPay अभी भी भुगतान प्रोसेस कर रहा है, या उस समय उसका API पहुँच में नहीं है, तो Payment confirmation पेज पर EveryPay आपके भुगतान की पुष्टि कर रहा है। ऑर्डर की पुष्टि होते ही आपको ईमेल मिलेगा। संदेश और एक Check again बटन दिखता है; EveryPay के भुगतान की पुष्टि करते ही कॉलबैक ऑर्डर बना देता है।

यदि भुगतान विफल हो गया, तो ग्राहक चेकआउट पर लौटता है और आपका EveryPay भुगतान सफल नहीं हुआ। कृपया फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें। संदेश देखता है। यदि ग्राहक बिना भुगतान किए भुगतान पेज छोड़ देता है, तो संदेश होता है EveryPay भुगतान पूरा नहीं हुआ। आप फिर से प्रयास कर सकते हैं या कोई दूसरी भुगतान विधि चुन सकते हैं। कार्ट सुरक्षित रहता है। हर नया प्रयास नया EveryPay भुगतान बनाता है; पिछले प्रयास भी दर्ज रहते हैं, इसलिए पुराने लिंक से किया गया भुगतान भी पहचाना जाता है।

यदि EveryPay भुगतान शुरू नहीं कर पाता, तो ग्राहक चेकआउट पर ही रहता है और एक छोटा संदेश देखता है, जैसे EveryPay अस्थायी रूप से उपलब्ध नहीं है। कृपया कुछ देर बाद फिर से प्रयास करें या कोई दूसरी भुगतान विधि चुनें। विवरण लॉग में होते हैं।

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

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

ऑर्डर

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

No order yet: ग्राहक को EveryPay पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान विफल हुआ या छोड़ दिया गया, या EveryPay ने अभी तक भुगतान की पुष्टि नहीं की है। केवल कार्ट मौजूद है।

Payment accepted: EveryPay ने भुगतान को सेटल या अधिकृत बताया है। भुगतान EveryPay भुगतान संदर्भ को ट्रांज़ैक्शन ID के रूप में दर्ज होता है, और एक नोट राशि, मुद्रा और संदर्भ दिखाता है। अधिकृत भुगतान के लिए नोट बताता है कि राशि रोक दी गई है: यदि आपका खाता अपने-आप कैप्चर नहीं करता, तो EveryPay Merchant Portal में भुगतान को कैप्चर करें। बाद में भुगतान सेटल होने पर एक नोट यह बताता है।

EveryPay payment on hold: भुगतान को मैन्युअल समीक्षा चाहिए। भुगतान की गई राशि या मुद्रा कार्ट से अलग है (उदाहरण के लिए, भुगतान शुरू होने के बाद कार्ट बदला गया), ऑर्डर भुगतान पहुँचने से पहले रद्द हो चुका था, या ऑर्डर अब दूसरी भुगतान विधि का उपयोग करता है। नोट इसकी वजह बताता है और कहता है कि ऑर्डर को भुगतान किया हुआ चिह्नित नहीं किया गया। Merchant Portal में भुगतान की जाँच करें, फिर ऑर्डर पूरा करें या मैन्युअली रिफ़ंड करें। इस भुगतान के बाद के कॉलबैक ऑर्डर को अपने-आप पूरा नहीं करते।

यदि पहले से भुगतान किए गए ऑर्डर के लिए दूसरा भुगतान पूरा होता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे EveryPay Merchant Portal में डुप्लिकेट भुगतान का रिफ़ंड करने के लिए कहता है।

EveryPay भुगतान ब्लॉक

ऑर्डर पेज पर EveryPay payment ब्लॉक दिखता है, जिसमें ऑर्डर के हर EveryPay भुगतान प्रयास की जानकारी होती है: तारीख, भुगतान संदर्भ (टेस्ट भुगतानों पर Test mode बैज के साथ), ऑर्डर संदर्भ, राशि, EveryPay स्थिति और परिणाम। उसके नीचे ऑर्डर के EveryPay notes होते हैं, सबसे नए पहले।

Check EveryPay payment status: ब्लॉक का बटन ऑर्डर के हर EveryPay भुगतान की जाँच API से करता है, सबसे नए से सबसे पुराने तक, ऊपर बताए अनुसार परिणाम लागू करता है, और हर भुगतान की स्थिति के साथ एक नोट जोड़ता है। परिणाम ब्लॉक में दिखता है। आपको ऑर्डर संपादित करने का अधिकार चाहिए; मॉड्यूल पेज तक पहुँच की ज़रूरत नहीं है। इसका उपयोग तब करें जब कॉलबैक कभी न आया हो, उदाहरण के लिए बाद में हुआ कैप्चर या रिफ़ंड देखने के लिए।

रिफ़ंड

PrestaShop से रिफ़ंड समर्थित नहीं हैं। EveryPay Merchant Portal में रिफ़ंड करें, फिर PrestaShop में ऑर्डर स्थिति अपडेट करें। जब EveryPay किसी भुगतान को रिफ़ंड या चार्जबैक के रूप में बताता है, तो मॉड्यूल ऑर्डर में केवल एक नोट जोड़ता है; ऑर्डर स्थिति नहीं बदलती। ऑर्डर पेज के PrestaShop के मानक रिफ़ंड बटन EveryPay के माध्यम से पैसे वापस नहीं भेजते।

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

मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox EveryPay Payment, Modules > Module Manager > VibeFox EveryPay Payment > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी छिपी हुई दिखती है, साथ ही स्थिति (जैसे लाइसेंस कब तक सक्रिय है और आपका डोमेन) और बटन Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए) दिखते हैं। इनके नीचे Product: presta-payment-everypay वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को EveryPay नहीं दिखाया जाता। फिर भी यदि भुगतान शुरू होता है, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि होती रहती है, और स्थिति जाँच काम करती है।

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

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

चेकआउट पर EveryPay दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का API यूज़रनेम, API secret और Processing Account Name भरा हुआ है, और कार्ट की मुद्रा प्रोसेसिंग खाते की मुद्रा है। इन मामलों में सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है।

भुगतान हो गया, पर ऑर्डर नहीं बना: कॉलबैक काम नहीं कर रहा है। जाँचें कि सेटिंग्स का कॉलबैक URL उस मोड (डेमो या लाइव) के Merchant Portal में Callback notification URL के रूप में सेट है जिसे आप उपयोग कर रहे हैं। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर बनता है। मॉड्यूल पेज पर Log फ़ील्ड देखें: एरर हमेशा दर्ज होते हैं।

कॉलबैक जवाब देता है Unknown payment, Unknown payment reference या Payment does not belong to this order: भुगतान इस स्टोर या इस कार्ट ने नहीं बनाया, या EveryPay का जवाब उससे मेल नहीं खाता। कुछ नहीं बदलता।

कॉलबैक जवाब देता है Not configured: उस वातावरण के क्रेडेंशियल्स गायब हैं जहाँ भुगतान बनाया गया था, उदाहरण के लिए टेस्ट क्रेडेंशियल्स हटाने के बाद का टेस्ट भुगतान। उन्हें फिर से दर्ज करें; EveryPay कॉलबैक दोबारा भेजता है।

कॉलबैक जवाब देता है Payment status unavailable, Busy, please retry या Order could not be created: EveryPay API तक पहुँचा नहीं जा सका, उसी समय कोई और अनुरोध ऑर्डर बना रहा था, या ऑर्डर नहीं बन सका (उदाहरण के लिए मॉड्यूल बंद होने पर)। EveryPay कॉलबैक दोबारा भेजता है। कारण लॉग में है।

ग्राहक को दिखता है «EveryPay अस्थायी रूप से उपलब्ध नहीं है»: EveryPay ने क्रेडेंशियल्स अस्वीकार किए या उस तक पहुँचा नहीं जा सका। वर्तमान मोड का API यूज़रनेम और API secret जाँचें।

ग्राहक को दिखता है «यह भुगतान विधि ऑर्डर की मुद्रा का समर्थन नहीं करती»: कार्ट की मुद्रा प्रोसेसिंग खाते की मुद्रा से अलग है।

ग्राहक Payment confirmation पेज पर रुका रहता है: EveryPay ने अभी भुगतान पूरा नहीं किया है। ऑर्डर कॉलबैक से बनता है, या जब EveryPay भुगतान की पुष्टि कर दे और ग्राहक Check again पर क्लिक करे, तब बनता है।

ऑर्डर EveryPay payment on hold पर है: ऑर्डर ब्लॉक में EveryPay notes पढ़ें। राशि या मुद्रा अलग थी, या भुगतान पहुँचने से पहले ऑर्डर रद्द हो चुका था। Merchant Portal में भुगतान की जाँच करें, फिर ऑर्डर पूरा करें या मैन्युअली रिफ़ंड करें।

डेवलपर्स के लिए: मॉड्यूल की README में हुक actionWcpEverypayOneoffRequest (भुगतान अनुरोध बदलना) और actionWcpEverypayLocale (भुगतान पेज की भाषा बदलना) सूचीबद्ध हैं।

अनइंस्टॉल

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

EveryPay उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल EveryPay से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।