VibeFox Braintree for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin olmalı.

PHP: 8.0 veya üzeri.

HTTPS: sitenizin HTTPS kullanması gerekir.

Braintree hesabı: Braintree hesabınızın Merchant ID, Public Key ve Private Key bilgilerine ihtiyacınız var. Bunlar Braintree Control Panel'de (test ortamı: sandbox.braintreegateway.com, canlı: www.braintreegateway.com) dişli simgesinin altında, API ve API Keys bölümünde bulunur. Test ve canlı hesapların anahtarları farklıdır. 3-D Secure, 3-D Secure seçeneğini Disabled yapmadığınız sürece Braintree satıcı hesabınız için etkin olmalıdır. Webhook gerekmez.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_braintree_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Braintree > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Braintree Control Panel'deki Merchant ID, Public Key ve Private Key bilgilerini test veya canlı alanlarına kopyalayın.

6. Enable/Disable seçeneğini açın. Sandbox mode seçeneğini açık bırakın ve bir Braintree test kartıyla test siparişi verin; örneğin 4111 1111 1111 1111 numaralı kartı, gelecekteki herhangi bir son kullanma tarihiyle kullanın. 3-D Secure için Braintree'nin 3-D Secure test kartlarını kullanın.

7. Canlı kimlik bilgileriyle gerçek ödemeler almak için Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Braintree. Ağ geçidi etkinken seçili modun Merchant ID, Public Key veya Private Key bilgilerinden biri eksikse sayfa, bunlar doldurulana kadar ödeme yönteminin ödeme sayfasında gizlendiği konusunda uyarır. Sayfa yalnızca seçili modun kimlik bilgisi alanlarını gösterir; her iki kümeye ait bilgiler de kayıtlı kalır.

Genel

Enable/Disable: Enable Braintree card payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Credit / debit card.

Description: ödeme sayfasında kart formunun üstünde gösterilen metin. Varsayılan: Pay securely with your credit or debit card via Braintree.

API kimlik bilgileri

Braintree Control Panel'e (test veya canlı) giriş yapın, dişli simgesine, ardından API ve API Keys bölümüne tıklayın. Genel ve özel anahtarlar burada listelenir; Merchant ID aynı sayfada gösterilir.

Sandbox mode: Use the Braintree sandbox (test payments, no real money). Varsayılan: açık. Gerçek ödemeleri canlı kimlik bilgileriyle almak için işaretini kaldırın. İadeler, tahsilatlar ve iptaller (void) her zaman siparişin ödendiği ortamı kullanır.

Sandbox Merchant ID ve Live Merchant ID: test veya canlı hesabın Merchant ID'si.

Sandbox Public Key ve Live Public Key: o hesabın genel anahtarı.

Sandbox Private Key ve Live Private Key: o hesabın özel anahtarı.

Sandbox merchant account ID(s) ve Live merchant account ID(s): isteğe bağlı. Braintree, tahsilatı satıcı hesabının para biriminde yapar. Varsayılan satıcı hesabınızı kullanmak için boş bırakın; tek bir ID girin (örneğin mystore_EUR) veya para birimi başına bir tane: EUR=mystore_EUR, USD=mystore_USD. Tahsil edilen para birimi sipariş para birimiyle eşleşmezse işlem otomatik olarak iptal edilir (void) ve müşteriden ücret alınmaz.

Ödeme

Transaction type: kartın nasıl tahsil edileceği.

3-D Secure: 3-D Secure 2 (Güçlü Müşteri Kimlik Doğrulaması), EEA ve Birleşik Krallık'ta çoğu kart ödemesi için zorunludur. Braintree hesabınızda da etkin olmalıdır.

Gelişmiş

Debug log: Also log API calls and payment steps (errors are always logged). Günlükler WooCommerce > Status > Logs bölümünde, kaynak wcp_braintree_gateway olarak yer alır. Hiçbir zaman API anahtarlarını, kart veya müşteri verilerini içermez. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit / debit card) ve kartı ödeme sayfasındaki Braintree formuna girer. Test ortamında form, SANDBOX / TEST MODE — no real money is charged. metnini gösterir. 3-D Secure açıksa müşteri siparişi verirken bankanın doğrulamasını tamamlar.

Eklenti, tek kullanımlık jetonu sipariş para biriminde sipariş toplamı için Braintree API üzerinden tahsil eder; sipariş numarası sipariş kimliği olarak kullanılır. Sipariş, yalnızca Braintree'nin kimliği doğrulanmış yanıtından ve tahsil edilen tutar ile para birimi siparişle karşılaştırıldıktan sonra ödenmiş olarak işaretlenir. Ödeme onaylanırsa müşteri sipariş alındı sayfasına gider. Kart ödemeleri webhook gerektirmez: sonuç hemen bilinir.

Ödeme başarısız olursa sipariş Pending payment durumunda kalır, nedeni sipariş notlarına eklenir ve müşteri açık bir mesaj görür; örneğin Your card was declined. Please use another card or contact your bank., 3-D Secure authentication failed. Please try again or use another card. veya The card security code or billing address could not be verified. Please check your details and try again. Müşteri hemen yeniden deneyebilir. Tahsil edilen para birimi sipariş para birimiyle eşleşmezse işlem iptal edilir (void) ve müşteri This payment could not be processed in the currency of your order. Your card has not been charged. Please choose another payment method or contact us. mesajını görür.

Bir sipariş asla iki kez tahsil edilmez: ödeme sürerken ikinci bir gönderim This order is already being paid. Please wait a moment and check your e-mail before trying again. mesajını gösterir.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca kart ödemelerini kabul eder. Kayıtlı kart (vaulting), WooCommerce Subscriptions veya ön sipariş, PayPal, Venmo, Apple Pay, Google Pay, ACH veya yerel ödeme yöntemleri, Braintree webhook'ları, Level 2/3 verisi, sipariş satırları veya Fastlane desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: ödeme henüz yapılmadı veya reddedildi.

Processing or Completed: kart tahsil edildi (Sale) veya bir ön provizyon tahsil edildi. WooCommerce durumu İşleniyor olarak ayarlar; yalnızca sanal ve indirilebilir ürünlerden oluşan siparişler için Tamamlandı olarak ayarlanır. Sipariş notunda tutar, işlem kimliği ve 3-D Secure sonucu gösterilir. İşlem kimliği Braintree işlem kimliğidir ve sipariş ekranında Braintree Control Panel'deki işleme bağlanır.

On hold: ön provizyon yalnızca ayrılmıştır (Authorize only). Braintree beklenmeyen bir işlem durumu döndürdüğünde veya yanlış para birimindeki bir tahsilat otomatik olarak iptal edilemediğinde de sipariş beklemeye alınır. Sipariş notu, Braintree Control Panel'de neyi kontrol etmeniz gerektiğini açıklar.

Cancelled: bir ön provizyon Void Braintree authorization ile iptal edildi.

Tahsilat ve iptal (void)

Ön provizyonlu bir sipariş için siparişi açın, sipariş işlemlerinde Capture Braintree payment veya Void Braintree authorization seçeneğini belirleyin, ardından güncelleme düğmesine tıklayın. Tahsilat siparişi ödenmiş olarak işaretler; iptal (void) siparişi iptal eder ve ayrılmış tutarı müşteriye serbest bırakır. İşlem başarısız olursa hata sipariş ekranında gösterilir ve sipariş notlarına eklenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit / debit card düğmesine tıklayın (düğme, ödeme yönteminizin başlığını kullanır). Tam ve kısmi iadeler desteklenir. Braintree yalnızca mutabakatı tamamlanmış işlemleri iade edebilir; bu genellikle 24 saat içinde olur. Mutabakattan önce tam iade iptal (void) olarak yapılır; kısmi iade ise mutabakat için beklemeniz gerektiğini bildiren bir mesajla başarısız olur. İade, siparişin ödendiği ortama (test veya canlı) gönderilir. Braintree iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade veya iptal (void) sipariş notlarına eklenir.

İtirazlar (chargeback) ve mutabakat reddleri WooCommerce ile senkronize edilmez. Bunları Braintree Control Panel'de kontrol edin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü, WooCommerce > Settings > Payments > Braintree sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Braintree ödeme sayfasında müşterilere gösterilmez. Ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Oturum açmış mağaza yöneticileri ödeme yöntemini yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: tahsilatlar, iptaller (void) ve iadeler çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Braintree ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve seçili modun Merchant ID, Public Key ve Private Key bilgilerinin bulunduğunu kontrol edin. Ayarlar sayfası eksik bir anahtar olduğunda uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: kart ödemeleri hemen onaylanır, webhook gerekmez. Sipariş notu Braintree'den gelen yanıtın kaybolduğunu söylüyorsa, başka bir ödeme kabul etmeden önce Braintree Control Panel'de bu sipariş numarasına ait bir işlem olup olmadığını kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde kaynak wcp_braintree_gateway kayıtlarına bakın.

Kart formunda Could not initialize payment form görünüyor: seçili modun anahtarları yanlış veya satıcı hesabı ID'si o hesapta mevcut değil. Anahtarları ve satıcı hesabı ID'lerini kontrol edin, ardından sayfayı yenileyin.

Her ödemede 3-D Secure başarısız oluyor: 3-D Secure, Braintree satıcı hesabınızda etkin olmalıdır. Braintree desteğiyle iletişime geçin veya 3-D Secure seçeneğini Disabled yapın (EEA ve Birleşik Krallık'ta SCA'nın zorunlu olduğu yerlerde önerilmez).

Müşteri, ödemenin sipariş para biriminde işlenemediği mesajını görüyor: Braintree, satıcı hesabının para biriminde tahsilat yaptı. Mevcut modun satıcı hesabı alanına sipariş para birimi için satıcı hesabı ID'sini girin.

Ödemeden hemen sonra kısmi iade başarısız oluyor: Braintree yalnızca mutabakatı tamamlanmış işlemleri iade edebilir; bu genellikle 24 saat içinde olur. İşlemi hemen iptal etmek (void) için tam tutarı iade edin ya da kısmi iadeyi mutabakattan sonra yapın.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır; aksi halde yeniden kurulum için saklanır. Siparişlerde saklanan Braintree verileri her zaman korunur, çünkü yeniden kurulumdan sonra iadeler için gereklidir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Braintree, ilgili sahibinin ticari markasıdır. Bu eklenti Braintree ile bağlantılı değildir ve Braintree tarafından onaylanmamıştır.