# Checkout.com Modülü

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

Checkout.com ile kart ödemelerini alın ve müşterilerin sonraki yenilemeler için kartlarını saklamasını sağlayın.

## Ekrana Erişim

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

Müşterilerin göreceği yöntemleri [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranından yönetin.

## Ekranda Neler Var

Modül kartında API anahtarları, webhook doğrulaması, işlem kanalı, ödeme yöntemi ve ortam ayarları bulunur.

Bu sürümün normal ödeme akışında sitenizin kart formu kullanılır. Müşteri ardından banka doğrulamasını tamamlayabilir. Kart saklama ve otomatik ödeme desteklenir; sağlayıcının yönettiği abonelik ve taksit sunulmaz.

Modülde ayrıca sağlayıcının ödeme sayfasına yönlendirme bulunur. İzin verilen yöntem listesi o sayfayı etkiler; normal kart formunu değiştirmez.

## Ön Koşullar

- Ülkeniz, para biriminiz ve ödeme yöntemleriniz için açık bir Checkout.com hesabı; denemeler için sandbox erişimi.
- Aynı ortamdan genel ve gizli API anahtarları. Kart belirteci oluşturma, saklı kart yönetimi, ödeme oluşturma ve okuma ile iade yetkileri gerekir.
- Ulaşılabilir bir HTTPS bildirim adresi ve o bildirimin imza anahtarı.

## Alanlar

- **Gizli Anahtar**: Zorunlu. Checkout.com'a giden ödeme, saklı kart ve iade isteklerini doğrular.
- **Genel Anahtar**: Kart formu ve kart ekleme için zorunlu. Kart belirteci oluştururken kullanılır.
- **Webhook İmza Anahtarı**: Bildirimler için zorunlu. Webhook kaydına ait imza anahtarını girin; API gizli anahtarıyla aynı değildir.
- **İşlem Kanalı Kimliği**: Ödemelerin kullanılacağı kanal. Hesabınız kanal seçimi gerektiriyorsa kimliğini girin; API anahtarlarının bu kanala izni olmalıdır.
- **İzin Verilen Ödeme Yöntemleri**: İsteğe bağlı, virgülle ayrılmış adlar: `card, applepay, googlepay`. Sağlayıcının ödeme sayfasını süzer. Boşsa hesaptaki tüm uygun yöntemler sunulur.
- **Otomatik Tahsil Et**: Kayıtlı değer yoksa açık gelir. Kapalıyken provizyon faturayı ödendi yapmaz; ödemeyi Checkout.com'dan tahsil etmeniz gerekir.
- **Test Modu**: Canlı ortam yerine sandbox kullanır. Seçim; iki API anahtarı ve webhook kaydıyla aynı ortama ait olmalıdır.

**Durum**, komisyon, para birimi dönüştürme, tutar aralığı ve ülke listeleri için [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) makalesine bakın. **Callback URL**, **Success URL** ve **Failed URL** değerlerini WISECP verir.

## İşlemler

### API anahtarlarını oluşturma

1. Checkout.com panelinde **Developers → Keys → Create a new key** yolunu izleyin.
2. Test ortamı için genel ve gizli anahtar oluşturun. İşlem kanalına ve ön koşullarda belirtilen işlemlere izin verin.
3. Anahtarları kopyalayın. **Developers → Keys** bölümünde ilgili anahtarı açın ve bağlı işlem kanalının kimliğini alın.

### Hesabı bağlama

1. Checkout.com modül kartında **Durum** kutusunu işaretleyerek ayarları açın.
2. **Gizli Anahtar**, **Genel Anahtar** ve gerekiyorsa **İşlem Kanalı Kimliği** alanlarını doldurun.
3. Sandbox anahtarları için **Test Modu** kutusunu işaretleyin. Hemen tahsilat için **Otomatik Tahsil Et** açık kalsın.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Ayarlar kaydedilir; ödeme denemesinden önce bildirim kurulumunu tamamlayın.

### Ödeme bildirimlerini kurma

1. Modül kartındaki **Callback URL** değerini kopyalayın.
2. Aynı Checkout.com ortamında **Developers → Webhooks** sayfasını açın ve bu HTTPS adresi için bir bildirim kaydı oluşturun.
3. `payment_captured` ile `payment_declined` ve `payment_capture_declined` gibi başarısız ödeme olaylarını ekleyin. Kaydı saklayın ve imza anahtarını kopyalayın.
4. Anahtarı **Webhook İmza Anahtarı** alanına girip **Değişiklikleri Kaydet** butonuna tıklayın. WISECP artık bu adrese gelen bildirimleri doğrulayabilir.

### Müşteri ödemesini deneme

1. Müşteri olarak test siparişi başlatın veya ödenmemiş bir faturayı açıp Checkout.com yöntemini seçin.
2. Kart formuna Checkout.com test kartı girin. İstenirse banka doğrulamasını tamamlayın.
3. Checkout.com'daki işlemle WISECP faturasını kontrol edin. Tamamlanan tahsilat faturayı ödendi yapar; provizyon aşamasında fatura açık kalır.
4. Gerçek tahsilata geçerken iki anahtarı ve webhook kaydını canlı ortam değerleriyle değiştirin; **Test Modu** işaretini kaldırıp kaydedin.

### Kart saklama ve yenilemeleri açma

1. **Ödeme Ağ Geçitleri → Başlangıç Ayarları** ekranına dönün. **Kart Saklama Modülü** alanında **Checkout.com** seçip **Değişiklikleri Kaydet** butonuna tıklayın.
2. Hesap sahibi müşteri hesabından kart ekleyebilir veya ödeme sırasında kartını saklayabilir. Kart eklenirken sıfır tutarlı doğrulama yapılır.
3. Müşteri **Kayıtlı Kartlar** bölümündeki kart menüsünden **Otomatik Ödemeyi Aç** seçer. Yenileme faturaları otomatik tahsilata alınabilir.
4. Başarılı yenileme ödemesi faturayı kapatır. Saklı kart silindiğinde Checkout.com'daki yeniden kullanılabilir kart kaydı da kaldırılır.

### Faturayı iade etme

1. Ödenmiş faturayı açın: `{admin}/invoices/detail?id={invoice}`
2. **Özet → Durumu Değiştir** bölümünde **İade Edildi** ve **Ödeme altyapısı ile iade** seçin.
3. **Durumu Güncelle** butonuna tıklayın. Kabul edilen iade isteği faturayı günceller; iadenin tamamlandığını Checkout.com'dan kontrol edin.

## Dikkat Edilecekler

> **Provizyon tahsilat değildir**
> 
> Ödeme provizyonda beklerken başarı sayfası görünebilir. Hizmeti sunmadan önce fatura durumunu kontrol edin. Otomatik tahsilat kapalıysa ödemeyi Checkout.com'dan tahsil edin.

> **Ortamları ve imzaları birlikte değiştirin**
> 
> Yanlış imza anahtarı bildirim doğrulamasını engeller. Dönüş sayfası da ödeme durumunu sorgulayabilir; fakat müşteri sayfayı kapatabilir. Güvenilir ödeme onayı için bildirimleri kurun.

> **İadeden önce tahsilat kaydını kontrol edin**
> 
> Modül faturaya kaydedilmiş tutarı kullanır. Bu kayıt yokken ödeme kimliği bulunursa istek ödemenin tamamını iade edebilir. Tek ödemeyle birkaç fatura kapatılmışsa tutarı dikkatle kontrol edin.

## Gerekli Yetkiler

Modül ayarları için **Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir. İade ayrıca `INVOICES_OPERATION` ister.

## İlgili Makaleler

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