Geri

VibeFox Braintree for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonraki sürümler (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

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

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

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_braintree_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_braintree_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_braintree_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri yoktur, bu nedenle Extensions > Modifications sayfasını yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin, Payments türünü seçin, VibeFox Braintree Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı, sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox mode seçeneğini açık tutun ve Braintree sandbox test kartı (örneğin 4111 1111 1111 1111) ile bir test siparişi verin. Ardından canlı kimlik bilgilerini girin ve gerçek ödemeleri almak için Sandbox mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_braintree_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Braintree Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve Braintree kimlik bilgilerini OpenCart 3 için 3-5. adımlarda olduğu gibi girin ve ödemeyi test edin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Braintree Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ödeme yöntemi etkinleştirilmiş ama seçili ortam için Merchant ID, Public Key veya Private Key eksikse, sayfa bu bilgiler doldurulana kadar ödeme yönteminin ödeme sayfasında gizlendiğini uyarır. Sandbox modu açıkken sayfa Sandbox mode is on: test payments, no real money. mesajını gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title alanı 1 ila 128 karakter olmalıdır, Sort Order tam sayı olmalıdır ve Total 0 veya daha büyük bir sayı olmalıdır. Herhangi bir alanda hata varsa hiçbir şey kaydedilmez ve sayfa alanı belirtir.

Braintree

Enable/Disable: Braintree kart ödemelerini açar veya kapatır. Seçili ortamın Merchant ID, Public Key ve Private Key bilgileri doldurulana kadar ödeme yöntemi ödeme sayfasında gizlenir. Varsayılan: kapalı.

Title: Müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit / debit card. Zorunlu, en fazla 128 karakter.

Description: Müşterinin Confirm Order adımında kart formunun üstünde gördüğü metin. Varsayılan: Pay securely with your credit or debit card via Braintree.

Sort Order: Braintree'nin ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: Braintree'yi yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones altında ayarlanır.

Total: Braintree'nin sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde toplam tutar. Braintree'yi her tutar için sunmak istiyorsanız boş bırakın.

API kimlik bilgileri

Braintree Control Panel'e giriş yapın (sandbox veya canlı, bu bölümde bağlantılıdır), dişli simgesine ve ardından API ile API Keys seçeneklerine tıklayın. Genel ve özel anahtarlar orada listelenir; Merchant ID aynı sayfada gösterilir. Sayfa yalnızca seçili ortamın kimlik bilgisi alanlarını gösterir; her iki takım da kayıtlı kalır.

Sandbox mode: Braintree sandbox ortamını kullanır (test ödemeleri, gerçek para yok). Varsayılan: açık. Canlı kimlik bilgileriyle gerçek ödemeler almak için kapatın. İadeler, tahsilatlar ve iptaller (void) her zaman siparişin ödendiği ortamı kullanır. Açıkken müşteriler Confirm Order adımında SANDBOX / TEST MODE — no real money is charged. mesajını görür.

Sandbox Merchant ID ve Live Merchant ID: sandbox 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ı; girildiği gibi kaydedilir. Kayıtlı özel anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Sandbox merchant account ID(s) ve Live merchant account ID(s): isteğe bağlı. Braintree, satıcı hesabının para biriminde tahsilat yapar. Varsayılan satıcı hesabınızı kullanmak için boş bırakın, bir ID (örneğin mystore_EUR) ya da para birimi başına bir ID girin: 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.

Sale — anında tahsilat: sipariş hemen ödenir (varsayılan).
Authorize only — sonradan tahsilat: sipariş Authorized Status durumunu alır (ödenmemiş). Sipariş sayfasındaki VibeFox Braintree Gateway sekmesinden tahsil edin veya iptal (void) edin. Ön provizyonlar karta bağlı olarak yaklaşık 7–30 gün sonra sona erer.

3-D Secure: 3-D Secure 2 (Güçlü Müşteri Kimlik Doğrulaması, SCA), EEA ve Birleşik Krallık'taki çoğu kart ödemesi için zorunludur. Braintree hesabınızda da etkin olmalıdır (ödemeler 3-D Secure yapılandırma hatasıyla başarısız olursa Braintree desteğiyle iletişime geçin).

Enabled — kartları doğrula, başarısız kimlik doğrulamaları engelle: varsayılan. Müşteri bankasının doğrulamasını tamamlar; başarısız bir kimlik doğrulama, kart tahsil edilmeden engellenir.
Required — yalnızca sorumluluk devri olan ödemeleri kabul et: başarılı bir 3-D Secure kimlik doğrulaması olmayan ödemeler reddedilir; Braintree bunu sunucu tarafında da uygular.
Disabled: 3-D Secure kontrolü yapılmaz.

3-D Secure sonucu, kart tahsil edilmeden önce yalnızca tarayıcıda değil, sunucuda da kontrol edilir.

Siparişler

OpenCart siparişi Confirm Order adımında durum olmadan oluşturur (eksik bir sipariş). Braintree kart ödemesini kabul ettikten sonra bir durum alır. Reddedilen bir kart siparişi durumsuz bırakır ve müşteri onay adımında kalır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: bir satış tahsil edildi veya sipariş sekmesinde bir ön provizyon tahsil edildi. Varsayılan: İşleniyor.

Authorized Status: yalnızca ön provizyon: tutar ayrılır, henüz ödenmemiştir. Varsayılan: Ödeme bekleniyor, çünkü OpenCart'ta Beklemede durumu yoktur; sipariş notu ve sipariş sekmesi bunu açıklar. System > Localisation > Order Statuses altında kendi durumunuzu oluşturabilir ve buradan seçebilirsiniz.

On Hold (Review) Status: Braintree beklenmeyen bir işlem durumu döndürdü veya tahsil edilen tutar ya da para birimi eşleşmedi ve otomatik iptal (void) başarısız oldu. Bir not, neyi kontrol etmeniz gerektiğini açıklar. Varsayılan: Ödeme bekleniyor.

Voided Status: ön provizyon sipariş sekmesinde iptal edildi ve ayrılan tutar serbest bırakıldı. Varsayılan: İptal edildi.

Refunded Status: ödeme tamamen iade edildi veya mutabakattan önce tam iade olarak iptal edildi. Kısmi iadeler yalnızca bir not ekler. Varsayılan: İade edildi.

Gelişmiş

Debug log: API çağrılarını ve ödeme adımlarını ayrıca wc_btg_debug.log.php dosyasına (OpenCart günlükler klasörü, storage/logs) kaydeder. Dosya web üzerinden açılamaz. Bu kapalıyken bile hatalar her zaman kaydedilir. Günlük hiçbir zaman API anahtarlarını, kart veya müşteri verilerini içermez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data on uninstall: açıksa eklentinin kaldırılması, ağ geçidi ayarlarını ve günlüğü siler. Braintree işlemleri ve iadeleri her zaman kalır; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir, tahsil edilebilir veya iptal edilebilir. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Özel anahtarlar dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı özel anahtarlar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit / debit card). Confirm Order adımında müşteri sizin açıklamanızı ve mağazanın dilinde Braintree tarafından yüklenen Braintree kart formunu görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında form kartı kontrol eder; 3-D Secure açıksa müşteri bankasının doğrulamasını tamamlar. Sipariş toplamı, e-posta ve fatura adresi forma iletilir. Mağazanıza yalnızca tek kullanımlık bir jeton ulaşır. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle ve Payment method options penceresinde seçer. Kart formu bu durumda, ödeme sayfasının altındaki onay bloğunda, Confirm Order düğmesinin üstünde görünür. Mağaza bir ödeme adresi istemiyorsa (OpenCart 4 varsayılanı), 3-D Secure kontrolü bunun yerine teslimat adresini kullanır.

Ardından eklenti, jetonu sipariş para biriminde sipariş toplamı için Braintree API üzerinden tahsil eder; Braintree'de sipariş kimliği olarak OpenCart sipariş numarası kullanılır. Tahsil edilen tutar ve para birimi siparişle karşılaştırılır. Sipariş, Braintree ödemeyi kabul ettikten sonra, her zamanki e-posta ve stok güncellemesiyle birlikte standart OpenCart yöntemiyle durum alır. Sepet boşaltılır ve müşteri OpenCart sipariş başarı sayfasını görür.

Ödeme başarısız olursa sipariş durumsuz kalır, siparişe nedenini içeren bir not eklenir ve müşteri Confirm Order adımında bir mesajla kalı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 kartı yeniden girebilir ve hemen tekrar deneyebilir. Tahsil edilen para birimi veya tutar siparişle 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. Ödenmiş bir siparişin yeniden onaylanması müşteriyi doğrudan başarı sayfasına götürür; ön provizyonlu bir ödeme için A payment for this order has already been received and is awaiting review. gösterilir. Kart tahsil edildi ama OpenCart sipariş durumunu ayarlayamadıysa müşteri Your payment was received, but the order could not be completed automatically. Please contact us — do not pay again. mesajını görür. Aynı sepetle yapılan bir sonraki deneme, o siparişin durumunu kayıtlı işlemden yeniden tahsil etmeden ayarlar. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; bu nedenle tek bir sepetin birden fazla siparişi olabilir (OpenCart 4 ise ödeme sürecinde tek bir sipariş tutar ve onu günceller; reddedilen bir karttan sonra müşteri aynı siparişi öder): bunlardan biri ödendiğinde, aynı sepetin başka bir siparişi tahsil edilmez ve müşteri This cart has already been paid with order #…. Please check your order history — do not pay again. mesajını görür.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş bu arada mağaza tarafından kapatılmışsa (örneğin iptal edilmiş, iptal (void) edilmiş veya iade edilmişse) ya da zaten ödenmiş ve o zamandan beri sepet değişmişse (başka ürünler veya adetler), Confirm Order müşteriyi ödeme sayfasına geri gönderir; bu da sepetten kendi ödemesiyle yeni bir sipariş oluşturur. Aynı sepet iki kez gönderilirse yine başarı sayfasına gidilir ve ikinci kez tahsilat yapılmaz.

Eklenti yalnızca kart ödemelerini kabul eder. Kayıtlı kart, abonelik veya yinelenen ödeme, PayPal, Venmo, Apple Pay, Google Pay veya yerel ödeme yöntemleri desteği yoktur ve Braintree webhook'ları yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): Ödeme yapılmadı veya reddedildi. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): kart tahsil edildi (Sale) veya bir ön provizyon tahsil edildi. Bir not tutarı, Braintree işlem kimliğini ve 3-D Secure sonucunu gösterir.

Authorized Status (varsayılan Pending): Tutar yalnızca ön provizyonla ayrılmıştır (Authorize only). Bir not, gönderimden önce ödemeyi sipariş sayfasında tahsil etmenizi ister.

On Hold (Review) Status (varsayılan Pending): Braintree beklenmeyen bir işlem durumu döndürdü veya yanlış para birimindeki ya da yanlış tutardaki bir tahsilat otomatik olarak iptal edilemedi. Not, Braintree Control Panel'de neyi kontrol etmeniz gerektiğini açıklar.

Voided Status (varsayılan Canceled): bir ön provizyon iptal edildi.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Braintree Gateway sekmesi

Sales > Orders sayfasında Braintree ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Braintree Gateway sekmesi; sandbox ödemeleri için Sandbox etiketiyle birlikte Transaction ID'yi (ortamının Braintree Control Panel'indeki işleme bağlı olarak), işlemin Status değerini, Amount ve satıcı hesabını, 3-D Secure sonucunu, Charged / refunded tutarlarını, tahsilat, iptal ve iade düğmelerini, iade geçmişini ve siparişin Braintree notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir; düğmeler için eklentiyi değiştirme yetkisi gerekir (System > Users > User Groups altında ayarlanır).

Tahsilat ve iptal

Ön provizyonlu bir ödeme için, sipariş toplamını tahsil etmek amacıyla Capture Braintree payment düğmesine, ayrılan tutarı serbest bırakıp siparişi iptal etmek için Void Braintree authorization düğmesine tıklayın. Tahsilat siparişi Order Status After Payment durumuna, iptal ise Voided Status durumuna getirir. İşlem başarısız olursa hata sekmede gösterilir ve sipariş notlarına eklenir.

İadeler

VibeFox Braintree Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz Reason (optional) alanını da doldurun ve Refund via Braintree düğmesine tıklayın. Bu tutar Braintree üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir; hem tahsil edilmiş bir ödeme hem de incelemedeki bir ödeme için geçerlidir. İadeler, Braintree'nin tahsil ettiği tutar ve para biriminde yapılır. Braintree yalnızca mutabakatı tamamlanmış işlemleri iade eder; genellikle 24 saat içinde. Mutabakattan önce tam iade iptal (void) olarak yapılır; bu durumda kısmi iade, mutabakatı beklemeniz gerektiğini bildiren bir mesajla başarısız olur. İade, ödemenin yapıldığı ortama (sandbox veya canlı) gönderilir; bu nedenle o ortamın kimlik bilgileri girilmiş olmalıdır. Braintree iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded Status durumuna getirir; kısmi iade durumu değiştirmez. Sekmeden yapılan durum değişiklikleri müşteriye bildirim göndermez ve ürünleri stoğa geri eklemez; tıpkı elle yapılan bir durum değişikliği gibi.

Sales > Returns altındaki ürün iadeleri Braintree üzerinden para geri göndermez. İtirazlar (chargeback), mutabakat reddleri ve Braintree Control Panel'de yapılan iadeler OpenCart ile senkronize edilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Braintree Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Braintree Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: opencart-payment-braintree satırı ve hesabınızda vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresi değiştikten veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Braintree, ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza, yönetici girişini görmez; bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder; tahsilat, iptal ve iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim paneli Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

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 ortamda Merchant ID, Public Key ve Private Key bulunduğunu kontrol edin. Eksik bir anahtar olduğunda ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Kart tahsil edildi ama sipariş durumsuz kalıyor: kart ödemeleri webhook olmadan, anında onaylanır. Siparişin notlarına ve eklenti sayfasındaki Log alanına bakın. Bir not, 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 sahip bir işlem olup olmadığını kontrol edin. Tahsilattan sonra durum ayarlanamadıysa, aynı sepetle yapılan bir sonraki ödeme denemesi, yeniden tahsilat yapmadan durumu ayarlar.

Kart formu Could not initialize payment form mesajını gösteriyor: seçili ortamın anahtarları yanlış veya satıcı hesabı kimliği o hesapta yok. Anahtarları ve satıcı hesabı kimliklerini kontrol edin, ardından sayfayı yenileyin.

Müşteri Your session has expired. Please refresh the page and try again. mesajını görüyor: form açıkken ödeme oturumu değişti. Müşteri ödeme sayfasını yeniden yüklemelidir.

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

Müşteriye, ödemenin sipariş para biriminde işlenemediği bildiriliyor: Braintree, satıcı hesabının para biriminde tahsilat yaptı. Mevcut ortamın satıcı hesabı alanına, sipariş para birimi için satıcı hesabı kimliğini girin.

Müşteri The order total must be greater than zero to pay by card. mesajını görüyor: sipariş toplamı sıfır, örneğin bir kupon uygulandıktan sonra. Bu tür siparişler kartla ödenemez.

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

Sekmede düğme yok veya ortamla ilgili bir mesaj var: kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok, ya da ödeme sandbox veya canlı ortamda yapıldı ve o ortamın kimlik bilgileri girilmedi. Bilgileri girin ve yeniden deneyin.

Kaldırma

Extensions > Extensions sayfasına gidin, Payments türünü seçin ve VibeFox Braintree Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, sandbox modu, kimlik bilgileri, satıcı hesapları, işlem türü, 3-D Secure, hata ayıklama günlüğü) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanır. Braintree işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir, tahsil edilebilir veya iptal edilebilir. Mevcut siparişler kendi ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Braintree Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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