VibeFox Klarna for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder.

Klarna satıcı hesabı: bir API bölgesi için satıcı hesabınızın API kimlik bilgilerine (kullanıcı adı ve şifre) ve Klarna test ortamı portalından test kimlik bilgilerine ihtiyacınız vardır (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ölgenizdeki 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.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Klarna Payments modülünü bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğundaki License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Klarna satıcı hesabınızın API region bölgesini seçin.

5. Klarna test ortamı 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 etkinleştirin, 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ş gönderildiğinde).

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Klarna fraud review ve Klarna payment on hold. Bunların hiçbiri ödenmiş sayılmaz ve e-posta göndermez. PrestaShop, tüm para birimleri, ülkeleri ve müşteri gruplarına yönelik yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Klarna Payments > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanları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 adımında gizlenir) ve mağazanın varsayılan para birimi seçilen API bölgesinde Klarna tarafından satılmıyorsa uyarır.

Klarna Payments

Enable/Disable: Enable Klarna Payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

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

Description: müşteriye Klarna widget'ının üzerinde gösterilen metin. Varsayılan: Pay now, later or in instalments with Klarna.

API kimlik bilgileri

Klarna API kimlik bilgileri (kullanıcı adı ve şifre), Klarna Merchant Portal (portal.klarna.com) üzerinde Settings > Klarna API credentials altında oluşturulur. Test kimlik bilgileri playground portalından alınır: Avrupa için playground.eu.portal.klarna.com, Kuzey Amerika ve Okyanusya için playground.us.portal.klarna.com.

Test mode: Klarna test ortamını kullanır (test kimlik bilgileri, gerçek ödeme yok). Varsayılan: açık. Test modu açıkken müşteri, ödeme yönteminin altında TEST MODE: Klarna playground, no real payment is made. ifadesini görür. Siparişler verildikleri ortamı korur: test 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, o ülkenin para biriminde ödeme yapabilir. Ülke, sepetin fatura adresinden alınır.

Europe: Avusturya, Belçika, Finlandiya, Fransa, Almanya, Yunanistan, İrlanda, İtalya, Hollanda, Portekiz, Slovakya ve İspanya (EUR), İsveç (SEK), Norveç (NOK), Danimarka (DKK), Birleşik Krallık (GBP), İsviçre (CHF), Polonya (PLN), Çekya (CZK), Macaristan (HUF), Romanya (RON). Varsayılan.

North America (US, CA, MX): Amerika Birleşik Devletleri (USD), Kanada (CAD), Meksika (MXN).

Oceania (AU, NZ): Avustralya (AUD), Yeni Zelanda (NZD).

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

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

Test username (UID): test ortamının API kullanıcı adı.

Test password: test ortamının API şifresi (paylaşılan gizli anahtar).

Kaydedilmiş şifreler bir daha 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.

Clear saved passwords: bir şifreyi işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan, kayıtlı değeri korur.

Sipariş yönetimi

Verilen bir Klarna siparişi bir yetkilendirmedir: müşteri yalnızca sipariş tahsil edildiğinde ücretlendirilir. Tahsil edilmeyen yetkilendirmeler genellikle 28 gün sonra sona erer; bu yüzden siparişleri zamanında gönderin veya otomatik tahsilatı kullanın.

Capture: müşterinin ne zaman ücretlendirileceği. İadeler yalnızca tahsil edilen tutarlar için mümkündür.

When the order is shipped (recommended): siparişi Shipped veya Delivered gibi bir gönderim durumuna aldığınızda tahsil eder (varsayılan). Tahsil edilen tutar, sipariş toplamından daha önce tahsil edilenin çıkarılmasıyla bulunur ve hâlâ yetkili olan tutardan fazla olamaz. Tahsilat başarısız olursa sipariş durumu değişmez ve neden sipariş sayfasında gösterilir.

Immediately (auto capture): müşteriyi hemen ücretlendirir; dijital ürünler veya hizmetler için.

Manually in the Klarna portal: modül tahsilat yapmaz. Siparişi Klarna Merchant Portal üzerinden tahsil edin.

Cancellation: Cancel the Klarna order (release the authorization) when a not yet captured order is Cancelled. Varsayılan: açık.

Bildirimler

Klarna, dolandırıcılık incelemesinin sonucunu (“pending” olarak verilen siparişler), Notification URL altında gösterilen adrese bildirir. Dostu URL'lerle şu biçimde görünür: https://your-shop/module/wcp_klarna_payment/notification; isteğe bağlı olarak /en/ gibi bir dil koduyla birlikte. URL her siparişle otomatik olarak gönderilir, bu nedenle Klarna tarafında ayarlanacak bir şey yoktur. Bildirim içeriğine asla güvenilmez: her bildirim, siparişin verildiği ortam ve bölgenin kimlik bilgileriyle Klarna Order Management API üzerinden doğrulanır ve Klarna siparişi bu mağazanın sepetine atıfta bulunmalıdır. Modül, Klarna'nın bildirdiklerine göre işlem yapar:

ACCEPTED: Klarna satın almayı kabul etti. Tutar ve para birimi kontrolünden sonra sipariş ödendi olarak işaretlenir.

REJECTED or STOPPED: satın alma dolandırıcılık incelemesini geçemedi. Sipariş Payment error durumuna geçer.

Klarna order CANCELLED, EXPIRED or CLOSED: müşteri ücretlendirilmedi. Sipariş iptal edilir.

Siparişi iptal ettikten veya iade ettikten sonra Klarna bir satın almayı kabul ederse, sipariş yeniden açılmaz ve Klarna yetkilendirmesi serbest bırakılır. Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Gelişmiş

Debug log: API çağrılarını ve ödeme olaylarını modül klasöründeki logs/wc_kl_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Günlük hiçbir zaman kimlik bilgisi, yetkilendirme belirteci veya müşteri verisi içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını, ayrıca temizlemek için bir düğme ile birlikte gösterir.

Uninstall: modül kaldırıldığında modül ayarlarını ve günlüğü siler. Sipariş verileri (Klarna sipariş kimlikleri, iadeler) her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Klarna, Klarna rozetiyle) ve Klarna widget'ı ödeme adımının içinde yüklenir. Modül, Klarna oturumunu sunucuda sepetten oluşturur. Widget'ta müşteri, Klarna'nın sunduğu şekilde hemen öde, sonra öde veya taksit seçeneklerinden birini seçer. Müşteri siparişi verdiğinde, Klarna oturumu önce son sepetle güncellenir ve Klarna satın almayı widget içinde yetkilendirir. Ardından modül, sepetin sipariş satırları, toplamları ve adresleriyle Klarna siparişini sunucu tarafında oluşturur. Sepet indirimleri Klarna'ya ayrı bir satır olarak gönderilir. Klarna yanıt verene kadar sipariş mevcut değildir.

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

ACCEPTED: sipariş Payment accepted olarak oluşturulur ve müşteri standart sipariş onay sayfasını görür. Para yetkilendirilir ve Capture ayarına göre tahsil edilir.

PENDING: sipariş, Klarna'nın bildirimi gelene kadar Awaiting Klarna fraud review olarak oluşturulur. Bunu önce göndermeyin.

REJECTED: sipariş oluşturulmaz. Müşteri Klarna could not approve this purchase. Please choose another payment method. mesajıyla ödeme adımında kalır.

Klarna siparişi kabul edemezse, müşteri ödeme adımında kısa bir mesajla 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 yetkilendirmenin süresi dolduysa "Place order" düğmesine yeniden tıklama isteği. Ayrıntılar günlüğe yazılır. Müşterinin ülkesi ve para birimi, mağazanızın bölgesindeki 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, aynı sepet için hiçbir zaman ikinci bir Klarna siparişi oluşturmaz. Klarna yanıt verirken sepet değişirse, örneğin başka bir tarayıcı sekmesinde, sipariş bir notla birlikte Klarna payment on hold olarak oluşturulur. Klarna satın almayı onayladı ama sipariş oluşturulamadı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, kaydedilmiş Klarna siparişinden yeni bir yetkilendirme olmadan siparişi oluşturur.

Klarna Merchant Portal'daki Klarna siparişi, sepet numarasını satıcı referansı olarak taşır; çünkü PrestaShop siparişi verildiğinde henüz mevcut değildir.

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

Siparişler ve iadeler

Order statuses

No order yet: müşteri Klarna yetkilendirmesini tamamlamadı veya Klarna satın almayı reddetti. Yalnızca sepet mevcuttur.

Payment accepted: Klarna satın almayı kabul etti. Ödeme, Klarna sipariş kimliği işlem kimliği olarak kaydedilir ve özel bir not, Klarna sipariş kimliğini ve ne zaman tahsil edileceğini gösterir.

Awaiting Klarna fraud review: satın alma, Klarna'nın dolandırıcılık incelemesini bekliyor. Klarna'nın bildirimi siparişi Payment accepted, Payment error veya Canceled durumuna taşır.

Klarna payment on hold: 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: Klarna, dolandırıcılık incelemesinden sonra satın almayı reddetti veya durdurdu. Siparişi göndermeyin.

Canceled: siparişi siz iptal ettiniz veya Klarna, Klarna siparişinin iptal edildiğini, süresinin dolduğunu ya da kapandığını bildirdi. Cancellation açıkken, henüz tahsil edilmemiş bir siparişin iptal edilmesi Klarna siparişini de iptal eder ve yetkilendirmeyi serbest bırakır; böylece müşteri ücretlendirilmez. Zaten tahsil edilmiş bir sipariş Klarna'da iptal edilmez: parayı geri vermek için iade edin.

Refunded: tahsil edilen tutar modül üzerinden tamamen iade edildi.

Capture

When the order is shipped seçeneğinde, siparişi bir gönderim durumuna almak, yeni durum kaydedilmeden önce sipariş toplamını tahsil eder. Klarna tahsilatı reddederse, örneğin düzenlemeden sonra sipariş toplamı yetkili tutarın üzerine çıktığı için, sipariş durumu değişmez, e-posta gönderilmez ve neden sipariş sayfasında ve bir notta gösterilir: müşteri ÜCRETLENDİRİLMEDİ. Sorunu giderin ve yeniden denemek için durumu tekrar değiştirin ya da Klarna Merchant Portal'da tahsil edin ve Capture ayarını manuel yapın. PrestaShop 8'de üretim modunda yönetim paneli durumu yine de kaydedebilir; bu durumda modül bunun yerine bir notla birlikte Klarna payment on hold ayarlar, böylece sipariş hiçbir zaman tahsilat olmadan gönderilmiş gibi görünmez. Başarılı bir tahsilat, tahsil edilen tutar ve tahsilat kimliğiyle birlikte bir not ekler.

Klarna payment bloğu

Sipariş sayfasında, Klarna sipariş kimliği, ortamı ve bölgesi, test siparişleri için bir Playground rozeti, dolandırıcılık ve Klarna durumu, yetkilendirilen tutar, tahsil edilen ve iade edilen tutarlar ile iade geçmişini içeren bir Klarna payment bloğu gösterilir.

İadeler

Klarna payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden 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 tutarın, daha önce iade edilenler düşülmüş hali ile sınırlıdır. Siparişleri düzenleme yetkisine sahip olmanız gerekir; modüllere erişim gerekmez. İade, siparişin verildiği ortama ve bölgeye gönderilir, bu nedenle o ortamın kimlik bilgileri girilmiş olmalıdır. Klarna iadeyi kabul etmezse, blok 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 Refunded durumuna getirir; kısmi iade durumu değiştirmez. Yeniden denenen bir iade hiçbir zaman iki kez yapılmaz.

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

Modül kredi notları oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Klarna üzerinden para geri göndermez. Klarna Merchant Portal'da yapılan iadeler bloğa eklenmez, ancak Klarna'nın hâlâ iade etmeye izin verdiği tutara dahil edilir.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Klarna Payments lisans bloğu, Modules > Module Manager > VibeFox Klarna Payments > Configure sayfasında, ayarların üstünde ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-klarna satırı ile Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül, son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: çok mağazalı bir kurulumda da ana mağazanın alan adında. Anahtarı mağazadan kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Klarna, ödeme adımında müşterilere 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. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu yüzden ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: Klarna bildirimleri işlenmeye devam eder ve siparişler hâlâ tahsil edilebilir, iptal edilebilir ve iade edilebilir.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Klarna ödeme adımı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ı olanlar. Ayarlar sayfası, eksik olduklarında bir uyarı gösterir. Müşterinin fatura ülkesi, API region bölgenizdeki bir Klarna ülkesi olmalı ve müşteri o ülkenin para biriminde ödeme yapmalıdır (örneğin İsveç'ten bir müşteri SEK ile ödemelidir). Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı, ancak sipariş Awaiting Klarna fraud review 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 modül 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 dener.

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

Bildirim Busy yanıtı veriyor: sipariş, aynı anda başka bir istek tarafından güncelleniyordu. Klarna bildirimi yeniden dener.

Bildirim mismatch_ref veya Unknown order yanıtı veriyor: Klarna siparişi bu mağazanın sepetine atıfta bulunmuyor veya modül 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 ülkesi ile para birimini kontrol edin.

Shipped durumuna geçiş reddediliyor: Klarna tahsilatı başarısız oldu. Nedeni Klarna payment bloğunda veya notta okuyun. Sipariş toplamı hâlâ yetkili olandan fazlasını gerektiriyor olabilir, Klarna siparişi henüz kabul edilmemiş olabilir ya da yetkilendirmenin süresi dolmuş olabilir. Sorunu giderin ve durumu yeniden değiştirin veya Klarna Merchant Portal'da tahsil edin.

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

Müşteri This order is already being paid mesajını görüyor: aynı sepet için başka bir istek çalışıyor, örneğin çift tıklama. Bir an bekleyin ve siparişin oluşturulup oluşturulmadığını kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Klarna Payments yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Advanced bölümünde Uninstall açıksa, modül ayarları, günlük ve geçici widget oturumları kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için tüm ayarlar korunur. Klarna siparişleri ve iadeleri ile Awaiting Klarna fraud review ve Klarna payment on hold sipariş durumları her zaman korunur; böylece önceden verilen siparişler yeniden kurulumdan sonra da tahsil edilip iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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