# GoCardless Modülü

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

GoCardless ile tek seferlik ödemeyi doğrudan müşterinin banka hesabından tahsil edin; müşteri banka yetkisini bir kez verir.

## Ekrana Erişim

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

**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; erişim anahtarınızı, sandbox kutusunu, webhook parolasını ve ortak ağ geçidi ayarlarını taşır.

GoCardless tahsilatı doğrudan borçlandırma ile yapar. Müşteri bir GoCardless sayfasına gider ve banka hesabı için bir kez yetki verir; sonraki ödemeler aynı yetkiyi kullanır, yeniden onay istenmez.

Banka tahsilatı anında sonuçlanmaz. Ödeme beklemede oluşturulur ve fatura **Ödeme Bekleniyor** durumunda bekler. Mevcut sürümde GoCardless'tan gelen onay faturayı kapatmaz; faturayı siz ödendi işaretlersiniz, İşlemler bölümüne bakın. İade GoCardless panelinizden yapılır. Kart saklama, kayıtlı kartla otomatik ödeme ve taksit desteklenmez.

## Ön Koşullar

- Bir GoCardless hesabı. Test için ayrı bir sandbox hesabı gerekir; `manage-sandbox.gocardless.com` adresinden açılır.
- Aynı ortamda **Developers → API settings** altından üretilmiş bir erişim anahtarı. Bunu yalnız yönetici yetkisi olan kullanıcı oluşturabilir.
- Aynı hesapta oluşturulmuş bir webhook uç noktası; buraya gireceğiniz parola oradan gelir.
- GoCardless'ın doğrudan borçlandırma desteklediği bir para birimi ve müşteri ülkesi. Sisteminiz başka bir para biriminde fiyatlıyorsa **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.
- **Access Token**: Zorunlu. GoCardless geliştirici panelinizden aldığınız erişim anahtarı. Sandbox anahtarı yalnız **Sandbox Mode** işaretliyken çalışır.
- **Sandbox Mode**: Her isteği canlı servis yerine GoCardless sandbox'ına gönderir. İşaretsiz gelir.
- **Webhook Secret**: GoCardless'ın oluşturduğunuz webhook uç noktasında gösterdiği parola. Bu sürüm değeri saklar ama kullanmaz; gelen bildirimin imzası bu parolayla karşılaştırılmaz.

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; webhook olarak kaydettiğiniz adres callback adresidir.

## İşlemler

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

1. Sandbox panelinizde **Developers → API settings** sayfasını açın, sağ üstteki **Create** butonuna tıklayın ve **Access token** seçin. Ada verip okuma-yazma yetkisi seçin ve anahtarı kopyalayın; anahtar bir kez gösterilir.
2. **Tüm Modüller** altındaki GoCardless kartını açın ve **Durum** kutusunu işaretleyin.
3. Sandbox anahtarınızı **Access Token** alanına yapıştırın ve **Sandbox Mode** kutusunu işaretleyin.
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** değerini kopyalayın.
2. GoCardless **Developers** sayfasında **Create → Webhook endpoint** seçin, adresi URL olarak yapıştırın ve uç noktaya bir ad verin.
3. Listede yeni uç noktayı açıp parolasını **Webhook Secret** alanına kopyalayın, sonra **Değişiklikleri Kaydet** butonuna tıklayın. GoCardless her olayı gönderir; bu modül `payments` olaylarından `confirmed` eylemini okur.
4. Mevcut sürümde bildirim faturayla eşleştirilemez; faturayı henüz kapatmaz, sonraki işleme bakın.

### Test ödemesi yapma

1. Müşteri olarak küçük tutarlı bir sipariş verin ve ödeme adımında GoCardless'ı seçin.
2. GoCardless sayfasında test banka bilgileriyle yetkiyi tamamlayın.
3. Müşteri döner ve ödeme tahsilatı bekler; fatura bu sırada **Ödeme Bekleniyor** durumuna geçer.
4. Sandbox ödemeyi gerçekleşmiş gösterdiğinde faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) ekranından açın ve ödendi işaretleyin. Sipariş böylece aktifleşir.

### İade gönderme

1. Faturayı [Fatura Detayı](https://docs.wisecp.com/tr/fatura-detayina-genel-bakis) ekranından açın.
2. Durumunu iade edildi yapın, iade yöntemi olarak **Gider olarak ekle** ya da **Hesap kredisine ekle** seçin ve onaylayın. Kendiniz ödendi işaretlediğiniz faturanın arkasında ödeme kaydı olmadığından **Ödeme altyapısı ile iade** gönderecek bir şey bulamaz.
3. Parayı GoCardless panelinizden geri gönderin.

## Dikkat Edilecekler

> **Sipariş bankayı ve sizi bekler**
> 
> Doğrudan borçlandırma saniyeler içinde değil günler içinde sonuçlanır. Siz ödendi işaretleyene kadar fatura **Ödeme Bekleniyor** durumunda kalır ve hizmet aktifleşmez. Gerçekleşen tahsilatları GoCardless panelinizden izleyin; anında teslimat bekleyen müşteriyi başka bir yönteme yönlendirin.

> **Sandbox ve canlı ayrı hesaplardır**
> 
> Sandbox anahtarı hiç para tahsil etmez; canlı anahtar da **Sandbox Mode** işaretliyken çalışmaz. Anahtarı ve kutuyu birlikte değiştirin, canlı hesapta da bir webhook oluşturun. Sandbox ortamında verilen banka yetkisi müşterinin kaydında kalır ve yeniden kullanılır. Test ettiğiniz hesaplardan canlı ödeme almayın.

> **Yenilenen kalemli sipariş ödenemez**
> 
> Yenilenen kalem taşıyan siparişte müşteriye seçim ekranı açılır: tek seferlik ödeme ya da abonelik. Bu sürümde ekrandaki butonlar çalışmaz, müşteri devam edemez. Böyle siparişler için başka bir yöntem sunun.

## Gerekli Yetkiler

**Ödeme Modülü Ayarları** (`MODULES_PAYMENT_SETTINGS`) 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)