Adyen Modülü

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 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 ekranında kart saklama sağlayıcısı olarak Adyen'i seçin.

Alanlar

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

Gerekli Yetkiler

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

İlgili Makaleler

• Ödeme Ağ Geçitleri
• Fatura Detayı