# Klarna Modülü

https://docs.wisecp.com/tr/klarna-modulu

Klarna ile ödeme alın: müşteri Klarna'nın kendi sayfasında şimdi ödeme, sonra ödeme ya da taksitle ödeme seçeneklerinden birini seçer.

## Ekrana Erişim

**Ayarlar → Finansal → Ödeme Ağ Geçitleri** yolunu izleyin, **Tüm Modüller** sekmesini açın ve Klarna kartına tıklayın: `{admin}/modules/payment?module=Klarna`

**Durum** kutusunu işaretleyip kaydettiğinizde yöntem ödeme adımında listelenir. Müşterinin gördüğü sırayı [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranından düzenleyin.

## Ekranda Neler Var

Kart; Klarna kimlik bilgilerinizi, üç davranış ayarını ve ortak ağ geçidi ayarlarını taşır.

Müşteri sepetin içinde kısa bir panel görür ve Klarna'nın barındırılan sayfasını oradan açar; ödeme bilgileri sitenize hiç ulaşmaz. Klarna'nın hangi seçenekleri sunacağı müşterinin ülkesine ve siparişe bağlıdır.

Klarna ödeme yöntemini sonraki yenilemeler için saklayabilir; saklanan yöntem müşteri olmadan çekilir. Abonelik, sizin tarafınızda yürüyen taksit ve site içi kart formu desteklenmez: tekrar eden tahsilatı saklanan yöntem karşılar.

## Ön Koşullar

- Merchant portal erişimi olan bir Klarna hesabı ve API kimliği oluşturabilen bir yönetici kullanıcı.
- Test için ayrı bir playground hesabı. Playground ile üretim kimlikleri hiçbir zaman aynı değildir.
- Kimliklerinizin verildiği bölge: Avrupa, Kuzey Amerika ya da Okyanusya.
- Klarna'nın hizmet verdiği bir para birimi ve ülke. Fiyatlarınız başka bir para birimindeyse **Para Birimi Dönüştürme** alanını doldurun.

## Alanlar

- **Durum**: Modülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
- **API Username (UID)**: Zorunlu. Klarna API kimlik çiftinin kullanıcı adı bölümü.
- **API Password**: Zorunlu. Aynı çiftin parola bölümü. Klarna bunu bir kez gösterir.
- **API Region**: Kimliklerin ait olduğu Klarna bölgesi: Avrupa, Kuzey Amerika ya da Okyanusya. Kimlikler tek bölgede çalışır.
- **Playground (test) mode**: Tüm istekleri Klarna'nın test ortamına gönderir; orada para geçmez. Varsayılan açık, yöntemi müşterilere açmadan önce kapatın.
- **Capture immediately**: Parayı sipariş verilir verilmez tahsil eder. Varsayılan açık. Klarna sözleşmeniz tahsilatı sevkiyatta istiyorsa kapatın; fatura o zaman sizi bekler.
- **Offer saved payment method**: Ödeme panelinde müşteriye saklama seçeneği sunar ve yöntemi yenilemeler için saklar. Varsayılan açık.

Komisyon, para birimi dönüştürme, kabul edilen tutar aralığı ve ülke listeleri her ağ geçidinde aynı çalışır: [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri). **Callback URL**, **Success URL** ve **Failed URL** alanlarını değiştiremezsiniz. Klarna bu adresleri her ödemeyle birlikte alır; Merchant portal tarafında bir kayıt açmanız gerekmez.

## İşlemler

### Klarna hesabınızı bağlama

1. Merchant portal panelinde **Payment settings → Klarna API Keys → Generate new Klarna API key** yolunu açın. Kimlik bilgilerini metin dosyası olarak indirin.
2. **Tüm Modüller** altındaki Klarna kartını açın ve **Durum** kutusunu işaretleyin.
3. Dosyadaki **Key ID** değerini **API Username (UID)**, **Secret** değerini **API Password** alanına girin. **API Region** seçin; **Playground (test) mode** işaretli kalsın.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Yöntem artık ödeme adımında görünür.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında Klarna'yı seçin.
2. **Klarna ile Devam Et** butonuna tıklayın ve ödemeyi Klarna'nın test verileriyle tamamlayın.
3. Siteye dönersiniz. Fatura ödendi olarak işaretlenir ve sipariş aktifleşir.

### Canlıya geçme

1. Üretim Merchant portal panelinizde bir kimlik oluşturun.
2. **API Username (UID)** ve **API Password** alanlarını üretim çiftiyle değiştirin, bölgeyi kontrol edin.
3. **Playground (test) mode** işaretini kaldırın ve **Değişiklikleri Kaydet** butonuna tıklayın. Testi küçük tutarlı gerçek bir ödemeyle yineleyin.

### Provizyonlu ödemeyi tahsil etme

1. **Capture immediately** ayarını kapalı bırakın. Klarna o zaman parayı yalnız bloke eder ve fatura açık kalır.
2. Faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) ekranından açın ve üstteki **Ödemeyi tahsil et** butonuna tıklayın.
3. **Tahsil et** ile onaylayın. Klarna parayı çeker, ödeme kaydedilir ve fatura kapanır.

### Saklanan ödeme yöntemi sunma

1. **Offer saved payment method** kutusunu işaretleyin ve kaydedin.
2. Müşteri ödeme panelinde **Bu ödeme yöntemini sonraki yenilemeler için sakla** kutusunu işaretler ve Klarna sayfasında onaylar.
3. Yenileme faturaları bundan sonra saklanan yöntemden, müşteri olmadan tahsil edilir.

### İade gönderme

1. Faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) ekranından açın.
2. **Özet → Durumu Değiştir** bölümünde **İade Edildi** ve **Ödeme altyapısı ile iade** seçin. **Durumu Güncelle** butonuna tıklayın.
3. Klarna bu fatura için tahsil edilen tutarı geri gönderir.

## Dikkat Edilecekler

> **Provizyon henüz sizin paranız değil**
> 
> **Capture immediately** kapalıyken müşterinin parası yalnız bloke edilir ve fatura bekler. Bunu sizin yerinize tahsil eden bir mekanizma yok. Klarna provizyonunun süresi de dolar; o andan sonra tahsil edilecek bir tutar kalmaz.

> **Playground para tahsil etmez**
> 
> Test ödemeleri faturayı ödendi yapar ve siparişi aktifleştirir, ama para geçmez. Üretim kimliğini girmekle **Playground (test) mode** işaretini kaldırmayı birlikte yapın: playground çifti üretimde reddedilir, yanlış bölge de öyle.

> **Saklama müşterinin onayını gerektirir**
> 
> **Offer saved payment method** kapalıyken yeni ödemelerde saklama seçeneği görünmez. Önceden saklanan yöntemler kalır. Yeni yöntem ancak müşteri kutuyu işaretleyip Klarna'da onaylarsa saklanır.

## Gerekli Yetkiler

Ayarlar için **Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir. Fatura üzerinden tahsilat ve iade için **Faturalandırma → Düzenleme** (`INVOICES_OPERATION`) yetkisi gerekir.

## İlgili Makaleler

- [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri)
- [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis)