VibeFox eWAY for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।
स्टोर की मुद्रा: AUD, NZD, SGD, HKD या MYR। अन्य कार्ट मुद्राओं के लिए चेकआउट पर यह भुगतान विधि नहीं दिखाई जाती। भुगतान कार्ट की मुद्रा में लिया जाता है।
eWAY खाता: आपको Rapid API एक्सेस वाला eWAY मर्चेंट खाता चाहिए, और उसकी Rapid API कुंजी व पासवर्ड। ये MyeWAY में Settings, API Key के अंतर्गत मिलते हैं। परीक्षण के लिए आपको अपनी कुंजी और पासवर्ड वाला eWAY सैंडबॉक्स खाता चाहिए। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं। eWAY में कुछ सेट करने की ज़रूरत नहीं है: रिटर्न URL हर भुगतान के साथ भेजा जाता है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox eWAY Payment Gateway ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के सबसे ऊपर वाले लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. अपनी sandbox API कुंजी और पासवर्ड दर्ज करें, Sandbox Mode चालू रहने दें, Enable/Disable चालू करें, Save पर क्लिक करें और एक टेस्ट ऑर्डर दें।
5. अपनी live API कुंजी और पासवर्ड दर्ज करें, Sandbox Mode बंद करें और Save पर क्लिक करें।
6. वैकल्पिक रूप से, Configure पेज पर दिखाए गए cron URL को अपने सर्वर के cron jobs में जोड़ें (देखें कॉन्फ़िगरेशन)।
इंस्टॉल होने पर मॉड्यूल eWAY payment on hold ऑर्डर स्थिति बनाता है। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल देता है। आप इन्हें Payment > Preferences में सीमित कर सकते हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox eWAY Payment Gateway > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है। फ़ील्ड्स के ऊपर एक बैज मोड दिखाता है: SANDBOX — payments go to the eWAY sandbox, no real money is charged. या LIVE — real payments are taken with the live API key. जब मौजूदा मोड की API कुंजी या पासवर्ड खाली हों (तब चेकआउट पर भुगतान विधि नहीं दिखती), और जब स्टोर की डिफ़ॉल्ट मुद्रा eWAY द्वारा समर्थित न हो, तब पेज चेतावनी देता है।
eWAY
Enable/Disable: Enable eWAY Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। यही नाम ऑर्डर में भुगतान विधि के रूप में भी सेव होता है। डिफ़ॉल्ट: Credit Card (eWAY)। अनिवार्य।
Description: चेकआउट पर भुगतान विधि के नीचे दिखने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely using your credit card via eWAY. You will be redirected to the eWAY secure payment page.
API क्रेडेंशियल
Rapid API कुंजी और पासवर्ड MyeWAY में Settings, API Key के अंतर्गत हैं। eWAY ने लाइव और सैंडबॉक्स कुंजियों के लिए गाइड दिए हैं, जो इस सेक्शन में लिंक किए गए हैं। सैंडबॉक्स और लाइव अलग-अलग कुंजियाँ इस्तेमाल करते हैं।
Sandbox Mode: भुगतान सैंडबॉक्स कुंजी और पासवर्ड के साथ eWAY sandbox पर जाते हैं। कोई वास्तविक राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। लाइव कुंजी से असली भुगतान लेने के लिए इसे बंद करें। चालू रहने तक ग्राहकों को भुगतान विधि के नीचे Test mode: no real payment is taken. दिखता है।
Live API Key: आपके eWAY लाइव खाते की Rapid API कुंजी।
Live API Password: आपके eWAY लाइव खाते का Rapid API पासवर्ड।
Sandbox API Key: आपके eWAY sandbox (partner/developer) खाते की Rapid API कुंजी।
Sandbox API Password: आपके eWAY sandbox खाते का Rapid API पासवर्ड।
सेव की गई कुंजियाँ और पासवर्ड दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।
Clear saved credentials: कोई कुंजी या पासवर्ड चिह्नित करें और उसे हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सेव किया हुआ मान रखता है।
Return URL / re-checks: eWAY में किसी webhook या return URL को कॉन्फ़िगर करने की ज़रूरत नहीं है, क्योंकि return URL हर भुगतान के साथ भेजा जाता है। इस फ़ील्ड में एक वैकल्पिक cron URL दिखता है। इसे सर्वर के cron job से कॉल करें, उदाहरण के लिए हर 15 मिनट में। अगर ग्राहक भुगतान करे और स्टोर पर लौटने से पहले ब्राउज़र बंद कर दे, तो लगभग एक घंटे बाद भुगतान के बारे में eWAY से पूछा जाता है और ऑर्डर बनता है। अगर eWAY तक पहुँच न हो, तो जाँच अधिकतम तीन बार दोहराई जाती है। यह URL गुप्त रखें: इसमें एक टोकन है, और गलत टोकन वाली कॉल को Forbidden का जवाब मिलता है।
ऑर्डर
Order Status on Success: eWAY द्वारा भुगतान की पुष्टि होने पर ऑर्डर की स्थिति।
जो स्वीकृत राशि या मुद्रा ऑर्डर से मेल न खाए, वह हमेशा eWAY payment on hold में जाती है।
उन्नत
Debug log: API कॉल और भुगतान के परिणाम मॉड्यूल फ़ोल्डर में logs/eway_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। कार्ड डेटा, कुंजियाँ, पासवर्ड, ग्राहक के ईमेल और एक्सेस कोड लॉग नहीं होते। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। लॉग खाली करने के लिए Clear log पर क्लिक करें।
Delete all plugin data on uninstall: चालू होने पर मॉड्यूल हटाने से गेटवे की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर का eWAY भुगतान डेटा और eWAY payment on hold ऑर्डर स्थिति हमेशा रहते हैं। डिफ़ॉल्ट: बंद।
चेकआउट
भुगतान के चरण में ग्राहक भुगतान विधि (डिफ़ॉल्ट रूप से Credit Card (eWAY)) चुनता है और पुष्टि करता है। मॉड्यूल कार्ट की मुद्रा में कार्ट कुल राशि के लिए eWAY से एक भुगतान पेज माँगता है, जिसमें इनवॉइस संदर्भ के रूप में PS- और कार्ट नंबर होता है, साथ ही ग्राहक का बिलिंग पता और ईमेल भी। फिर ग्राहक को eWAY Responsive Shared Page पर भेजा जाता है। वहाँ ग्राहक कार्ड से भुगतान करता है। राशि तुरंत कैप्चर होती है। इस बिंदु पर अभी कोई ऑर्डर मौजूद नहीं होता।
भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। मॉड्यूल ब्राउज़र पर भरोसा नहीं करता: वह सर्वर-से-सर्वर पर eWAY से उस भुगतान पेज का परिणाम माँगता है जो इस कार्ट के लिए बना था। ऑर्डर को तभी भुगतान किया हुआ मार्क किया जाता है जब eWAY पुष्टि कर दे और स्वीकृत राशि व मुद्रा कार्ट से मेल खाएँ। फिर ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है, जिस पर Your payment with eWAY has been received. लिखा होता है। होल्ड पर चल रहे ऑर्डर के लिए पेज पर Your payment was received and is being reviewed by the store. We will contact you if anything is needed. दिखता है।
अगर उस समय eWAY से पूछा नहीं जा सकता, तो Payment confirmation पेज पर We have not received the confirmation of your payment from eWAY yet. If you completed the payment, this order will be updated shortly — please do not pay again. दिखता है, साथ में Check again बटन और Back to checkout बटन होते हैं। ग्राहक दोबारा जाँच करे या cron URL चले, तब ऑर्डर बनता है।
अगर भुगतान अस्वीकृत हो जाए, तो ग्राहक कारण के साथ चेकआउट पर लौट आता है, जैसे Your payment was declined: D4451 Insufficient funds. Please try again or use a different payment method. अगर ग्राहक eWAY पेज पर Cancel पर क्लिक करे, तो मॉड्यूल पहले eWAY से जाँचता है कि कुछ भी भुगतान नहीं हुआ है (जैसे किसी दूसरे टैब में)। फिर ग्राहक को You cancelled the payment on the eWAY page. Your order has not been paid — you can try again. दिखता है। अगर भुगतान पूरा नहीं हुआ, तो संदेश The payment was not completed. Please try again. होता है। कार्ट हर स्थिति में सुरक्षित रहता है।
ग्राहक दोबारा कोशिश कर सकता है। नया भुगतान पेज बनाने से पहले, उस कार्ट के पिछले पेज को eWAY से जाँचा जाता है। अगर वह पहले से भुगतान किया हुआ है, तो दूसरे भुगतान के बजाय ऑर्डर बनाया जाता है। अगर eWAY भुगतान पेज नहीं बना पाता, तो ग्राहक चेकआउट पर रहता है और छोटा संदेश देखता है, जैसे Payment error: Unable to connect to eWAY. Please try again. या eWAY could not start the payment, साथ में eWAY के एरर कोड।
Shared Page के लिए eWAY सर्वर-से-सर्वर सूचनाएँ नहीं भेजता: परिणाम ग्राहक के लौटने पर और cron URL के ज़रिए लिया जाता है। मॉड्यूल में आपकी साइट पर कार्ड फ़ील्ड नहीं हैं, न सेव किए गए कार्ड या सब्सक्रिप्शन हैं, न केवल-authorise और अलग capture है, और यह Beagle फ़्रॉड स्कोर का मूल्यांकन नहीं करता (eWAY के फ़्रॉड नियमों से ब्लॉक किए गए लेन-देन eWAY स्वयं अस्वीकार करता है)।
ऑर्डर और रिफ़ंड
ऑर्डर स्थितियाँ
No order yet: ग्राहक को eWAY पर भेजा गया था और उसने भुगतान नहीं किया, रद्द किया, भुगतान अस्वीकृत हुआ, या परिणाम अभी लिया नहीं जा सका। केवल कार्ट मौजूद है।
Payment accepted or Delivered: भुगतान स्वीकृत हुआ। स्थिति Order Status on Success का पालन करती है। भुगतान eWAY ट्रांज़ैक्शन ID के साथ दर्ज होता है, और एक नोट में ट्रांज़ैक्शन ID, auth code, प्रतिक्रिया और मोड (सैंडबॉक्स या लाइव) दिखते हैं।
eWAY payment on hold: eWAY ने कार्ट से अलग राशि या मुद्रा स्वीकृत की (जैसे Approved for partial amount, या ग्राहक द्वारा भुगतान पेज खोलने के बाद कार्ट बदला गया), भुगतान ग्राहक द्वारा eWAY पेज पर रद्द करने के बाद स्वीकृत हुआ, या ऑर्डर रद्द होने के बाद स्वीकृत हुआ। भुगतान उस राशि के साथ दर्ज होता है जो eWAY ने ली, और नोट कारण समझाता है। ऑर्डर की जाँच करें और उसे पूरा करें या भुगतान रिफ़ंड करें।
Refunded: भुगतान मॉड्यूल के ज़रिए पूरी तरह रिफ़ंड किया गया।
अगर पहले से भुगतान किए गए कार्ट के लिए दूसरा भुगतान स्वीकृत होता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे MyeWAY में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। किसी दूसरे इनवॉइस संदर्भ के लिए स्वीकृत भुगतान कभी ऑर्डर पर लागू नहीं होता।
eWAY भुगतान ब्लॉक
ऑर्डर पेज पर eWAY payment ब्लॉक दिखता है, जिसमें ट्रांज़ैक्शन ID, auth code, eWAY प्रतिक्रिया, स्थिति, मोड और इनवॉइस संदर्भ, भुगतान की गई और रिफ़ंड की गई राशि, सैंडबॉक्स भुगतानों के लिए Sandbox बैज, रिफ़ंड इतिहास और ऑर्डर के eWAY notes शामिल हैं।
रिफ़ंड
eWAY payment ब्लॉक में राशि दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई है, वह अपने-आप भर जाती है), वैकल्पिक रूप से कारण लिखें, और Refund via eWAY पर क्लिक करें। प्रश्न Refund this amount through eWAY? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। आपको ऑर्डर संपादित करने का अधिकार चाहिए; Modules पेज की पहुँच ज़रूरी नहीं है। रिफ़ंड उसी राशि और मुद्रा में होते हैं जो eWAY ने ली थी, इसलिए आंशिक राशि की स्वीकृति के बाद आप ऑर्डर कुल राशि तक नहीं, बल्कि ग्राहक द्वारा वास्तव में चुकाई गई राशि तक रिफ़ंड कर सकते हैं। रिफ़ंड उसी वातावरण में भेजा जाता है जिसमें भुगतान हुआ था (सैंडबॉक्स या लाइव), इसलिए उस वातावरण की API कुंजी और पासवर्ड सेट होने चाहिए। अगर eWAY रिफ़ंड अस्वीकार करता है, तो ब्लॉक में eWAY कोड के साथ eWAY refund failed: दिखता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोट्स में eWAY रिफ़ंड ट्रांज़ैक्शन ID के साथ जुड़ जाता है। पूर्ण रिफ़ंड ऑर्डर को Refunded पर सेट करता है। आंशिक रिफ़ंड स्थिति नहीं बदलता। रिफ़ंड तभी उपलब्ध होते हैं जब eWAY भुगतान स्वीकृत कर चुका हो।
मॉड्यूल क्रेडिट स्लिप नहीं बनाता। ऑर्डर पेज के मानक PrestaShop रिफ़ंड बटन eWAY के ज़रिए पैसे वापस नहीं भेजते। MyeWAY में किए गए रिफ़ंड PrestaShop के साथ सिंक नहीं होते। ज़रूरत हो तो ऑर्डर को हाथ से अपडेट करें।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक License — VibeFox eWAY Payment Gateway, Modules > Module Manager > VibeFox eWAY Payment Gateway > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी छिपी हुई दिखती है, साथ ही स्थिति (जैसे लाइसेंस कब तक सक्रिय है और आपका डोमेन) और बटन Check now (स्थिति फिर से जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए) दिखते हैं। इनके नीचे Product: presta-payment-eway वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को eWAY नहीं दिखता। फिर भी यदि भुगतान शुरू होता है, तो ग्राहक को यह भुगतान विधि उपलब्ध नहीं है। कृपया कोई दूसरी चुनें। दिखता है। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान विधि आपके लिए भी छिपी रहती है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसका परीक्षण नहीं कर सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि होती रहती है, और रिफ़ंड काम करते हैं।
लाइसेंस की अवधि समाप्त होने पर मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है।
समस्या निवारण
eWAY does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड की API कुंजी और पासवर्ड सेट हैं (सैंडबॉक्स मोड में sandbox फ़ील्ड, लाइव मोड में live फ़ील्ड), और कार्ट की मुद्रा AUD, NZD, SGD, HKD या MYR है। क्रेडेंशियल गायब होने पर सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमति प्राप्त है।
The payment went through, but no order was created: ग्राहक eWAY से वापस नहीं लौटा, या उस समय eWAY से पूछा नहीं जा सका। eWAY, Shared Page के लिए सूचनाएँ नहीं भेजता। Return URL / re-checks से cron URL सेट करें: यह लगभग एक घंटे बाद भुगतान उठा लेगा। MyeWAY में ट्रांज़ैक्शन जाँचें और मॉड्यूल पेज पर Log फ़ील्ड देखें।
The customer sees This payment method is temporarily unavailable: मौजूदा मोड की API कुंजी या पासवर्ड गायब हैं, या eWAY ने उन्हें अस्वीकार कर दिया है। मौजूदा मोड के क्रेडेंशियल जाँचें।
The customer sees eWAY could not start the payment: eWAY ने एरर कोड लौटाए हैं, जो संदेश में दिखते हैं। अक्सर बिलिंग विवरण अमान्य होते हैं।
The customer sees We could not match this payment to an order: रिटर्न लिंक इस स्टोर की किसी कार्ट का नहीं है, या eWAY ने किसी दूसरे इनवॉइस संदर्भ के लिए भुगतान स्वीकृत किया है। अगर ग्राहक से पैसे कट गए हैं, तो MyeWAY में भुगतान खोजें।
The customer sees We could not check the status of your previous payment attempt: उसी कार्ट को कोई और अनुरोध प्रोसेस कर रहा था। ग्राहक थोड़ी देर बाद फिर कोशिश कर सकता है।
Order is eWAY payment on hold after payment: eWAY payment ब्लॉक के eWAY notes पढ़ें (ऑर्डर स्थितियाँ देखें), फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Refund fails with a message about the sandbox or live mode: ऑर्डर उस वातावरण में चुकाया गया था, और उसकी API कुंजी और पासवर्ड सेट नहीं हैं। उन्हें दर्ज करें और फिर कोशिश करें।
Refund fails with at most … can be refunded: राशि, eWAY द्वारा ली गई राशि में से पहले हो चुके रिफ़ंड घटाने के बाद बची राशि से अधिक है।
डेवलपर्स के लिए: मॉड्यूल के README में hook actionWcpEwaySupportedCurrencies दिया गया है, यदि आपका eWAY खाता अतिरिक्त मुद्राओं के लिए सक्षम है।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox eWAY Payment Gateway के बगल वाला मेन्यू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। अगर Delete all plugin data on uninstall चालू है, तो गेटवे की सेटिंग्स और लॉग हट जाते हैं। अगर बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सभी सेटिंग्स रखी जाती हैं। ऑर्डर का eWAY भुगतान डेटा और eWAY payment on hold ऑर्डर स्थिति हमेशा रहते हैं, इसलिए पहले चुकाए गए ऑर्डर दोबारा इंस्टॉल करने के बाद भी रिफ़ंड किए जा सकते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।
eWAY उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल eWAY से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।