VibeFox Klarna for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Klarna satıcı hesabı: bir API bölgesi için satıcı hesabınızın Klarna API kimlik bilgilerine (kullanıcı adı ve şifre) ve Klarna Playground portalından test kimlik bilgilerine ihtiyacınız var (bkz. Yapılandırma). Her API bölgesinin kendi kimlik bilgileri vardır. Mağaza başına yalnızca bir satıcı hesabı (bir API bölgesi) kullanılabilir.

Para birimi: bölgenize ait bir Klarna para birimi: Avrupa'da EUR, SEK, NOK, DKK, GBP, CHF, PLN, CZK, HUF veya RON; Kuzey Amerika'da USD, CAD veya MXN; Okyanusya'da AUD veya NZD. Para birimi System > Localisation > Currencies bölümünde tanımlı olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. Arşivde README.txt, OpenCart 3 paketi wcp_klarna_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_klarna_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_klarna_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin, tür olarak Payments seçin, VibeFox Klarna Payments eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Klarna satıcı hesabınızın API region değerini seçin.

5. Klarna Playground portalındaki test kullanıcı adını ve şifresini girin, Test mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi verin.

6. Klarna Merchant Portal'daki canlı kullanıcı adını ve şifreyi girin, Test mode seçeneğini kapatın ve siparişlerin ne zaman tahsil edileceğini seçin (varsayılan: sipariş kargoya verildiğinde veya tamamlandığında).

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_klarna_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

2. Paket, aynı sayfada kurulu uzantıların listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin, tür olarak Payments seçin, VibeFox Klarna Payments eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, API region değerini, kimlik bilgilerini ve tahsilat modunu OpenCart 3 için 3 ila 6. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Bildirimler).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar. Bildirim URL'si her Klarna siparişiyle birlikte gönderilir, bu nedenle Klarna tarafında herhangi bir ayar yapmanız gerekmez.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa TEST MODE: Klarna playground, no real payments. veya LIVE: real Klarna payments. ifadesini gösterir. Etkin modun kullanıcı adı veya şifresi eksikse (bu durumda Klarna ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi seçilen API bölgesinde Klarna tarafından desteklenmiyorsa sizi uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve API bölgesi, tahsilat modu, coğrafi bölge ve sipariş durumları geçerli olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Eksik kimlik bilgileri kaydetmeyi engellemez.

Klarna Payments

Enable/Disable: ödeme yöntemini açar veya kapatır. Varsayılan: kapalı. Klarna, yalnızca etkin modun kullanıcı adı ve şifresi doldurulduğunda ve müşterinin fatura ülkesi API bölgesinin bir Klarna pazarı olduğunda, o ülkenin para biriminde ödeme yapılacak şekilde ödeme sayfasında gösterilir.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Klarna. Zorunlu.

Description: Confirm Order adımında, Klarna widget'ının üstünde müşteriye gösterilen metin. Varsayılan: Pay now, later or in instalments with Klarna.

Sort Order: Klarna'nın ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Klarna'yı yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: Klarna'nın sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için Klarna sunmak istiyorsanız boş bırakın.

API kimlik bilgileri

Klarna API kimlik bilgileri (kullanıcı adı ve şifre), Klarna Merchant Portal'da Settings > Klarna API credentials altında oluşturulur (bölümün bağlantıları orada yer alır). Test kimlik bilgileri Playground portalından gelir: biri Avrupa, biri Kuzey Amerika ve Okyanusya içindir. Her API bölgesinin kendi kimlik bilgileri vardır.

Test mode: Klarna Playground ortamını kullanır (test kimlik bilgileri, gerçek ödeme yok). Varsayılan: açık. Test modu açıkken müşteriler Confirm Order adımında TEST MODE: Klarna playground, no real payment is made. ifadesini görür. Siparişler verildikleri ortamı korur: Playground siparişlerinin tahsilatları ve iadeleri her zaman test kimlik bilgilerini kullanır.

API region: Klarna satıcı hesabınızın bölgesi. Müşteriler Klarna ile yalnızca bu bölgedeki ülkelerden, kendi ülkelerinin para biriminde ödeme yapabilir. Ülke, siparişin ödeme adresinden alınır.

Live username (UID): canlı API kullanıcı adı, örneğin PK12345_abcdef012345.

Live password: canlı API şifresi (paylaşılan gizli anahtar).

Test username (UID): Playground API kullanıcı adı.

Test password: Playground API şifresi (paylaşılan gizli anahtar).

Kaydedilmiş şifreler bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kaydedilmiş bir şifreyi kaldırmak için alanın altındaki Clear the saved password on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Sipariş yönetimi

Verilen bir Klarna siparişi bir ön otorizasyondur: müşteriden yalnızca sipariş tahsil edildiğinde ücret alınır. Tahsil edilmeyen ön otorizasyonlar, genellikle 28 gün sonra sona erer; bu nedenle siparişleri zamanında gönderin veya otomatik tahsilatı kullanın.

Capture: müşterinin ne zaman ücretlendirildiği. İadeler yalnızca tahsil edilen tutarlar için yapılabilir.

Cancellation: tahsil edilmemiş bir sipariş aşağıdaki Canceled Status durumuna ayarlandığında Klarna siparişini iptal eder (ön otorizasyonu serbest bırakır). Varsayılan: açık.

Sipariş durumları

OpenCart siparişi Confirm Order adımında durum olmadan oluşturur (eksik sipariş). Sipariş, Klarna widget'ında onaylanan satın alma için Klarna siparişini oluşturduktan sonra bir durum alır. Klarna'nın onaylamadığı bir satın alma, siparişi durumsuz bırakır ve müşteri Confirm Order adımında kalır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Klarna satın almayı kabul etti (dolandırıcılık durumu ACCEPTED). Tutar, Capture ayarına göre ön otorize edilir ve tahsil edilir. Varsayılan: Processing.

Awaiting Fraud Review Status: Klarna siparişi PENDING (dolandırıcılık incelemesi) olarak oluşturdu. Klarna'nın bildirimi siparişi kabul edene kadar göndermeyin; sipariş otomatik olarak güncellenir. Varsayılan: Pending.

On Hold Status: Klarna beklenmeyen bir dolandırıcılık durumu döndürdü veya Klarna'nın bildirdiği tutar ya da para birimi siparişle eşleşmedi. Bir not neyin kontrol edilmesi gerektiğini açıklar. Varsayılan: Pending.

Payment Error Status: Klarna, dolandırıcılık incelemesinden sonra satın almayı reddetti veya durdurdu. Siparişi göndermeyin. Varsayılan: Failed.

Canceled Status: tahsil edilmemiş bir siparişi bu duruma ayarlamak Klarna siparişini iptal eder (bkz. Cancellation). Klarna'nın Klarna siparişini iptal edildi, süresi doldu veya kapatıldı olarak bildirmesi de bu durumu ayarlar. Varsayılan: Canceled.

Refunded Status: tahsil edilen tutar, sipariş sayfasındaki Klarna sekmesinden tamamen iade edildi. Kısmi iadeler yalnızca bir not ekler. Varsayılan: Refunded.

OpenCart'ın dolandırıcılık incelemesi veya beklemedeki bir ödeme için kendi durumları yoktur. Bunları System > Localisation > Order Statuses bölümünde oluşturup buradan seçebilirsiniz.

Bildirimler

Klarna, dolandırıcılık incelemesinin sonucunu (beklemede olarak oluşturulan siparişler) Notification URL bölümünde gösterilen adrese bildirir. OpenCart 3'te adres şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_klarna_payment/notification, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_klarna_payment/payment/wcp_klarna_payment.notification biçimindedir. URL her siparişle otomatik olarak gönderilir, bu nedenle Klarna tarafında yapılandırılacak bir şey yoktur. Bildirim içeriğine asla güvenilmez: her bildirim, siparişin verildiği ortamın ve bölgenin kimlik bilgileriyle Klarna Order Management API üzerinden doğrulanır ve Klarna siparişi bu sipariş numarasına atıfta bulunmalıdır. Eklenti, Klarna'nın bildirdiklerine göre işlem yapar:

Siparişi iptal ettikten veya iade ettikten sonra Klarna bir satın almayı kabul ederse sipariş yeniden açılmaz ve Klarna ön otorizasyonu serbest bırakılır. Bildirim, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti, bildirimin ve müşterinin Klarna'dan dönüşünün geçmesine izin veren bir başlangıç eylemi ekler.

Gelişmiş

Debug log: API çağrılarını ve ödeme olaylarını OpenCart günlük klasöründe (storage/logs) bulunan wc_kl_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Günlük hiçbir zaman kimlik bilgilerini, yetkilendirme belirteçlerini veya müşteri verilerini içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa eklentiyi kaldırdığınızda ağ geçidi ayarları, günlük ve geçici widget oturumları silinir. Sipariş verileri (Klarna sipariş kimlikleri, iadeler) her zaman korunur. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Şifreler dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kaydedilmiş şifreler korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Klarna). OpenCart siparişi Confirm Order adımında, hâlâ durum olmadan oluşturur. Bu adımda müşteri Klarna rozetini, açıklamanızı ve Klarna widget'ını görür. Eklenti, bu siparişten sunucuda bir Klarna oturumu oluşturur: seçenekleriyle birlikte ürünler, hediye kartları, kargo, kupon, voucher ve ödül puanı indirimleri, vergiler ve adresler. Widget'ta müşteri, Klarna'nın sunduğuna göre hemen öde, sonra öde veya taksitle öde seçeneğini belirler. Müşteri Confirm Order düğmesine tıkladığında Klarna satın almayı widget'ta onaylar ve eklenti, OpenCart siparişinin verileriyle Klarna siparişini sunucu tarafında oluşturur. Klarna siparişi, OpenCart sipariş numarasını satıcı referansı olarak taşır.

OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer. Klarna widget'ı bu durumda ödeme sayfasının altındaki sipariş onay bloğunda, Confirm Order düğmesinin üstünde görünür. OpenCart 4'te hediye sertifikası yoktur, bu nedenle Klarna'ya gönderilmez. OpenCart 4 varsayılan olarak ödeme adresi sormaz; bu durumda eklenti, teslimat adresini ödeme adresi, ülkesini de satın alma ülkesi olarak kullanır.

Sonuç, Klarna'nın dolandırıcılık durumuna bağlıdır:

Klarna siparişi kabul edemezse müşteri, kısa bir mesajla Confirm Order adımında kalır; örneğin 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. veya ön otorizasyonun süresi dolmuşsa "Confirm Order" düğmesine yeniden tıklama isteği. Ayrıntılar günlüğe yazılır ve sipariş bir not alır. Müşterinin ülkesi ve para birimi, bölgenizdeki bir Klarna pazarıyla eşleşmiyorsa müşteri Klarna is not available for your billing country and currency. Please choose another payment method. mesajını görür.

Çift tıklama, sayfayı yenileme veya aynı sepeti ikinci bir tarayıcı sekmesinde ödeme, asla ikinci bir Klarna siparişi oluşturmaz (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 siparişi günceller, bu nedenle reddedilen bir satın almadan sonra müşteri aynı siparişi öder). Klarna satın almayı onayladı ama sipariş durumu ayarlanamadıysa müşteri Your Klarna purchase was approved, but the order could not be completed automatically. Please contact us — do not pay again. mesajını görür. Bir sonraki deneme veya Klarna'nın bildirimi, yeni bir ön otorizasyon olmadan durumu kayıtlı Klarna siparişinden ayarlar. Sepetteki bir değişiklik, yeni adet dahil, kendi ödemesi gereken yeni bir sepet sayılır.

OpenCart 4'te sipariş, başarı sayfası gösterilene kadar ödeme sayfasında tutulur. Bu arada sipariş ödenmeden kapatıldıysa (örneğin siz iptal ettiniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir. Sipariş zaten verilmişse ve sepet değiştiyse mesaj Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. şeklindedir. Her iki durumda da bir sonraki Confirm Order işlemi sepetin yeni bir siparişini öder. Bu mesajlar ödeme sayfasının üstünde gösterilir.

Eklentide Klarna Checkout (KCO, ödeme sayfasının tamamen değiştirilmesi), Klarna Express Checkout düğmeleri, On-site messaging veya Sign in with Klarna yoktur; abonelik veya kayıtlı ödeme yöntemleri ve sipariş satırı bazında kısmi tahsilat da yoktur. Sipariş verildikten sonra bir siparişi düzenlediğinizde sipariş satırları Klarna'ya yeniden gönderilmez.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Klarna ön otorizasyonunu tamamlamadı veya Klarna satın almayı reddetti. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (default Processing): Klarna satın almayı kabul etti. Bir not, Klarna sipariş kimliğini ve tahsilatın ne zaman yapılacağını gösterir.

Awaiting Fraud Review Status (default Pending): satın alma, Klarna'nın dolandırıcılık incelemesini bekliyor. Klarna'nın bildirimi siparişi Order Status After Payment, Payment Error Status veya Canceled Status durumuna taşır.

On Hold Status (default Pending): Klarna beklenmeyen bir dolandırıcılık durumu döndürdü veya Klarna'nın bildirdiği tutar ya da para birimi siparişle eşleşmedi. Not bunu açıklar. Siparişi Klarna Merchant Portal'da kontrol edin.

Payment Error Status (default Failed): Klarna, dolandırıcılık incelemesinden sonra satın almayı reddetti veya durdurdu. Siparişi göndermeyin.

Canceled Status (default Canceled): siparişi siz iptal ettiniz veya Klarna, Klarna siparişinin iptal edildiğini, süresinin dolduğunu ya da kapatıldığını bildirdi. Cancellation açıkken tahsil edilmemiş bir siparişi iptal etmek Klarna siparişini iptal eder ve ön otorizasyonu serbest bırakır; böylece müşteriden ücret alınmaz. Zaten tahsil edilmiş bir sipariş Klarna'da iptal edilmez: parayı geri vermek için iade edin.

Refunded Status (default Refunded): tahsil edilen tutar, eklenti üzerinden tamamen iade edildi.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır. Klarna kelimesiyle başlarlar.

Capture

When the order is shipped / completed seçeneğiyle, Sales > Orders bölümünde bir siparişin durumunu (Add History) tamamlanmış bir duruma değiştirmek, yeni durum kaydedilmeden önce sipariş toplamını tahsil eder. Klarna tahsilatı reddederse, örneğin siparişi düzenledikten sonra sipariş toplamı hâlâ ön otorize edilen tutarın üzerine çıktıysa, durum değişmez, e-posta gönderilmez ve sipariş sayfası başarı mesajı yerine nedeni gösterir. Bir not, müşterinin ÜCRETLENDİRİLMEDİĞİNİ belirtir. Sorunu giderin ve yeniden denemek için durumu tekrar değiştirin ya da Klarna Merchant Portal'da tahsil edip Capture ayarını manuel olarak değiştirin. Başarılı bir tahsilat, tahsil edilen tutar ve tahsilat kimliğiyle bir not ekler. Yeni bir siparişin ilk durumu ve bir tamamlanmış durumdan başka bir tamamlanmış duruma geçiş tahsilat yapmaz. Eklenti kurulu olduğu sürece, kapalı olsa bile tahsilatlar ve iptaller çalışmaya devam eder. OpenCart 4.1'de reddedilen durum değişikliği nedenini sipariş sayfasında da gösterir; OpenCart 4.0.x'te durum yine değişmez, ancak neden yalnızca sipariş geçmişindeki notta gösterilir.

VibeFox Klarna Payments sekmesi

Sales > Orders bölümünde Klarna ile ödenmiş bir sipariş açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Klarna Payments sekmesi; ortam ve bölgesiyle birlikte Klarna sipariş kimliğini, test siparişleri için Playground etiketini, dolandırıcılık durumunu ve Klarna durumunu, Authorized tutarını, Captured / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Klarna notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Klarna Payments sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Klarna düğmesine tıklayın. Refund this amount through Klarna? This cannot be undone. sorusunu onaylayın. Tahsil edilen tutarlar için tam ve kısmi iadeler desteklenir; Klarna'nın tahsil edilmiş olarak bildirdiği tutardan daha önce iade edilmiş tutarı düşerek bulunan sınıra kadar. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups bölümünde ayarlanır). İade, siparişin verildiği ortama ve bölgeye gönderilir; bu nedenle o ortamın kimlik bilgileri ayarlanmış olmalıdır. Klarna iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Klarna iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna ayarlar; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. Yeniden denenen bir iade asla iki kez yapılmaz.

Henüz tahsil edilmemiş bir sipariş iade edilemez: ön otorizasyonu serbest bırakmak için bunun yerine iptal edin. Capture manuel olarak ayarlıysa, mağaza Klarna Merchant Portal'da neyi tahsil ettiğinizi bilmez. Bu durumda iade formu boş tutarla gösterilir ve Klarna, gönderdiğinizde tutarı kontrol eder.

Sales > Returns bölümündeki ürün iadeleri Klarna üzerinden para geri göndermez. Klarna Merchant Portal'da yapılan iadeler sekmeye eklenmez, ancak Klarna'nın hâlâ iade etmeye izin verdiği tutara dahil edilir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Klarna Payments lisans bloğu, Extensions > Extensions > Payments > VibeFox Klarna Payments > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: opencart-payment-klarna satırı ve hesabınızda vibefox.net'i açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresini değiştirdikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Klarna müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu nedenle etkin anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: Klarna bildirimleri işlenmeye devam eder ve siparişler hâlâ tahsil edilebilir, iptal edilebilir ve iade edilebilir.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Klarna ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve etkin modun kimlik bilgilerinin doldurulduğunu kontrol edin: test modunda test kullanıcı adı ve şifresi, canlı modda canlı kimlik bilgileri. Eksik olduklarında ayarlar sayfası bir uyarı gösterir. Müşterinin ödeme ülkesi, API region bölgenizin bir Klarna ülkesi olmalı ve o ülkenin para biriminde ödeme yapılmalıdır (örneğin İsveç'teki bir müşteri SEK ile ödemelidir). Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti ancak sipariş Awaiting Fraud Review Status durumunda kaldı: satın alma Klarna'nın dolandırıcılık incelemesini bekliyor ve Klarna'nın bildirimi geldiğinde sipariş güncellenir. Mağazanızın ayarlarda gösterilen Notification URL adresinden Klarna isteklerini alabildiğini ve siparişin verildiği ortamın kimlik bilgilerinin hâlâ girili olduğunu kontrol edin. Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın.

Bildirim Not configured yanıtı veriyor: siparişin verildiği ortamın (test veya canlı) kimlik bilgileri eksik olduğundan bildirim doğrulanamıyor. Bunları girin. Klarna bildirimi yeniden deneyecektir.

Bildirim Verification failed yanıtı veriyor: Klarna siparişi Order Management API'den okunamadı. Klarna bildirimi yeniden deneyecektir.

Bildirim Busy yanıtı veriyor: sipariş tam o sırada başka bir istek tarafından güncelleniyordu. Klarna bildirimi yeniden deneyecektir.

Bildirim mismatch_ref veya Unknown order yanıtı veriyor: Klarna siparişi bu siparişe atıfta bulunmuyor veya eklenti onu tanımıyor. Sipariş değiştirilmez.

Widget yüklenmiyor: müşteri Klarna could not be loaded. Please try again or choose another payment method. veya Klarna is not available for this purchase. mesajını görür. Etkin modun kimlik bilgilerini ve müşterinin ülkesini ve para birimini kontrol edin.

Complete veya Shipped durumuna geçiş reddediliyor: Klarna tahsilatı başarısız oldu. Nedeni sipariş sayfasında veya notta okuyun. Sipariş toplamı hâlâ ön otorize edilen tutardan fazlasını gerektiriyor olabilir, Klarna siparişi henüz kabul etmemiş olabilir veya ön otorizasyonun süresi dolmuş olabilir. Sorunu giderin ve durumu yeniden değiştirin ya da Klarna Merchant Portal'da tahsil edin.

İade başarısız oluyor: sekmedeki mesajı okuyun. Sipariş henüz tahsil edilmemiş olabilir (bunun yerine iptal edin), tutar hâlâ iade edilebilir tutarı aşıyor olabilir veya siparişin ortamının kimlik bilgileri eksik olabilir.

Sekmede iade formu yok: sekme nedenini belirtir: henüz hiçbir şey tahsil edilmedi, tahsil edilen tutarın tamamı iade edildi veya kullanıcı grubunuzun eklentiyi değiştirme izni yok.

Müşteri This order is already being paid mesajını görüyor: aynı satın alma için başka bir istek çalışıyor, örneğin çift tıklama. Kısa bir süre bekleyin ve siparişin bir durum alıp almadığını kontrol edin.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Klarna Payments yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Order statuses bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayları da kaldırılır, bu nedenle durum değişiklikleri artık Klarna siparişlerini tahsil etmez veya iptal etmez (OpenCart 4'te ayrıca bakım modunda bildirimin ve müşterinin Klarna'dan dönüşünün geçmesini sağlayan başlangıç eylemi de). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, API bölgesi, kimlik bilgileri, tahsilat, iptal, günlük kaydı), günlük ve geçici widget oturumları kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Klarna siparişleri ve iadeleri her zaman korunur, bu nedenle önceden verilen siparişler yeniden kurulumdan sonra da tahsil edilebilir ve iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklentinin dosyalarını da silmek için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox Klarna Payments yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

Klarna, sahibinin ticari markasıdır. Bu eklenti Klarna ile bağlantılı değildir ve Klarna tarafından onaylanmamıştır.