VibeFox eWAY for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

स्टोर मुद्रा: AUD, NZD, SGD, HKD या MYR। अन्य मुद्राओं के लिए चेकआउट पर यह भुगतान विधि छिपी रहती है। ऑर्डर अपनी ही मुद्रा में चार्ज होता है।

eWAY खाता: आपको Rapid API एक्सेस वाला eWAY मर्चेंट खाता और उसकी Rapid API कुंजी व पासवर्ड चाहिए, जो MyeWAY में Settings, API Key के अंतर्गत मिलते हैं। परीक्षण के लिए अपनी कुंजी और पासवर्ड वाला eWAY सैंडबॉक्स खाता चाहिए। सैंडबॉक्स और लाइव कुंजियाँ अलग होती हैं। eWAY में कुछ भी सेट करने की ज़रूरत नहीं है: हर भुगतान के साथ रिटर्न URL भेजा जाता है।

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

इंस्टॉलेशन

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

2. Activate पर क्लिक करें।

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

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

5. अपनी सैंडबॉक्स API कुंजी और पासवर्ड डालें, Sandbox Mode को चालू रखें, Enable/Disable चालू करें, और eWAY के टेस्ट कार्ड 4444333322221111 से एक टेस्ट ऑर्डर दें।

6. अपनी लाइव API कुंजी और पासवर्ड डालें, Sandbox Mode का चेकमार्क हटाएँ और सेव करें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > eWAY। फ़ील्ड्स के ऊपर एक बैज मोड दिखाता है: SANDBOX (भुगतान eWAY सैंडबॉक्स में जाते हैं, कोई असली पैसा नहीं कटता) या LIVE (असली भुगतान लाइव API कुंजी से लिए जाते हैं)। यदि मौजूदा मोड की API कुंजी या पासवर्ड गायब हैं (तब चेकआउट पर गेटवे नहीं दिखता) या स्टोर मुद्रा समर्थित नहीं है, तो पेज चेतावनी देता है। भुगतान विधियों की सूची में, जब तक मौजूदा मोड में क्रेडेंशियल नहीं होते, 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: Enable sandbox (test) mode भुगतान को सैंडबॉक्स कुंजी के साथ eWAY सैंडबॉक्स में भेजता है। कोई असली पैसा नहीं कटता। डिफ़ॉल्ट: चालू। लाइव कुंजी से असली भुगतान लेने के लिए इसका चेकमार्क हटाएँ।

Live API Key: आपके eWAY लाइव खाते की Rapid API कुंजी।

Live API Password: आपके eWAY लाइव खाते का Rapid API पासवर्ड।

Sandbox API Key: आपके eWAY सैंडबॉक्स (partner/developer) खाते की Rapid API कुंजी।

Sandbox API Password: आपके eWAY सैंडबॉक्स खाते का Rapid API पासवर्ड।

ऑर्डर

Order Status on Success: eWAY द्वारा भुगतान की पुष्टि होने के बाद ऑर्डर की स्थिति।

उन्नत

Debug log: Enable logging API कॉल और भुगतान परिणामों को WooCommerce > Status > Logs में लिखता है, स्रोत wcp_eway_payment_gateway। कार्ड डेटा और कुंजियाँ लॉग नहीं होतीं। त्रुटियाँ हमेशा लॉग होती हैं। डिफ़ॉल्ट: बंद।

Uninstall: Delete all plugin data on uninstall। चेकमार्क होने पर प्लगइन हटाने पर गेटवे की सेटिंग्स और उसके लॉग हटा दिए जाते हैं। ऑर्डर पर सेव भुगतान संदर्भ (payment references) रखे जाते हैं। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit Card (eWAY)) और ऑर्डर देता है। प्लगइन eWAY से ऑर्डर कुल राशि के लिए, ऑर्डर मुद्रा में, एक भुगतान पेज माँगता है, जिसमें ऑर्डर ID इनवॉइस संदर्भ के रूप में और ग्राहक की बिलिंग जानकारी शामिल होती है, और ग्राहक को eWAY Responsive Shared Page पर भेजता है। वहाँ ग्राहक कार्ड से भुगतान करता है। भुगतान तुरंत कैप्चर होता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौट आता है। प्लगइन ब्राउज़र पर भरोसा नहीं करता: वह सर्वर-से-सर्वर पर eWAY से उस भुगतान पेज का परिणाम माँगता है जो इस ऑर्डर के लिए बना था। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब eWAY पुष्टि करे और स्वीकृत राशि व मुद्रा ऑर्डर से मेल खाएँ। फिर ग्राहक "ऑर्डर प्राप्त हुआ" पेज पर पहुँचता है। यदि उस समय eWAY से पूछा नहीं जा सका, तो ऑर्डर "भुगतान लंबित" रहता है और पेज पर 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. दिखता है। "ऑर्डर प्राप्त हुआ" पेज खुलने पर और WooCommerce द्वारा बिना भुगतान वाले ऑर्डर को स्वचालित रूप से रद्द करने से पहले भुगतान फिर से जाँचा जाता है।

यदि भुगतान अस्वीकार हो जाता है, तो ग्राहक कारण सहित चेकआउट (या Pay for order पेज) पर लौट आता है, जैसे Your payment was declined: Insufficient funds. Please try again or use a different payment method. यदि ग्राहक eWAY पेज पर Cancel पर क्लिक करता है, तो प्लगइन पहले eWAY से जाँचता है कि कुछ भी भुगतान नहीं हुआ। चेकआउट पर दिया गया ऑर्डर तब रद्द हो जाता है, और Pay for order पेज से भुगतान किया गया ऑर्डर बिना भुगतान के रहता है। ग्राहक को 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 भुगतान पेज नहीं बना पाता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे Payment error: Unable to connect to eWAY. Please try again.

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

eWAY, Shared Page के लिए सर्वर-से-सर्वर सूचनाएँ नहीं भेजता: परिणाम तब लिया जाता है जब ग्राहक लौटता है और ऊपर बताई गई जाँचों में। प्लगइन में आपकी साइट पर कार्ड फ़ील्ड नहीं हैं, सेव किए गए कार्ड या सब्सक्रिप्शन नहीं हैं, केवल-authorise और बाद में capture नहीं है, और Beagle फ़्रॉड स्कोर का मूल्यांकन नहीं करता (eWAY के फ़्रॉड नियमों से ब्लॉक किए गए लेन-देन को eWAY स्वयं अस्वीकार करता है)।

ऑर्डर और रिफ़ंड

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

Pending payment: ग्राहक को eWAY पर भेजा गया है और उसने अभी भुगतान नहीं किया है, या परिणाम अभी eWAY से नहीं मिल सका है (ऑर्डर नोट में यह लिखा होगा)।

Processing or Completed: भुगतान स्वीकृत हो गया है। स्थिति Order Status on Success के अनुसार होती है। ऑर्डर नोट में eWAY ट्रांज़ैक्शन ID, auth code और प्रतिक्रिया दिखती है। ऑर्डर का ट्रांज़ैक्शन ID ही eWAY ट्रांज़ैक्शन ID है।

On hold after payment: eWAY ने ऑर्डर से अलग राशि या मुद्रा स्वीकृत की है (उदाहरण के लिए Approved for partial amount, या ग्राहक के भुगतान पेज खोलने के बाद ऑर्डर संपादित हुआ), या ऑर्डर रद्द होने के बाद भुगतान स्वीकृत हुआ। नोट इसकी व्याख्या करता है। "ऑर्डर प्राप्त हुआ" पेज पर ग्राहक को Your payment was received and is being reviewed by the store. We will contact you if anything is needed. दिखता है। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

Failed: eWAY ने भुगतान अस्वीकार किया। नोट में eWAY कोड और उसका अर्थ दिखता है।

Cancelled: ग्राहक ने चेकआउट पर ऑर्डर देने के बाद eWAY पेज पर रद्द किया, या eWAY द्वारा पुष्टि होने पर कि भुगतान नहीं हुआ, ऑर्डर आपके द्वारा या WooCommerce के स्टॉक होल्ड टाइमआउट से रद्द हुआ।

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि डालें और Refund via Credit Card (eWAY) पर क्लिक करें (बटन भुगतान विधि का शीर्षक इस्तेमाल करता है)। पूर्ण और आंशिक दोनों रिफ़ंड समर्थित हैं। रिफ़ंड उसी वातावरण (सैंडबॉक्स या लाइव) में भेजा जाता है जिसमें भुगतान हुआ था, इसलिए उस वातावरण की API कुंजी और पासवर्ड सेट होने चाहिए। यदि eWAY रिफ़ंड अस्वीकार करता है, तो WooCommerce eWAY कोड दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड eWAY रिफ़ंड ट्रांज़ैक्शन ID के साथ ऑर्डर नोट्स में जोड़ा जाता है।

MyeWAY में किए गए रिफ़ंड WooCommerce के साथ सिंक नहीं होते। ज़रूरत हो तो eWAY रिफ़ंड बटन के बिना WooCommerce में मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

लाइसेंस की अवधि समाप्त होने पर प्लगइन चलता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

eWAY does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, मौजूदा मोड की API कुंजी और पासवर्ड सेट हैं (सैंडबॉक्स मोड में सैंडबॉक्स फ़ील्ड, लाइव मोड में लाइव फ़ील्ड), और स्टोर मुद्रा AUD, NZD, SGD, HKD या MYR है। Pay for order पेज पर ऑर्डर की मुद्रा जाँची जाती है।

The payment went through, but the order stays Pending payment: ग्राहक eWAY से वापस नहीं लौटा, या उस समय eWAY से नहीं पूछा जा सका। eWAY Shared Page के लिए सूचनाएँ नहीं भेजता। "ऑर्डर प्राप्त हुआ" पेज खुलने पर और WooCommerce द्वारा बिना भुगतान वाले ऑर्डर को रद्द करने से पहले भुगतान फिर से जाँचा जाता है। MyeWAY में लेन-देन जाँचें और WooCommerce > Status > Logs देखें, स्रोत wcp_eway_payment_gateway।

ग्राहक को This payment method is temporarily unavailable संदेश दिखता है: मौजूदा मोड की API कुंजी या पासवर्ड गायब हैं, या eWAY ने उन्हें अस्वीकार किया। मौजूदा मोड के क्रेडेंशियल जाँचें।

ग्राहक को eWAY could not start the payment संदेश दिखता है: eWAY ने त्रुटि कोड लौटाए, जो संदेश में दिखते हैं। अक्सर बिलिंग जानकारी गलत होती है।

ग्राहक को We could not match this payment to an order संदेश दिखता है: रिटर्न लिंक इस स्टोर के किसी ऑर्डर का नहीं है। यदि ग्राहक से शुल्क लिया गया है, तो MyeWAY में भुगतान खोजें।

ग्राहक को We could not confirm your payment with eWAY संदेश दिखता है: भुगतान का परिणाम जाँचा नहीं जा सका। परिणाम मिलने पर ऑर्डर अपडेट होता है; ग्राहक को दोबारा भुगतान नहीं करना चाहिए।

Order is On hold after payment: ऑर्डर नोट पढ़ें। स्वीकृत राशि या मुद्रा ऑर्डर से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद आया। ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

सैंडबॉक्स या लाइव मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है: ऑर्डर उसी वातावरण में चुकाया गया था, और उस वातावरण की API कुंजी और पासवर्ड सेट नहीं हैं। उन्हें डालें और फिर से कोशिश करें।

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

डेवलपर्स के लिए: readme में eway_p_supported_currencies फ़िल्टर सूचीबद्ध है, यदि आपका eWAY खाता अधिक मुद्राओं के लिए सक्षम है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा बना रहता है। हटाने के लिए, प्लगइन को Plugins पेज पर निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। गेटवे सेटिंग्स और लॉग तभी हटाए जाते हैं जब Uninstall (Delete all plugin data on uninstall) चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। ऑर्डर पर सेव भुगतान संदर्भ हमेशा रखे जाते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID बनाए रखते हैं।

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