VibeFox Klarna for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

HTTPS: Klarna, canlı ödemeler için HTTPS gerektirir.

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 test 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.

Mağaza para birimi: bölgenizde 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. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_klarna_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Klarna Payments > Manage ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. Klarna test portalından test kullanıcı adı ve şifresini girin, Test mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın ve bir test siparişi verin.

7. Klarna Merchant Portal'dan canlı kullanıcı adı ve şifresini girin, Test mode seçeneğinin işaretini kaldırın ve siparişlerin ne zaman tahsil edileceğini seçin (varsayılan: sipariş Tamamlandı olarak işaretlendiğinde).

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Klarna Payments. Sayfa başlığının yanında TEST MODE veya LIVE rozeti görünür. Sayfa, etkin modun kullanıcı adı veya şifresi eksik olduğunda (bu durumda Klarna ödeme sayfasında gizlenir) ve mağaza para birimi seçili API bölgesinde Klarna tarafından satılmadığında sizi uyarır. Ödeme yöntemleri listesinde, etkin modun kimlik bilgileri girilene kadar Klarna kurulum gerektiriyor olarak işaretlenir ve test modu açıkken bir test modu rozeti gösterir.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Klarna.

Description: müşterinin Klarna widget'ının üstünde gördüğü 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 test 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: Use the Klarna playground (test credentials, no real payments). Varsayılan: açık. Test modu açıkken ödeme sayfasında TEST MODE: Klarna playground, no real payment is made. gösterilir. Siparişler oluşturuldukları ortamı korur: test siparişlerinin tahsilat 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ölgenin ülkelerinden, kendi ülkelerinin para biriminde ödeme yapabilir.

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 API kullanıcı adı.

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

Sipariş yönetimi

Yerleştirilmiş 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 nedenle siparişleri zamanında tamamlayın (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. Tahsilat başarısız olursa sipariş bir notla Beklemede durumuna geçer.

When the order is Completed (recommended): siparişi Tamamlandı olarak işaretleyerek gönderimde tahsilat (varsayılan). Tahsil edilen tutar, sipariş toplamı eksi daha önce tahsil edilen tutardır ve hâlâ yetkilendirilmiş tutarı aşamaz.

Immediately (auto capture): dijital ürünler veya hizmetler için müşteriden hemen ücret alır.

Manually in the Klarna portal: eklenti tahsilat yapmaz. Siparişi Klarna Merchant Portal'da 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 yerleştirilen siparişler) bu bölümde gösterilen bildirim URL'sine iletir. Şu biçimdedir: https://your-site/wc-api/wc_kl_payment/. URL her siparişle otomatik olarak gönderilir, bu yüzden Klarna'da yapılandırılacak bir şey yoktur. Bildirim içeriğine asla güvenilmez: her bildirim Klarna Order Management API ile doğrulanır ve Klarna siparişi bu mağaza siparişine işaret etmelidir. Eklenti, Klarna'nın bildirdiklerine göre işlem yapar:

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

REJECTED or STOPPED: satın alma dolandırıcılık incelemesini geçemedi. Sipariş Başarısız olur.

Klarna order CANCELLED, EXPIRED or CLOSED: müşteriden ücret alınmadı. Sipariş iptal edilir.

Siz 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.

Gelişmiş

Debug log: Log API calls and payment events, WooCommerce > Status > Logs altında, kaynak wcp_klarna_payment. Hatalar her zaman kaydedilir. Günlükler kimlik bilgilerini veya müşteri verilerini asla içermez. Varsayılan: kapalı.

Uninstall: Delete the plugin settings and logs when the plugin is deleted. Sipariş verileri (Klarna sipariş kimlikleri) her zaman saklanır. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Klarna) ve Klarna widget'ı ödeme sayfasının içinde yüklenir. Müşteri orada, Klarna'nın sunduğu şekilde hemen, sonra veya taksitle ödemeyi seçer. Müşteri "Siparişi ver" düğmesine tıkladığında Klarna satın almayı widget içinde yetkilendirir. Ödeme bloğunda Klarna oturumu önce son sepetle güncellenir; böylece sonradan yapılan kargo veya toplam değişiklikleri Klarna'nın siparişi reddetmesine yol açmaz. Ardından eklenti, WooCommerce siparişinin sipariş satırları, toplamları ve adresleriyle Klarna siparişini sunucu tarafında oluşturur.

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

ACCEPTED: sipariş hemen ödenmiş olarak işaretlenir ve müşteri Sipariş alındı sayfasına gider. Tutar yetkilendirilmiştir ve Capture ayarına göre tahsil edilir.

PENDING: Klarna'nın bildirimi gelene kadar sipariş Beklemede durumuna alınır. Önce göndermeyin.

REJECTED: sipariş Başarısız olur ve müşteri Klarna could not approve this purchase. Please choose another payment method. mesajını görür.

Klarna siparişi kabul edemezse müşteri kısa bir mesaj görü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 "Siparişi ver" düğmesine yeniden tıklama isteği. Ayrıntılar sipariş notlarına ve günlüğe eklenir. Müşterinin fatura ü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.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

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, kayıtlı ödeme yöntemi ve sipariş satırı bazında kısmi tahsilat da yoktur. Bir sipariş yerleştirildikten sonra düzenlediğinizde sipariş satırları Klarna'ya yeniden gönderilmez.

Siparişler ve iadeler

Sipariş durumları

Processing or Completed: Klarna satın almayı kabul etti. WooCommerce, ödenmiş bir sipariş için olağan durumu ayarlar. Sipariş notu, Klarna sipariş kimliğini ve ne zaman tahsil edileceğini gösterir. İşlem kimliği Klarna sipariş kimliğidir. Sipariş tahsil edildiğinde bir not, tahsil edilen tutarı ve tahsilat kimliğini gösterir.

On hold: satın alma dolandırıcılık incelemesinde bekliyor, Klarna beklenmeyen bir dolandırıcılık durumu döndürdü, Klarna'nın bildirdiği tutar veya para birimi siparişle eşleşmedi ya da bir tahsilat başarısız oldu. Sipariş notları hangisi olduğunu belirtir.

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

Cancelled: siparişi siz iptal ettiniz ya da Klarna, Klarna siparişinin iptal edildiğini, süresinin dolduğunu veya kapandığını bildirdi. Cancellation açıkken, henüz tahsil edilmemiş bir siparişi iptal etmek Klarna siparişini iptal eder ve yetkilendirmeyi 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.

Tahsilat

When the order is Completed seçeneğinde siparişi Tamamlandı olarak işaretlemek sipariş toplamını tahsil eder. Tahsilat başarısız olursa, örneğin düzenlemeden sonra sipariş toplamı yetkilendirilen tutarın üzerine çıktığı için, sipariş müşterinin ücretlendirilmediğini belirten bir notla Beklemede durumuna geçer ve müşteri "Sipariş tamamlandı" e-postasını almaz. Sorunu giderin ve yeniden denemek için siparişi tekrar Tamamlandı olarak işaretleyin ya da Klarna Merchant Portal'da tahsil edin.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Klarna Payments düğmesine tıklayın. Tahsil edilen tutarlar için, tahsil edilen tutar eksi daha önce iade edilenler kadar tam ve kısmi iadeler desteklenir. İade, siparişin verildiği ortama ve bölgeye gönderilir; bu nedenle o ortamın kimlik bilgilerinin girilmiş olması gerekir. Klarna iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Klarna iade kimliğiyle birlikte sipariş notlarına eklenir. Yeniden denenen bir iade asla iki kez yapılmaz.

Henüz tahsil edilmemiş bir sipariş iade edilemez: yetkilendirmeyi serbest bırakmak için bunun yerine iptal edin. Klarna Merchant Portal'da yapılan iadeler WooCommerce ile geri senkronize edilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > Klarna Payments sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar yoksa 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: bildirimler işlenmeye devam eder ve tahsilat, iptal ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka planda otomatik olarak yeniden kontrol edilir.

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. Müşterinin fatura ülkesi, API region bölgenizdeki bir Klarna ülkesi olmalı ve o ülkenin para biriminde ödeme yapmalıdır (örneğin İsveç'teki bir müşteri SEK ile ödemelidir).

Ödeme geçti ama sipariş On hold durumunda kaldı: satın alma Klarna'nın dolandırıcılık incelemesinde bekliyor ve Klarna'nın bildirimi geldiğinde sipariş güncellenir. Sitenizin, ayarlarda gösterilen bildirim URL'sinden Klarna'dan gelen istekleri alabildiğini ve siparişin verildiği ortamın kimlik bilgilerinin hâlâ girili olduğunu kontrol edin. WooCommerce > Status > Logs sayfasına, kaynak wcp_klarna_payment olacak şekilde bakın.

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

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

Bildirim mismatch_ref yanıtı veriyor: Klarna siparişi bu mağaza siparişine işaret etmiyor. 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.

Tahsilat başarısız, sipariş On hold: sipariş notunu okuyun. Sipariş toplamı hâlâ yetkilendirilmiş tutardan fazla olabilir, Klarna siparişi henüz kabul etmemiş olabilir veya yetkilendirmenin süresi dolmuş olabilir. Sorunu giderin ve siparişi yeniden Tamamlandı olarak işaretleyin ya da Klarna Merchant Portal'da tahsil edin.

İade başarısız: 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.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva boşaltın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler (kaynak wcp_klarna_payment) yalnızca Uninstall (Delete the plugin settings and logs when the plugin is deleted) açıksa kaldırılır. Aksi halde, daha sonra yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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