VibeFox Klarna for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

HTTPS: Klarna वास्तविक भुगतान के लिए HTTPS की आवश्यकता रखता है।

Klarna मर्चेंट खाता: आपको एक API क्षेत्र के लिए अपने मर्चेंट खाते के Klarna API क्रेडेंशियल (उपयोगकर्ता नाम और पासवर्ड) और Klarna टेस्ट पोर्टल के टेस्ट क्रेडेंशियल (देखें Configuration) चाहिए। हर API क्षेत्र के अपने क्रेडेंशियल होते हैं। हर स्टोर के लिए केवल एक मर्चेंट खाता (एक API क्षेत्र) इस्तेमाल किया जा सकता है।

स्टोर मुद्रा: आपके क्षेत्र की एक Klarna मुद्रा: यूरोप में EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF या RON; उत्तरी अमेरिका में USD, CAD या MXN; ओशिनिया में AUD या NZD।

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

इंस्टॉलेशन

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

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

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

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

5. अपने Klarna मर्चेंट खाते का API region चुनें।

6. Klarna टेस्ट पोर्टल का टेस्ट उपयोगकर्ता नाम और पासवर्ड डालें, Test mode चालू रखें, Enable/Disable चालू करें और एक टेस्ट ऑर्डर दें।

7. Klarna Merchant Portal का लाइव उपयोगकर्ता नाम और पासवर्ड डालें, Test mode का निशान हटाएँ और चुनें कि ऑर्डर कब कैप्चर हों (डिफ़ॉल्ट: जब ऑर्डर पूर्ण चिह्नित हो)।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Payments > Klarna Payments। पेज शीर्षक के बगल में TEST MODE या LIVE बैज दिखता है। जब सक्रिय मोड का यूज़रनेम या पासवर्ड नहीं होता (तब Klarna चेकआउट में छिपा रहता है), और जब चुने हुए API क्षेत्र में स्टोर की मुद्रा Klarna द्वारा नहीं बेची जाती, तब पेज चेतावनी देता है। भुगतान तरीकों की सूची में, सक्रिय मोड के क्रेडेंशियल डालने तक Klarna को सेटअप की ज़रूरत वाला दिखाया जाता है, और टेस्ट मोड चालू होने पर टेस्ट मोड बैज दिखता है।

सामान्य

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

Title: वह नाम जो ग्राहक चेकआउट पर भुगतान तरीके के रूप में देखते हैं। डिफ़ॉल्ट: Klarna।

Description: वह पाठ जो ग्राहक Klarna विजेट के ऊपर देखते हैं। डिफ़ॉल्ट: Pay now, later or in instalments with Klarna.

API क्रेडेंशियल

Klarna API क्रेडेंशियल (उपयोगकर्ता नाम और पासवर्ड) Klarna Merchant Portal (portal.klarna.com) में Settings > Klarna API credentials के अंतर्गत बनाए जाते हैं। टेस्ट क्रेडेंशियल टेस्ट पोर्टल से मिलते हैं: यूरोप के लिए playground.eu.portal.klarna.com, उत्तरी अमेरिका और ओशिनिया के लिए playground.us.portal.klarna.com।

Test mode: Use the Klarna playground (test credentials, no real payments)। डिफ़ॉल्ट: चालू। टेस्ट मोड चालू होने पर चेकआउट में TEST MODE: Klarna playground, no real payment is made. दिखता है। ऑर्डर उसी वातावरण में रहते हैं जिसमें वे बनाए गए थे: टेस्ट ऑर्डर के कैप्चर और रिफ़ंड हमेशा टेस्ट क्रेडेंशियल से होते हैं।

API region: आपके Klarna मर्चेंट खाते का क्षेत्र। ग्राहक केवल इसी क्षेत्र के देशों से, अपने देश की मुद्रा में Klarna से भुगतान कर सकते हैं।

Live username (UID): लाइव API उपयोगकर्ता नाम, उदाहरण के लिए PK12345_abcdef012345।

Live password: लाइव API पासवर्ड (साझा गोपनीय कुंजी)।

Test username (UID): टेस्ट API उपयोगकर्ता नाम।

Test password: टेस्ट API पासवर्ड (साझा गोपनीय कुंजी)।

ऑर्डर प्रबंधन

किया गया Klarna ऑर्डर एक अधिकरण है: ग्राहक से तभी शुल्क लिया जाता है जब ऑर्डर कैप्चर होता है। बिना कैप्चर किए अधिकरण आमतौर पर 28 दिन बाद समाप्त हो जाते हैं, इसलिए ऑर्डर समय पर पूरा (शिप) करें या ऑटो कैप्चर का उपयोग करें।

Capture: जब ग्राहक से शुल्क लिया जाता है। रिफ़ंड केवल कैप्चर की गई राशियों के लिए संभव हैं। कैप्चर विफल होने पर ऑर्डर नोट के साथ होल्ड पर चला जाता है।

Cancellation: Cancel the Klarna order (release the authorization) when a not yet captured order is Cancelled। डिफ़ॉल्ट: चालू।

सूचनाएँ

Klarna धोखाधड़ी जाँच का परिणाम (जो ऑर्डर "pending" के रूप में दर्ज हुए हैं) इस सेक्शन में दिखाए गए नोटिफ़िकेशन URL पर भेजता है। यह इस तरह दिखता है: https://your-site/wc-api/wc_kl_payment/। यह URL हर ऑर्डर के साथ अपने-आप भेजा जाता है, इसलिए Klarna में कुछ कॉन्फ़िगर करने की ज़रूरत नहीं है। नोटिफ़िकेशन की सामग्री पर कभी भरोसा नहीं किया जाता: हर नोटिफ़िकेशन Klarna Order Management API से सत्यापित होता है, और Klarna ऑर्डर इसी स्टोर के ऑर्डर को संदर्भित करना चाहिए। प्लगइन वही करता है जो Klarna बताता है:

यदि आपने ऑर्डर रद्द या रिफ़ंड करने के बाद Klarna खरीद स्वीकार करता है, तो ऑर्डर फिर से नहीं खुलता और Klarna का अधिकरण जारी कर दिया जाता है।

उन्नत

Debug log: Log API calls and payment events, WooCommerce > Status > Logs में, स्रोत wcp_klarna_payment। त्रुटियाँ हमेशा लॉग होती हैं। लॉग में कभी क्रेडेंशियल या ग्राहक डेटा नहीं होता। डिफ़ॉल्ट: बंद।

Uninstall: Delete the plugin settings and logs when the plugin is deleted। ऑर्डर डेटा (Klarna ऑर्डर ID) हमेशा रखा जाता है। डिफ़ॉल्ट: बंद।

चेकआउट

ग्राहक भुगतान तरीका चुनता है (डिफ़ॉल्ट रूप से Klarna), और Klarna विजेट चेकआउट के भीतर लोड होता है। वहाँ ग्राहक, Klarna द्वारा दिए गए विकल्पों के अनुसार, अभी भुगतान, बाद में भुगतान या किस्तें चुनता है। जब ग्राहक "ऑर्डर दें" पर क्लिक करता है, तो Klarna विजेट में खरीद को अधिकृत करता है। Checkout ब्लॉक में Klarna सत्र पहले अंतिम कार्ट के साथ अपडेट होता है, ताकि बाद में शिपिंग या कुल राशि में बदलाव होने पर Klarna ऑर्डर अस्वीकार न करे। इसके बाद प्लगइन WooCommerce ऑर्डर की ऑर्डर लाइन, कुल राशियों और पतों के साथ सर्वर-साइड पर Klarna ऑर्डर बनाता है।

परिणाम Klarna की धोखाधड़ी स्थिति पर निर्भर करता है:

यदि Klarna ऑर्डर स्वीकार नहीं कर सकता, तो ग्राहक को एक छोटा संदेश दिखता है, जैसे Klarna could not accept this order. Please check your billing details or choose another payment method., Klarna did not respond. Please try again in a moment., या जब अधिकरण समाप्त हो गया हो, तो "ऑर्डर दें" फिर से क्लिक करने का अनुरोध। विवरण ऑर्डर नोट्स और लॉग में जोड़े जाते हैं। यदि ग्राहक का बिलिंग देश और मुद्रा आपके क्षेत्र के किसी Klarna बाज़ार से मेल नहीं खाते, तो ग्राहक को Klarna is not available for your billing country and currency. Please choose another payment method. दिखता है।

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

प्लगइन में Klarna Checkout (KCO, पूरा चेकआउट बदलने वाला), Klarna Express Checkout बटन, On-site messaging या Sign in with Klarna नहीं हैं, और न सदस्यताएँ, सेव किए गए भुगतान तरीके, या ऑर्डर लाइन के अनुसार आंशिक कैप्चर हैं। ऑर्डर दिए जाने के बाद उसे संपादित करने पर ऑर्डर लाइनें Klarna को फिर से नहीं भेजी जातीं।

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

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

Processing or Completed: Klarna ने खरीद स्वीकार कर ली है। WooCommerce भुगतान किए गए ऑर्डर के लिए सामान्य स्थिति सेट करता है। ऑर्डर नोट में Klarna ऑर्डर ID और यह दिखता है कि वह कब कैप्चर होगा। ट्रांज़ैक्शन ID, Klarna ऑर्डर ID है। जब ऑर्डर कैप्चर होता है, तो एक नोट कैप्चर की गई राशि और कैप्चर ID दिखाता है।

On hold: खरीद धोखाधड़ी जाँच के लंबित होने, Klarna द्वारा अप्रत्याशित धोखाधड़ी स्थिति लौटाने, Klarna द्वारा बताई गई राशि या मुद्रा का ऑर्डर से मेल न खाने, या कैप्चर विफल होने के कारण। ऑर्डर नोट बताते हैं कि कौन-सा कारण है।

Failed: Klarna ने धोखाधड़ी जाँच के बाद खरीद अस्वीकार की या रोक दी। ऑर्डर शिप न करें।

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

कैप्चर

When the order is Completed के साथ, ऑर्डर को पूर्ण चिह्नित करने पर ऑर्डर कुल कैप्चर होता है। यदि कैप्चर विफल होता है, जैसे ऑर्डर संपादित करने के बाद ऑर्डर कुल अधिकृत राशि से ऊपर चला गया हो, तो ऑर्डर एक नोट के साथ होल्ड पर चला जाता है कि ग्राहक से शुल्क NOT लिया गया है, और ग्राहक को "पूर्ण हुआ ऑर्डर" ईमेल नहीं मिलता। समस्या ठीक करें और पुनः प्रयास के लिए ऑर्डर को फिर से पूर्ण चिह्नित करें, या Klarna Merchant Portal में कैप्चर करें।

रिफ़ंड

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

जो ऑर्डर अभी तक कैप्चर नहीं हुआ है, उसका रिफ़ंड नहीं हो सकता: अधिकरण जारी करने के लिए उसे रद्द करें। Klarna Merchant Portal में किए गए रिफ़ंड WooCommerce के साथ वापस सिंक नहीं होते।

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

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

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

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

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

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

Klarna checkout पर दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और सक्रिय मोड के क्रेडेंशियल भरे हैं: टेस्ट मोड में टेस्ट यूज़रनेम और पासवर्ड, लाइव मोड में लाइव क्रेडेंशियल। ग्राहक का बिलिंग देश आपके API region का Klarna देश होना चाहिए, और उसे उस देश की मुद्रा में भुगतान करना चाहिए (जैसे स्वीडन का ग्राहक SEK में भुगतान करे)।

भुगतान हो गया, लेकिन ऑर्डर On hold रहता है: खरीद Klarna की धोखाधड़ी जाँच में लंबित है, और Klarna की सूचना आने पर ऑर्डर अपडेट होता है। जाँचें कि आपकी साइट सेटिंग्स में दिखाए गए नोटिफ़िकेशन URL पर Klarna के अनुरोध प्राप्त कर सकती है, और जिस वातावरण में ऑर्डर दिया गया था उसके क्रेडेंशियल अब भी भरे हुए हैं। WooCommerce > Status > Logs देखें, स्रोत wcp_klarna_payment।

नोटिफ़िकेशन का उत्तर Not configured है: जिस वातावरण (टेस्ट या लाइव) में ऑर्डर दिया गया था, उसके क्रेडेंशियल नहीं हैं, इसलिए नोटिफ़िकेशन सत्यापित नहीं हो सकता। उन्हें भरें।

नोटिफ़िकेशन का उत्तर Verification failed है: Order Management API से Klarna ऑर्डर पढ़ा नहीं जा सका। Klarna नोटिफ़िकेशन दोबारा भेजता है।

नोटिफ़िकेशन का उत्तर mismatch_ref है: Klarna ऑर्डर इस स्टोर के ऑर्डर को संदर्भित नहीं करता। ऑर्डर नहीं बदला जाता।

विजेट लोड नहीं होता: ग्राहक को Klarna could not be loaded. Please try again or choose another payment method. या Klarna is not available for this purchase. दिखता है। सक्रिय मोड के क्रेडेंशियल और ग्राहक का देश व मुद्रा जाँचें।

कैप्चर विफल, ऑर्डर On hold: ऑर्डर नोट पढ़ें। ऑर्डर कुल अभी भी अधिकृत राशि से अधिक की ज़रूरत हो सकती है, Klarna ऑर्डर अभी स्वीकार न हुआ हो, या अधिकरण समाप्त हो गया हो। समस्या ठीक करें और ऑर्डर को फिर से पूर्ण चिह्नित करें, या Klarna Merchant Portal में कैप्चर करें।

रिफ़ंड विफल: संदेश पढ़ें। ऑर्डर अभी कैप्चर न हुआ हो (उसे रद्द करें), राशि अभी रिफ़ंड योग्य राशि से अधिक हो, या ऑर्डर के वातावरण के क्रेडेंशियल न हों।

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

अनइंस्टॉल

प्लगइन को डीऐक्टिवेट करने पर सारा डेटा रहता है। इसे हटाने के लिए इसे डीऐक्टिवेट करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। गेटवे सेटिंग्स और लॉग (स्रोत wcp_klarna_payment) केवल तभी हटाए जाते हैं जब Uninstall (Delete the plugin settings and logs when the plugin is deleted) चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहते हैं। मौजूदा ऑर्डर अपने भुगतान नोट्स और ट्रांज़ैक्शन ID रखते हैं।

Klarna उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Klarna से संबद्ध नहीं है और न ही Klarna द्वारा समर्थित है।