VibeFox Tranzila for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: ILS, USD, EUR veya GBP. Diğer müşteri para birimleri için ödeme yöntemi ödeme sayfasında gizlenir.

Tranzila terminali: terminal adına ihtiyacınız vardır. Terminal şifresi (TranzilaPW), handshake için ve sipariş sayfasından yapılan iadeler için gereklidir. Bazı terminaller iadeler için ayrıca bir kredi şifresi (CreditPass) ister. Terminal adı ve şifreler Tranzila tarafından sağlanır: terminal ayarlarınıza bakın ya da Tranzila desteğine sorun. Test için Tranzila ayrı bir test terminali verir; adını terminal adı olarak girin.

Gerçek ziyaretçi IP'si: ödeme bildirimleri Tranzila sunucusunun IP adresine göre kontrol edilir. Mağazanız Cloudflare gibi bir proxy veya CDN'in arkasındaysa, web sunucusu gerçek ziyaretçi IP'sini PHP'ye iletmelidir (REMOTE_ADDR).

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. Dosyada README.txt, OpenCart 3 paketi wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_tranzila_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze ait paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_tranzila_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümü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 bölümüne gidin ve tür olarak Payments seçin. VibeFox Tranzila Payment Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri 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. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Terminal name (supplier) alanını ve handshake ya da iadeleri kullanıyorsanız Terminal password (TranzilaPW) alanını doldurun.

5. Notifications seçeneğini açık tutun ve Trusted IP alanını kontrol edin: Tranzila'nın bildirim gönderdiği IP adreslerini içermelidir. Listeyi Tranzila desteğiyle doğrulayın. Bildirim URL'si her ödemeyle birlikte gönderilir, bu nedenle onu bir yere kopyalamanız gerekmez.

6. Önerilir: Tranzila terminalinde handshake'i etkinleştirin, orada sunucunuzun IP adresine izin verin, ardından eklentide Handshake seçeneğini açın.

7. Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve Tranzila test terminaliyle bir ödeme deneyin.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_tranzila_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

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

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox Tranzila Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları OpenCart 3 için 3 ila 7. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

Yeni bir kurulum, ödeme yöntemi kapalı olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Tranzila Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa; terminal adı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), bildirimler kapalıysa veya Trusted IP boşsa (ödenen siparişler bu durumda manuel inceleme için beklemeye alınır), handshake terminal şifresi olmadan açıksa (ödeme sayfası açılamaz) ve mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken sayfa hiçbir zaman her şeyi birden reddetmez. Boş veya 128 karakterden uzun bir Title, geçersiz bir terminal adı, Trusted IP içinde geçersiz bir giriş, tam sayı olmayan bir sayı alanı veya geçersiz bir Sort Order, Total, Geo Zone ya da sipariş durumu kaydedilmez: sayfa mesajı ayarların üstünde kırmızı bir blokta gösterir ve alan önceki değerini tekrar gösterir. İzin verilen aralığın dışındaki bir sayı, en yakın izin verilen değer olarak kaydedilir ve sayfa bunu bildirir; örneğin 5000 değerinin 400–1500 aralığının dışında olduğunu ve 1500 olarak kaydedildiğini gösterir. Diğer tüm alanlar kaydedilir.

Tranzila

Enable/Disable: Enable Tranzila Payment Gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi adı ve ödeme sayfasının başlığı. Siparişte de ödeme yöntemi adı olarak saklanır; bu nedenle zorunludur ve en fazla 128 karakter olabilir. Varsayılan: Credit Card (Tranzila).

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely with your credit card on the Tranzila payment page.

Sort Order: ödeme sırasında Tranzila'nın ödeme yöntemleri arasındaki konumu. Boş bırakın veya tam sayı girin (negatif değerlere izin verilir).

Geo Zone: Tranzila'yı yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Tranzila'nın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme tutarı. Herhangi bir tutar için Tranzila sunmak üzere boş bırakın.

Terminal

Terminal name (supplier): Tranzila terminal adınız, örneğin myshop. Yalnızca harfler, rakamlar, "-" ve "_". Girilene kadar ödeme yöntemi ödeme sayfasında görünmez. Test için Tranzila test terminalinizin adını girin.

Terminal password (TranzilaPW): terminalin API şifresi. Handshake ve sipariş sayfasından yapılan iadeler için gereklidir.

Refund password (CreditPass): yalnızca terminaliniz kredi (iade) işlemleri için ayrı bir şifre istiyorsa. Aksi halde boş bırakın.

Kaydedilmiş şifreler bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir şifreyi kaldırmak için alanın altındaki Clear saved password on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme sayfası

Payment page version: iFrame içinde gösterilen Tranzila sayfası.

Payment page language: Tranzila sayfasının dili: Site language, İbranice, İngilizce, Rusça, İspanyolca, Almanca, Fransızca veya Japonca. Varsayılan: Hebrew. Site language, müşterinin mağaza dili bu dillerden biriyse onu kullanır; değilse İngilizce.

iFrame width (px): 300 ile 1200 arası. Varsayılan: 600. Küçük ekranlarda çerçeve hiçbir zaman sayfadan geniş olmaz.

iFrame height (px): 400 ile 1500 arası. Varsayılan: 650.

Max installments: müşterinin ödeme sayfasında seçebileceği en fazla taksit (tashlumim) sayısı, 36'ya kadar. 0 veya 1 taksit yok anlamına gelir. Varsayılan: 0. Terminalin taksit işlemesine izin verilmiş olmalıdır.

Handshake: tutarı bir handshake jetonuyla kilitler (önerilir). Ödeme sayfası açılmadan önce mağaza, Tranzila'dan tutara bağlı, tek kullanımlık bir jeton ister; böylece tutar tarayıcıda değiştirilemez. Terminal şifresi, Tranzila terminalinde handshake'in etkin olması ve sunucunuzun IP adresinin orada izinli olması gerekir. Varsayılan: off.

Ödeme onayı

Tranzila bildirimleri imzalanmamıştır. Bir sipariş yalnızca bildirim bir Trusted IP'den geldiğinde ve ödeme sayfası jetonu, sipariş, terminal, tutar ve para birimi ödeme sayfasıyla eşleştiğinde ödenmiş durumunu alır. Handshake ile jeton da eşleşmelidir. Müşterinin ödeme sayfasından dönüşü hiçbir zaman bir siparişi ödenmiş olarak işaretlemez.

Notifications: ödemeleri Tranzila bildirimleriyle (bildirim URL'si) otomatik olarak onaylar. Varsayılan: on. Bildirimler kapalıyken, başarılı bir ödeme sayfasından dönen müşteri siparişi On hold status durumuna alır ve Tranzila terminalini kontrol ettikten sonra ödemeyi manuel olarak onaylarsınız.

Notification URL: bilgi amacıyla gösterilir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_tranzila_payment_gateway/notify; OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_tranzila_payment_gateway/payment/wcp_tranzila_payment_gateway.notify. URL, OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL her ödemeyle birlikte Tranzila'ya gönderilir, bu nedenle Tranzila terminaline girmeniz gerekmez. Mağaza bakım modundayken de çalışır (OpenCart 4'te eklentinin bir başlangıç eylemi bildirimin ve müşteri dönüşünün geçmesine izin verir).

Trusted IP: bildirim gönderen Tranzila sunucularının IP adresleri veya CIDR aralıkları, virgülle ayrılmış. Varsayılan: 80.244.170.7. Güncel listeyi Tranzila desteğiyle doğrulayın. Diğer adreslerden gelen bildirimler reddedilir. Alan boşsa bildirimler doğrulanamaz: bildirilen başarılı bir ödeme siparişi manuel inceleme için On hold status durumuna alır, bildirilen bir red ise hiçbir şeyi değiştirmez.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş yalnızca doğrulanmış bir Tranzila bildiriminden sonra bir durum alır. OpenCart'ta On hold durumu yoktur; bu nedenle burada seçtiğiniz durum kullanılır ve bir sipariş notu nedenini açıklar. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order status after payment: ödeme, doğrulanmış bir bildirimle onaylandı (tutar, para birimi, terminal ve jeton eşleşiyor). Varsayılan: Processing.

On hold status: ödemenin sizin incelemenize ihtiyacı var: tutar, para birimi veya handshake jetonu farklı, bildirim doğrulanamadı (Trusted IP yok) ya da bildirimler kapalı ve müşteri başarılı bir ödeme sayfasından döndü. Varsayılan: Pending. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Refunded status: ödeme sipariş sayfasından tamamen iade edildiğinde ayarlanır. Varsayılan: Refunded.

Cancelled order status: eklenti bunu ayarlamaz. Bu durumdaki ve daha sonra ödenen bir sipariş, stoku kontrol etmenizi hatırlatan bir notla yeniden açılır. Varsayılan: Canceled.

Payment error status: eklenti bunu ayarlamaz. Bu durumdaki bir sipariş, daha sonra onaylanan bir Tranzila ödemesiyle ödenir. Varsayılan: Failed.

Gelişmiş

Debug log: ödeme sayfası, bildirim ve iade olaylarını OpenCart günlükler klasöründeki (storage/logs; OpenCart 4'te system/storage/logs) tranzila_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında tranzila_p_debug.old.log.php dosyasına taşınır. Bu seçenek kapalı olsa bile uyarılar ve hatalar her zaman kaydedilir. Şifreler, jetonlar ve müşteri verileri hiçbir zaman yazılmaz. Varsayılan: off.

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

Delete data on uninstall: açıksa, eklentiyi kaldırmak ayarları ve günlüğü siler. Tranzila işlemleri ve iadeleri her zaman korunur, çünkü eski siparişler bunlara ihtiyaç duyar. Varsayılan: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Şifreler 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ı şifreler korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Tranzila)). Confirm Order adımında müşteri sizin açıklamanızı ve After you confirm, you will enter your card details on the secure Tranzila payment page. The order is confirmed once Tranzila confirms the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında, mağazanızın bir ödeme sayfasına gider. Orada Tranzila ödeme sayfası bir iFrame içinde açılır; sipariş tutarı sipariş para biriminde, fatura bilgileri ve kısa bir ürün listesi gösterilir. Sayfada Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". yazar. Çerçevenin altında Choose another payment method bağlantısı bulunur. Taksitlere izin veriliyorsa müşteri taksit sayısını Tranzila sayfasında seçer. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve sayfanın altındaki Confirm Order düğmesine tıklar.

Ödeme sayfasının her gösterimi, kendi jetonu (ve handshake jetonu) ile yeni bir ödeme denemesidir. Sayfayı yenilemek, aynı müşteri oturumundaki sipariş için yeni bir deneme açar; başka bir tarayıcıda açılan bir ödeme sayfası bağlantısı ise sizi yeniden ödeme sayfasına yönlendirir.

Başarılı bir ödemeden sonra Tranzila müşteriyi geri gönderir ve tüm pencere ilerler. Sipariş, Tranzila bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Sipariş daha sonra OpenCart'ın standart yöntemiyle durum alır; olağan sipariş e-postaları ve stok güncellemesi yapılır. Beklemedeki bir sipariş daha sonra ödenirse müşteri, siparişin yeni durumuyla ilgili e-postayı alır. Bildirim zaten geldiyse müşteri Your payment with Tranzila has been received. ifadesiyle OpenCart sipariş başarı sayfasını görür. Sipariş inceleme için beklemedeyse sayfa Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. gösterir. Bildirim henüz gelmediyse bir Payment confirmation sayfası Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. yazısını ve Check again ile Back to checkout düğmelerini gösterir.

Ödeme reddedilir veya iptal edilirse müşteri The payment was not completed. You have not been charged — please try again or choose another payment method. mesajıyla ödeme sayfasına döner. Tranzila bir yanıt kodu bildirirse neden ve kod eklenir; örneğin kartın son kullanma tarihinin geçmiş olması gibi. Sepet korunur ve sipariş durumsuz kalır. OpenCart 4'te bu mesaj ödeme sayfasının üstünde gösterilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi ödeme adımında günceller; bu siparişlerden biri tarafından zaten ödenmiş bir sepet yeniden tahsil edilmez. Sepette, yeni bir adet dahil, yapılan her değişiklik kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Reddedilen bir ödemeden sonra müşteri aynı siparişi yeni bir ödeme denemesiyle yeniden öder. Bu sipariş bu arada kapatıldıysa (örneğin siz iptal ettiyseniz) ya da o zamandan beri değişmiş bir sepet için ödendiyse, müşteri This order can no longer be paid. Please confirm your order again. mesajıyla ödeme adımına geri gönderilir ve bir sonraki Confirm Order yeni bir sipariş öder.

Ödeme sayfası açılamazsa, örneğin handshake başarısız olduğunda, müşteri Confirm Order adımında düğmenin üstünde kısa bir mesajla kalır, örneğin Could not connect to Tranzila. Please try again in a moment. Teknik neden günlüğe yazılır.

Eklenti yalnızca Tranzila sayfasındaki tek seferlik kart ödemelerini kabul eder. Kayıtlı kartları veya jetonları, abonelikleri, ayrı yetkilendirme ve tahsilatı (J5), kendi Bit, Apple Pay veya Google Pay düğmelerini (Tranzila ödeme sayfanızın sunduğu her şey iFrame içinde gösterilir) ve Tranzila faturalarını desteklemez.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri ödeme sayfasına yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya Tranzila bildirimi henüz gelmedi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür. OpenCart 4.1'de böyle bir sipariş Voided durumunda da olabilir; bu durum, onay adımı yeniden gösterildiğinde OpenCart tarafından ayarlanır. Eklenti bunu durumsuz bir sipariş olarak sayar.

Ödeme sonrası sipariş durumu (varsayılan Processing): ödeme doğrulanmış bir bildirimle onaylandı. Bir not; tutarı, Tranzila işlemini (index), yetkilendirme numarasını ve varsa taksit sayısını gösterir.

On hold status (varsayılan Pending): ödeme bildirildi ama otomatik olarak kabul edilmedi: tutar, para birimi veya handshake jetonu eşleşmedi; Trusted IP boş olduğu için bildirim doğrulanamadı; ya da bildirimler kapalı ve müşteri başarılı bir ödeme sayfasından döndü. Not nedenini açıklar. Ödemeyi Tranzila terminalinde kontrol edin ve durumu manuel olarak değiştirin.

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

Bekletilmiş, iptal edilmiş veya ödeme hatası durumundaki bir sipariş için ödeme gelirse sipariş Order status after payment durumunu alır; iptal edilmiş bir sipariş ayrıca göndermeden önce stoku kontrol etmenizi isteyen bir not alır. Zaten ödenmiş veya iade edilmiş bir sipariş için ya da zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme gelirse sipariş değiştirilmez. Ödenmiş siparişteki bir not, onu kontrol etmenizi ve mükerrer ödemeyi Tranzila terminalinde iade etmenizi ister. Aynı işleme ait tekrarlanan bildirimler yok sayılır.

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

VibeFox Tranzila Payment Gateway sekmesi

Sales > Orders bölümünde Tranzila ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Tranzila Payment Gateway sekmesi Transaction (index), Authorization, Terminal, Status, Paid / refunded tutarlarını, Installments sayısını, iade formunu, iade geçmişini, sonucuyla birlikte tüm Payment pages of the cart kayıtlarını ve siparişin Tranzila notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Tranzila Payment Gateway sekmesinde Amount alanına girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Tranzila düğmesine tıklayın. Refund this amount via Tranzila? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde sale/order). İade, orijinal ödemenin Tranzila kredi işlemi olarak, ödemeyi tahsil eden terminal üzerinden, Tranzila'nın gerçekte tahsil ettiği tutar ve para biriminde yapılır. Bu nedenle bir tutar veya para birimi uyuşmazlığından sonra, sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz.

Form, terminal şifresi ayarlandığında ve siparişin onaylanmış bir Tranzila işlemi olduğunda kullanılabilir. Aksi halde sekme nedenini gösterir, örneğin Refunds need the terminal password (TranzilaPW) in the gateway settings. Ayarlardaki mevcut terminalden farklı bir terminalde (örneğin bir test terminalinde) ödenen bir sipariş sipariş sayfasından iade edilemez; o Tranzila terminalinde iade edin.

Tranzila iadeyi kabul etmezse sekme, örneğin kodu ve anlamıyla birlikte Tranzila declined the refund hatasını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Tranzila kredi işlemiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirim göndermeden ve manuel bir durum değişikliği gibi ürünleri stoka geri koymadan siparişi Refunded status durumuna alır. Kısmi iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri Tranzila üzerinden para geri göndermez. Tranzila terminalinde yapılan iadeler mağazaya bildirilmez. Gerekirse siparişi manuel olarak güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Tranzila Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Tranzila Payment 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-tranzila satırı ve 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 yetkisine sahip 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 tarihle birlikte License expired on. Mağaza adresi değiştikten sonra 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 adresinde. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Tranzila, ödeme sırası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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; 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örmediği için etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler Tranzila bildirimi ve müşterinin mağazaya dönüşüyle yine onaylanır, iadeler de çalışır.

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

Sorun giderme

Tranzila ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, Terminal name (supplier) alanının doldurulduğunu ve müşterinin para biriminin ILS, USD, EUR veya GBP olduğunu kontrol edin. Ayarlar sayfası, terminal adı eksikse veya varsayılan para birimi desteklenmiyorsa uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin.

Ödeme geçti ama sipariş durumsuz kalıyor: bildirim gelmedi veya reddedildi. Notifications seçeneğinin açık olduğunu ve Trusted IP alanının Tranzila'nın bildirim gönderdiği adresleri içerdiğini kontrol edin. Hatalar her zaman günlüğe yazılır; eklenti sayfasındaki Log alanına bakın. Bir IP'nin Trusted IP listesinde olmadığı mesajı, Trusted IP ayarının veya proxy yapılandırmanızın düzeltilmesi gerektiği anlamına gelir: bir proxy veya CDN'in arkasında web sunucusu gerçek ziyaretçi IP'sini PHP'ye iletmelidir. Mağazası güvenilir bir ters proxy arkasında olan geliştiriciler için eklenti, IP'yi ayarlamak üzere OpenCart olayı wcp_tranzila_payment_gateway/remote_ip'i tetikler.

Bildirim Forbidden yanıtı veriyor: Trusted IP içinde olmayan bir IP adresinden gelmiş.

Bildirim Bad request veya Not found yanıtı veriyor: bildirimdeki sipariş, ödeme sayfası jetonu, terminal veya işlem indeksi bu mağazanın hiçbir ödeme sayfasıyla eşleşmiyor.

Bildirim Accepted for manual review yanıtı veriyor: Trusted IP boş olduğu için bildirim doğrulanamadı. Başarılı bir ödeme siparişi beklemeye alır. Ödemeleri otomatik onaylamak için Trusted IP alanını doldurun.

Bildirim Busy, retry yanıtı veriyor: sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş durumu ayarlanamadı. Günlük nedeni gösterir. Ödemeyi Tranzila terminalinde kontrol edin.

Bazı siparişler beklemede durumunda: VibeFox Tranzila Payment Gateway sekmesindeki notları okuyun. Tutar, para birimi veya handshake jetonu eşleşmedi ya da bildirim doğrulanamadı (Trusted IP boş veya bildirimler kapalı). Ödemeyi Tranzila terminalinde kontrol edin ve durumu manuel olarak değiştirin.

Handshake açıkken ödeme sayfası açılmıyor: terminal adını ve terminal şifresini, Tranzila terminalinde handshake'in etkin olup olmadığını ve sunucunuzun IP adresinin orada izinli olup olmadığını kontrol edin. Günlük nedeni gösterir.

İadeler başarısız oluyor: iadeler Terminal password (TranzilaPW) gerektirir. Bazı terminaller ayrıca ayrı bir kredi şifresi ister; bunu Refund password (CreditPass) alanına girin. Başka bir terminalde ödenmiş siparişler o terminalde iade edilmelidir. Tranzila'nın yanıtı beklenmedik ise sekme iadenin onaylanmadığını belirtir: tekrar denemeden önce Tranzila terminalini kontrol edin. Siparişleri değiştirme yetkiniz yoksa sekme You do not have permission to refund orders. gösterir.

Diğer para birimleri: eklenti yalnızca ILS, USD, EUR ve GBP'yi destekler.

Geliştiriciler için: ödeme sayfası gösterilmeden önce eklenti, ödeme sayfası ve sipariş alanlarıyla birlikte OpenCart olayı wcp_tranzila_payment_gateway/payment_page_params'ı tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Tranzila Payment 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. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda bildirimin ve müşteri dönüşünün geçmesine izin veren başlangıç eylemi de). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, terminal, şifreler, ödeme sayfası, ödeme onayı, günlükleme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Tranzila işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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