VibeFox ePayco for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होगा।
मुद्रा: कोलंबियाई पेसो (COP) या US डॉलर (USD)। अन्य मुद्राओं वाले कार्ट के लिए चेकआउट पर यह भुगतान तरीका छिपा रहता है।
ePayco खाता: आपको अपने ePayco खाते की चार कुंजियाँ चाहिए: P_CUST_ID_CLIENTE, P_KEY, PUBLIC_KEY और PRIVATE_KEY। ये ePayco डैशबोर्ड में Integrations, API keys के अंतर्गत मिलती हैं। वही कुंजियाँ टेस्ट मोड और लाइव मोड दोनों में काम करती हैं। ग्राहक जिन भुगतान तरीकों का उपयोग कर सकता है (कार्ड, PSE, कैश नेटवर्क, वॉलेट), वे आपके ePayco खाते में सक्षम तरीके हैं।
सार्वजनिक वेबसाइट: आपके स्टोर का कन्फ़र्मेशन URL इंटरनेट से पहुँच योग्य होना चाहिए, और फ़ायरवॉल या बेसिक ऑथेंटिकेशन से ब्लॉक नहीं होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफ़िस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox ePayco Payment ढूँढकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर के लाइसेंस ब्लॉक में License key के अंतर्गत अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. ePayco की चार कुंजियाँ दर्ज करें और चेकआउट प्रकार चुनें (देखें कॉन्फ़िगरेशन)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। Test Mode चालू रखकर ePayco टेस्ट कार्ड से एक भुगतान आज़माएँ, फिर Test Mode बंद कर दें।
इंस्टॉल होने पर मॉड्यूल दो ऑर्डर स्टेटस बनाता है: Awaiting ePayco payment और ePayco payment on hold। PrestaShop सभी मुद्राओं, देशों और ग्राहक समूहों के लिए एक नया भुगतान मॉड्यूल उपलब्ध कराता है। आप इसे Payment > Preferences में सीमित कर सकते हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox ePayco Payment > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। फ़ील्ड्स के ऊपर पेज आपको चेतावनी देता है जब चारों कुंजियाँ दर्ज नहीं होतीं (तब चेकआउट पर भुगतान तरीका छिपा रहता है) और जब आपके स्टोर की डिफ़ॉल्ट मुद्रा COP या USD नहीं होती, और टेस्ट मोड चालू होने पर Test mode is on: customers pay with ePayco test cards and no real money is charged. दिखाता है।
ePayco
Enable/Disable: Enable ePayco Payment भुगतान तरीके को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह नाम जो ग्राहक चेकआउट पर भुगतान तरीके के रूप में देखता है। ऑर्डर में भी भुगतान तरीके का यही नाम सहेजा जाता है। डिफ़ॉल्ट: ePayco।
Description: चेकआउट पर भुगतान तरीके के नीचे दिखाया जाने वाला पाठ। डिफ़ॉल्ट: Pay securely with ePayco.
ePayco खाते की कुंजियाँ
चारों कुंजियाँ ePayco डैशबोर्ड में Integrations, API keys के अंतर्गत मिलती हैं। P_CUST_ID_CLIENTE और P_KEY भुगतान पुष्टियों की जाँच करती हैं; PUBLIC_KEY और PRIVATE_KEY चेकआउट सत्र बनाती हैं। वही कुंजियाँ टेस्ट मोड और लाइव मोड में काम करती हैं।
Customer ID (P_CUST_ID_CLIENTE): आपकी ePayco ग्राहक ID (संख्यात्मक)।
Secret Key (P_KEY): ePayco भुगतान पुष्टियों के हस्ताक्षर की जाँच के लिए उपयोग होती है। इसे गोपनीय रखें।
Public Key (PUBLIC_KEY): आपकी ePayco सार्वजनिक API कुंजी।
Private Key (PRIVATE_KEY): आपकी ePayco निजी API कुंजी। इसे गोपनीय रखें।
सहेजी गई गोपनीय कुंजियाँ दोबारा नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। नया मान केवल तभी दर्ज करें जब आप उसे बदलना चाहते हों।
सहेजी गई गोपनीय कुंजियाँ हटाएँ: Secret Key (P_KEY) या Private Key (PRIVATE_KEY) पर टिक करें और हटाने के लिए Save पर क्लिक करें। खाली फ़ील्ड सहेजे गए मान को बनाए रखता है।
Test Mode: चेकआउट सत्र टेस्ट लेन-देन के रूप में बनाए जाते हैं। ग्राहक ePayco टेस्ट कार्ड से भुगतान करते हैं और कोई असली पैसा नहीं काटा जाता। टेस्ट लेन-देन लाइव मोड में बनाए गए ऑर्डर का भुगतान कभी नहीं करते। डिफ़ॉल्ट: बंद। चालू रहने पर ग्राहक भुगतान तरीके के नीचे और भुगतान पेज पर TEST MODE — use ePayco test cards, no real money is charged. देखते हैं।
चेकआउट
Checkout Type: ePayco चेकआउट कैसे खुलता है।
कन्फ़र्मेशन URL
कन्फ़र्मेशन URL आपके स्टोर को भुगतान का परिणाम बताता है। यह हर भुगतान के साथ अपने-आप ePayco को भेजा जाता है, इसलिए ePayco डैशबोर्ड में कुछ सेट करने की ज़रूरत नहीं है। यह सेक्शन URL दिखाता है। फ्रेंडली URL के साथ यह इस रूप में होता है: https://your-shop/module/wcp_epayco_payment/confirmation, और इसके आगे /en/ जैसा भाषा कोड भी हो सकता है। यह इंटरनेट से पहुँच योग्य होना चाहिए, और फ़ायरवॉल या बेसिक ऑथेंटिकेशन से ब्लॉक नहीं होना चाहिए। स्टोर मेंटेनेंस मोड में होने पर भी यह काम करता है, और आपके स्टोर की देश-सीमा से ब्लॉक नहीं होता।
हर पुष्टि पर आपके P_CUST_ID_CLIENTE और P_KEY से बना मान्य हस्ताक्षर होना चाहिए। मान्य हस्ताक्षर के बिना आई पुष्टियाँ अस्वीकार होती हैं और कुछ नहीं बदलतीं। पुष्टि के बिना, ग्राहक के भुगतान के बाद स्टोर पर लौटने पर ही ऑर्डर बनता है।
एडवांस्ड
Logging: API त्रुटियाँ और भुगतान पुष्टियाँ मॉड्यूल फ़ोल्डर में logs/epc_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। कुंजियाँ और ग्राहक डेटा दर्ज नहीं होते। डिफ़ॉल्ट: बंद। बंद होने पर भी त्रुटियाँ हमेशा दर्ज होती हैं।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।
Delete Data on Uninstall: चालू होने पर मॉड्यूल हटाने से मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। ऑर्डर के लिए सहेजा गया ePayco डेटा और मॉड्यूल के ऑर्डर स्टेटस हमेशा बने रहते हैं, ताकि मौजूदा ऑर्डर काम करते रहें। डिफ़ॉल्ट: बंद।
चेकआउट
भुगतान के चरण में ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से ePayco) और पुष्टि करता है। मॉड्यूल कार्ट के कुल योग के लिए कार्ट की मुद्रा में एक ePayco चेकआउट सत्र बनाता है, जिसमें कर, कार्ट नंबर और बिलिंग नाम, पता, ईमेल और फ़ोन शामिल होते हैं। ePayco पर भुगतान Cart # और कार्ट नंबर के रूप में दिखता है। चेकआउट की भाषा स्टोर की भाषा के अनुसार स्पेनिश या अंग्रेज़ी होती है। इस बिंदु पर अभी कोई ऑर्डर मौजूद नहीं होता।
इसके बाद ग्राहक को ePayco payment पेज दिखता है, जिस पर Thank you for your order. The secure ePayco checkout opens automatically; if it does not, click the button below. लिखा होता है। ePayco चेकआउट Checkout Type के आधार पर पॉपअप या रीडायरेक्ट के रूप में खुलता है। पेज पर Pay with ePayco बटन और Choose another payment method लिंक भी होता है। भुगतान बटन पर हर क्लिक पर एक नया ePayco सत्र बनता है।
ePayco चेकआउट में ग्राहक आपके ePayco खाते में सक्षम भुगतान तरीकों में से किसी एक से भुगतान करता है। इसके बाद ePayco आपके स्टोर को पुष्टि भेजता है और ग्राहक को वापस भेजता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब ePayco उसकी पुष्टि कर दे: हस्ताक्षरित पुष्टि से, या ग्राहक के लौटने पर सर्वर की ओर से ePayco से अनुरोध करके। केवल ग्राहक का लौटना कभी ऑर्डर का भुगतान नहीं करता। इसके बाद ऑर्डर बनता है और ग्राहक को मानक ऑर्डर पुष्टि पेज दिखता है।
लंबित भुगतान (जैसे PSE या कैश) के लिए ऑर्डर Awaiting ePayco payment में बनता है और पुष्टि पेज पर 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. कार्ट सुरक्षित रहता है और कोई ऑर्डर नहीं बनता।
यदि ePayco भुगतान शुरू नहीं कर पाता, तो ग्राहक चेकआउट पर ही रहता है और We could not connect to ePayco. Please try again in a moment or choose another payment method. जैसा छोटा संदेश देखता है। तकनीकी कारण लॉग में लिखा जाता है।
मॉड्यूल केवल एक बार के भुगतान लेता है। स्टोर से रिफ़ंड, सेव किए गए कार्ड, सब्सक्रिप्शन या स्प्लिट भुगतान नहीं होते, और मॉड्यूल लंबित लेन-देन के लिए ePayco से समय-समय पर पूछताछ नहीं करता: ऑर्डर ePayco की पुष्टि और ग्राहक की वापसी से अपडेट होते हैं।
ऑर्डर
ऑर्डर स्टेटस
No order yet: ग्राहक को ePayco पर भेजा गया है और उसने भुगतान नहीं किया है, ePayco ने अभी भुगतान की पुष्टि नहीं की है, या भुगतान अस्वीकृत हुआ है। केवल कार्ट मौजूद है।
Payment accepted: ePayco ने भुगतान स्वीकार किया। भुगतान ePayco संदर्भ (ref_payco) को लेन-देन ID के रूप में दर्ज होता है, और एक नोट में संदर्भ, स्थिति, राशि, भुगतान तरीका और स्वीकृति कोड दिखता है।
Awaiting ePayco payment: ePayco ने भुगतान को लंबित या रोका हुआ बताया है, जैसे PSE ट्रांसफ़र या कैश भुगतान। जब ePayco भुगतान को स्वीकार या अस्वीकार करता है, तो ऑर्डर अपने-आप बदल जाता है।
ePayco payment on hold: ePayco ने ऐसा भुगतान स्वीकार किया जिसकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती (उदाहरण के लिए, भुगतान शुरू होने के बाद कार्ट बदला गया), या ऑर्डर रद्द होने के बाद भुगतान स्वीकार किया। मुद्रा मेल खाने पर वास्तव में दी गई राशि ऑर्डर पर दर्ज होती है। शिप करने से पहले ePayco डैशबोर्ड में लेन-देन की जाँच करें।
Payment error: लंबित भुगतान अस्वीकृत, विफल, समाप्त या रद्द हो गया। नोट में ePayco द्वारा दिया गया कारण दिखता है। कार्ट के लिए नया स्वीकृत भुगतान अब भी ऑर्डर का भुगतान करता है। बाद में हुई विफलता कभी भुगतान किए गए ऑर्डर को नहीं बदलती।
Refunded: ePayco ने इस ऑर्डर का भुगतान रिवर्स कर दिया है।
यदि ePayco किसी पहले से भुगतान किए गए ऑर्डर के लिए कोई और स्वीकृत भुगतान बताता है, तो स्टेटस नहीं बदलता। एक नोट आपसे दोहरे शुल्क की जाँच करने और ज़रूरत हो तो ePayco में रिफ़ंड करने को कहता है। लाइव मोड में दिए गए ऑर्डर के लिए टेस्ट लेन-देन, और जो लेन-देन पहले से किसी दूसरे ऑर्डर का है, वे नोट के साथ अनदेखे किए जाते हैं।
ePayco भुगतान ब्लॉक
ऑर्डर पेज पर एक ePayco payment ब्लॉक दिखता है, जिसमें ePayco संदर्भ (ref_payco), लेन-देन ID, स्थिति, भुगतान तरीका, स्वीकृति कोड, लेन-देन की तारीख, टेस्ट भुगतानों के लिए Test mode बैज और ऑर्डर के ePayco notes होते हैं। ePayco payment on hold वाले ऑर्डर के लिए ब्लॉक शिप करने से पहले लेन-देन जाँचने की चेतावनी दिखाता है।
रिफ़ंड
स्टोर से रिफ़ंड समर्थित नहीं हैं। ePayco डैशबोर्ड में भुगतान रिफ़ंड करें, और ज़रूरत हो तो PrestaShop में ऑर्डर को मैन्युअली अपडेट करें। ePayco द्वारा बताया गया भुगतान लेन-देन का रिवर्सल ऑर्डर को Refunded पर सेट करता है।
लाइसेंस कुंजी
यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox ePayco Payment, Modules > Module Manager > VibeFox ePayco Payment > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन), और ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे Product: presta-payment-epayco वाली पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को ePayco नहीं दिखाया जाता। अगर फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। PrestaShop स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए भुगतान तरीका आपके लिए भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जो भुगतान पहले से शुरू हो चुके हैं, उनकी पुष्टि अब भी होती है।
जब लाइसेंस समाप्त होता है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron job ज़रूरी नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाते हैं।
समस्या निवारण
चेकआउट पर ePayco दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चारों कुंजियाँ दर्ज हैं और कार्ट की मुद्रा COP या USD है। कुंजियाँ छूटने पर सेटिंग्स पेज चेतावनी दिखाता है। Payment > Preferences में जाँचें कि मॉड्यूल कार्ट की मुद्रा, ग्राहक के देश और ग्राहक के समूह के लिए अनुमत है।
भुगतान हो गया, पर ऑर्डर नहीं बना: ePayco की पुष्टि आपके स्टोर तक नहीं पहुँच रही। जाँचें कि सेटिंग्स में दिखाया गया कन्फ़र्मेशन URL इंटरनेट से खुलता है और फ़ायरवॉल, सुरक्षा मॉड्यूल या बेसिक ऑथेंटिकेशन से ब्लॉक नहीं है। मॉड्यूल पेज पर Log फ़ील्ड देखें; हर पुष्टि देखने के लिए Logging चालू करें। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर बनता है।
पुष्टि का उत्तर Invalid signature है: Customer ID (P_CUST_ID_CLIENTE) या Secret Key (P_KEY) उस ePayco खाते से मेल नहीं खाते जिसने भुगतान लिया। दोनों को ePayco डैशबोर्ड से दोबारा कॉपी करें।
पुष्टि का उत्तर Gateway not configured है: P_CUST_ID_CLIENTE या P_KEY खाली है। उन्हें सेटिंग्स में दर्ज करें।
पुष्टि का उत्तर Order not found है: पुष्टि ऐसे कार्ट की ओर इशारा करती है जिसका इस स्टोर का कोई ePayco भुगतान नहीं है।
पुष्टि का उत्तर Busy, retry later है: ऑर्डर उसी समय किसी दूसरे अनुरोध से अपडेट हो रहा था, या ऑर्डर बन नहीं सका (उदाहरण के लिए, मॉड्यूल बंद है)। ePayco पुष्टि दोबारा भेजता है। कारण लॉग में है।
ग्राहक को We could not connect to ePayco दिखता है: ePayco ने PUBLIC_KEY और PRIVATE_KEY को अस्वीकार किया। लॉग में ePayco का उत्तर दिखता है। दोनों कुंजियाँ दोबारा कॉपी करें।
ग्राहक को ePayco could not start the payment दिखता है: ePayco ने चेकआउट सत्र नहीं बनाया। लॉग में ePayco की त्रुटि पढ़ें।
ePayco चेकआउट नहीं खुलता: ग्राहक को The ePayco checkout could not be loaded. Please reload the page or choose another payment method. दिखता है। भुगतान पेज पर ePayco चेकआउट स्क्रिप्ट लोड नहीं हो पाई। ग्राहक पेज रीलोड कर सकता है या Choose another payment method का उपयोग कर सकता है।
टेस्ट भुगतान से ऑर्डर का भुगतान नहीं हुआ: टेस्ट लेन-देन लाइव मोड में दिए गए ऑर्डर का भुगतान कभी नहीं करते। टेस्ट ऑर्डर Test Mode चालू रहने पर दें।
ऑर्डर ePayco payment on hold में है: ePayco payment ब्लॉक के नोट पढ़ें (देखें ऑर्डर स्टेटस) और शिप करने से पहले ePayco डैशबोर्ड में लेन-देन जाँचें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox ePayco Payment के बगल का मेन्यू खोलें और Uninstall चुनें। इस मॉड्यूल की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं। यदि Delete Data on Uninstall चालू है, तो मॉड्यूल की सेटिंग्स और लॉग हट जाते हैं। यदि बंद है, तो बाद में दोबारा इंस्टॉल करने के लिए सारी सेटिंग्स रहती हैं। ऑर्डर के लिए सहेजा गया ePayco डेटा और ऑर्डर स्टेटस Awaiting ePayco payment तथा ePayco payment on hold हमेशा रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट और लेन-देन ID बनाए रखते हैं।
ePayco उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल ePayco से संबद्ध नहीं है और ePayco द्वारा समर्थित नहीं है।