VibeFox Culqi for OpenCart — सहायता

आवश्यकताएँ

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

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

स्टोर की मुद्रा: पेरू का सोल (PEN) या अमेरिकी डॉलर (USD) आपके स्टोर में सक्षम मुद्रा होनी चाहिए। Culqi कोई अन्य मुद्रा स्वीकार नहीं करता, और भुगतान विधि केवल तभी दिखाई देती है जब ग्राहक PEN या USD में भुगतान करता है।

Culqi खाता: आपको अपने Culqi खाते की सार्वजनिक कुंजी (public key) और गुप्त कुंजी (secret key) चाहिए। इंटीग्रेशन (टेस्ट) कुंजियाँ integ-panel.culqi.com से, और प्रोडक्शन (लाइव) कुंजियाँ mipanel.culqi.com से, CulqiPanel > Desarrollo > API Keys में मिलती हैं। सार्वजनिक कुंजी ब्राउज़र में Culqi पॉपअप द्वारा उपयोग की जाती है। गुप्त कुंजी केवल आपके सर्वर पर उपयोग होती है और कभी ब्राउज़र को नहीं भेजी जाती। वेबहुक की आवश्यकता नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

4. इंटीग्रेशन कुंजियाँ चिपकाएँ और वास्तविक भुगतान के लिए प्रोडक्शन कुंजियाँ चिपकाएँ (देखें कॉन्फ़िगरेशन)।

5. Enable/Disable चालू करें और Save पर क्लिक करें। परीक्षण के दौरान Test Mode चालू रखें, और वास्तविक भुगतान लेने के लिए उसे बंद कर दें।

OpenCart 4

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

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

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

4. लाइसेंस कुंजी और Culqi की कुंजियाँ वैसे ही दर्ज करें जैसे OpenCart 3 के चरण 3 से 5 में हैं। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।

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

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Culqi Payment > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर, टेस्ट मोड चालू होने पर पेज Test mode is active: the integration keys are used and no real money is charged. दिखाता है। जब गेटवे सक्षम हो पर वर्तमान मोड की कुंजियाँ गायब हों, या किसी भी सक्षम स्टोर मुद्रा को Culqi समर्थित न करता हो, तब यह चेतावनी देता है। दोनों ही स्थितियों में चेकआउट पर भुगतान विधि छिप जाती है। यदि आपकी डिफ़ॉल्ट मुद्रा PEN या USD नहीं है, तो पेज बताता है कि Culqi केवल तभी दिया जाता है जब ग्राहक समर्थित मुद्रा में भुगतान करता है। एक्सटेंशन को संशोधित करने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

सेव करते समय, गलत मान सेव नहीं होता और अपना पिछला मान रखता है, जबकि बाकी फ़ील्ड सेव हो जाते हैं। पेज ऐसे हर फ़ील्ड के लिए त्रुटि दिखाता है: गलत प्रीफ़िक्स वाली कुंजी (जैसे Live Secret Key must start with sk_live_ — the previous value was kept.), खाली या 128 अक्षरों से लंबा Title, पूर्ण संख्या न होने वाला Sort Order, 0 या उससे अधिक संख्या न होने वाला Total, या कोई ऐसा geo zone या ऑर्डर स्टेटस जो मौजूद नहीं है।

Culqi

Enable/Disable: Enable Culqi Payment Gateway भुगतान विधि को चालू या बंद करता है। डिफ़ॉल्ट: बंद।

Title: चेकआउट पर ग्राहक को दिखने वाला भुगतान विधि का नाम। ऑर्डर में सेव होने वाला भुगतान विधि नाम भी यही है। डिफ़ॉल्ट: Credit/Debit Card or Yape (Culqi)। आवश्यक, अधिकतम 128 अक्षर।

Description: Confirm Order चरण में पुष्टि बटन के ऊपर ग्राहक को दिखने वाला पाठ। डिफ़ॉल्ट: Pay securely with your credit/debit card or Yape via Culqi.

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

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

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

API कुंजियाँ

CulqiPanel > Desarrollo > API Keys से कुंजियाँ कॉपी करें: इंटीग्रेशन (टेस्ट) कुंजियाँ integ-panel.culqi.com पर, और प्रोडक्शन कुंजियाँ mipanel.culqi.com पर (पेज में उनके लिंक हैं)। टेस्ट मोड केवल टेस्ट कुंजियाँ उपयोग करता है, और लाइव मोड केवल लाइव कुंजियाँ। हर कुंजी अपने फ़ील्ड के प्रीफ़िक्स से शुरू होनी चाहिए।

Test Mode: चालू होने पर टेस्ट कुंजियाँ (pk_test_ / sk_test_) उपयोग होती हैं और कोई वास्तविक राशि नहीं ली जाती। डिफ़ॉल्ट: चालू। लाइव कुंजियों से वास्तविक भुगतान लेने के लिए इसे बंद करें। चालू रहने पर ग्राहक Confirm Order चरण पर TEST MODE: No real charges will be made. देखते हैं।

Test Public Key: इंटीग्रेशन वातावरण की सार्वजनिक कुंजी। यह pk_test_ से शुरू होती है।

Test Secret Key: इंटीग्रेशन वातावरण की गुप्त कुंजी। यह sk_test_ से शुरू होती है और कभी ब्राउज़र के साथ साझा नहीं होती।

Live Public Key: प्रोडक्शन वातावरण की सार्वजनिक कुंजी। यह pk_live_ से शुरू होती है।

Live Secret Key: प्रोडक्शन वातावरण की गुप्त कुंजी। यह sk_live_ से शुरू होती है और कभी ब्राउज़र के साथ साझा नहीं होती।

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

भुगतान विधियाँ

कार्ड हमेशा दिए जाते हैं। बैंक ट्रांसफ़र, एजेंट, वॉलेट और Cuotéalo के लिए Culqi Orders API चाहिए और यह एक्सटेंशन इन्हें नहीं देता।

Yape: Offer Yape in the Culqi popup Culqi विंडो में कार्ड के साथ Yape दिखाता है। डिफ़ॉल्ट: चालू।

ऑर्डर

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

Order Status After Payment: Culqi ने शुल्क की पुष्टि की है और उसकी राशि व मुद्रा ऑर्डर से मेल खाती है। डिफ़ॉल्ट: Processing।

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

Refunded Status: ऑर्डर पेज से भुगतान पूरी तरह रिफ़ंड किया गया। आंशिक रिफ़ंड केवल एक नोट जोड़ते हैं। डिफ़ॉल्ट: Refunded।

उन्नत

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

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

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

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

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

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

चेकआउट

Payment Method चरण पर ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card or Yape (Culqi))। Confirm Order चरण पर ग्राहक आपका विवरण देखता है, और OpenCart ऑर्डर बनाता है, जो अभी भी बिना स्टेटस के होता है। जब ग्राहक Confirm Order पर क्लिक करता है, तो उसी पेज पर Culqi Checkout पॉपअप खुलता है, जिसमें आपके स्टोर का नाम, ऑर्डर की कुल राशि और मुद्रा दिखती है। वहाँ ग्राहक कार्ड विवरण दर्ज करता है या Yape से भुगतान करता है। Culqi की स्क्रिप्ट हमेशा Culqi से लोड होती हैं। OpenCart 4 पर ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है, और चेकआउट पेज के नीचे के कन्फ़र्म ब्लॉक में Confirm Order पर क्लिक करता है। यदि स्टोर भुगतान पता नहीं माँगता (OpenCart 4 का डिफ़ॉल्ट), तो शुल्क के साथ भेजे गए ग्राहक विवरण डिलीवरी पते और ग्राहक के नाम से लिए जाते हैं।

Culqi भुगतान डेटा को एक बार उपयोग होने वाले टोकन में बदल देता है, और केवल वही टोकन आपके स्टोर को भेजा जाता है। आपका सर्वर Culqi Charges API से ऑर्डर मुद्रा में ऑर्डर की कुल राशि के लिए चार्ज बनाता है, जो तुरंत कैप्चर होता है। यह चार्ज CulqiPanel में Order, ऑर्डर नंबर और ग्राहक के ईमेल के साथ दिखता है। ऑर्डर तभी भुगतान किया हुआ चिह्नित होता है जब Culqi पुष्टि करे। इसके बाद ऑर्डर OpenCart के मानक तरीके से स्टेटस पाता है, सामान्य ऑर्डर ईमेल और स्टॉक अपडेट होते हैं, और ग्राहक OpenCart का ऑर्डर सफलता पेज देखता है।

यदि बैंक 3-D Secure माँगता है, तो ग्राहक को Your bank requires additional verification (3-D Secure). Please complete it in the window that opens. दिखता है। प्रमाणीकरण के बाद चार्ज अपने-आप फिर से भेजा जाता है। यदि सत्यापन पूरा नहीं होता, तो ग्राहक को The 3-D Secure verification was not completed. Please try again or use another card. दिखता है।

यदि कार्ड अस्वीकृत होता है, तो ग्राहक को Payment failed: के बाद Culqi का संदेश दिखता है, और वह उसी चरण पर दूसरे कार्ड से फिर प्रयास कर सकता है। यदि Culqi उत्तर नहीं देता, तो ग्राहक को We could not confirm your payment with Culqi. Please check your email or contact us before trying again. दिखता है। इन मामलों में ऑर्डर बिना स्टेटस के रहता है, और ऑर्डर इतिहास का एक नोट प्रयास दर्ज करता है। यदि ग्राहक Culqi विंडो बंद कर देता है, तो कोई राशि नहीं ली जाती और Confirm Order बटन फिर से क्लिक किया जा सकता है। इन सभी स्थितियों में कार्ट सुरक्षित रहता है।

किसी ऑर्डर का दोबारा चार्ज कभी नहीं होता। यदि उसी ऑर्डर का भुगतान चल रहा हो और ग्राहक फिर से सबमिट करता है, तो उसे This order is already being paid. Please wait a moment and check your email before trying again. दिखता है। यदि Culqi ने राशि ले ली हो, पर ऑर्डर स्टेटस सेट नहीं हो सका, तो ग्राहक को Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. दिखता है। चार्ज सुरक्षित रहता है, और उसी कार्ट के साथ अगला प्रयास उसी के आधार पर ऑर्डर स्टेटस सेट करता है, बिना नया चार्ज किए। कार्ट एक ही बार भुगतान होता है: यदि उसी कार्ट का कोई और ऑर्डर (OpenCart 3 हर बार Confirm Order चरण दिखाए जाने पर नया ऑर्डर बनाता है) पहले से भुगतान किया हुआ है, तो ग्राहक सफलता पेज पर जाता है और उसे दोबारा चार्ज नहीं किया जाता। OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और उसे अपडेट करता है, इसलिए कार्ड अस्वीकृत होने के बाद ग्राहक उसी ऑर्डर का भुगतान करता है।

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

यह एक्सटेंशन केवल एक-बार के कार्ड और Yape भुगतान लेता है, जो तुरंत कैप्चर होते हैं। इसमें बैंक ऐप, एजेंट, वॉलेट या Cuotéalo नहीं हैं, सेव किए गए कार्ड, सदस्यताएँ या किस्तें नहीं हैं, Culqi वेबहुक नहीं हैं, और अलग से authorize व capture नहीं है।

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

ऑर्डर स्टेटस

No status (missing order): ग्राहक ने अभी भुगतान नहीं किया, कार्ड अस्वीकृत हुआ, या Culqi ने उत्तर नहीं दिया। Sales > Orders में ऐसे ऑर्डर केवल तभी दिखते हैं जब Order Status फ़िल्टर को Missing Orders पर सेट किया गया हो। ऑर्डर इतिहास के नोट विफल प्रयासों को समझाते हैं।

Order Status After Payment (default Processing): चार्ज की पुष्टि हो गई और वह ऑर्डर से मेल खाता है। एक नोट Culqi payment successful दिखाता है, साथ में मोड (टेस्ट या लाइव), उपयोग किया गया 3-D Secure (यदि हो), और Culqi चार्ज ID (chr_...)।

On Hold (Review) Status (default Pending): Culqi ने ऐसा चार्ज बताया जिसकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या ऐसा भुगतान जो authorize हुआ पर capture नहीं हुआ। नोट इसे समझाता है और चार्ज ID दिखाता है। CulqiPanel में चार्ज जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

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

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

VibeFox Culqi Payment टैब

Sales > Orders में Culqi से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Culqi Payment टैब टेस्ट भुगतानों के लिए Test लेबल के साथ Charge ID, उपयोग किए गए 3-D Secure सहित चार्ज की गई Amount, होल्ड पर चल रहे ऑर्डरों के लिए Review संकेत, Paid / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Culqi notes दिखाता है। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

Sales > Returns में उत्पाद वापसी Culqi के माध्यम से पैसे वापस नहीं भेजती। CulqiPanel में किए गए रिफ़ंड OpenCart में सिंक नहीं होते। ज़रूरत होने पर ऑर्डर को मैन्युअली अपडेट करें।

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

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

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

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

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

भुगतान हो गया, लेकिन ऑर्डर बिना स्टेटस के रहा: एक्सटेंशन वेबहुक का उपयोग नहीं करता। चार्ज की पुष्टि केवल Culqi के आपके सर्वर को दिए उत्तर से होती है। यदि Culqi ने समय पर उत्तर नहीं दिया, तो ऑर्डर पर Culqi did not confirm the charge नोट लगता है। CulqiPanel में इस ऑर्डर का चार्ज खोजें। यदि ग्राहक ने देखा कि ऑर्डर पूरा नहीं हो सका, तो उसी ग्राहक सत्र में अगला भुगतान प्रयास बिना दोबारा चार्ज किए स्टेटस सेट कर देता है।

भुगतान के बाद ऑर्डर समीक्षा स्टेटस में है: VibeFox Culqi Payment टैब के नोट पढ़ें। चार्ज की गई राशि या मुद्रा ऑर्डर से अलग थी, या भुगतान कैप्चर नहीं हुआ था। CulqiPanel में चार्ज जाँचें, फिर ऑर्डर पूरा करें या भुगतान रिफ़ंड करें।

कुंजी सेव नहीं होती: त्रुटि बताती है कि फ़ील्ड को किसी प्रीफ़िक्स से शुरू होना चाहिए, जैसे sk_live_। हर फ़ील्ड केवल अपने प्रकार और मोड की कुंजियाँ स्वीकार करता है: pk_test_, sk_test_, pk_live_ या sk_live_।

ग्राहक को Payment gateway misconfiguration. Please contact the store owner. दिखता है: वर्तमान मोड की कुंजियाँ गायब हैं, या Culqi ने गुप्त कुंजी अस्वीकार कर दी। सेटिंग्स में कुंजियाँ जाँचें।

ग्राहक को Payment token is invalid. Please try again. दिखता है: Culqi विंडो का टोकन दूसरे मोड का है, जैसे चेकआउट पेज खुले रहते हुए Test Mode बदलने के बाद। ग्राहक को पेज रीलोड करके फिर से भुगतान करना चाहिए।

Culqi विंडो नहीं खुलती: ग्राहक को The Culqi payment window could not be loaded. Please reload the page and try again. दिखता है। जाँचें कि आपके चेकआउट पेज पर js.culqi.com और 3ds.culqi.com की स्क्रिप्ट किसी कैश या ऑप्टिमाइज़ेशन एक्सटेंशन द्वारा ब्लॉक तो नहीं हो रहीं।

ग्राहक को Security check failed. Please reload the page and try again. दिखता है: चेकआउट पेज किसी दूसरे सत्र में खुला था। पेज रीलोड करने से यह ठीक हो जाता है।

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

कार्ड अस्वीकृत हुआ और आपको कारण चाहिए: ऑर्डर का नोट या एक्सटेंशन पेज पर Log फ़ील्ड पढ़ें। अस्वीकृतियाँ Culqi के decline कोड के साथ दर्ज होती हैं, भले ही Debug log बंद हो।

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

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

अनइंस्टॉल

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

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

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