VibeFox EveryPay for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 या बाद का (4.1.0.3 पर परीक्षण किया गया)।

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

EveryPay खाता: आपको अपने ई-स्टोर का API उपयोगकर्ता नाम, API सीक्रेट और प्रोसेसिंग खाते (processing account) का नाम चाहिए। ये EveryPay Merchant Portal में, ई-स्टोर की सेटिंग्स में दिखाई देते हैं। डेमो पोर्टल (टेस्ट मोड) और लाइव पोर्टल के क्रेडेंशियल अलग-अलग होते हैं। ग्राहक जिन भुगतान तरीकों (कार्ड, Apple Pay, Google Pay, बैंक लिंक) का उपयोग कर सकते हैं, वे आपके EveryPay खाते के लिए सक्षम किए गए तरीके ही हैं।

मुद्रा: एक प्रोसेसिंग खाता केवल एक मुद्रा में भुगतान लेता है। खाते का नाम उसकी मुद्रा कोड से शुरू होता है, उदाहरण के लिए EUR3D1 यूरो में भुगतान लेता है। EveryPay केवल तभी दिया जाता है जब ग्राहक उस मुद्रा में भुगतान करता है।

सार्वजनिक वेबसाइट: आपके स्टोर का callback URL इंटरनेट से पहुँचा जा सकने वाला होना चाहिए, और उसे बेसिक ऑथेंटिकेशन या फ़ायरवॉल द्वारा ब्लॉक नहीं होना चाहिए।

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

इंस्टॉलेशन

डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_everypay_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_everypay_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_everypay_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD संशोधन नहीं है, इसलिए Extensions > Modifications को रिफ़्रेश करने की आवश्यकता नहीं है। इंस्टॉलर के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox EveryPay Payment खोजें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन की सूची बदलने का अधिकार होना चाहिए।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के शीर्ष पर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. डेमो पोर्टल से टेस्ट API उपयोगकर्ता नाम, टेस्ट API सीक्रेट और प्रोसेसिंग खाते का नाम दर्ज करें। Callback notification URL को Merchant Portal में कॉपी करें (देखें कॉन्फ़िगरेशन)।

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

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_everypay_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. इंस्टॉल किए गए एक्सटेंशन की सूची में, उसी पेज पर, पैकेज दिखाई देता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox EveryPay Payment खोजें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।

4. लाइसेंस कुंजी, EveryPay क्रेडेंशियल और callback को चरण 3 से 5 (OpenCart 3) की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल callback URL अलग है (देखें भुगतान सूचनाएँ (callback))।

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox EveryPay Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर, जब तक टेस्ट मोड चालू है, पेज Test mode is on: payments go to the EveryPay demo environment, no real money is charged. दिखाता है। यदि भुगतान विधि सक्षम है लेकिन वर्तमान मोड का API उपयोगकर्ता नाम, API सीक्रेट या प्रोसेसिंग खाता गायब है (तब भुगतान विधि चेकआउट पर छिपी रहती है), और यदि प्रोसेसिंग खाते की मुद्रा आपके स्टोर की डिफ़ॉल्ट मुद्रा से अलग है, तो पेज चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

सहेजते समय, Title अधिकतम 128 अक्षरों का होना चाहिए, Sort Order पूर्ण संख्या होनी चाहिए, Total शून्य से कम न हो, और चुना गया जियो ज़ोन तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए। अन्यथा एक त्रुटि उस फ़ील्ड का नाम बताती है और कुछ भी सहेजा नहीं जाता। उपयोगकर्ता नामों, सीक्रेट्स और खाते के नाम में से स्पेस और लाइन ब्रेक हटा दिए जाते हैं।

EveryPay

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

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

Description: Confirm Order चरण में, कन्फ़र्म बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely by card or bank link on the EveryPay payment page.

Sort Order: चेकआउट पर भुगतान विधियों के बीच EveryPay की स्थिति। खाली छोड़ें या एक पूर्ण संख्या दर्ज करें।

Geo Zone: EveryPay केवल चुने गए जियो ज़ोन के भुगतान पते के लिए दें। डिफ़ॉल्ट: All zones। जियो ज़ोन System > Localisation > Geo Zones में सेट किए जाते हैं।

Total: चेकआउट कुल राशि, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही EveryPay दिया जाए। किसी भी राशि पर EveryPay देने के लिए खाली छोड़ें।

EveryPay खाता

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

Test Mode: भुगतान टेस्ट क्रेडेंशियल के साथ EveryPay डेमो वातावरण में जाते हैं; कोई वास्तविक राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। लाइव क्रेडेंशियल से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर, ग्राहक Confirm Order चरण में TEST MODE: EveryPay demo environment, no real money is charged. देखते हैं।

Test API Username: डेमो वातावरण का API उपयोगकर्ता नाम।

Test API Secret: डेमो वातावरण का API सीक्रेट।

Live API Username: लाइव वातावरण का API उपयोगकर्ता नाम।

Live API Secret: लाइव वातावरण का API सीक्रेट।

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

सहेजे गए API सीक्रेट्स दोबारा कभी नहीं दिखाए जाते। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजा गया सीक्रेट हटाने के लिए, फ़ील्ड के नीचे Clear the saved API secret on save पर टिक करें और Save पर क्लिक करें।

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

callback आपके स्टोर को बताता है कि भुगतान पूरा हो गया है, ताकि ग्राहक ब्राउज़र बंद कर दे तब भी ऑर्डर पक्के हो जाएँ। Callback notification URL में दिखाए गए URL को EveryPay Merchant Portal में अपने ई-स्टोर के callback URL फ़ील्ड में कॉपी करें, डेमो पोर्टल और लाइव पोर्टल दोनों में। OpenCart 3 पर URL ऐसा दिखता है: https://your-store/index.php?route=extension/payment/wcp_everypay_payment/callback, और OpenCart 4 पर ऐसा: https://your-store/index.php?route=extension/wcp_everypay_payment/payment/wcp_everypay_payment.callback। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं।

callback में केवल भुगतान के संदर्भ होते हैं। एक्सटेंशन उस पर अकेले कभी भरोसा नहीं करता: वह भुगतान जिस मोड में हुआ था, उसके क्रेडेंशियल से EveryPay API से भुगतान की स्थिति पूछता है। ऐसे भुगतान के लिए callback जो इस स्टोर ने नहीं बनाया, EveryPay को बिना किसी अनुरोध के अस्वीकार कर दिया जाता है। स्टोर मेंटेनेंस मोड में होने पर भी callback काम करता है, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है (ग्राहक की वापसी के लिए भी)। callback के बिना, ग्राहक के स्टोर पर लौटने पर, या जब आप ऑर्डर पेज पर Check EveryPay payment status पर क्लिक करते हैं, तब ऑर्डर को स्थिति मिलती है।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (लापता ऑर्डर)। ऑर्डर को स्थिति तभी मिलती है जब EveryPay अपने API के माध्यम से भुगतान की पुष्टि कर देता है। नीचे का हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।

Order Status After Payment: सत्यापित, निपटाए गए या अधिकृत भुगतान के बाद सेट होने वाली ऑर्डर स्थिति। डिफ़ॉल्ट: प्रक्रियाधीन।

Manual Review Status: भुगतान हुआ, लेकिन राशि या मुद्रा ऑर्डर से मेल नहीं खाती, ऑर्डर इस बीच रद्द हो गया, या ऑर्डर दूसरी भुगतान विधि का उपयोग करता है। एक नोट कारण बताता है, और ऑर्डर भुगतान किया हुआ चिह्नित नहीं होता। डिफ़ॉल्ट: लंबित, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Cancelled Order Status: इस स्थिति वाले ऑर्डर के लिए आया भुगतान, ऑर्डर का भुगतान करने के बजाय मैनुअल समीक्षा में भेजा जाता है। डिफ़ॉल्ट: रद्द।

उन्नत

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

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

Delete data on uninstall: चालू होने पर, एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डरों का EveryPay भुगतान डेटा हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

आयात / निर्यात

Export: Download JSON सेटिंग्स को JSON फ़ाइल के रूप में सहेजता है। API सीक्रेट्स निर्यात नहीं होते।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सहेजे गए API सीक्रेट्स बने रहते हैं।

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से EveryPay)। Confirm Order चरण पर ग्राहक को आपका विवरण और You will be redirected to the secure EveryPay payment page. नोट दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, विंडो Payment method options में, भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल राशि के लिए एक बार का EveryPay भुगतान बनाता है, ग्राहक का ईमेल और भुगतान पता जोड़ता है, और ग्राहक को EveryPay भुगतान पेज पर भेजता है। पेज की भाषा ग्राहक की स्टोर भाषा के अनुसार होती है (अंग्रेज़ी, एस्टोनियाई, रूसी, लातवियाई, लिथुआनियाई, फ़िनिश या जर्मन; अन्यथा अंग्रेज़ी)। वहाँ ग्राहक आपके EveryPay खाते के लिए सक्षम तरीकों में से किसी एक से भुगतान करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब EveryPay उसकी पुष्टि करता है: एक्सटेंशन ग्राहक की वापसी पर और callback पर EveryPay API से भुगतान की स्थिति पूछता है। फिर ऑर्डर OpenCart के मानक तरीके से स्थिति पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। यदि EveryPay अभी भी भुगतान प्रोसेस कर रहा है, या उस समय उसके API तक नहीं पहुँचा जा सकता, तो एक Payment confirmation पेज Your payment is being confirmed by EveryPay. You will receive an e-mail as soon as the order is confirmed. और एक Check again बटन दिखाता है; EveryPay के भुगतान की पुष्टि होते ही callback ऑर्डर स्थिति सेट कर देता है।

यदि भुगतान विफल हो जाता है, तो ग्राहक Your EveryPay payment was not successful. Please try again or choose another payment method. के साथ चेकआउट पर लौट आता है। यदि ग्राहक बिना भुगतान किए भुगतान पेज छोड़ देता है, तो संदेश है The EveryPay payment was not completed. You can try again or choose another payment method. कार्ट सुरक्षित रहता है, और ऑर्डर बिना स्थिति के रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं।

OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए नया प्रयास उसी ऑर्डर को एक नए EveryPay भुगतान से भुगतान करता है। EveryPay बनाए गए भुगतान को रद्द नहीं कर सकता। इसलिए नए भुगतान से पहले एक्सटेंशन EveryPay API से इस ऑर्डर और इसी कार्ट के दूसरे ऑर्डरों के खुले भुगतान प्रयासों की जाँच करता है। यदि उनमें से कोई पहले से भुगतान किया हुआ है, या इसी कार्ट का कोई दूसरा ऑर्डर पहले से भुगतान किया हुआ है, तो ग्राहक दूसरे भुगतान के बिना सफलता पेज पर जाता है। हर प्रयास याद रखा जाता है, इसलिए पुराने लिंक से किया गया भुगतान भी पहचाना जाता है। यदि ग्राहक इसी कार्ट के दूसरे ऑर्डर का भुगतान फिर भी करता है (उदाहरण के लिए दो खुले ब्राउज़र टैब से), तो वह ऑर्डर कोई स्थिति नहीं पाता, ग्राहक ऑर्डर सफलता पेज देखता है, और भुगतान किए गए ऑर्डर पर एक नोट आता है जो आपसे दूसरे भुगतान को EveryPay Merchant Portal में रिफ़ंड करने को कहता है।

OpenCart 4 चेकआउट में ऑर्डर को तब तक रखता है जब तक सफलता पेज न दिखे। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद कर दिया गया (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled. Please confirm the order again. के साथ चेकआउट पर वापस भेजा जाता है, और अगला Confirm Order कार्ट के लिए एक नया ऑर्डर भुगतान करता है। यदि वह ऑर्डर पहले से भुगतान किया हुआ है, पर उसके बाद कार्ट बदल गया है (जिसमें नई मात्रा भी शामिल है), तो संदेश है Your previous order is already paid. Please confirm the order again: the cart will be paid with a new order. किसी भुगतान किए गए ऑर्डर को कभी किसी दूसरे कार्ट के लिए भुगतान किया हुआ नहीं दिखाया जाता।

यदि EveryPay भुगतान शुरू नहीं कर पाता, तो ग्राहक बटन के ऊपर एक छोटे संदेश के साथ Confirm Order चरण पर ही रहता है, जैसे EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. विवरण लॉग में हैं।

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

ऑर्डर

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

No status (missing order): ग्राहक को EveryPay पर भेजा गया था और उसने भुगतान नहीं किया, भुगतान विफल हुआ या छोड़ दिया गया, या EveryPay ने अभी भुगतान की पुष्टि नहीं की है। Sales > Orders में ऐसे ऑर्डर केवल Order Status फ़िल्टर को Missing Orders पर सेट करने पर दिखते हैं।

Order Status After Payment (default Processing): EveryPay ने भुगतान को निपटाया हुआ या अधिकृत बताया है। एक नोट राशि, मुद्रा और भुगतान संदर्भ दिखाता है। अधिकृत भुगतान के लिए, नोट बताता है कि राशि रोकी गई है: यदि आपका खाता स्वतः कैप्चर नहीं करता, तो EveryPay Merchant Portal में भुगतान कैप्चर करें। बाद में निपटने पर एक नोट यह बताता है।

Manual Review Status (default Pending): भुगतान को मैनुअल समीक्षा चाहिए। भुगतान की गई राशि या मुद्रा ऑर्डर से मेल नहीं खाती, भुगतान आने से पहले ऑर्डर पर Cancelled Order Status था, या ऑर्डर अब दूसरी भुगतान विधि का उपयोग करता है। नोट इसे समझाता है और बताता है कि ऑर्डर भुगतान किया हुआ चिह्नित नहीं हुआ। Merchant Portal में भुगतान जाँचें और ऑर्डर को मैनुअल रूप से पूरा करें या रिफ़ंड करें। इस भुगतान के बाद के callback ऑर्डर को अपने आप पूरा नहीं करते; लेकिन उसी ऑर्डर के किसी अन्य प्रयास से सही भुगतान आने पर वह भुगतान हो जाता है।

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

VibeFox EveryPay Payment टैब

Sales > Orders में EveryPay से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox EveryPay Payment टैब हर प्रयास के लिए EveryPay payments of this order दिखाता है: Payment reference, Order reference, Mode (टेस्ट या लाइव), Amount, EveryPay state, Result और Date। उनके नीचे ऑर्डर के EveryPay notes हैं। यह टैब उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

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

रिफ़ंड

स्टोर से रिफ़ंड और कैप्चर समर्थित नहीं हैं। EveryPay Merchant Portal में रिफ़ंड करें, फिर OpenCart में ऑर्डर स्थिति अपडेट करें। जब EveryPay किसी भुगतान को रिफ़ंड किया हुआ या चार्जबैक (विवाद के कारण वापस लिया गया) बताता है, तो एक्सटेंशन केवल ऑर्डर में एक नोट जोड़ता है; ऑर्डर स्थिति नहीं बदलती। Sales > Returns में उत्पाद वापसी EveryPay के ज़रिए पैसे वापस नहीं भेजती।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक License — VibeFox EveryPay Payment, Extensions > Extensions > Payments > VibeFox EveryPay Payment > Edit पेज का पहला ब्लॉक है, जो सेटिंग्स के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है, और आपका डोमेन) और ये बटन दिखाता है: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: opencart-payment-everypay वाली पंक्ति और Manage licenses and domains in your account लिंक है, जो आपका vibefox.net खाता खोलता है। केवल उन एडमिन उपयोगकर्ताओं को कुंजी बदलने की अनुमति है जिनके पास इस एक्सटेंशन के लिए Modify अधिकार है। ब्लॉक के पाठ एडमिन भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

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

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

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

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

EveryPay does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, वर्तमान मोड का API उपयोगकर्ता नाम, API सीक्रेट और Processing Account Name भरे हुए हैं, और ग्राहक प्रोसेसिंग खाते की मुद्रा में भुगतान कर रहा है। इन स्थितियों में सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

The payment went through, but the order stays without a status: callback काम नहीं कर रहा। जाँचें कि आप जिस मोड (डेमो या लाइव) का उपयोग करते हैं, उसके Merchant Portal में Callback notification URL का URL सेट है और वह इंटरनेट से खुलता है। भुगतान के बाद ग्राहक स्टोर पर लौटता है तो भी ऑर्डर को स्थिति मिलती है। एक्सटेंशन पेज पर Log फ़ील्ड देखें: त्रुटियाँ हमेशा लिखी जाती हैं।

Callback answers Unknown payment, Unknown payment reference, Payment cannot be verified or Payment does not belong to this order: भुगतान इस स्टोर द्वारा या इस ऑर्डर के लिए नहीं बनाया गया था, या EveryPay का उत्तर उससे मेल नहीं खाता। कुछ नहीं बदला जाता।

Callback answers Missing or invalid payment_reference: अनुरोध में कोई वैध भुगतान संदर्भ नहीं था, जैसे URL को सीधे ब्राउज़र में खोलने पर।

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

Callback answers Payment status unavailable, Busy, please retry or Processing error, please retry: EveryPay API तक पहुँच नहीं हो सकी, उसी समय ऑर्डर किसी दूसरे अनुरोध से प्रोसेस हो रहा था, या प्रोसेसिंग विफल हुई। कारण लॉग में है। EveryPay callback दोबारा करता है।

The customer sees This payment method is not available right now: वर्तमान मोड के क्रेडेंशियल या प्रोसेसिंग खाता गायब है।

The customer sees EveryPay is temporarily unavailable or Unable to start the EveryPay payment: EveryPay ने क्रेडेंशियल अस्वीकार किए या उससे संपर्क नहीं हो सका। वर्तमान मोड का API उपयोगकर्ता नाम और API सीक्रेट जाँचें।

The customer sees This payment method does not support the order currency: ऑर्डर की मुद्रा प्रोसेसिंग खाते की मुद्रा से अलग है।

The customer stays on the Payment confirmation page: EveryPay ने अभी भुगतान पूरा नहीं किया है। ऑर्डर को स्थिति callback से मिलेगी, या जब EveryPay भुगतान की पुष्टि कर दे तब ग्राहक Check again पर क्लिक करेगा।

Order is in the review status: VibeFox EveryPay Payment टैब के EveryPay notes पढ़ें। राशि या मुद्रा मेल नहीं खाती थी, भुगतान आने से पहले ऑर्डर रद्द हो चुका था, या वह दूसरी भुगतान विधि का उपयोग करता है। Merchant Portal में भुगतान जाँचें और ऑर्डर को मैनुअल रूप से पूरा करें या रिफ़ंड करें।

डेवलपर्स के लिए: भुगतान बनाने से पहले एक्सटेंशन OpenCart इवेंट wc_evp_oneoff_request (भुगतान अनुरोध बदलें) और wc_evp_locale (भुगतान पेज की भाषा बदलें) ट्रिगर करता है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox EveryPay Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। OpenCart 4 पर एक्सटेंशन का इवेंट (चेकआउट संदेश) और उसका स्टार्टअप एक्शन, जो मेंटेनेंस मोड में callback और ग्राहक की वापसी को गुज़रने देता है, वे भी हटा दिए जाते हैं। यदि Advanced में Uninstall स्विच चालू है, तो बाकी गेटवे सेटिंग्स (शीर्षक, विवरण, टेस्ट मोड, क्रेडेंशियल, प्रोसेसिंग खाता, डीबग लॉग) और लॉग हटा दिए जाते हैं। यदि वह बंद है, तो उन्हें बाद में दोबारा इंस्टॉल करने के लिए रखा जाता है। ऑर्डरों का EveryPay भुगतान डेटा हमेशा रखा जाता है, इसलिए दोबारा इंस्टॉल के बाद पुराने ऑर्डरों के देर से आए callback अब भी काम करते हैं। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।

OpenCart 4 पर, एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox EveryPay Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

EveryPay अपने-अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन EveryPay से संबद्ध नहीं है और EveryPay द्वारा समर्थित नहीं है।