VibeFox ePayco for OpenCart — सहायता

आवश्यकताएँ

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

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

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

ePayco खाता: आपको अपने ePayco खाते की चार कुंजियाँ चाहिए: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY और PRIVATE_KEY। ये ePayco डैशबोर्ड में Integrations, API keys के अंतर्गत मिलती हैं। वही कुंजियाँ टेस्ट मोड और लाइव मोड दोनों में काम करती हैं। ग्राहक जिन भुगतान विधियों (कार्ड, PSE, नकद नेटवर्क, वॉलेट) का उपयोग कर सकता है, वे वही हैं जो आपके ePayco खाते में सक्षम हैं।

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. ePayco की चार कुंजियाँ दर्ज करें और चेकआउट प्रकार चुनें (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू होने की स्थिति में ePayco टेस्ट कार्ड से एक भुगतान आज़माएँ, फिर Test Mode बंद करें।

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड बंद के साथ शुरू होता है। पुष्टि URL हर भुगतान के साथ ePayco को भेजा जाता है, इसलिए ePayco डैशबोर्ड में कुछ भी सेट करने की ज़रूरत नहीं है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox ePayco Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सेव करता है। सेटिंग्स के ऊपर पेज बताता है कि ऑर्डर को तभी स्थिति मिलती है जब ePayco लेन-देन की पुष्टि कर दे। यदि चारों कुंजियाँ दर्ज नहीं हैं (तब चेकआउट पर भुगतान विधि छिपा दी जाती है) या आपके स्टोर की डिफ़ॉल्ट मुद्रा COP या USD नहीं है, तो यह चेतावनी देता है, और टेस्ट मोड चालू होने पर Test mode is on: customers pay with ePayco test cards and no real money is charged. दिखाता है। एक्सटेंशन को संशोधित करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, लेकिन उन्हें सेव नहीं कर सकता।

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

ePayco

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

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

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with ePayco.

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

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

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

ePayco खाता कुंजियाँ

चारों कुंजियाँ ePayco डैशबोर्ड में Integrations, API keys के अंतर्गत खोजें (इस सेक्शन में डैशबोर्ड का लिंक है)। P_CUST_ID_CLIENTE और P_KEY भुगतान पुष्टियों को सत्यापित करती हैं; PUBLIC_KEY और PRIVATE_KEY चेकआउट सत्र बनाती हैं। वही कुंजियाँ टेस्ट मोड और लाइव मोड दोनों में काम करती हैं।

Customer ID (P_CUST_ID_CLIENTE): आपकी ePayco ग्राहक आईडी (संख्यात्मक)।

Secret Key (P_KEY): ePayco भुगतान पुष्टियों के हस्ताक्षर को सत्यापित करने के लिए उपयोग की जाती है। इसे गुप्त रखें।

Public Key (PUBLIC_KEY): आपकी ePayco सार्वजनिक API कुंजी।

Private Key (PRIVATE_KEY): आपकी ePayco निजी API कुंजी। इसे गुप्त रखें।

सेव की गई Secret Key (P_KEY) और Private Key (PRIVATE_KEY) दोबारा कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल तभी नया मान दर्ज करें जब उसे बदलना हो। सेव की गई कुंजी हटाने के लिए फ़ील्ड के नीचे Clear saved secret on save पर निशान लगाएँ और Save पर क्लिक करें।

Test Mode: चेकआउट सत्र टेस्ट लेन-देन के रूप में बनाए जाते हैं। ग्राहक ePayco टेस्ट कार्ड से भुगतान करते हैं और कोई वास्तविक धनराशि नहीं काटी जाती। टेस्ट लेन-देन लाइव मोड में बनाए गए ऑर्डरों का भुगतान कभी नहीं करते। डिफ़ॉल्ट: बंद। चालू रहने पर ग्राहक Confirm Order चरण और भुगतान पेज पर TEST MODE — use ePayco test cards, no real money is charged. देखते हैं।

चेकआउट

Checkout Type: ePayco चेकआउट कैसे खुलता है।

पुष्टि URL

पुष्टि URL आपके स्टोर को भुगतान का परिणाम बताता है। यह हर भुगतान के साथ अपने-आप ePayco को भेजा जाता है, इसलिए ePayco डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की आवश्यकता नहीं है। यह सेक्शन URL दिखाता है। OpenCart 3 पर यह https://your-store/index.php?route=extension/payment/wcp_epayco_payment/confirmation जैसा दिखता है, और OpenCart 4 पर https://your-store/index.php?route=extension/wcp_epayco_payment/payment/wcp_epayco_payment.confirmation जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। इसे इंटरनेट से पहुँच योग्य होना चाहिए, और इसे फ़ायरवॉल या बेसिक ऑथेंटिकेशन द्वारा अवरुद्ध नहीं किया जाना चाहिए। स्टोर मेंटेनेंस मोड में होने पर भी यह काम करता है, क्योंकि OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को जाने देता है, और OpenCart 4 पर एक्सटेंशन इसके लिए एक स्टार्टअप एक्शन जोड़ता है।

हर पुष्टि में आपके P_CUST_ID_CLIENTE और P_KEY से बना वैध हस्ताक्षर होना चाहिए। बिना वैध हस्ताक्षर वाली पुष्टियाँ अस्वीकार कर दी जाती हैं और कुछ नहीं बदलतीं। पुष्टि के बिना, ऑर्डर को तभी स्थिति मिलती है जब ग्राहक भुगतान के बाद स्टोर में लौटता है।

ऑर्डर

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

Order Status After Payment: ePayco ने भुगतान स्वीकृत कर दिया है, और राशि व मुद्रा ऑर्डर से मेल खाती हैं। डिफ़ॉल्ट: Processing.

Awaiting Payment Status: ePayco ने भुगतान को लंबित या रोका हुआ (PSE ट्रांसफ़र, नकद नेटवर्क) बताया है। जब ePayco इसे स्वीकृत या अस्वीकृत करता है, तो ऑर्डर अपने-आप बदल जाता है। डिफ़ॉल्ट: Pending.

On Hold (Review) Status: ePayco ने ऐसा भुगतान स्वीकृत किया है जिसकी राशि या मुद्रा ऑर्डर से भिन्न है, या ऑर्डर को कोई दूसरी स्थिति (उदाहरण के लिए Canceled) मिलने के बाद उसे स्वीकृत किया है। एक नोट इसका कारण बताता है। ePayco डैशबोर्ड में लेन-देन जाँचने से पहले शिप न करें। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थिति बना सकते हैं और यहाँ चुन सकते हैं।

Payment Failed Status: लंबित भुगतान अस्वीकृत, विफल, समाप्त या रद्द हो गया। नया स्वीकृत भुगतान फिर भी ऑर्डर का भुगतान करता है। डिफ़ॉल्ट: Failed.

Reversed Status: ePayco ने ऑर्डर का भुगतान वापस (reverse) कर दिया है। डिफ़ॉल्ट: Refunded.

उन्नत

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

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

Delete Data on Uninstall: चालू होने पर एक्सटेंशन हटाने पर एक्सटेंशन सेटिंग्स और लॉग हट जाते हैं। ऑर्डर के लिए सेव किया गया ePayco डेटा हमेशा रहता है। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से ePayco)। Confirm Order चरण पर ग्राहक को आपका विवरण और After confirming the order you pay securely in the ePayco checkout (cards, PSE, cash, wallets). का नोट दिखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। OpenCart 4 पर ग्राहक भुगतान विधि ब्लॉक के Choose बटन से, Payment method options विंडो में भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन ऑर्डर मुद्रा में ऑर्डर कुल राशि के लिए एक ePayco चेकआउट सत्र बनाता है, जिसमें कर, ऑर्डर नंबर तथा बिलिंग नाम, पता, ईमेल और फ़ोन शामिल होते हैं। ePayco में भुगतान Order # और ऑर्डर नंबर के रूप में दिखता है। चेकआउट की भाषा ग्राहक के स्टोर भाषा के अनुसार स्पेनिश या अंग्रेज़ी होती है।

इसके बाद ग्राहक को Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. वाला ePayco payment पेज दिखता है। ePayco चेकआउट Checkout Type के आधार पर पॉपअप या रीडायरेक्ट के रूप में खुलता है। पेज पर Pay with ePayco बटन और Choose another payment method लिंक भी होता है। हर नए Confirm Order पर एक नया ePayco सत्र बनता है (OpenCart 3 हर बार जब Confirm Order चरण दिखाया जाता है तब एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए नया प्रयास वही ऑर्डर भुगतान करता है)। यदि उसी कार्ट का पिछला ऑर्डर पहले ही भुगतान हो चुका है या ePayco की प्रतीक्षा कर रहा है, तो ग्राहक को ऑर्डर सफलता पेज पर भेजा जाता है और उससे दोबारा शुल्क नहीं लिया जाता।

ePayco चेकआउट में ग्राहक आपके ePayco खाते में सक्षम विधियों में से किसी एक से भुगतान करता है। इसके बाद ePayco आपके स्टोर को पुष्टि भेजता है और ग्राहक को वापस भेजता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब ePayco उसकी पुष्टि कर दे: हस्ताक्षरित पुष्टि से, या ग्राहक के लौटने पर सर्वर की ओर से ePayco को किए गए अनुरोध से। केवल ग्राहक का लौटना कभी ऑर्डर का भुगतान नहीं करता। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है।

लंबित भुगतान (उदाहरण के लिए PSE या नकद) के लिए ऑर्डर को Awaiting Payment Status मिलती है और सफलता पेज Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. दिखाता है। यदि ग्राहक के लौटने तक लंबित भुगतान पहले ही अस्वीकृत हो चुका है या समाप्त हो चुका है, तो पेज Your ePayco payment was not completed. Please contact us about this order. दिखाता है। यदि ग्राहक के लौटने तक ePayco ने भुगतान की पुष्टि नहीं की है, तो एक Payment confirmation पेज We are waiting for ePayco to confirm your payment. This page does not need to stay open. और Check again बटन दिखाता है।

यदि भुगतान अस्वीकृत हुआ, तो ग्राहक Your ePayco payment was declined or could not be completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। यदि ग्राहक बिना भुगतान किए लौटता है, तो संदेश The ePayco payment was not completed. If you already paid, the order will be updated as soon as ePayco confirms it; otherwise you can try again. होता है। कार्ट सुरक्षित रहता है और ऑर्डर बिना स्थिति के रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं।

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

यदि ePayco भुगतान शुरू नहीं कर पाता, तो ग्राहक बटन के ऊपर एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, उदाहरण के लिए We could not connect to ePayco. Please try again in a moment or choose another payment method. तकनीकी कारण लॉग में लिखा जाता है।

यह एक्सटेंशन केवल एक-बार के भुगतान स्वीकार करता है। इसमें स्टोर से रिफ़ंड, सहेजे गए कार्ड, सब्सक्रिप्शन या विभाजित भुगतान नहीं हैं, और यह लंबित लेन-देन के लिए ePayco से पूछताछ नहीं करता: ऑर्डर ePayco की पुष्टि और ग्राहक की वापसी से अपडेट होते हैं।

ऑर्डर

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

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

Order Status After Payment (default Processing): ePayco ने भुगतान स्वीकृत किया है। एक नोट ePayco संदर्भ, स्थिति, राशि, भुगतान विधि और स्वीकृति कोड दिखाता है।

Awaiting Payment Status (default Pending): ePayco ने भुगतान को लंबित या रोका हुआ बताया है, जैसे PSE ट्रांसफ़र या नकद भुगतान। जब ePayco इसे स्वीकृत करता है, तो ऑर्डर Order Status After Payment पर चला जाता है; जब यह अस्वीकृत, विफल, समाप्त या रद्द होता है, तो ऑर्डर Payment Failed Status पर चला जाता है। OpenCart इन बदलावों के बारे में ग्राहक को ईमेल भेजता है।

On Hold (Review) Status (default Pending): ePayco ने ऐसे भुगतान को स्वीकृत किया है जिसकी राशि या मुद्रा ऑर्डर से भिन्न है, या आपके ऑर्डर को कोई दूसरी स्थिति (उदाहरण के लिए Canceled) देने के बाद भुगतान स्वीकृत किया है। नोट इसकी व्याख्या करता है। शिप करने से पहले ePayco डैशबोर्ड में लेन-देन जाँचें।

Payment Failed Status (default Failed): लंबित भुगतान पूरा नहीं हुआ। नोट में ePayco का कारण दिखता है। नया स्वीकृत भुगतान फिर भी ऑर्डर का भुगतान करता है। देर से आई विफलता कभी भी भुगतान किए गए ऑर्डर को नहीं बदलती।

Reversed Status (default Refunded): ePayco ने वह भुगतान वापस कर दिया है जिससे यह ऑर्डर भुगतान हुआ था।

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

VibeFox ePayco Payment टैब

Sales > Orders में ePayco से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox ePayco Payment टैब ऑर्डर का ePayco reference (ref_payco), Transaction ID, State, Payment method, Approval code, Transaction date, Mode (टेस्ट भुगतानों के लिए Test mode लेबल के साथ), Attempt status और ePayco notes दिखाता है। समीक्षा (review) में रखे गए ऑर्डर के लिए टैब शिप करने से पहले लेन-देन जाँचने की चेतावनी दिखाता है। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखाया जाता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

स्टोर से रिफ़ंड समर्थित नहीं हैं। भुगतान को ePayco डैशबोर्ड में रिफ़ंड करें, फिर ज़रूरत हो तो OpenCart में ऑर्डर को मैन्युअल रूप से अपडेट करें। ePayco द्वारा बताए गए भुगतान लेन-देन का रिवर्सल ऑर्डर को Reversed Status पर सेट करता है। Sales > Returns में उत्पाद वापसी ePayco के माध्यम से पैसे वापस नहीं भेजती।

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

यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक License — VibeFox ePayco Payment, Extensions > Extensions > Payments > VibeFox ePayco Payment > Edit पर पहला ब्लॉक है, जो सेटिंग्स के ऊपर होता है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) दिखाता है, साथ ही ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-epayco वाली पंक्ति और 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 खाते में स्लॉट खाली करें।

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

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

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

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

The payment went through, but the order stays without a status: ePayco की पुष्टि आपके स्टोर तक नहीं पहुँच रही। जाँचें कि सेटिंग्स में दिखाया गया पुष्टि URL इंटरनेट से खुलता है और फ़ायरवॉल, सुरक्षा एक्सटेंशन या बेसिक ऑथेंटिकेशन द्वारा अवरुद्ध नहीं है। एक्सटेंशन पेज पर Log फ़ील्ड देखें; हर पुष्टि देखने के लिए Logging चालू करें। ग्राहक के भुगतान के बाद स्टोर में लौटने पर भी ऑर्डर को स्थिति मिलती है।

Confirmation answers Invalid signature: Customer ID (P_CUST_ID_CLIENTE) या Secret Key (P_KEY) उस ePayco खाते से मेल नहीं खाती जिसने भुगतान लिया। दोनों को ePayco डैशबोर्ड से दोबारा कॉपी करें।

Confirmation answers Gateway not configured: P_CUST_ID_CLIENTE या P_KEY खाली है। उन्हें सेटिंग्स में दर्ज करें।

Confirmation answers Order not found: पुष्टि ऐसे ऑर्डर की ओर इंगित करती है जिसका इस स्टोर का कोई ePayco भुगतान नहीं है।

Confirmation answers Busy, retry later: उसी समय कोई दूसरा अनुरोध ऑर्डर को अपडेट कर रहा था। ePayco पुष्टि दोबारा भेजता है। कारण लॉग में है।

The customer sees We could not connect to ePayco: ePayco ने PUBLIC_KEY और PRIVATE_KEY अस्वीकार कर दिए। लॉग में ePayco का उत्तर दिखता है। दोनों कुंजियाँ दोबारा कॉपी करें।

The customer sees ePayco could not start the payment: ePayco ने चेकआउट सत्र नहीं बनाया। लॉग में ePayco त्रुटि पढ़ें।

The customer sees This payment method is not available right now: चेकआउट सत्र अब ऑर्डर से मेल नहीं खाता, इस बीच भुगतान विधि बंद हो गई या कुंजियाँ हटा दी गईं। ग्राहक चेकआउट को फिर से लोड करता है।

The ePayco checkout does not open: ग्राहक को The ePayco checkout could not be loaded. Please reload the page or choose another payment method. दिखता है। ePayco चेकआउट स्क्रिप्ट भुगतान पेज पर लोड नहीं हो सकी। ग्राहक पेज रीलोड कर सकता है या Choose another payment method का उपयोग कर सकता है।

A test payment did not pay the order: टेस्ट लेन-देन लाइव मोड में दिए गए ऑर्डर का भुगतान कभी नहीं करते। टेस्ट ऑर्डर Test Mode चालू होने पर दें।

Order is in the review status after payment: VibeFox ePayco Payment टैब के नोट पढ़ें (देखें ऑर्डर स्थितियाँ) और शिप करने से पहले ePayco डैशबोर्ड में लेन-देन जाँचें।

अनइंस्टॉल

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

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

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