VibeFox ePayco for WooCommerce — सहायता

आवश्यकताएँ

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

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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

स्टोर की मुद्रा: कोलंबियाई पेसो (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. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_epayco_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

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

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

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

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

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > ePayco। फ़ील्ड्स के ऊपर पेज आपको चेतावनी देता है जब चारों कुंजियाँ दर्ज न हों (तब भुगतान तरीका चेकआउट पर छिपा रहता है), जब स्टोर की मुद्रा 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 कुंजी। इसे गोपनीय रखें।

Test Mode: Enable test mode चेकआउट सत्र को टेस्ट लेन-देन के रूप में बनाता है। ग्राहक ePayco टेस्ट कार्ड से भुगतान करते हैं और कोई वास्तविक राशि नहीं काटी जाती। टेस्ट लेन-देन लाइव मोड में बनाए गए ऑर्डर का भुगतान कभी नहीं करते। डिफ़ॉल्ट: बंद।

चेकआउट

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

पुष्टि URL

पुष्टि URL आपके स्टोर को भुगतान का परिणाम बताता है। यह हर भुगतान के साथ अपने-आप ePayco को भेजा जाता है, इसलिए ePayco डैशबोर्ड में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है। यह सेक्शन URL दिखाता है। यह कुछ ऐसा दिखता है: https://your-site/wc-api/epc_p/। यह इंटरनेट से पहुँचने योग्य होना चाहिए, और इसे मेंटेनेंस मोड, फ़ायरवॉल या बेसिक प्रमाणीकरण द्वारा अवरुद्ध नहीं होना चाहिए।

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

एडवांस्ड

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

Delete Data on Uninstall: Remove the gateway settings and logs when the plugin is deleted। प्लगइन को निष्क्रिय करने से कुछ भी नहीं मिटता। ऑर्डर पर सहेजा गया ePayco डेटा बना रहता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से ePayco) और ऑर्डर देता है। प्लगइन ऑर्डर की मुद्रा में ऑर्डर के कुल योग के लिए एक ePayco चेकआउट सत्र बनाता है, जिसमें ऑर्डर के कर, ऑर्डर नंबर और बिलिंग नाम, पता, ईमेल और फ़ोन शामिल होते हैं। चेकआउट की भाषा साइट की भाषा के अनुसार स्पेनिश या अंग्रेज़ी होती है। इसके बाद ग्राहक ऑर्डर भुगतान पेज पर पहुँचता है, जिस पर 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 लिंक भी होता है। टेस्ट मोड में पेज और चेकआउट पर TEST MODE — use ePayco test cards, no real money is charged. दिखता है।

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

यदि भुगतान की पुष्टि अभी नहीं हुई है, तो ऑर्डर प्राप्ति पेज पर We are waiting for ePayco to confirm your payment. This page does not need to stay open. दिखता है। लंबित भुगतान (जैसे PSE या कैश) के लिए यह Your ePayco payment is being confirmed. We will e-mail you as soon as it is approved. दिखाता है।

यदि भुगतान अस्वीकार हो गया, तो ग्राहक Pay for order पेज पर लौट आता है, जिस पर 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. कारण ऑर्डर नोट्स और लॉग में जोड़ा जाता है।

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

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

ऑर्डर

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

Pending payment: ग्राहक को ePayco पर भेजा गया था और उसने अभी भुगतान नहीं किया है, या ePayco ने अभी भुगतान की पुष्टि नहीं की है।

Processing: भुगतान स्वीकार हो गया (केवल वर्चुअल, डाउनलोड योग्य उत्पादों वाले ऑर्डर WooCommerce के डिफ़ॉल्ट के अनुसार पूर्ण हो जाते हैं)। ऑर्डर नोट में ePayco संदर्भ, स्थिति, राशि, भुगतान तरीका और अनुमोदन कोड दिखता है। ऑर्डर की ट्रांज़ैक्शन ID ePayco संदर्भ (ref_payco) है।

On hold, payment pending: ePayco ने भुगतान को लंबित या रोका हुआ बताया, उदाहरण के लिए PSE ट्रांसफ़र या कैश भुगतान। ePayco के पुष्टि या अस्वीकार करने पर ऑर्डर अपने-आप बदल जाता है।

On hold, amount/currency mismatch: ePayco ने ऐसा भुगतान स्वीकार किया जिसकी राशि या मुद्रा ऑर्डर से अलग है। ePayco डैशबोर्ड में लेन-देन जाँचने से पहले शिप न करें।

On hold, payment for a cancelled order: ऑर्डर रद्द होने के बाद ePayco ने भुगतान स्वीकार किया। ऑर्डर बहाल करें या ePayco में भुगतान रिफ़ंड करें।

Failed: भुगतान अस्वीकार, विफल, समाप्त, छोड़ा गया, रद्द या एंटीफ़्रॉड द्वारा रोका गया। नोट में ePayco का कारण दिखता है। ग्राहक फिर से कोशिश कर सकता है। भुगतान के बाद की कोई देर से आई विफलता कभी भी भुगतान किए गए ऑर्डर को नहीं बदलती।

Refunded: ePayco ने इस ऑर्डर का भुगतान वापस कर दिया।

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

रिफ़ंड: WooCommerce से रिफ़ंड समर्थित नहीं हैं। ePayco डैशबोर्ड में भुगतान रिफ़ंड करें, फिर Refund manually के साथ WooCommerce में रिफ़ंड दर्ज करें।

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

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

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

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

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

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

ePayco चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, चारों कुंजियाँ दर्ज हैं और स्टोर की मुद्रा COP या USD है। Pay for order पेज पर ऑर्डर की मुद्रा जाँची जाती है। सेटिंग्स पेज पर कुछ छूटने पर चेतावनी दिखती है।

भुगतान हो गया, लेकिन ऑर्डर Pending payment पर रहता है: ePayco की पुष्टि आपके स्टोर तक नहीं पहुँच रही। जाँचें कि सेटिंग्स में दिखाया गया पुष्टि URL इंटरनेट से खुलता है और उसे मेंटेनेंस मोड, फ़ायरवॉल, सुरक्षा प्लगइन या बेसिक प्रमाणीकरण अवरुद्ध नहीं कर रहा। Logging चालू करें और WooCommerce > Status > Logs में स्रोत wcp_epayco_payment देखें। ग्राहक के भुगतान के बाद स्टोर पर लौटने पर भी ऑर्डर अपडेट होता है।

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

पुष्टि Gateway not configured बताती है: P_CUST_ID_CLIENTE या P_KEY खाली है। सेटिंग्स में दर्ज करें।

पुष्टि 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 चालू होने पर दें।

ऑर्डर On hold पर है: ऑर्डर नोट पढ़ें। ePayco ने भुगतान को लंबित बताया, स्वीकृत राशि या मुद्रा ऑर्डर से अलग थी, या भुगतान ऑर्डर रद्द होने के बाद आया। शिप करने से पहले ePayco डैशबोर्ड में लेन-देन जाँचें।

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

डेवलपर्स के लिए, प्लगइन दस्तावेज़ में ये फ़िल्टर सूचीबद्ध हैं: epc_p_supported_currencies (वे मुद्राएँ जिनके लिए भुगतान तरीका दिया जाता है), epc_p_session_payload (ePayco को भेजा गया डेटा) और epc_p_icon (चेकआउट आइकन)।

अनइंस्टॉल

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

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