VibeFox Wompi for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या बाद का संस्करण।
मुद्रा: कोलंबियाई पेसो (COP)। Wompi Colombia COP में शुल्क लेता है। यदि आपके स्टोर में COP अभी नहीं है, तो System > Localisation > Currencies में COP जोड़ें; भुगतान विधि केवल तभी दी जाती है जब ग्राहक COP में चेकआउट करे। यदि स्टोर की डिफ़ॉल्ट मुद्रा COP नहीं है, तो सेटिंग्स पेज चेतावनी देता है।
Wompi खाता: एक Wompi Colombia मर्चेंट खाता। हर वातावरण (sandbox और production) में चार कुंजियाँ होती हैं: public key, private key, events secret और integrity secret। ये आपको Wompi मर्चेंट डैशबोर्ड (comercios.wompi.co) के developers सेक्शन में मिलेंगी। Wompi El Salvador और Panama अलग APIs का उपयोग करते हैं और समर्थित नहीं हैं।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज wcp_wompi_payment-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज wcp_wompi_payment.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_wompi_payment-oc3-(version).ocmod.zip चुनें। इस एक्सटेंशन में कोई OCMOD बदलाव नहीं है, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। इंस्टॉलर के बजाय आप इस पैकेज के upload फ़ोल्डर की सामग्री को अपने स्टोर के root फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Wompi Payment ढूँढें और Install (हरा + बटन) पर क्लिक करें। आपके एडमिन उपयोगकर्ता के पास भुगतान एक्सटेंशन सूची बदलने का अधिकार होना चाहिए।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें। पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. Wompi मर्चेंट डैशबोर्ड से sandbox और production की कुंजियाँ चिपकाएँ और Wompi में Events URL सेट करें (देखें कॉन्फ़िगरेशन)।
5. Enable/Disable चालू करें और Save पर क्लिक करें। sandbox मोड में एक भुगतान का परीक्षण करें, फिर असली भुगतान स्वीकार करने के लिए Sandbox mode बंद करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल wcp_wompi_payment.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज इसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके आगे Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और प्रकार Payments चुनें। VibeFox Wompi Payment ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. लाइसेंस कुंजी, Wompi की कुंजियाँ और Events URL OpenCart 3 के चरण 3 से 5 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं। केवल Events URL अलग है (देखें Events URL)।
नया इंस्टॉल भुगतान विधि बंद और sandbox मोड चालू के साथ शुरू होता है।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Wompi Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर एक स्थिति बॉक्स वर्तमान मोड दिखाता है, SANDBOX या PRODUCTION। जब इस मोड की कोई कुंजी गायब होती है, तो बॉक्स उसे सूचीबद्ध करता है और बताता है कि इस वातावरण की सभी कुंजियाँ सेट होने तक भुगतान विधि चेकआउट पर छिपी रहेगी। जब सभी कुंजियाँ सेट हों, तो यह बताता है कि असली भुगतान लिए जाएँगे या नहीं। सेव करते समय, यदि कोई कुंजी अपने सेक्शन के प्रीफ़िक्स से शुरू नहीं होती, या यदि Wompi सक्षम है पर कुंजियाँ गायब होने के कारण चेकआउट पर छिपा है, तो एक्सटेंशन चेतावनी देता है। Title अधिकतम 128 अक्षरों का होना चाहिए (Title must be at most 128 characters.), Sort Order पूर्ण संख्या होनी चाहिए (Sort Order must be a whole number.), Total 0 या उससे अधिक की संख्या होनी चाहिए (Total: enter a number, 0 or greater.), और चुने गए geo zone तथा ऑर्डर स्थितियाँ मौजूद होनी चाहिए; अन्यथा कुछ भी सेव नहीं होता और पेज त्रुटि दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।
Wompi
Enable/Disable: Enable Wompi भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।
Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखते हैं। ऑर्डर में भी भुगतान विधि का यही नाम सेव होता है। डिफ़ॉल्ट: Wompi। अधिकतम 128 अक्षर। खाली छोड़ने पर एक्सटेंशन का नाम इस्तेमाल होता है।
Description: वह पाठ जो ग्राहक को Confirm Order चरण में, पुष्टि बटन के ऊपर दिखता है। डिफ़ॉल्ट: Pay securely with Wompi: cards, PSE, Nequi, Bancolombia and more.
Sort Order: चेकआउट पर भुगतान विधियों के बीच Wompi की स्थिति। खाली छोड़ें या पूर्ण संख्या लिखें; ऋणात्मक संख्याएँ मान्य हैं।
Geo Zone: Wompi केवल चुने गए geo zone के भुगतान पते के लिए दिखाएँ। डिफ़ॉल्ट: All zones। Geo zones System > Localisation > Geo Zones में सेट होते हैं। OpenCart 4 पर, जब चेकआउट में भुगतान पता न हो, तो शिपिंग पता जाँचा जाता है।
Total: चेकआउट का कुल योग, स्टोर की डिफ़ॉल्ट मुद्रा में, जिस तक पहुँचने पर ही Wompi दिखाया जाता है: 0 या उससे अधिक की संख्या। किसी भी कुल योग के लिए दिखाने हेतु खाली छोड़ें। Wompi स्वयं कम से कम COP 1,500 माँगता है।
Wompi खाता
Wompi मर्चेंट डैशबोर्ड (comercios.wompi.co) के developers सेक्शन से कुंजियाँ कॉपी करें। हर वातावरण की अपनी public key, private key, events secret और integrity secret होती है।
Sandbox mode: Wompi sandbox का उपयोग करता है (sandbox कुंजियाँ, कोई असली पैसा नहीं)। यह कुंजियों और Wompi API (sandbox.wompi.co या production.wompi.co), दोनों को बदल देता है। भुगतान प्रयास उसी वातावरण में रहते हैं जिसमें वे किए गए थे। डिफ़ॉल्ट: चालू। असली भुगतान स्वीकार करने के लिए इसे बंद करें। चालू होने पर ग्राहक Confirm Order चरण पर Sandbox mode: no real payment is made. देखते हैं।
Sandbox कुंजियाँ
Wompi sandbox की चार कुंजियाँ। ये pub_test_, prv_test_, test_events_ और test_integrity_ से शुरू होती हैं।
Public key: sandbox public key (pub_test_...)। यह Wompi Web Checkout पर आपके खाते की पहचान करती है।
Private key: sandbox private key (prv_test_...)। इसका उपयोग Wompi API से लेन-देन पढ़ने के लिए होता है।
Events secret: sandbox events secret (test_events_...)। यह Wompi इवेंट के हस्ताक्षर की जाँच करता है।
Integrity secret: sandbox integrity secret (test_integrity_...)। यह Web Checkout को भेजे गए भुगतान अनुरोध पर हस्ताक्षर करता है।
Production कुंजियाँ
Wompi production वातावरण की चार कुंजियाँ। ये pub_prod_, prv_prod_, prod_events_ और prod_integrity_ से शुरू होती हैं।
Public key: production public key (pub_prod_...)।
Private key: production private key (prv_prod_...)।
Events secret: production events secret (prod_events_...)।
Integrity secret: production integrity secret (prod_integrity_...)।
Public keys उनके फ़ील्ड में दिखती हैं। सेव की गई private keys और secrets फिर कभी नहीं दिखाई जातीं। फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान लिखें। सेव किया गया मान हटाने के लिए फ़ील्ड के नीचे Clear saved secret on save चिह्नित करें और Save पर क्लिक करें।
Events URL (webhook)
Wompi इवेंट आपके स्टोर को बताते हैं कि कोई लेन-देन बदल गया है। Wompi मर्चेंट डैशबोर्ड के developers सेक्शन में, इस सेक्शन में दिखाए गए Events URL को sandbox और production दोनों के लिए सेट करें। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_wompi_payment/webhook, OpenCart 4 पर इस तरह: https://your-store/index.php?route=extension/wcp_wompi_payment/payment/wcp_wompi_payment.webhook। URL को ठीक वैसा ही कॉपी करें जैसा सेटिंग्स दिखाती हैं।
एक्सटेंशन यह इवेंट उपयोग करता है:
अन्य इवेंट का उत्तर Ignored के साथ दिया जाता है। हर इवेंट उसके वातावरण (sandbox या production) की events secret से जाँचा जाता है। मान्य हस्ताक्षर के बिना webhooks अस्वीकार होते हैं। जाँच के बाद, उस वातावरण की private key से Wompi API से लेन-देन पढ़ा जाता है, और केवल वही डेटा उपयोग होता है। Events URL के बिना, ऑर्डर को स्थिति तभी मिलती है जब ग्राहक भुगतान के बाद स्टोर पर लौटे।
Orders
OpenCart Confirm Order चरण पर ऑर्डर बिना स्थिति के बनाता है (एक लापता ऑर्डर)। इसे स्थिति तभी मिलती है जब Wompi लेन-देन की रिपोर्ट करे। नीचे हर फ़ील्ड आपकी OpenCart ऑर्डर स्थितियों की सूची देता है।
Order Status After Payment: अपेक्षित COP राशि के लिए APPROVED लेन-देन। डिफ़ॉल्ट: Processing।
Awaiting Payment Status: PENDING लेन-देन, जैसे PSE, Nequi या पुष्टि की प्रतीक्षा में नकद भुगतान। Wompi के स्वीकार करने पर ऑर्डर को Order Status After Payment मिलता है। डिफ़ॉल्ट: Pending।
On Hold (Review) Status: Wompi ने ऑर्डर के कुल योग से अलग राशि या मुद्रा स्वीकृत की, या ऑर्डर रद्द होने के बाद भुगतान स्वीकृत किया। एक नोट इसे समझाता है; ऑर्डर भुगतान किया हुआ नहीं माना जाता। डिफ़ॉल्ट: Pending, क्योंकि OpenCart में On hold स्थिति नहीं है। आप System > Localisation > Order Statuses में अपनी स्थितियाँ बना सकते हैं और यहाँ चुन सकते हैं।
Failed Payment Status: नवीनतम भुगतान प्रयास का लंबित लेन-देन अस्वीकृत हुआ या त्रुटि के साथ समाप्त हुआ। डिफ़ॉल्ट: Failed।
Cancelled Order Status: नवीनतम भुगतान प्रयास का लंबित लेन-देन Wompi में void किया गया। इस स्थिति वाले ऑर्डर के लिए स्वीकृत भुगतान उसे भुगतान किया हुआ मानने के बजाय होल्ड पर रखता है। डिफ़ॉल्ट: Canceled।
उन्नत
Debug log: भुगतान और webhook गतिविधि को OpenCart के logs फ़ोल्डर (storage/logs, OpenCart 4 पर system/storage/logs) में wompi_p_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। यह विकल्प बंद होने पर भी त्रुटियाँ और चेतावनियाँ हमेशा दर्ज होती हैं। कुंजियाँ, secrets और ग्राहक डेटा कभी लॉग नहीं होते। डिफ़ॉल्ट: बंद।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से उसकी सेटिंग्स और लॉग हट जाते हैं। ऑर्डर और Wompi भुगतान प्रयास हमेशा रखे जाते हैं। डिफ़ॉल्ट: बंद।
Import / Export
Export: Download JSON सेटिंग्स को JSON फ़ाइल में सेव करता है। Private keys और secrets एक्सपोर्ट नहीं होते।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें। सेव की गई private keys और secrets बनी रहती हैं।
चेकआउट
Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Wompi)। Confirm Order चरण पर ग्राहक आपका विवरण देखता है। OpenCart इस चरण पर ऑर्डर बनाता है, अभी भी बिना स्थिति के। जब ग्राहक Confirm Order पर क्लिक करता है, तो एक्सटेंशन अपने संदर्भ (OC-, ऑर्डर नंबर और एक टाइमस्टैम्प) के साथ एक भुगतान प्रयास बनाता है, उसे integrity secret से हस्ताक्षरित करता है, और ग्राहक को ऑर्डर का कुल योग COP में दिखाते हुए Wompi Web Checkout पर भेजता है। ग्राहक का ईमेल और भुगतान पते का नाम Wompi को भेजे जाते हैं। OpenCart 4 पर ग्राहक भुगतान विधि भुगतान विधि के ब्लॉक के Choose बटन से चुनता है, विंडो Payment method options में, और पेज के नीचे Confirm Order पर क्लिक करता है। जब चेकआउट में भुगतान पता न हो, तो नाम ऑर्डर या शिपिंग पते से लिया जाता है।
Wompi के पेज पर ग्राहक आपके Wompi खाते में सक्षम किसी भी भुगतान विधि से भुगतान करता है। फिर Wompi ग्राहक को आपके स्टोर पर वापस भेजता है। ऑर्डर तभी भुगतान किया हुआ माना जाता है जब Wompi पुष्टि करे: हस्ताक्षरित इवेंट से, या ग्राहक के लौटने पर Wompi API को सर्वर-साइड अनुरोध से। वापसी पते में दिए गए लेन-देन नंबर पर भरोसा नहीं किया जाता, और केवल उस प्रयास के वातावरण में उस ऑर्डर के लिए बनाए गए लेन-देन स्वीकार होते हैं। पेज रीलोड होने पर लेन-देन की जाँच अधिकतम हर 20 सेकंड में फिर से होती है।
लेन-देन स्वीकृत होने पर ऑर्डर को OpenCart के सामान्य तरीके से स्थिति मिलती है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। लंबित भुगतान (जैसे PSE, Nequi या नकद भुगतान) के लिए पेज Your Wompi payment is pending confirmation (for example PSE, Nequi or a cash payment). We will process the order as soon as Wompi confirms the payment. दिखाता है। होल्ड पर रखे ऑर्डर के लिए We have received your Wompi payment and are reviewing it. We will contact you if anything is needed. दिखाता है। लंबित भुगतान बाद में अस्वीकृत होने पर पेज Your Wompi payment was not approved. Please contact us. दिखाता है। रद्द होने पर Your Wompi payment was voided and this order was cancelled. Please contact us. दिखाता है।
यदि ग्राहक के लौटने तक Wompi ने लेन-देन की पुष्टि नहीं की है, तो एक पेज We are waiting for Wompi to confirm your payment. You will receive an e-mail as soon as it is confirmed. दिखाता है, साथ में Check again और Back to checkout बटन। Wompi इवेंट आते ही ऑर्डर की स्थिति सेट कर देता है।
यदि भुगतान अस्वीकृत होता है, तो ऑर्डर बिना स्थिति के रहता है और कार्ट सुरक्षित रहता है। ग्राहक Wompi द्वारा बताए गए कारण के साथ Your Wompi payment was not approved (...). You can try again or choose another payment method. देखकर चेकआउट पर लौटता है। रद्द किया गया भुगतान Your Wompi payment was voided. You can try again or choose another payment method. देता है। यदि ग्राहक बिना भुगतान किए Web Checkout छोड़ देता है, तो संदेश Your Wompi payment was not completed. You can try again or choose another payment method. होता है। हर नए प्रयास को नया संदर्भ मिलता है। OpenCart हर बार Confirm Order चरण दिखने पर नया ऑर्डर बनाता है, पर एक कार्ट का भुगतान केवल एक बार होता है: कार्ट का कोई ऑर्डर एक बार भुगतान किया हुआ, भुगतान की प्रतीक्षा में या होल्ड पर हो जाए, तो ग्राहक फिर से भुगतान करने के बजाय सफलता पेज पर भेजा जाता है।
OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और हर बार Confirm Order चरण दिखाए जाने पर उसे अपडेट करता है: अस्वीकृत या अधूरे भुगतान के बाद ग्राहक नए प्रयास से उसी ऑर्डर का भुगतान करता है। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया (उदाहरण के लिए उसका लंबित PSE या Nequi भुगतान बाद में अस्वीकृत या रद्द हुआ, या आपने उसे रद्द किया), या भुगतान शुरू होने के बाद कार्ट बदली गई, तो ऑर्डर चेकआउट से बाहर चला जाता है और ग्राहक को Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. दिखता है। अगला Confirm Order कार्ट का भुगतान नए ऑर्डर से करता है।
भुगतान विधि केवल तभी दिखती है जब लाइसेंस सक्रिय हो, वर्तमान मोड की चारों कुंजियाँ सेट हों, ग्राहक COP में चेकआउट करे और कुल योग कम से कम COP 1,500 हो। यदि भुगतान शुरू नहीं हो सकता, तो ग्राहक Confirm Order चरण पर रहता है और बटन के ऊपर एक छोटा संदेश दिखता है:
स्टोर maintenance मोड में होने पर भी Events URL काम करता है, क्योंकि OpenCart भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है। OpenCart 4 पर एक्सटेंशन की startup action Events URL और ग्राहक की वापसी को आगे जाने देती है।
एक्सटेंशन OpenCart से रिफ़ंड नहीं करता। आपकी साइट पर सेव किए गए कार्ड, सब्सक्रिप्शन या कार्ड फ़ील्ड नहीं हैं: सभी भुगतान डेटा Wompi पर दर्ज होता है।
ऑर्डर
ऑर्डर स्थितियाँ
कोई स्थिति नहीं (लापता ऑर्डर): ग्राहक Wompi पर भेजा गया और उसने भुगतान नहीं किया, भुगतान अस्वीकृत हुआ, या Wompi ने लेन-देन की रिपोर्ट अभी तक नहीं की। Sales > Orders में ऐसे ऑर्डर केवल तब दिखते हैं जब Order Status फ़िल्टर Missing Orders पर सेट हो।
Awaiting Payment Status (डिफ़ॉल्ट Pending): Wompi लेन-देन को लंबित बताता है, जैसे PSE, Nequi या पुष्टि की प्रतीक्षा में नकद भुगतान। Wompi के स्वीकार या अस्वीकार करने तक ऑर्डर प्रतीक्षा करता है। स्वीकार होने पर ऑर्डर Order Status After Payment पर चला जाता है।
Order Status After Payment (डिफ़ॉल्ट Processing): ऑर्डर की COP राशि के लिए लेन-देन स्वीकृत हुआ। एक नोट लेन-देन, भुगतान विधि के प्रकार (जैसे CARD, PSE या NEQUI), संदर्भ, राशि और वातावरण दिखाता है।
On Hold (Review) Status (डिफ़ॉल्ट Pending): Wompi ने ऑर्डर के कुल योग से अलग राशि या मुद्रा स्वीकृत की (जैसे भुगतान शुरू होने के बाद कार्ट बदला गया), या ऑर्डर रद्द होने के बाद भुगतान स्वीकृत हुआ। ऑर्डर भुगतान किया हुआ नहीं माना जाता। नोट इसे समझाता है। Wompi डैशबोर्ड में भुगतान जाँचें और फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Failed Payment Status (डिफ़ॉल्ट Failed): नवीनतम भुगतान प्रयास का लंबित लेन-देन अस्वीकृत हुआ या त्रुटि के साथ समाप्त हुआ। Wompi का संदेश नोट में जोड़ा जाता है। पुराने प्रयासों के परिणाम ऑर्डर नहीं बदलते।
Cancelled Order Status (डिफ़ॉल्ट Canceled): नवीनतम भुगतान प्रयास का लंबित लेन-देन Wompi में void किया गया।
जब पहले से स्थिति वाला ऑर्डर बदलता है (जैसे प्रतीक्षा से भुगतान किया हुआ या विफल), तो OpenCart ग्राहक को सूचित करता है। यदि पहले से भुगतान किए गए ऑर्डर के लिए, या पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर के लिए, दूसरा स्वीकृत भुगतान आता है, तो ऑर्डर नहीं बदलता। एक नोट आपसे Wompi डैशबोर्ड में डुप्लिकेट भुगतान रिफ़ंड करने को कहता है। यदि भुगतान लेन-देन Wompi में void हो जाता है, तो एक नोट ऑर्डर की समीक्षा करने को कहता है। दोहराए गए इवेंट और वापसी कभी भी नोट या भुगतान दोहराते नहीं।
नोट ऑर्डर के History की वे प्रविष्टियाँ हैं जो ग्राहक को दिखाई नहीं देतीं।
VibeFox Wompi Payment टैब
Sales > Orders में Wompi से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Wompi Payment टैब Reference, Transaction ID, Status (Wompi स्थिति के साथ), Requested राशि, Transaction amount, Payment method, Wompi message, sandbox भुगतानों के लिए SANDBOX लेबल, कार्ट के कई होने पर उसके Payment attempts, और ऑर्डर के Wompi notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनके पास एक्सटेंशन की पहुँच है।
रिफ़ंड
रिफ़ंड OpenCart से नहीं भेजे जाते। Wompi मर्चेंट डैशबोर्ड में भुगतान रिफ़ंड या void करें, फिर रिफ़ंड को OpenCart में मैन्युअली दर्ज करें। Wompi में किया गया भुगतान लेन-देन का void ऑर्डर में एक नोट के रूप में जुड़ता है। Sales > Returns में उत्पाद वापसी Wompi के ज़रिए पैसे वापस नहीं भेजती।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net की VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Wompi Payment एक्सटेंशन पेज Extensions > Extensions > Payments > VibeFox Wompi Payment > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके, स्थिति (जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन) दिखाता है, साथ ही ये बटन: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-payment-wompi की पंक्ति और 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Wompi चेकआउट पर ग्राहकों को नहीं दिखाया जाता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को This payment method is not available. Please choose another one. दिखता है। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन में लॉग इन है, उसे स्टोर में भुगतान विधि (unlicensed — visible to admins only) चिह्न के साथ अब भी दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर को एडमिन लॉगिन दिखाई नहीं देता, इसलिए सक्रिय कुंजी के बिना भुगतान विधि सभी से छिपी रहती है। एक बार Edit पेज खोलने के बाद एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करें, तो वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते: जिन भुगतानों की शुरुआत हो चुकी है उनकी पुष्टि अब भी Wompi इवेंट और ग्राहक की वापसी से होती है।
लाइसेंस समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण की ज़रूरत होती है। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप फिर से जाँची जाती है: कुंजी दर्ज होने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ़्ते एक बार। cron job की ज़रूरत नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है।
समस्या निवारण
चेकआउट पर Wompi नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और वर्तमान मोड की चारों कुंजियाँ सेट हैं (सेटिंग्स पेज का स्थिति बॉक्स गायब कुंजियों की सूची देता है)। यह भी जाँचें कि ग्राहक COP में चेकआउट करता है और कुल योग कम से कम COP 1,500 है। यह भी देखें कि भुगतान पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।
भुगतान हो गया, पर ऑर्डर बिना स्थिति के है: Events URL काम नहीं कर रहा। Wompi डैशबोर्ड में जाँचें कि जिस वातावरण (sandbox या production) का आप उपयोग करते हैं, उसके लिए Events URL सेट है और सेटिंग्स में दिखाए गए URL से बिल्कुल मेल खाता है। जाँचें कि उस वातावरण की events secret सही सेक्शन में है। भुगतान के बाद ग्राहक स्टोर पर लौटेगा तो ऑर्डर को भी स्थिति मिल जाएगी।
Events URL answers Not configured: इवेंट के वातावरण की events secret खाली है। उसे सेटिंग्स में चिपकाएँ।
Events URL answers Invalid signature: events secret किसी दूसरे वातावरण या दूसरे खाते की है। Wompi डैशबोर्ड से उसे फिर से कॉपी करें।
Events URL answers Transaction lookup failed: Wompi API ने लेन-देन वापस नहीं किया, जैसे गलत private key या नेटवर्क समस्या के कारण। Wompi बाद में इवेंट फिर भेजेगा।
Events URL answers Retry: उसी समय दूसरा अनुरोध ऑर्डर की पुष्टि कर रहा था, या ऑर्डर की स्थिति सेट नहीं हो सकी। Wompi बाद में इवेंट फिर भेजेगा। कारण के लिए Log फ़ील्ड देखें।
Events URL answers Environment mismatch: sandbox लेन-देन production भुगतान प्रयास के लिए आया, या इसका उल्टा। Sandbox भुगतान कभी production ऑर्डर की पुष्टि नहीं करते।
Events URL answers Unknown reference: लेन-देन का संदर्भ इस स्टोर के संदर्भ जैसा लगता है, पर यहाँ कभी जारी नहीं हुआ, उदाहरण के लिए उसी Wompi खाते पर किसी दूसरे OpenCart स्टोर द्वारा। दूसरी प्रणालियों के संदर्भों को Ignored: not an OpenCart reference का उत्तर मिलता है।
The Events URL shows Method not allowed in the browser: यह सामान्य है। यह URL केवल Wompi के अनुरोध स्वीकार करता है।
The key does not start with ... warning on save: कोई कुंजी गलत सेक्शन में चिपकाई गई है। Sandbox कुंजियाँ pub_test_, prv_test_, test_events_ और test_integrity_ से, और production कुंजियाँ pub_prod_, prv_prod_, prod_events_ और prod_integrity_ से शुरू होती हैं।
Order is in the review status: VibeFox Wompi Payment टैब के नोट पढ़ें (देखें ऑर्डर स्थितियाँ), फिर Wompi डैशबोर्ड में ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।
Other errors: एक्सटेंशन पेज पर Log फ़ील्ड और ऑर्डर के Wompi notes देखें। त्रुटियाँ हमेशा दर्ज होती हैं। अधिक विवरण के लिए Debug log चालू करें।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Payments चुनें और VibeFox Wompi Payment के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। OpenCart एक्सटेंशन की अपनी सेटिंग्स हमेशा हटाता है: Enable/Disable, Sort Order, Geo Zone, Total और Orders सेक्शन की ऑर्डर स्थितियाँ, जो दोबारा इंस्टॉल करने पर डिफ़ॉल्ट पर लौट आती हैं। एक्सटेंशन का OpenCart इवेंट भी हटा दिया जाता है (OpenCart 4 पर उसके इवेंट्स और उसकी startup action भी, जो maintenance mode में Events URL को आगे जाने देती है)। यदि Delete data on uninstall चालू है, तो बाकी सेटिंग्स (शीर्षक, विवरण, sandbox मोड, कुंजियाँ, लॉगिंग) और लॉग हटा दिए जाते हैं। यदि बंद है, तो वे बाद में दोबारा इंस्टॉल करने के लिए रखे जाते हैं। Wompi भुगतान प्रयास हमेशा रखे जाते हैं, इसलिए पुराने भुगतान का देर से आया इवेंट दोबारा इंस्टॉल करने के बाद भी पहचाना जाता है। मौजूदा ऑर्डर अपने भुगतान नोट रखते हैं।
OpenCart 4 पर फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ और इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Wompi Payment के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किए गए पैकेज को हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Wompi उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Wompi से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।