VibeFox Tranzila for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Mağaza para birimi: ILS, USD, EUR veya GBP. Diğer sepet 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 ve sipariş sayfasından iadeler için gereklidir. Bazı terminaller iadeler için ayrıca bir kredi şifresi (CreditPass) da ister. Terminal adı ve şifreler Tranzila tarafından sağlanır: terminal ayarlarınıza bakın veya Tranzila destek ekibine sorun. Tranzila'nın herkese açık bir sandbox ortamı yoktur. Test için Tranzila size ayrı bir test terminali verir; adını terminal adı olarak girin.

Ziyaretçinin gerçek IP adresi: ödeme bildirimleri, Tranzila sunucusunun IP adresine göre kontrol edilir. Mağazanız Cloudflare gibi bir proxy veya CDN arkasındaysa, web sunucusu ziyaretçinin gerçek IP adresini 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

1. Back office'te Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Tranzila Payment Gateway öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı, Configure sayfasının üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Handshake veya iadeleri kullanıyorsanız Terminal name (supplier) alanına terminal adını, Terminal password (TranzilaPW) alanına da terminal şifresini girin.

5. Notifications seçeneğini açık tutun ve Trusted IP alanını kontrol edin: Tranzila'nın bildirimleri gönderdiği IP adreslerini listelemelidir. Listeyi Tranzila destek ekibiyle doğrulayın.

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

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

Kurulumda modül Tranzila payment on hold sipariş durumunu oluşturur. PrestaShop, yeni bir ödeme modülüne tüm para birimlerini, ülkeleri ve müşteri gruplarını varsayılan olarak sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Tranzila Payment Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanları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 (ödenmiş 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. Kaydetme sırasında geçersiz bir terminal adı, Trusted IP alanındaki geçersiz bir giriş veya tam sayı olmayan bir sayı alanı kaydedilmez: sayfa bir hata gösterir ve önceki değer korunur. İzin verilen aralığın dışındaki bir sayı, en yakın izin verilen değer olarak kaydedilir ve sayfa bunu size bildirir.

Tranzila

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı ve ödeme sayfasının başlığı. Ayrıca siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Credit Card (Tranzila).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit card on the Tranzila payment page.

Terminal

Terminal name (supplier): Tranzila terminal adınız, örneğin myshop. Yalnızca harf, rakam, "-" ve "_" kullanılabilir. Girilene kadar ödeme yöntemi ödeme sayfasında gösterilmez. Test için Tranzila test terminalinizin adını girin.

Terminal password (TranzilaPW): terminalin API şifresi. Handshake ve sipariş sayfasından 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.

Kayıtlı ş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.

Clear saved passwords: bir şifreyi işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan kayıtlı değeri korur.

Ö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: İbranice. Site language, müşterinin sepetinin 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 sayısı (tashlumim), en fazla 36. 0 veya 1, taksit yok anlamına gelir. Varsayılan: 0. Terminalin taksitli işlem yapmasına izin verilmiş olmalıdır.

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

Ödeme onayı

Tranzila bildirimleri imzalı değildir. Bir sipariş, bildirim Trusted IP'den geldiğinde ve ödeme sayfası jetonu, sepeti, terminali, tutarı ve para birimi ödeme sayfasıyla eşleştiğinde ödenmiş olarak oluşturulur. Handshake ile jeton da ödeme sayfasıyla eşleşmelidir. Müşterinin ödeme sayfasından dönmesi bir siparişi asla ödenmiş olarak işaretlemez.

Notifications: Tranzila bildirimleri (notify URL) ile ödemeleri otomatik onaylar. Varsayılan: açık. Bildirimler kapalıyken, başarılı bir ödeme sayfasından dönen müşteri siparişi Tranzila payment on hold durumunda oluşturur ve Tranzila terminalini kontrol ettikten sonra ödemeyi manuel olarak onaylarsınız.

Notification URL: bilgi amaçlı gösterilir. Dostça URL'lerle şu biçimde görünür: https://your-shop/module/wcp_tranzila_payment_gateway/notify, başında bir dil kodu olabilir. URL her ödemede Tranzila'ya gönderildiği için Tranzila terminaline girmeniz gerekmez.

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 destek ekibiyle 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 Tranzila payment on hold durumunda oluşturur, bildirilen bir red ise hiçbir şeyi değiştirmez.

Gelişmiş

Debug log: ödeme sayfası, bildirim ve iade olaylarını modül klasöründeki logs/tranzila_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Uyarılar ve hatalar bu seçenek kapalı olsa bile her zaman kaydedilir. Şifreler, jetonlar ve müşteri verileri hiçbir zaman yazılmaz. 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çıkken modül kaldırıldığında ayarlar ve günlükler silinir. Tranzila işlemleri ve iadeleri ile Tranzila payment on hold sipariş durumu her zaman kalır, çünkü eski siparişler bunlara ihtiyaç duyar. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Tranzila)) ve açıklamayı ile After you confirm, you will enter your card details on the secure Tranzila payment page. The order is created once Tranzila confirms the payment. notunu görür. Onayladıktan sonra müşteri mağazanızın bir ödeme sayfasına gider. Orada, sepet tutarı sepet para biriminde, fatura bilgileri ve kısa bir ürün listesiyle birlikte Tranzila ödeme sayfası bir iframe içinde açılır. Sayfa Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". ifadesini gösterir. Choose another payment method bağlantısı çerçevenin altındadır. Taksit izin veriliyorsa müşteri taksit sayısını Tranzila sayfasında seçer. Bu noktada henüz bir sipariş yoktur.

Başarılı bir ödemeden sonra Tranzila müşteriyi geri gönderir ve tüm pencere ilerler. Sipariş, yalnızca Tranzila ödemeyi bir bildirimle onayladıktan sonra ödenmiş olarak işaretlenir. Bildirim zaten geldiyse müşteri standart sipariş onay sayfasını Your payment with Tranzila has been received. ifadesiyle 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. ifadesini gösterir. Bildirim henüz gelmediyse 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. ifadesini ve Check again düğmesini 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 adımına döner. Tranzila bir yanıt kodu bildirirse neden ve kod eklenir, örneğin kartın son kullanma tarihinin geçmiş olması. Sepet korunur ve sipariş oluşturulmaz. Ödeme sayfası her açıldığında, kendi jetonuna sahip yeni bir ödeme sayfasıdır.

Ödeme sayfası açılamazsa, örneğin handshake başarısız olduğunda, müşteri Could not connect to Tranzila. Please try again in a moment. gibi kısa bir mesaj ve Choose another payment method düğmesini görür. Teknik neden günlüğe yazılır.

Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez. Aynı ödeme sayfası Classic ve Hummingbird temalarıyla kullanılır.

Modül yalnızca Tranzila sayfasında tek seferlik kart ödemelerini kabul eder. Kayıtlı kart veya jeton, abonelik, ayrı ön provizyon ve tahsilat (J5), kendi Bit, Apple Pay veya Google Pay düğmeleri (Tranzila ödeme sayfanızın sunduğu her şey iframe içinde gösterilir) ve Tranzila faturaları yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri ödeme sayfasına yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya Tranzila bildirimi henüz gelmedi. Yalnızca sepet vardır.

Payment accepted: ödeme doğrulanmış bir bildirimle onaylandı. Ödeme, Tranzila işlem indeksiyle işlem kimliği olarak kaydedilir; bir not tutarı, işlemi, onay numarasını ve varsa taksit sayısını gösterir.

Tranzila payment on hold: ö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ıyken 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: ödeme modül üzerinden tamamen iade edildi.

İptal edilmiş bir sipariş için ödeme gelirse, sipariş yeniden Payment accepted durumuna alınır ve sevkiyattan önce stoğu kontrol etmenizi isteyen bir not eklenir. Zaten ödenmiş veya iade edilmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunu kontrol edip çiftleneni Tranzila terminalinde iade etmenizi ister. Aynı işleme ait tekrarlanan bildirimler yok sayılır.

Tranzila ödeme bloğu

Sipariş sayfasında işlem indeksi, onay numarası, terminal, durum, ödenen ve iade edilen tutar, taksit sayısı, iade geçmişi, sonuçlarıyla birlikte tüm Payment pages of the cart ve siparişin Tranzila notes bölümü ile birlikte bir Tranzila payment bloğu gösterilir.

İadeler

Tranzila payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden 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 düzenleme yetkisine sahip olmanız gerekir; Modül sayfalarına erişim gerekmez. İade, orijinal ödemenin bir Tranzila kredi işlemi olarak, ödemeyi alan terminal üzerinden ve Tranzila'nın gerçekte tahsil ettiği tutar ve para biriminde yapılır. Bu nedenle tutar veya para birimi uyuşmazlığından sonra, sipariş toplamını değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz.

Form, terminal şifresi girildiğinde ve siparişte onay numaralı, onaylanmış bir Tranzila işlemi olduğunda kullanılabilir. Aksi halde blok nedenini gösterir, örneğin Refunds need the terminal password (TranzilaPW) in the gateway settings. Şu anda ayarlardaki terminalden farklı bir terminalde (örneğin bir test terminalinde) ödenmiş bir sipariş sipariş sayfasından iade edilemez; o Tranzila terminalinde iade edin.

Tranzila iadeyi kabul etmezse blok hatayı gösterir, örneğin kodu ve anlamıyla birlikte Tranzila declined the refund, ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve Tranzila kredi işlemiyle birlikte notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notları (credit slips) oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri, Tranzila üzerinden para iadesi yapmaz. Tranzila terminalinde yapılan iadeler mağazaya bildirilmez. Gerekirse siparişi manuel olarak güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Tranzila Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox Tranzila Payment Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now düğmesini, durumu yeniden kontrol etmek için, Change key düğmesini başka bir anahtar girmek için ve Remove key düğmesini anahtarı bu mağazadan kaldırmak için gösterir. Bunların altında Product: presta-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 modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

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

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 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. PrestaShop vitrini, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ama ödeme sırasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler, müşteri ödeme sayfasından mağazaya döndüğünde ve Tranzila bildirimi geldiğinde onaylanır; iadeler çalışmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman 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 sepet para biriminin ILS, USD, EUR veya GBP olduğunu kontrol edin. Terminal adı eksikse veya varsayılan para birimi desteklenmiyorsa ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: bildirim gelmedi veya reddedildi. Notifications seçeneğinin açık olduğunu ve Trusted IP alanında Tranzila'nın bildirim gönderdiği adreslerin bulunduğunu kontrol edin. Hatalar her zaman günlüğe yazılır; modül sayfasındaki Log alanına bakın. Bir IP'nin Trusted IP listesinde olmadığına dair mesaj, Trusted IP ayarının veya proxy yapılandırmanızın düzeltilmesi gerektiği anlamına gelir: proxy veya CDN arkasında web sunucusu ziyaretçinin gerçek IP adresini PHP'ye iletmelidir. Mağazası güvenilir bir ters proxy arkasında olan geliştiriciler, IP'yi actionTranzilaPRemoteIp hook'uyla ayarlayabilir.

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

Bildirim Bad request veya Not found yanıtı veriyor: bildirimdeki sepet, ö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 alarak oluşturur. Ödemelerin otomatik onaylanması 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ş oluşturulamadı (örneğin modül devre dışı). Günlükte neden görünür. Ödemeyi Tranzila terminalinde kontrol edin; orada onaylıysa ve sipariş oluşturulmadıysa müşteriyle iletişime geçin veya siparişi manuel oluşturun.

Bazı siparişler Tranzila payment on hold durumunda: Tranzila payment bloğundaki 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 olduğunu ve sunucunuzun IP adresinin orada izinli olduğunu kontrol edin. Günlük nedeni gösterir.

İadeler başarısız oluyor: iadeler Terminal password (TranzilaPW) gerektirir. Bazı terminaller ayrıca 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ı beklenmedikse blok iadenin onaylanmadığını belirtir: tekrar denemeden önce Tranzila terminalini kontrol edin.

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

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Tranzila Payment Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ayarlar ve günlükler silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Tranzila işlemleri ve iadeleri ile Tranzila payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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