Braintree Modülü

Braintree ile kart ödemelerini alın ve sonraki yenilemeler için kart saklama veya abonelik sunun.

Ekrana Erişim

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

Ağ geçidini müşterinin gördüğü yöntem listesine eklemeyi Ödeme Modülleri makalesinde bulursunuz.

Ekranda Neler Var

Tek bir ayar formu: Braintree anahtar çifti, isteğe bağlı bir satıcı hesabı, iki işaret kutusu ve her modülde bulunan ortak ağ geçidi ayarları.

Müşteri Braintree'nin kendi kart paneliyle ödeme sayfasında karşılaşır, siteden ayrılmaz. Kart numarası doğrudan Braintree'ye gider, sistem yalnız bir belirteç saklar.

Modül kart saklar, yenilemede saklı kartı çeker, abonelik açar ve fatura ekranından ödemeyi iade eder. Kendi formunuza yazılan kart numarasını kabul etmez, taksit sunmaz.

Ön Koşullar

• Genel ve özel anahtarını aldığınız bir Braintree hesabı. Test anahtarları ile canlı anahtarlar iki ayrı panelden gelen iki ayrı çifttir.
• Tahsilat yaptığınız para biriminin bir Braintree satıcı hesabında açık olması.
• Saklı kart ve otomatik yenileme ödemeleri için Başlangıç Ayarları içindeki Kart Saklama Modülü alanında bu modülün seçili olması.
• Abonelik için Braintree tarafında her ödeme aralığına bir plan ve webhook. Webhook oluşturmak Braintree'de Manage Webhooks yetkisi ister.

Alanlar

Durum, komisyon, para birimi, tutar ve ülke sınırları için Ödeme Modülleri makalesine bakın. Abonelik Ücretinin Güncellenmesi yenileme tutarı değişince Braintree tutarını günceller; varsayılan kapalıdır. Callback URL, Success URL ve Failed URL değiştirilemez; kopyalama simgelerini kullanın.

İşlemler

Anahtarları Braintree'den alma

1. Braintree paneline giriş yapın. Test ortamı ile canlı ortam ayrı adreslerdir; anahtarını istediğiniz ortama girin.
2. Sağ üstteki dişli ikonuna tıklayın, API bölümünü açın ve API Keys başlığını bulun.
3. Private Key sütunundaki View bağlantısını açıp aynı satırın iki anahtarını kopyalayın. Anahtar yoksa Generate New API Key seçin.
4. Bir adım daha yalnız varsayılan hesap para biriminizi karşılamıyorsa gerekir. Dişli ikonunu yeniden açın, Business bölümüne gidin ve Merchant Accounts altındaki kimliği kopyalayın.

Kimlik bilgilerini girme

1. Modül kartını açın ve Durum kutusunu işaretleyin. Bunu yapmadan diğer alanlar kilitli kalır ve hiçbir değer kaydedilmez.
2. Public Key ve Private Key alanlarını doldurun, Sandbox Mode işaretini girdiğiniz çifte göre ayarlayın.
3. Değişiklikleri Kaydet butonuna tıklayın. Bu yöntemi seçen müşteriler artık Braintree kart panelini görür.
4. Sandbox kimlikleri ve Braintree test kartıyla bir test faturası ödeyin. Sağlayıcı işlem kaydını ve faturanın Ödendi durumunu kontrol edin.

Müşterinin kartını saklamasına izin verme

1. Ayarlar → Finansal → Ödeme Ağ Geçitleri ekranına dönün ve Başlangıç Ayarları sekmesini açın.
2. Kart Saklama Modülü alanından Braintree seçin ve Değişiklikleri Kaydet butonuna tıklayın.
3. Müşteriler artık hesaplarından kart ekleyebilir, ödeme sırasında saklı kartı seçebilir ve otomatik ödemeyi açabilir.

Abonelik sunma

1. Braintree'de Subscriptions → Plans → Create A Plan (veya New Plan) yolunu açın. Para birimini ve aylık aralığı belirleyip Create butonuna tıklayın. Her aralık için tekrarlayın. Günlük/haftalık döngü yoktur; tutar abonelikte belirlenir.
2. Dişli ikonundan API → Webhooks → Create New Webhook yolunu açın. Callback URL yapıştırın; subscription_charged_successfully, subscription_went_active, subscription_went_past_due, subscription_canceled ve subscription_expired seçin. Create Webhook butonuna tıklayın.
3. Modül kartına dönün, Recurring Billing kutusunu işaretleyin ve Değişiklikleri Kaydet butonuna tıklayın.
4. Ödeme paneli artık planlarınızla eşleşen döngüdeki kalemler için otomatik yenileme sunar. Eşleşen planı olmayan kalem hiç sunulmaz.

Müşterinin izlediği yol

Kart saklama, otomatik ödeme ve abonelik seçenekleri kendi hesabı adına ödeme yapan hesap sahibine sunulur. Paylaşımlı ödeme bağlantılarında görünmez.

1. Müşteri bu yöntemi sepette, bir faturada ya da bakiye yüklerken seçer.
2. Kart paneli aynı sayfada açılır. Müşteri kart girer ya da daha önce sakladığı kartı seçer. İki kutu kartı saklamayı ve gelecek faturaları o kartla ödemeyi önerir.
3. Abonelik açıksa müşteri hangi yenilenen kalemlerin tek bir sözleşmeye gireceğini de seçer. Farklı döngüdeki kalemler aynı sözleşmeye giremez.
4. Braintree kartı çeker. Ödeme faturayı kapatır ve hizmet etkinleşir.

Ödemeyi iade etme

1. Ödenmiş faturayı açın: {admin}/invoices/detail?id={fatura}
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. Braintree çekimi geri verir. Henüz sonuçlanmamış bir çekim ise iptal edilir; müşteri için sonuç aynıdır.

Dikkat Edilecekler

Gerekli Yetkiler

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

İlgili Makaleler

• Ödeme Modülleri
• Fatura Detayı Genel Görünüm
• Abonelikler
• Modül Yönetimi