GoCardless Modülü

30 görüntülenme Markdown

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

DurumModülü açar. Kapalıyken diğer alanlar kilitli kalır ve müşteriye bu yöntem sunulmaz.
Access TokenZorunlu. GoCardless geliştirici panelinizden aldığınız erişim anahtarı. Sandbox anahtarı yalnız Sandbox Mode işaretliyken çalışır.
Sandbox ModeHer isteği canlı servis yerine GoCardless sandbox'ına gönderir. İşaretsiz gelir.
Webhook SecretGoCardless'ı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. 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ı ekranından açın ve ödendi işaretleyin. Sipariş böylece aktifleşir.

İade gönderme

  1. Faturayı Fatura Detayı 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.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.