# Adyen Modülü

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

Adyen ile ödeme alın: müşteri ödemeyi Adyen'in kendi sayfasında tamamlar, kartı sonraki yenilemeler için saklayabilirsiniz.

## Ekrana Erişim

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

**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; Adyen kimlik bilgilerinizi, kart saklama ayarlarını ve ortak ağ geçidi ayarlarını taşır.

Adyen her sipariş için bir ödeme bağlantısı üretir. Müşteri sepetteki kısa panelden Adyen sayfasını açar; kart bilgileri sitenize hiç ulaşmaz. Sonuç **Callback URL** adresine bildirilir.

Saklanan kart, müşteri olmadan da çekilebilir; yenilemeler böyle ödenir. Abonelik ve taksit desteklenmez: Adyen'in kendi sözleşme kaydı yoktur, tekrar eden çekimler saklı kart üzerinden yürür.

## Ön Koşullar

- Ödeme alabileceğiniz bir satıcı hesabı tanımlı Adyen hesabı. Test ve canlı ayrı ortamlardır, kimlikleri de ayrıdır.
- Aynı ortamda, satıcı hesabınıza erişebilen bir API anahtarı. Hesapta ödeme yöntemlerini ve Pay by Link koşullarını tanımlayın; kart saklama için yinelenen ödeme yetkisi de gerekir.
- Adyen'in o satıcı hesabında kabul ettiği bir para birimi. Fiyatlarınız başka bir para birimindeyse **Para Birimi Dönüştürme** alanını doldurun.
- Kart saklamak istiyorsanız [Ödeme Ağ Geçitleri](https://docs.wisecp.com/tr/odeme-modulleri) ekranında kart saklama sağlayıcısı olarak Adyen'i seçin.

## Alanlar

- **Durum**: Modülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
- **Environment**: Test ya da Live. Test ortamında para tahsil edilmez. Canlı ortam ayrıca aşağıdaki öneki ister.
- **API Key**: Zorunlu. Adyen'e giden her isteğin taşıdığı anahtar.
- **Merchant Account**: Zorunlu. Ödeme bağlantılarının oluşturulacağı satıcı hesabı.
- **Live URL Prefix**: Yalnız canlı kipte zorunlu. Size özel canlı adres öneki; biçimi `1797a841fbb37ca7-AdyenDemo` şeklindedir.
- **Webhook HMAC Key**: Bildirimler için zorunlu. Eksik veya yanlış imza reddedilir; anahtar seçtiğiniz ortama ait olmalıdır.
- **Card Storage**: Adyen sayfasının kartı saklayıp saklamayacağı: müşteriye onay sor, her zaman sakla ya da hiç saklama. Varsayılan: onay sor.
- **Recurring Processing Model**: Saklı karttan yapılan sonraki çekimlerin hangi tür olarak bildirileceği. Sabit takvim için Subscription, değişken tarihler için UnscheduledCardOnFile kullanın. Varsayılan: UnscheduledCardOnFile.
- **Shopper Reference Prefix**: Saklı kartları Adyen tarafında müşteri bazında gruplar. Birden çok sistem aynı satıcı hesabını paylaşıyorsa değiştirin. Varsayılan: WCP.
- **Payment Link Lifetime (hours)**: Ödeme bağlantısının kaç saat ödenebilir kalacağı. Varsayılan: 24 saat.

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; bildirim adresini alanın sonundaki ikonla kopyalayın.

## İşlemler

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

1. Adyen Customer Area panelinizde **Developers → API credentials** sayfasını açın ve bir API anahtarı oluşturun. Anahtar bir kez gösterilir, o anda kopyalayın.
2. **Tüm Modüller** altındaki Adyen kartını açın ve **Durum** kutusunu işaretleyin.
3. **Environment** alanını Test yapın, ardından **API Key** ve **Merchant Account** alanlarını doldurun.
4. **Değişiklikleri Kaydet** butonuna tıklayın. Yöntem artık ödeme adımında görünür.

### Bildirim adresini kaydetme

1. Modül kartındaki **Callback URL** adresini kopyalayın.
2. Customer Area panelinizde **Developers → Webhooks** sayfasını açın, **Create new webhook** butonuna tıklayın ve standart webhook türünü seçin.
3. Kopyaladığınız adresi sunucu adresi olarak yapıştırın. Güvenlik ayarlarında bir HMAC anahtarı üretin ve kopyalayın.
4. Webhook kaydını kaydedin; anahtarını **Webhook HMAC Key** alanına girip **Değişiklikleri Kaydet** butonuna tıklayın. Modül `AUTHORISATION`, `REFUND`, `REFUND_FAILED` ve `REFUNDED_REVERSED` olaylarını işler.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında Adyen'i seçin.
2. **Adyen'e Devam Et** butonuna tıklayın ve Adyen'in test kartlarından biriyle ödeyin.
3. Siteye dönersiniz. Fatura ödendi olarak işaretlenir ve sipariş aktifleşir.

### Canlıya geçme

1. Canlı Customer Area panelinizde yeni bir API anahtarı oluşturun; anahtarlar ortamlar arasında paylaşılmaz.
2. Aynı panelde **Developers → API URLs** sayfasını açın ve öneki kopyalayın.
3. **Environment** alanını Live yapın, **API Key** ve **Live URL Prefix** alanlarını doldurun ve kaydedin.
4. Webhook kaydını canlı panelde yeniden oluşturup HMAC anahtarını yapıştırın. Testi küçük tutarlı gerçek bir ödemeyle yineleyin.

### Saklı kart ve otomatik ödeme sunma

1. **Ödeme Ağ Geçitleri → Başlangıç Ayarları** ekranında **Kart Saklama Modülü** alanından Adyen'i seçip **Değişiklikleri Kaydet** butonuna tıklayın.
2. Kartın nasıl saklanacağını **Card Storage**, sonraki çekimlerin nasıl bildirileceğini **Recurring Processing Model** alanında belirleyin.
3. **Değişiklikleri Kaydet** butonuna tıklayın. Müşteriler hesaplarından kart ekleyip **Kayıtlı Kartlar** bölümündeki kart menüsünden **Otomatik Ödemeyi Aç** seçebilir.

### İ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. Adyen isteği hemen kabul eder, para birkaç gün içinde çıkar. Sonucu iade bildirimi taşır.

## Dikkat Edilecekler

> **Bildirim için HMAC anahtarı gerekir**
> 
> Eksik veya yanlış **Webhook HMAC Key** bildirim doğrulamasını engeller. Müşterinin dönüşü ödemeyi ayrıca doğrulayabilir; fakat müşteri geri dönmeyebilir. Ödeme, iade ve saklı kart güncellemeleri için webhook kaydını koruyun.

> **Test ve canlı asla karışmaz**
> 
> Test anahtarıyla para tahsil edilmez, canlı anahtar da test trafiğini kabul etmez. Canlı kipte **Live URL Prefix** eksikse istekler Adyen'e hiç ulaşmaz. Ortamı, anahtarı ve öneki birlikte değiştirin.

> **Yeni kartların saklanma biçimini seçin**
> 
> **Never store**, ödeme bağlantısından yeni kart saklamayı önler; mevcut kartları silmez. **Always store** o sayfada sormadan saklar. Müşteri saklamayı onaylamalıysa onay soran seçeneği kullanın.

## Gerekli Yetkiler

**Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) yetkisi gerekir. Fatura iadesi ayrıca `INVOICES_OPERATION` ister.

## İlgili Makaleler

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