VibeFox Khipu for OpenCart — सहायता

आवश्यकताएँ

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

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

मुद्रा: चिली पेसो (CLP), अर्जेंटीना पेसो (ARS) या पेरू सोल (PEN)। यह मुद्रा System > Localisation > Currencies में मौजूद होनी चाहिए। Khipu तभी दिया जाता है जब ग्राहक इन्हीं में से किसी मुद्रा में भुगतान कर रहा हो; अन्य मुद्राओं के लिए चेकआउट पर भुगतान का तरीका छिप जाता है।

Khipu खाता: आपको अपने Khipu कलेक्शन खाते का Receiver ID ("Id de cobrador"), API key और secret key चाहिए। ये आपके Khipu खाते में मर्चेंट प्रोफ़ाइल के अंतर्गत मिलते हैं (khipu.com/merchant/profile)। तीनों आवश्यक हैं: इनके बिना चेकआउट पर Khipu नहीं दिया जाता, और secret key के बिना कोई भुगतान पुष्ट नहीं हो सकता। Khipu खाते में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।

पहुँच योग्य स्टोर: Khipu आपके स्टोर को कॉल करके भुगतान की पुष्टि करता है, इसलिए सूचना URL इंटरनेट से पहुँच योग्य होना चाहिए, बिना पासवर्ड सुरक्षा के और बिना किसी फ़ायरवॉल के जो Khipu को रोके। स्टोर का मेंटेनेंस मोड इसे नहीं रोकता।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. अपने Khipu कलेक्शन खाते की Receiver ID, API key और Secret key दर्ज करें (देखें Configuration)।

5. Enable / Disable चालू करें और Save पर क्लिक करें। पहले परीक्षण करने के लिए Khipu डेवलपर खाते की कुंजियाँ इस्तेमाल करें, फिर उन्हें अपने प्रोडक्शन खाते की कुंजियों से बदल दें।

OpenCart 4

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

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

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

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

नए इंस्टॉल में भुगतान का तरीका बंद होता है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Khipu Gateway > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरे पेज को सहेजता है। सेटिंग्स के ऊपर पेज चेतावनी देता है जब Receiver ID, API key या secret key गायब हो (तब चेकआउट पर Khipu नहीं दिया जाता), और जब स्टोर की डिफ़ॉल्ट मुद्रा Khipu द्वारा समर्थित न हो (तब Khipu केवल तभी दिया जाता है जब ग्राहक CLP, ARS या PEN में भुगतान करे)। एक्सटेंशन बदलने का अधिकार न हो तो पेज सेटिंग्स दिखाता है, पर उन्हें सहेज नहीं सकता।

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

Khipu

Enable / Disable: Enable Khipu payments भुगतान का तरीका चालू या बंद करता है। डिफ़ॉल्ट: बंद।

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

Description: वह टेक्स्ट जो ग्राहक को Confirm Order चरण में, कन्फ़र्म बटन के ऊपर दिखता है। डिफ़ॉल्ट: Khipu के माध्यम से बैंक ट्रांसफ़र से भुगतान करें।

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

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

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

Khipu खाता

अपने Khipu कलेक्शन खाते से Receiver ID, API key और secret key कॉपी करें (यह सेक्शन khipu.com/merchant/profile का लिंक देता है)। Khipu का अलग सैंडबॉक्स सर्वर नहीं है, और एक्सटेंशन में टेस्ट मोड का कोई स्विच नहीं है। परीक्षण के लिए डेवलपर ("desarrollo") कलेक्शन खाते की कुंजियाँ इस्तेमाल करें: वह टेस्ट बैंक DemoBank से भुगतान करता है, और कोई असली पैसा नहीं चलता। लाइव जाते समय अपने प्रोडक्शन कलेक्शन खाते की कुंजियों पर स्विच करें।

Receiver ID: आपका Khipu रिसीवर ("cobrador") ID। अन्य Khipu खातों के भुगतान अस्वीकार होते हैं।

API key: भुगतान बनाने और Khipu के साथ हर भुगतान को सत्यापित करने के लिए इस्तेमाल होती है।

Secret key: Khipu भुगतान सूचनाओं के हस्ताक्षर (HMAC-SHA256) को सत्यापित करने के लिए इस्तेमाल होती है। इसके बिना कोई भुगतान पुष्ट नहीं हो सकता।

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

भुगतान सूचनाएँ

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

हर सूचना में आपकी Secret key से बनाया गया वैध हस्ताक्षर होना चाहिए। वैध हस्ताक्षर के बिना सूचनाएँ अस्वीकार होती हैं। एक्सटेंशन सूचना की सामग्री पर कभी भरोसा नहीं करता: वह Khipu से भुगतान की स्थिति पूछता है और जो Khipu रिपोर्ट करता है, उसी के अनुसार कार्य करता है:

Status after payment: Khipu द्वारा भुगतान पुष्ट होने पर ऑर्डर को जो स्टेटस मिलता है। स्टेटस एक ही बदलाव में तुरंत सेट होता है।

OpenCart Confirm Order चरण पर ऑर्डर बिना स्टेटस के बनाता है (एक लापता ऑर्डर)। Khipu द्वारा भुगतान पुष्ट होने के बाद ही उसे स्टेटस मिलता है। नीचे का हर फ़ील्ड आपके OpenCart ऑर्डर स्टेटस सूचीबद्ध करता है।

Paid Order Status: Status after payment Processing होने पर, पुष्ट भुगतान के बाद का स्टेटस। डिफ़ॉल्ट: प्रक्रिया में।

Complete Order Status: Status after payment Completed होने पर, पुष्ट भुगतान के बाद का स्टेटस। डिफ़ॉल्ट: पूर्ण।

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

उन्नत

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

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

Delete data on uninstall: चालू होने पर एक्सटेंशन हटाने से गेटवे सेटिंग्स और लॉग हट जाते हैं। ऑर्डर डेटा (ऑर्डर के Khipu भुगतान ID) हमेशा रहता है। डिफ़ॉल्ट: बंद।

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

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

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

चेकआउट

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

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे Confirm Order पर क्लिक करता है।

भुगतान के बाद ग्राहक आपके स्टोर पर लौटता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Khipu उसकी पुष्टि करता है: हस्ताक्षरित सूचना से, या ग्राहक के लौटने पर Khipu से स्थिति अनुरोध से। लौटने की क्रिया स्वयं कुछ भी भुगतान किया हुआ नहीं बनाती। फिर ऑर्डर को OpenCart के मानक तरीके से स्टेटस मिलता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट के साथ, और ग्राहक को OpenCart का ऑर्डर सफलता पेज दिखता है। यदि बैंक अभी भी ट्रांसफ़र सत्यापित कर रहा है या Khipu तक पहुँचा नहीं जा सकता, तो एक Payment confirmation पेज दिखता है जिस पर Khipu is confirming your bank transfer. Your order will be confirmed automatically as soon as Khipu confirms the payment, and you will receive an e-mail. लिखा होता है, साथ में Check again और Back to checkout बटन। यदि ऑर्डर का नवीनतम Khipu भुगतान उससे मेल नहीं खा सकता (उदाहरण के लिए, वह किसी दूसरे Receiver ID का है), तो ग्राहक We could not match this payment to an order. If you paid, please contact us. के साथ चेकआउट पर लौट आता है।

यदि ग्राहक Khipu पेज पर रद्द करता है, या भुगतान पूरा नहीं हुआ, तो ग्राहक The Khipu payment was not completed. You can try again or choose another payment method. के साथ चेकआउट पर लौट आता है। कार्ट सुरक्षित रहता है। OpenCart 4 पर ये संदेश चेकआउट पेज के ऊपर दिखते हैं। हर नए प्रयास पर (OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है, OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है और उसे नए Khipu भुगतान से चुकाता है) उस ऑर्डर या कार्ट का पिछला अनभुगतान Khipu भुगतान हट जाता है, ताकि पुराना लिंक अब भुगतान योग्य न रहे। यदि Khipu को पिछला भुगतान पहले ही मिल चुका है, तो वह लागू होता है और ग्राहक नए भुगतान के बिना सफलता पेज पर जाता है। यदि पिछला ट्रांसफ़र अभी भी बैंक द्वारा सत्यापित हो रहा है, तो ग्राहक को Your previous Khipu payment for this order is still being verified by the bank. Please wait a few minutes before paying again. दिखता है। यदि पिछला भुगतान समीक्षा में है, तो ग्राहक से फिर से भुगतान करने से पहले स्टोर से संपर्क करने को कहा जाता है। कार्ट में कोई भी बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

OpenCart 4 में ऑर्डर तब तक चेकआउट में रहता है जब तक सफलता पेज नहीं दिखता। यदि वह ऑर्डर इस बीच बिना भुगतान के बंद हो गया हो (उदाहरण के लिए आपने उसे रद्द किया), तो ग्राहक Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. के साथ चेकआउट पर लौटा दिया जाता है। यदि ऑर्डर पहले ही दिया जा चुका है और तब से कार्ट बदल गया है, तो संदेश है Your previous order has already been placed. Your cart has changed since — please confirm the order again to pay for the current cart with a new order. दोनों स्थितियों में अगला Confirm Order कार्ट का नया ऑर्डर भुगतान करता है।

यदि Khipu भुगतान नहीं बना सकता, तो ग्राहक बटन के ऊपर एक छोटे संदेश के साथ Confirm Order चरण पर रुका रहता है, जैसे Khipu could not create the payment for this order. Please check your billing details and try again, or contact the store. या Khipu is temporarily unavailable. Please try again in a few minutes. विवरण लॉग में लिखे जाते हैं।

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

एक्सटेंशन केवल एकमुश्त बैंक ट्रांसफ़र भुगतान लेता है। रिफ़ंड OpenCart से Khipu को नहीं भेजे जाते, और इसमें सदस्यताएँ, सहेजे गए भुगतान तरीके या पूर्व-अधिकरण नहीं हैं। अनभुगतान किए गए भुगतान स्टॉक आरक्षण से जुड़े नहीं होते।

ऑर्डर

ऑर्डर स्टेटस

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

Paid Order Status या Complete Order Status (डिफ़ॉल्ट प्रक्रिया में या पूर्ण): Khipu ने भुगतान की पुष्टि की। स्टेटस Status after payment का पालन करता है। एक नोट Khipu payment verified. Payment ID: को भुगतान ID और राशि के साथ दिखाता है।

On Hold (Review) Status (डिफ़ॉल्ट भुगतान लंबित): Khipu ने ऐसे भुगतान की पुष्टि की जिसकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या भुगतान ऑर्डर रद्द या अस्वीकृत होने के बाद आया। एक नोट इसे समझाता है। Khipu खाते में भुगतान जाँचें, फिर ऑर्डर पूरा करें या ग्राहक को रिफ़ंड करें। यदि बाद में उसी ऑर्डर के लिए सही राशि का भुगतान आता है, तो ऑर्डर भुगतान किए गए स्टेटस पर चला जाता है और ग्राहक को ईमेल से सूचित किया जाता है। यदि भुगतान तब आता है जब ऑर्डर किसी और प्रोसेसिंग स्टेटस पर जा चुका है, तो स्टेटस नहीं बदलता और केवल एक नोट जुड़ता है।

यदि किसी पहले से भुगतान किए गए ऑर्डर, या पहले से भुगतान किए गए कार्ट के किसी दूसरे ऑर्डर के लिए भुगतान आता है, तो ऑर्डर नहीं बदलता। यदि यह दूसरा भुगतान है, तो एक नोट आपसे इसे ग्राहक को रिफ़ंड करने के लिए कहता है। यदि Khipu किसी भुगतान किए गए भुगतान को उलटा हुआ बताता है, तो ऑर्डर को एक नोट मिलता है और उसका स्टेटस नहीं बदलता।

नोट्स ऑर्डर के History की वे प्रविष्टियाँ हैं जिन्हें ग्राहक नहीं देखता। वे शब्द Khipu से शुरू होते हैं।

VibeFox Khipu Gateway टैब

Sales > Orders में Khipu से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Khipu Gateway टैब ऑर्डर के Khipu भुगतान प्रयास (तारीख, राशि, Khipu भुगतान ID, Khipu स्थिति और परिणाम) दिखाता है, जब तक ऑर्डर समीक्षा स्टेटस में है तब तक Manual review चेतावनी, और ऑर्डर के Khipu notes। यह टैब केवल-पढ़ने योग्य है और उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

Khipu अपने API के ज़रिए रिफ़ंड नहीं देता, इसलिए रिफ़ंड OpenCart से Khipu को नहीं भेजे जाते। टैब यही बताता है। ग्राहक को अपने Khipu खाते से या बैंक ट्रांसफ़र से रिफ़ंड करें, फिर OpenCart में ऑर्डर स्टेटस मैन्युअली बदलें।

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

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Khipu नहीं दिखता। यदि फिर भी भुगतान शुरू होता है, तो ग्राहक को 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 आवश्यक नहीं है। एक्सटेंशन हटाने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

चेकआउट पर Khipu दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable / Disable चालू है और Receiver ID, API key और Secret key तीनों दर्ज हैं। ग्राहक को CLP, ARS या PEN में भुगतान करना होगा। सेटिंग्स पेज कुछ गायब होने पर चेतावनी दिखाता है। यह भी जाँचें कि भुगतान का पता चुने गए Geo Zone में है और ऑर्डर सेटिंग्स के Total तक पहुँचता है।

भुगतान हो गया, पर ऑर्डर बिना स्टेटस के है: Khipu बैंक द्वारा ट्रांसफ़र सत्यापित करने के बाद ही उसकी पुष्टि करता है। Khipu की सूचना आने पर या ग्राहक के Check again क्लिक करने पर ऑर्डर को स्टेटस मिलता है। जाँचें कि आपका स्टोर Notification URL में दिखाए गए पते पर इंटरनेट से पहुँच योग्य है (कोई पासवर्ड सुरक्षा या फ़ायरवॉल Khipu को न रोके), और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

सूचना का उत्तर Secret key not configured है: Secret key खाली है। उसे दर्ज करें। Khipu सूचना दोबारा भेजता है।

सूचना का उत्तर Invalid signature, Missing signature या Malformed signature है: Secret key उस कलेक्शन खाते की नहीं है जिसकी कुंजियाँ आप इस्तेमाल कर रहे हैं, या अनुरोध Khipu से नहीं आया।

सूचना का उत्तर Order not found, Payment not found for this account या Payment does not belong to this order है: भुगतान किसी और Receiver ID पर, दूसरी कुंजियों से, या किसी दूसरे ऑर्डर के लिए किया गया। Receiver ID और कुंजियाँ जाँचें।

सूचना का उत्तर Payment not final yet या Verification unavailable है: ट्रांसफ़र अभी भी सत्यापित हो रहा है, या Khipu तक पहुँचा नहीं जा सका। Khipu सूचना दोबारा भेजता है।

सूचना का उत्तर Busy, retry later या Order could not be updated, retry later है: उसी समय ऑर्डर किसी दूसरे अनुरोध से पुष्ट हो रहा था, या ऑर्डर स्टेटस सेट नहीं हो सका। Khipu सूचना दोबारा भेजता है। कारण लॉग में है।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Khipu Gateway टैब के नोट्स पढ़ें। राशि या मुद्रा ऑर्डर से मेल नहीं खाती थी, या भुगतान ऑर्डर रद्द होने के बाद आया।

ग्राहक को "Khipu payments are not available right now" दिखता है: API key गायब या गलत है। अपने Khipu खाते में कुंजियाँ जाँचें।

डेवलपर्स के लिए: एक्सटेंशन OpenCart इवेंट wc_khp_supported_currencies (आपके Khipu खाते द्वारा स्वीकार्य मुद्रा जोड़ने के लिए, जैसे Khipu स्पेन के लिए EUR), wc_khp_currency_decimals और wc_khp_payment_data ट्रिगर करता है।

अनइंस्टॉल

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

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

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