VibeFox Conekta for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: चेकआउट की मुद्रा MXN या USD होनी चाहिए। अन्य मुद्राओं के लिए भुगतान विधि छिपी रहती है।

Conekta खाता: आपको अपने Conekta खाते की निजी API कुंजियाँ (टेस्ट और लाइव) और Conekta पैनल में एक वेबहुक चाहिए (देखें Configuration)। केवल निजी कुंजियाँ उपयोग होती हैं। सार्वजनिक कुंजी की ज़रूरत नहीं है, क्योंकि भुगतान Conekta द्वारा होस्ट किए गए चेकआउट पेज पर होता है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपनी टेस्ट और लाइव निजी कुंजियाँ दर्ज करें, मोड चुनें और Conekta पैनल में वेबहुक जोड़ें (देखें Configuration)।

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

OpenCart 4

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

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

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

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

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

Configuration

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Conekta Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज आपको चेतावनी देता है जब Conekta सक्षम हो पर वर्तमान मोड की निजी कुंजी खाली हो (तब चेकआउट पर भुगतान विधि छिपी रहती है), और जब स्टोर की डिफ़ॉल्ट मुद्रा MXN या USD न हो। टेस्ट मोड चालू होने पर यह Test mode is on: payments are simulated with the test private key. दिखाता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय Title खाली नहीं हो सकता, Sort Order पूर्ण संख्या होनी चाहिए, Total ऋणात्मक न हो, और चुना गया Geo Zone तथा ऑर्डर स्टेटस मौजूद होने चाहिए। कोई भी जाँच विफल होने पर कुछ भी सेव नहीं होता और पेज त्रुटियाँ सूचीबद्ध करता है। दो चेतावनियाँ सेव को नहीं रोकतीं: जब कोई भुगतान विधि चुनी न गई हो (तब कार्ड भुगतान दिए जाते हैं) और जब गेटवे वर्तमान मोड की निजी कुंजी के बिना सक्षम हो।

Conekta

Enable / Disable: Enable Conekta payments भुगतान विधि को चालू या बंद करता है। Default: off।

Title: वह भुगतान विधि का नाम जो ग्राहक चेकआउट पर देखता है। ऑर्डर में भी यही भुगतान विधि का नाम सेव होता है। Default: Conekta। अनिवार्य, अधिकतम 128 अक्षर।

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखाया जाने वाला पाठ। Default: Pay securely with card, OXXO cash or SPEI transfer. भुगतान पूरा करने के लिए आपको Conekta पर भेजा जाएगा।

Payment methods: Conekta भुगतान पेज पर दी जाने वाली विधियाँ। Default: card, cash and bank transfer. कैश, SPEI और BNPL केवल MXN ऑर्डर के लिए उपलब्ध हैं (USD ऑर्डर केवल कार्ड लेते हैं) और आपके Conekta खाते में सक्षम होने चाहिए। कुछ भी न चुनने पर कार्ड उपयोग होता है।

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

Geo Zone: Conekta केवल चुने गए geo zone के भुगतान पते के लिए दें। Default: All zones। Geo zones System > Localisation > Geo Zones में सेट किए जाते हैं।

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

API कुंजियाँ

Conekta पैनल में Developers > API keys के अंतर्गत से अपनी निजी कुंजियाँ कॉपी करें (पेज पर पैनल का लिंक है)। टेस्ट और लाइव कुंजियाँ अलग-अलग होती हैं।

Test mode: टेस्ट निजी कुंजी उपयोग करता है। कोई वास्तविक राशि नहीं काटी जाती, और ग्राहक Confirm Order चरण पर TEST MODE — No real charges will be made. देखता है। रिफ़ंड हमेशा उसी मोड की कुंजी से होते हैं जिसमें भुगतान हुआ था। Default: on।

Test private key: आपके Conekta खाते के टेस्ट मोड की निजी API कुंजी।

Live private key: आपके Conekta खाते के प्रोडक्शन मोड की निजी API कुंजी। इसे गोपनीय रखें।

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

हर Conekta ऑर्डर अपना मोड याद रखता है: सूचनाएँ और रिफ़ंड मिलती हुई कुंजी का उपयोग करते हैं। जब तक पुराने टेस्ट ऑर्डर खुले हैं, दोनों कुंजियाँ भरी रखें।

Webhook

वेबहुक आपके स्टोर को भुगतानों के बारे में बताता है, जैसे OXXO या SPEI के वे भुगतान जो ग्राहक के Conekta पेज छोड़ने के बाद किए गए। Conekta पैनल में Developers > Webhooks पर जाएँ और इस सेक्शन में Webhook URL के अंतर्गत दिखाया गया URL टेस्ट और लाइव, दोनों मोड के लिए जोड़ें। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_conekta_gateway/webhook, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_conekta_gateway/payment/wcp_conekta_gateway.webhook जैसा। यह आपके OpenCart इंस्टॉलेशन के स्टोरफ़्रंट पते से बनता है। URL को ठीक वैसे ही कॉपी करें जैसा सेटिंग्स दिखाती हैं। यह इंटरनेट से पहुँच योग्य होना चाहिए।

ये इवेंट चुनें (ये इस सेक्शन में भी सूचीबद्ध हैं):

वेबहुक की बॉडी केवल एक्सटेंशन को बताती है कि कौन-सा Conekta ऑर्डर बदला है। हर सूचना की जाँच उसके मोड की निजी कुंजी के साथ Conekta API से ऑर्डर को दोबारा पढ़कर होती है; वेबहुक का Digest हस्ताक्षर हेडर उपयोग नहीं होता। ऐसे Conekta ऑर्डरों की सूचनाएँ, जो इस स्टोर ने उस ऑर्डर के लिए नहीं बनाए, स्वीकार की जाती हैं और अनदेखी की जाती हैं। वेबहुक के बिना, ऑर्डर तभी पुष्टि होता है जब ग्राहक भुगतान के बाद स्टोर पर वापस आता है, या उसी कार्ट के लिए अगले भुगतान प्रयास पर।

ऑर्डर

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। ऑर्डर को स्टेटस तभी मिलता है जब Conekta भुगतान की सूचना दे, वेबहुक से या ग्राहक के लौटने पर; ऑर्डर को हमेशा Conekta से दोबारा पढ़ा जाता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Order Status After Payment: सत्यापित Conekta भुगतान के बाद सेट होने वाला स्टेटस। Default: Processing।

Awaiting Conekta Payment Status: ग्राहक को OXXO या SPEI संदर्भ जारी किया गया है, और Conekta को अभी राशि नहीं मिली है। Default: Pending।

Conekta Payment On Hold Status: भुगतान हो गया है, लेकिन राशि या मुद्रा ऑर्डर से मेल नहीं खाती, लाइव मोड में TEST भुगतान आ गया, ऑर्डर पहले ही रद्द हो चुका था, या भुगतान केवल पूर्व-प्राधिकृत (pre-authorized) है। एक नोट कारण बताता है। Default: Pending, क्योंकि OpenCart में On hold स्टेटस नहीं है। आप System > Localisation > Order Statuses में अपने स्टेटस बना सकते हैं और यहाँ चुन सकते हैं।

Payment Expired / Canceled Status: भुगतान की प्रतीक्षा करने वाला ऐसा ऑर्डर जिसका Conekta संदर्भ समाप्त हो गया या जिसका Conekta ऑर्डर रद्द हो गया। Default: Canceled।

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड होने के बाद सेट होता है। Default: Refunded।

उन्नत

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

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

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

इंपोर्ट / एक्सपोर्ट

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

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

चेकआउट

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

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर को तभी भुगतान किया हुआ चिह्नित किया जाता है जब Conekta उसकी पुष्टि करे: एक्सटेंशन वेबहुक आने पर और ग्राहक के लौटने पर Conekta API से ऑर्डर पढ़ता है। फिर ऑर्डर को OpenCart के सामान्य तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है। जब ग्राहक ने OXXO या SPEI चुना और भुगतान संदर्भ मिला, तो ऑर्डर को Awaiting Conekta Payment Status मिलता है और सफलता पेज पर Your Conekta payment reference has been issued. The order will be confirmed as soon as the payment is received. दिखता है। होल्ड पर चल रहे ऑर्डर के लिए पेज We are confirming your payment with Conekta. The order will be updated automatically — please do not pay again. दिखाता है।

यदि ग्राहक के लौटने पर भुगतान की पुष्टि अभी नहीं हो पाती, तो Payment confirmation पेज वही पाठ और Check again बटन दिखाता है। वेबहुक आते ही ऑर्डर स्टेटस सेट कर देता है। OpenCart 4 पर, जब Conekta ग्राहक को वापस भेजता है तो ब्राउज़र स्टोर सेशन नहीं भेजता, इसलिए एक्सटेंशन पहले एक छोटा पेज दिखाता है जो स्टोर से उसी वापसी पते को दोबारा खोलता है: ग्राहक का कार्ट और लॉगिन बना रहता है।

यदि भुगतान अस्वीकार हो जाए, तो ऑर्डर बिना स्टेटस के रहता है और ग्राहक The Conekta payment was not completed. Please try again or choose another payment method. के साथ चेकआउट पर लौट आता है। यदि चेकआउट की अवधि समाप्त हो गई या रद्द हुआ, तो संदेश The Conekta payment has expired or was cancelled. Please try again. होता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखाए जाते हैं। कार्ट सुरक्षित रहता है। हर नए प्रयास पर (OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर एक नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है) पहले उस कार्ट के पिछले Conekta चेकआउट पढ़े जाते हैं। उसी ऑर्डर का खुला चेकआउट, उसी राशि के साथ, दोबारा उपयोग होता है; अन्यथा नया बनाने से पहले पिछला Conekta में रद्द कर दिया जाता है, ताकि पुराना लिंक दो बार भुगतान में न लाया जा सके। यदि पिछला चेकआउट पहले ही भुगतान हो चुका है, तो दोबारा चार्ज करने के बजाय उसका ऑर्डर पुष्ट किया जाता है। कार्ट केवल एक बार भुगतान होता है: यदि उसी कार्ट के किसी दूसरे ऑर्डर के पास पहले से Conekta भुगतान या जारी किया गया OXXO / SPEI संदर्भ है, तो नया भुगतान शुरू नहीं होता और ग्राहक सफलता पेज पर जाता है। यदि उसी कार्ट के लिए दूसरा भुगतान फिर भी आ जाए, तो उसका ऑर्डर बिना स्टेटस के रहता है और भुगतान किए गए ऑर्डर पर एक नोट लगता है कि डुप्लिकेट को Conekta पैनल में रिफ़ंड करें।

OpenCart 4 ऑर्डर को तब तक चेकआउट में रखता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बंद हो गया (उदाहरण के लिए उसका OXXO या SPEI संदर्भ समाप्त हो गया, या आपने उसे रद्द किया), तो Confirm Order ग्राहक को The Conekta payment has expired or was cancelled. Please try again. संदेश के साथ चेकआउट पर वापस भेजता है, और अगला Confirm Order कार्ट का एक नया ऑर्डर भुगतान करता है। यदि ऑर्डर पहले से कोई स्टेटस रखता है और उसके बाद कार्ट बदल गया है (दूसरे उत्पाद या मात्रा), तो ग्राहक चेकआउट पर वापस भेजा जाता है, और बदले हुए कार्ट को एक नया ऑर्डर और अपना भुगतान मिलता है।

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

स्टोर मेंटेनेंस मोड में होने पर भी वेबहुक काम करता है: OpenCart 3 भुगतान एक्सटेंशन के अनुरोधों को आगे जाने देता है, और OpenCart 4 पर एक्सटेंशन वेबहुक के लिए एक स्टार्टअप ऐक्शन जोड़ता है।

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

ऑर्डर और रिफ़ंड

ऑर्डर स्टेटस

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

Order Status After Payment (default Processing): Conekta ने समान राशि और मुद्रा के साथ भुगतान की पुष्टि की। एक नोट भुगतान विधि दिखाता है (जैसे कार्ड ब्रांड और अंतिम चार अंक, OXXO / नकद या SPEI बैंक ट्रांसफ़र), Conekta ऑर्डर और चार्ज।

Awaiting Conekta Payment Status (default Pending): ग्राहक को OXXO या SPEI भुगतान संदर्भ मिला। जब Conekta भुगतान की सूचना देता है, तो ऑर्डर Order Status After Payment पर चला जाता है।

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

Payment Expired / Canceled Status (default Canceled): प्रतीक्षारत ऑर्डर का OXXO या SPEI संदर्भ समाप्त हो गया, या उसका Conekta ऑर्डर रद्द कर दिया गया।

Refunded Status (default Refunded): एक्सटेंशन के माध्यम से भुगतान पूरी तरह रिफ़ंड किया गया।

भुगतान किया हुआ या रिफ़ंड किया गया ऑर्डर कभी निचले स्टेटस पर नहीं जाता और न दोबारा खोला जाता है। यदि पहले से भुगतान किए गए ऑर्डर के लिए कोई और Conekta भुगतान आता है, तो एक WARNING नोट आपसे उसे Conekta पैनल में रिफ़ंड करने को कहता है।

नोट ऑर्डर के History की प्रविष्टियाँ हैं, जिन्हें ग्राहक नहीं देखता।

VibeFox Conekta Gateway टैब

Sales > Orders में Conekta से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Conekta Gateway टैब टेस्ट भुगतानों के लिए Test mode लेबल के साथ Conekta order, Charge, भुगतान का Status, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Conekta notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

VibeFox Conekta Gateway टैब में Amount दर्ज करें (जो राशि अभी रिफ़ंड नहीं हुई, वह पहले से भरी रहती है), वैकल्पिक रूप से Reason (optional) दर्ज करें, और Refund via Conekta पर क्लिक करें। प्रश्न Refund this amount through Conekta? This cannot be undone. की पुष्टि करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। आपके पास एक्सटेंशन बदलने का अधिकार होना चाहिए (जो System > Users > User Groups में सेट होता है)। रिफ़ंड उसी राशि और मुद्रा तक सीमित हैं जो Conekta ने वास्तव में चार्ज की; इसलिए राशि में अंतर होने पर आप ऑर्डर कुल नहीं, बल्कि ग्राहक द्वारा दी गई राशि तक ही रिफ़ंड कर सकते हैं। रिफ़ंड उस Conekta ऑर्डर पर जाता है जिसमें भुगतान है, और उस मोड की कुंजी उपयोग करता है जिसमें भुगतान हुआ था, इसलिए वह कुंजी सेट होनी चाहिए। यदि Conekta रिफ़ंड स्वीकार नहीं करता, तो टैब त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड रिफ़ंड इतिहास और नोटों में राशि, मोड, Conekta ऑर्डर, रिफ़ंड ID और कारण के साथ जुड़ता है। पूर्ण रिफ़ंड ऑर्डर को Refunded Status पर सेट करता है, बिना ग्राहक को सूचित किए और बिना उत्पादों को स्टॉक में लौटाए, जैसे मैनुअल स्टेटस बदलाव में होता है। आंशिक रिफ़ंड स्टेटस नहीं बदलता। रिफ़ंड तब उपलब्ध होते हैं जब Conekta भुगतान की सूचना दे चुका हो।

Sales > Returns में उत्पाद वापसी Conekta के माध्यम से पैसे वापस नहीं भेजती।

Conekta पैनल में किए गए रिफ़ंड वेबहुक से आते हैं और Conekta तथा OpenCart में रिफ़ंड की गई राशि के साथ एक नोट के रूप में जुड़ते हैं। वे अपने-आप दर्ज नहीं होते। Refund via Conekta का उपयोग किए बिना ऑर्डर को मैन्युअली अपडेट करें। Conekta द्वारा सूचित chargeback भी एक नोट के रूप में जुड़ता है।

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

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

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

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

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

Conekta चेकआउट पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है, वर्तमान मोड की निजी कुंजी भरी है (टेस्ट मोड में Test private key, लाइव मोड में Live private key), और चेकआउट मुद्रा MXN या USD है। कुंजी गायब होने या स्टोर मुद्रा समर्थित न होने पर सेटिंग्स पेज चेतावनी दिखाता है। यह भी जाँचें कि भुगतान पता चुने गए Geo Zone में है, और ऑर्डर सेटिंग्स में दिए गए Total तक पहुँचता है।

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के है: वेबहुक काम नहीं कर रहा। Conekta पैनल में जाँचें कि आपके उपयोग किए जा रहे मोड (टेस्ट या लाइव) के लिए वेबहुक मौजूद है, उसका URL ठीक वही है जो Webhook URL में दिखता है, और इवेंट चुने हुए हैं। जाँचें कि उस मोड की निजी कुंजी सेट है, क्योंकि हर सूचना उसी से सत्यापित होती है। ग्राहक के स्टोर पर लौटने या उसी कार्ट को दोबारा भुगतान करने की कोशिश करने पर भी ऑर्डर को स्टेटस मिल जाता है।

वेबहुक का उत्तर Temporarily unavailable है: Conekta API तक पहुँचा नहीं जा सका, ऑर्डर के मोड की निजी कुंजी गायब है, ऑर्डर किसी दूसरे अनुरोध द्वारा प्रोसेस हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Conekta वेबहुक को फिर से भेजता है। कारण के लिए Log फ़ील्ड देखें।

वेबहुक का उत्तर Verification failed, Invalid payload या Invalid order id है: Conekta API ने ऑर्डर की पुष्टि नहीं की, या सूचना एक वैध Conekta ऑर्डर इवेंट नहीं थी।

वेबहुक का उत्तर Ignored है: सूचना ऐसे Conekta ऑर्डर से संबंधित है जिसे इस स्टोर ने उस ऑर्डर के लिए नहीं बनाया (जैसे कोई दूसरा स्टोर या उसी खाते पर भुगतान लिंक), या वह ऑर्डर के अलावा किसी और ऑब्जेक्ट से संबंधित है।

ब्राउज़र में वेबहुक URL पर Method not allowed दिखता है: यह सामान्य है। यह URL केवल Conekta के अनुरोध स्वीकार करता है।

ग्राहक को We could not check the status of your previous payment attempt दिखता है: कार्ट के पिछले Conekta चेकआउट को पढ़ा नहीं जा सका, इसलिए दोहरे भुगतान से बचने के लिए नया चेकआउट नहीं बनाया गया। थोड़ी देर बाद फिर से प्रयास करें।

ग्राहक को Payment gateway is not configured दिखता है: वर्तमान मोड की निजी कुंजी गायब है।

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

ग्राहक को Payment verification failed दिखता है: Conekta से लौटने वाला लिंक ऑर्डर से मेल नहीं खाया। Conekta पैनल में ऑर्डर जाँचें; वेबहुक फिर भी असली भुगतान की पुष्टि करता है।

ऑर्डर प्रतीक्षा या होल्ड स्थिति में है: ऑर्डर टैब में Conekta notes पढ़ें। ग्राहक ने अभी OXXO या SPEI संदर्भ का भुगतान नहीं किया, राशि या मुद्रा मेल नहीं खाई, स्टोर के लाइव मोड में होने पर टेस्ट-मोड भुगतान आया, या भुगतान केवल पूर्व-प्राधिकृत है।

टैब में रिफ़ंड फ़ॉर्म नहीं है: टैब कारण बताता है: Conekta ने अभी भुगतान की सूचना नहीं दी, वह पूरी तरह रिफ़ंड हो चुका है, आपके उपयोगकर्ता समूह के पास एक्सटेंशन बदलने का अधिकार नहीं है, या भुगतान के मोड की निजी कुंजी सेट नहीं है।

टेस्ट या लाइव मोड से जुड़े संदेश के साथ रिफ़ंड विफल होता है: भुगतान उस मोड में हुआ था, और उसकी निजी कुंजी सेट नहीं है। उसे दर्ज करें और फिर प्रयास करें।

डेवलपर्स के लिए: OpenCart इवेंट wc_ckt_supported_currencies, wc_ckt_order_request, wc_ckt_allowed_payment_methods और wc_ckt_refund_reason अन्य एक्सटेंशनों को समर्थित मुद्राएँ, Conekta ऑर्डर अनुरोध, भुगतान विधियाँ और रिफ़ंड कारण बदलने देते हैं।

अनइंस्टॉल

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

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

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