VibeFox Klarna for OpenCart — सहायता

आवश्यकताएँ

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

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

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

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

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. Klarna Playground पोर्टल से परीक्षण का उपयोगकर्ता नाम और पासवर्ड डालें, Test mode को चालू रहने दें, Enable/Disable चालू करें, Save पर क्लिक करें और एक परीक्षण ऑर्डर दें।

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

OpenCart 4

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

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

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

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

नया इंस्टॉल भुगतान विधि बंद और टेस्ट मोड चालू के साथ शुरू होता है। हर Klarna ऑर्डर के साथ नोटिफ़िकेशन URL भेजा जाता है, इसलिए Klarna में कुछ भी कॉन्फ़िगर करने की ज़रूरत नहीं है।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं; सूची के नीचे का Save बटन पूरा पेज सेव करता है। सेटिंग्स के ऊपर पेज TEST MODE: Klarna playground, no real payments. या LIVE: real Klarna payments. दिखाता है। यदि सक्रिय मोड का उपयोगकर्ता नाम या पासवर्ड गायब है (तब चेकआउट में Klarna छिपा रहता है), या चुने हुए API रीजन में Klarna स्टोर की डिफ़ॉल्ट मुद्रा नहीं बेचता, तो पेज चेतावनी देता है। एक्सटेंशन बदलने का अधिकार न होने पर पेज सेटिंग्स दिखाता है, पर उन्हें सेव नहीं कर सकता।

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

Klarna भुगतान

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

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

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

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

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

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

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

Klarna API क्रेडेंशियल (उपयोगकर्ता नाम और पासवर्ड) Klarna Merchant Portal में Settings > Klarna API credentials के अंतर्गत बनाए जाते हैं (वहाँ सेक्शन के लिंक हैं)। परीक्षण क्रेडेंशियल Playground पोर्टल से आते हैं: एक यूरोप के लिए, एक उत्तर अमेरिका और ओशिनिया के लिए। हर API रीजन के अपने क्रेडेंशियल होते हैं।

Test mode: Klarna Playground वातावरण का उपयोग करता है (परीक्षण क्रेडेंशियल, कोई वास्तविक भुगतान नहीं)। डिफ़ॉल्ट: चालू। टेस्ट मोड चालू होने पर ग्राहक Confirm Order चरण में TEST MODE: Klarna playground, no real payment is made. देखते हैं। ऑर्डर उसी वातावरण को रखते हैं जिसमें वे दिए गए थे: Playground ऑर्डर की कैप्चर और रिफ़ंड हमेशा परीक्षण क्रेडेंशियल का उपयोग करते हैं।

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

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

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

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

Test password: Playground API पासवर्ड (साझा गुप्त कुंजी)।

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

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

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

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

Cancellation: जब बिना कैप्चर किया गया ऑर्डर नीचे दिए Canceled Status पर सेट होता है, तो Klarna ऑर्डर रद्द करता है (प्राधिकरण छोड़ता है)। डिफ़ॉल्ट: चालू।

ऑर्डर स्टेटस

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

Order Status After Payment: Klarna ने खरीद स्वीकार की (धोखाधड़ी स्टेटस ACCEPTED)। राशि Capture के अनुसार प्राधिकृत और कैप्चर होती है। डिफ़ॉल्ट: Processing।

Awaiting Fraud Review Status: Klarna ने ऑर्डर को PENDING (धोखाधड़ी समीक्षा) के रूप में दर्ज किया है। Klarna की सूचना के स्वीकार करने तक इसे न भेजें; ऑर्डर अपने-आप अपडेट होगा। डिफ़ॉल्ट: Pending।

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

Payment Error Status: धोखाधड़ी समीक्षा के बाद Klarna ने खरीद को अस्वीकार या रोक दिया। ऑर्डर न भेजें। डिफ़ॉल्ट: Failed।

Canceled Status: बिना कैप्चर किए ऑर्डर को इस स्टेटस पर सेट करने से Klarna ऑर्डर रद्द होता है (देखें Cancellation)। जब Klarna Klarna ऑर्डर को रद्द, समाप्त या बंद बताता है, तब भी यह स्टेटस सेट होता है। डिफ़ॉल्ट: Canceled।

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

OpenCart में धोखाधड़ी समीक्षा या रोके गए भुगतान के लिए अपने स्टेटस नहीं हैं। आप इन्हें System > Localisation > Order Statuses में बना सकते हैं और यहाँ चुन सकते हैं।

सूचनाएँ

Klarna धोखाधड़ी समीक्षा का परिणाम (लंबित के रूप में दर्ज ऑर्डर) Notification URL में दिखाए गए पते पर भेजता है। OpenCart 3 पर यह कुछ इस तरह दिखता है: https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification, OpenCart 4 पर https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification जैसा। यह URL हर ऑर्डर के साथ अपने-आप भेजा जाता है, इसलिए Klarna में कुछ भी कॉन्फ़िगर नहीं करना है। सूचना का मुख्य भाग कभी भरोसेमंद नहीं माना जाता: हर सूचना को उसी वातावरण और रीजन के क्रेडेंशियल के साथ Klarna Order Management API से सत्यापित किया जाता है जिसमें ऑर्डर दिया गया था, और Klarna ऑर्डर को इस ऑर्डर नंबर का संदर्भ देना होगा। एक्सटेंशन वही करता है जो Klarna बताता है:

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

उन्नत

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

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

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

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

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

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

चेकआउट

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

OpenCart 4 में ग्राहक Payment method options विंडो में, भुगतान विधि ब्लॉक के Choose बटन से भुगतान विधि चुनता है। इसके बाद Klarna विजेट चेकआउट पेज के नीचे, ऑर्डर पुष्टि ब्लॉक में, Confirm Order बटन के ऊपर दिखता है। OpenCart 4 में गिफ़्ट सर्टिफ़िकेट नहीं हैं, इसलिए वे Klarna को नहीं भेजे जाते। डिफ़ॉल्ट रूप से OpenCart 4 भुगतान पता नहीं माँगता; तब एक्सटेंशन शिपिंग पते को बिलिंग पते और उसके देश को खरीद के देश के रूप में इस्तेमाल करता है।

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

यदि Klarna ऑर्डर स्वीकार नहीं कर सकता, तो ग्राहक एक छोटे संदेश के साथ Confirm Order चरण पर रहता है, जैसे 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., या प्राधिकरण समाप्त होने पर "Confirm Order" फिर से क्लिक करने का अनुरोध। विवरण लॉग में लिखे जाते हैं और ऑर्डर पर नोट लगता है। यदि ग्राहक का देश और मुद्रा आपके क्षेत्र के किसी Klarna बाज़ार से मेल नहीं खाते, तो ग्राहक Klarna is not available for your billing country and currency. Please choose another payment method. देखता है।

दो बार क्लिक करने, पेज रीलोड करने या उसी कार्ट का दूसरे ब्राउज़र टैब में भुगतान करने से कभी दूसरा Klarna ऑर्डर नहीं बनता (OpenCart 3 हर बार जब Confirm Order चरण दिखाया जाता है, नया ऑर्डर बनाता है; OpenCart 4 चेकआउट के ऑर्डर को अपडेट करता है, इसलिए रद्द हुई खरीद के बाद ग्राहक वही ऑर्डर चुकाता है)। यदि Klarna ने खरीद स्वीकृत की है, पर ऑर्डर स्टेटस सेट नहीं हो सका, तो ग्राहक Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. देखता है। अगला प्रयास या Klarna की सूचना बिना नए प्राधिकरण के सहेजे गए Klarna ऑर्डर से स्टेटस सेट करती है। कार्ट में बदलाव, नई मात्रा सहित, एक नए कार्ट के रूप में गिना जाता है जिसे अपने भुगतान की ज़रूरत है।

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

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

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

ऑर्डर स्टेटस

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

Order Status After Payment (default Processing): Klarna ने खरीद स्वीकार की। एक नोट में Klarna ऑर्डर ID और यह दिखता है कि वह कब कैप्चर होगा।

Awaiting Fraud Review Status (default Pending): खरीद Klarna की धोखाधड़ी समीक्षा की प्रतीक्षा में है। Klarna की सूचना ऑर्डर को Order Status After Payment, Payment Error Status या Canceled Status पर ले जाती है।

On Hold Status (default Pending): Klarna ने एक अनपेक्षित धोखाधड़ी स्टेटस लौटाया, या Klarna द्वारा बताई गई राशि या मुद्रा ऑर्डर से मेल नहीं खाई। नोट इसे समझाता है। Klarna Merchant Portal में ऑर्डर जाँचें।

Payment Error Status (default Failed): धोखाधड़ी समीक्षा के बाद Klarna ने खरीद अस्वीकार या रोक दी। ऑर्डर न भेजें।

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

Refunded Status (default Refunded): कैप्चर की गई राशि एक्सटेंशन के माध्यम से पूरी तरह वापस कर दी गई।

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

Capture

When the order is shipped / completed के साथ, Sales > Orders में ऑर्डर का स्टेटस (Add History के माध्यम से) किसी पूर्ण स्टेटस में बदलने पर नया स्टेटस सेव होने से पहले ऑर्डर का कुल योग कैप्चर होता है। यदि Klarna कैप्चर से इनकार करता है, उदाहरण के लिए ऑर्डर संपादित करने के बाद कुल योग उस राशि से ऊपर चला गया जो अभी भी प्राधिकृत है, तो स्टेटस नहीं बदलता, कोई ईमेल नहीं जाता, और ऑर्डर पेज सफलता संदेश के बजाय कारण दिखाता है। एक नोट बताता है कि ग्राहक से शुल्क नहीं लिया गया है। समस्या ठीक करें और पुनः प्रयास के लिए स्टेटस फिर से बदलें, या Klarna Merchant Portal में कैप्चर करें और Capture को मैन्युअल पर बदलें। सफल कैप्चर कैप्चर की गई राशि और कैप्चर ID के साथ एक नोट जोड़ता है। नए ऑर्डर का पहला स्टेटस, और एक पूर्ण स्टेटस से दूसरे पूर्ण स्टेटस में बदलना, कैप्चर नहीं करता। एक्सटेंशन इंस्टॉल रहने तक, बंद होने पर भी, कैप्चर और रद्दीकरण काम करते रहते हैं। OpenCart 4.1 पर अस्वीकृत स्टेटस बदलाव का कारण ऑर्डर पेज पर भी दिखता है; OpenCart 4.0.x पर स्टेटस फिर भी अस्वीकार होता है, पर कारण केवल ऑर्डर इतिहास के नोट में दिखता है।

VibeFox Klarna Payments टैब

Sales > Orders में Klarna से भुगतान किया गया ऑर्डर खोलें। ऑर्डर पेज के नीचे, History और Additional के बगल में, VibeFox Klarna Payments टैब में वातावरण और रीजन के साथ Klarna ऑर्डर ID, परीक्षण ऑर्डर के लिए Playground लेबल, धोखाधड़ी स्टेटस और Klarna स्टेटस, Authorized राशि, Captured / refunded राशियाँ, रिफ़ंड फ़ॉर्म, रिफ़ंड इतिहास और ऑर्डर के Klarna notes दिखते हैं। यह टैब उन उपयोगकर्ताओं को दिखता है जिनकी एक्सटेंशन तक पहुँच है।

रिफ़ंड

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

जो ऑर्डर अभी कैप्चर नहीं हुआ है, उसका रिफ़ंड नहीं हो सकता: इसके बजाय उसे रद्द करें ताकि प्राधिकरण छूट जाए। Capture मैन्युअल पर होने पर स्टोर को नहीं पता होता कि आपने Klarna Merchant Portal में क्या कैप्चर किया है। तब रिफ़ंड फ़ॉर्म खाली राशि के साथ दिखता है, और सबमिट करने पर Klarna राशि की जाँच करता है।

Sales > Returns में उत्पाद वापसी से Klarna के माध्यम से पैसा वापस नहीं जाता। Klarna Merchant Portal में किए गए रिफ़ंड टैब में नहीं जुड़ते, पर वे उस राशि में गिने जाते हैं जिसे Klarna अभी भी रिफ़ंड करने देता है।

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

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

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

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

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

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

भुगतान हो गया, लेकिन ऑर्डर Awaiting Fraud Review Status में रहता है: खरीद Klarna की धोखाधड़ी समीक्षा की प्रतीक्षा में है, और Klarna की सूचना आने पर ऑर्डर अपडेट होगा। जाँचें कि आपका स्टोर सेटिंग्स में दिए गए Notification URL पर Klarna के अनुरोध प्राप्त कर सकता है, और जिस वातावरण में ऑर्डर दिया गया था उसके क्रेडेंशियल अब भी भरे हुए हैं। Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

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

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

सूचना Busy उत्तर देती है: उसी समय कोई और अनुरोध ऑर्डर को अपडेट कर रहा था। Klarna सूचना फिर से भेजेगा।

सूचना mismatch_ref या Unknown order उत्तर देती है: Klarna ऑर्डर इस ऑर्डर का संदर्भ नहीं देता, या एक्सटेंशन उसे नहीं पहचानता। ऑर्डर नहीं बदला जाता।

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

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

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

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

ग्राहक को This order is already being paid दिखता है: उसी खरीद के लिए कोई और अनुरोध चल रहा है, उदाहरण के लिए डबल क्लिक। थोड़ी देर रुकें और जाँचें कि ऑर्डर को कोई स्टेटस मिला या नहीं।

अनइंस्टॉल

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

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

Klarna उसके मालिक का ट्रेडमार्क है। यह एक्सटेंशन Klarna से संबद्ध नहीं है और Klarna द्वारा अनुमोदित नहीं है।