VibeFox Culqi for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

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

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

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से wcp_culqi_payment फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

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

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

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

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

6. Enable/Disable चालू करें। परीक्षण के दौरान Test Mode चालू रखें, फिर असली भुगतान लेने के लिए उसका चेक हटा दें।

7. सुनिश्चित करें कि स्टोर की मुद्रा PEN या USD है।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Culqi। टेस्ट मोड चालू होने पर पेज फ़ील्ड के ऊपर Test mode is active: the integration keys are used and no real money is charged. दिखाता है। जब गेटवे चालू हो लेकिन मौजूदा मोड की कुंजियाँ न हों, और जब स्टोर की मुद्रा Culqi द्वारा समर्थित न हो, तब पेज आपको चेतावनी देता है। दोनों स्थितियों में भुगतान विधि चेकआउट पर छिपा दी जाती है। भुगतान विधियों की सूची में, जब तक मौजूदा मोड की दोनों कुंजियाँ सेट नहीं हो जातीं, Culqi को सेटअप की आवश्यकता वाला चिह्नित किया जाता है।

सामान्य

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

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

Description: चेकआउट पर भुगतान विधि के नीचे दिखाया जाने वाला टेक्स्ट। डिफ़ॉल्ट: Pay securely with your credit/debit card or Yape via Culqi।

API कुंजियाँ

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

Test Mode: Use the Culqi integration (test) environment। चालू होने पर टेस्ट कुंजियाँ (pk_test_ / sk_test_) उपयोग होती हैं और कोई असली पैसा चार्ज नहीं होता। डिफ़ॉल्ट: चालू। लाइव कुंजियों से असली भुगतान लेने के लिए इसका चेक हटा दें।

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

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

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

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

यदि आप संस्करण 1.0 से अपडेट करते हैं, तो उस संस्करण की एकल कुंजी-जोड़ी उपसर्ग के आधार पर टेस्ट या लाइव फ़ील्ड में चली जाती है। अपडेट के बाद कुंजियाँ जाँच लें।

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

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

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

उन्नत

Debug log: Log API requests and payment steps विवरण WooCommerce > Status > Logs में, स्रोत wcp_culqi_payment के साथ लिखता है। त्रुटियाँ हमेशा लॉग की जाती हैं। कुंजियाँ, कार्ड का डेटा और ग्राहक का विवरण कभी लॉग नहीं किए जाते। डिफ़ॉल्ट: बंद।

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

चेकआउट

ग्राहक भुगतान विधि चुनता है (डिफ़ॉल्ट रूप से Credit/Debit Card or Yape (Culqi)) और ऑर्डर देने वाले बटन पर क्लिक करता है। Culqi Checkout पॉपअप उसी पेज पर आपके स्टोर के नाम, ऑर्डर के कुल और मुद्रा के साथ खुलता है। वहाँ ग्राहक कार्ड का विवरण दर्ज करता है या Yape से भुगतान करता है। टेस्ट मोड चालू होने पर भुगतान विधि TEST MODE: No real charges will be made. दिखाती है।

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

यदि बैंक को 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. दिखता है।

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

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

प्लगइन केवल कार्ड और Yape से एकमुश्त भुगतान लेता है, जो तुरंत कैप्चर होते हैं। इसमें PagoEfectivo या CIP कोड, बैंक ऐप, एजेंट, वॉलेट या Cuotéalo नहीं हैं; सेव किए गए कार्ड, सब्सक्रिप्शन या किस्तें नहीं हैं; Culqi वेबहुक नहीं हैं; और अलग से ऑथराइज़ व कैप्चर की सुविधा नहीं है।

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

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

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

Processing: भुगतान की पुष्टि हो गई (WooCommerce का डिफ़ॉल्ट; केवल वर्चुअल डाउनलोड योग्य उत्पादों वाले ऑर्डर पूर्ण हो जाते हैं)। ऑर्डर नोट में Culqi चार्ज ID, मोड (टेस्ट या लाइव) और यह दिखता है कि 3-D Secure इस्तेमाल हुआ या नहीं। ट्रांज़ैक्शन ID ही Culqi चार्ज ID है।

On hold: Culqi ने ऐसा चार्ज बताया जिसकी राशि या मुद्रा ऑर्डर से मेल नहीं खाती, या ऐसा भुगतान जो ऑथराइज़ हुआ लेकिन कैप्चर नहीं हुआ। ऑर्डर नोट इसे समझाता है और चार्ज ID दिखाता है। CulqiPanel में चार्ज जाँचें और ऑर्डर को मैन्युअल रूप से पूरा करें या रिफ़ंड करें।

Failed: कार्ड अस्वीकृत हुआ। ऑर्डर नोट में कारण, अस्वीकृति कोड और चार्ज ID दिखती है। ग्राहक दूसरे कार्ड से फिर भुगतान कर सकता है।

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

रिफ़ंड

ऑर्डर खोलें, Refund पर क्लिक करें, राशि दर्ज करें और Refund via Culqi पर क्लिक करें। पूर्ण और आंशिक रिफ़ंड समर्थित हैं। रिफ़ंड उस मोड (टेस्ट या लाइव) की कुंजियों से भेजा जाता है जिसमें भुगतान किया गया था, भले ही आपने तब से मोड बदल दिया हो, इसलिए उस मोड की गोपनीय कुंजी सेट होनी चाहिए। यदि Culqi रिफ़ंड स्वीकार नहीं करता, तो WooCommerce त्रुटि दिखाता है और कोई रिफ़ंड दर्ज नहीं होता। सफल रिफ़ंड ऑर्डर नोट्स में Culqi रिफ़ंड ID, राशि और कारण के साथ जुड़ जाता है।

CulqiPanel में किए गए रिफ़ंड वापस WooCommerce से सिंक नहीं होते। ज़रूरत हो तो WooCommerce में Refund via Culqi के बिना मैन्युअल रिफ़ंड बनाएँ।

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

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

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

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

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

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

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

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

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

कुंजी सेव नहीं होती: त्रुटि बताती है कि फ़ील्ड किसी उपसर्ग से शुरू होना चाहिए, उदाहरण के लिए 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 की स्क्रिप्ट आपके चेकआउट पेज पर, उदाहरण के लिए किसी ऑप्टिमाइज़ेशन प्लगइन द्वारा, ब्लॉक नहीं हैं।

ग्राहक को This order is already being paid दिखता है: उसी ऑर्डर का एक और भुगतान अनुरोध उसी क्षण चल रहा था। ग्राहक को प्रतीक्षा करनी चाहिए और फिर से प्रयास करने से पहले ईमेल देखना चाहिए।

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

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

डेवलपर्स के लिए, प्लगइन के दस्तावेज़ में फ़िल्टर culqi_p_supported_currencies, culqi_p_charge_data, culqi_p_icon और culqi_p_lock_timeout सूचीबद्ध हैं।

अनइंस्टॉल

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

Culqi अपने संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Culqi से संबद्ध नहीं है और न ही Culqi द्वारा अनुमोदित है।