VibeFox Tranzila for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: ILS, USD, EUR veya GBP. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Tranzila terminali: terminal adına ihtiyacınız vardır. Terminal şifresi (TranzilaPW), handshake ve WooCommerce'ten yapılan iadeler için gereklidir. Bazı terminallerde iadeler için ayrı bir kredi şifresi (CreditPass) da gerekir. Terminal adı ve şifreler Tranzila tarafından sağlanır: terminal ayarlarınıza bakın veya Tranzila destek ekibine danışın. Tranzila'nın herkese açık bir sandbox ortamı yoktur. Test için Tranzila ayrı bir test terminali sağlar; bu terminalin adını terminal adı olarak girin.

Gerçek ziyaretçi IP adresi: ödeme bildirimleri Tranzila sunucusunun IP adresine göre kontrol edilir. Siteniz Cloudflare gibi bir proxy veya CDN arkasındaysa, web sunucusunun gerçek ziyaretçi IP adresini PHP'ye (REMOTE_ADDR) iletmesi gerekir.

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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_tranzila_payment_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Tranzila > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Terminal name (supplier) alanını doldurun; handshake veya iadeleri kullanacaksanız Terminal password (TranzilaPW) alanını da doldurun.

6. 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 destek ekibiyle doğrulayın.

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

8. Enable/Disable seçeneğini açın ve Tranzila test terminaliyle bir ödeme deneyin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Tranzila. 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ğaza para birimi desteklenmiyorsa sizi uyarır. Kaydetme sırasında geçersiz bir terminal adı veya Trusted IP girişi kaydedilmez: sayfa bir hata gösterir ve önceki değer korunur. İzin verilen aralığın dışındaki sayılar, izin verilen en yakın değere düzeltilir.

General

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ı. 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 harfler, rakamlar, «-» 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 WooCommerce'ten yapılan iadeler için gereklidir.

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

Payment page

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

Payment page language: Tranzila sayfasının dili: Site language, Hebrew, English, Russian, Spanish, German, French veya Japanese. Varsayılan: Hebrew. Site language, ziyaretçinin WordPress yerel ayarı bu dillerden biriyse onu kullanır; değilse English kullanılır.

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 olmadığı anlamına gelir. Varsayılan: 0. Terminalin taksitli işlem yapmasına izin verilmiş olmalıdır.

Handshake: Lock the amount with a handshake token (recommended). Ödeme sayfası açılmadan önce mağaza, Tranzila'dan sipariş tutarına 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: kapalı.

Payment confirmation

Tranzila bildirimleri imzalanmaz. Bir sipariş, bildirim bir Trusted IP adresinden geliyorsa ve sipariş anahtarı, terminali, tutarı ve para birimi siparişle eşleşiyorsa ödenmiş olarak işaretlenir. Handshake açıkken jeton, siparişin ödeme sayfasıyla da eşleşmelidir. Müşterinin ödeme sayfasından dönmesi bir siparişi asla ödenmiş olarak işaretlemez.

Notifications: Confirm payments automatically with Tranzila notifications (notify URL). Varsayılan: açık. Bildirim URL'si her ödemede Tranzila'ya gönderilir, bu yüzden onu Tranzila terminaline girmeniz gerekmez. Şu biçimdedir: https://your-site/wc-api/tranzila_p_callback/ ve alanın altında gösterilir. Bildirimler kapalıyken, başarılı bir ödeme sayfasından dönen müşterinin siparişi beklemeye alınır ve ödemeyi Tranzila terminalinde kontrol ettikten sonra manuel olarak onaylarsınız.

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 beklemeye alır, bildirilen bir red ise siparişi değiştirmez.

Advanced

Debug log: Log payment page, notification and refund events, WooCommerce > Status > Logs bölümüne, kaynak wcp_tranzila_payment_gateway olarak yazar. Hatalar bu seçenek kapalı olsa bile her zaman kaydedilir. Şifreler, jetonlar ve müşteri verileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Delete the settings, logs and Tranzila order data when the plugin is deleted. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Tranzila)) ve Continue to payment düğmesine tıklar. Sipariş Ödeme bekleniyor durumuyla oluşturulur ve müşteri mağazanızın sipariş ödeme sayfasına yönlendirilir. Orada, sipariş tutarı sipariş para biriminde, fatura bilgileri ve sipariş edilen ürünlerin kısa bir listesiyle birlikte Tranzila ödeme sayfası bir iframe içinde açılır. Sayfada Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". yazar. Choose another payment method bağlantısı çerçevenin altındadır. Taksit izinliyse müşteri taksit sayısını Tranzila sayfasında seçer.

Başarılı bir ödemeden sonra Tranzila müşteriyi geri gönderir ve tüm pencere mağazanızın sipariş alındı sayfasına geçer. Sipariş, Tranzila bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. O zamana kadar sayfa 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. gösterir. Sipariş inceleme için beklemedeyse Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed. gösterilir.

Ö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 sipariş ödeme sayfasına döner. Tranzila bir yanıt kodu bildirdiğinde, nedeni ve kodu eklenir; örneğin kartın son kullanma tarihinin geçtiği gibi. Müşteri tekrar ödeme yapabilir veya başka bir ödeme yöntemi seçebilir.

Ö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 bağlantısını görür. Teknik neden kayda yazılır.

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

Eklenti yalnızca Tranzila sayfasında tek seferlik kart ödemeleri 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) ya da Tranzila faturaları yoktur.

Siparişler ve iadeler

Order statuses

Pending payment: müşteri ödeme sayfasına yönlendirildi ve henüz ödeme yapmadı ya da Tranzila bildirimi henüz gelmedi.

Processing or Completed: ödeme, doğrulanmış bir bildirimle onaylandı. WooCommerce, kargo gerektirmeyen siparişler için Processing veya Completed durumunu ayarlar. Sipariş notu tutarı, Tranzila işlemini ve yetkilendirme numarasını gösterir; taksit varsa taksit sayısını da içerir. İşlem kimliği Tranzila işlem indeksidir.

On hold: ödeme alındı ama otomatik olarak kabul edilmedi: tutar, para birimi veya handshake jetonu siparişle 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ü. Sipariş notu nedenini açıklar. Ödemeyi Tranzila terminalinde kontrol edin ve durumu manuel olarak değiştirin.

Failed: Tranzila, bekleyen bir sipariş için reddedilen bir ödeme bildirdi. Not, yanıt kodunu ve anlamını gösterir. Zaten ödenmiş bir sipariş asla Failed durumuna alınmaz.

İptal edilmiş bir sipariş için ödeme gelirse sipariş, sevkiyattan önce stoğu kontrol etmenizi isteyen bir notla yeniden açılır. Müşteri Pay for order sayfasında başka bir ödeme yöntemine geçtiyse ama hâlâ açık olan bir Tranzila sayfasında ödediyse, siparişin ödeme yöntemi tekrar Tranzila'ya ayarlanır. Zaten ödenmiş, tamamlanmış veya iade edilmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunu kontrol etmenizi ve mükerrer tutarı Tranzila terminalinde iade etmenizi ister. Aynı işleme ait tekrarlanan bildirimler yok sayılır.

Refunds

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit Card (Tranzila) düğmesine tıklayın (düğme ödeme yönteminin başlığını gösterir). Tam ve kısmi iadeler desteklenir. İade, asıl ödemenin bir Tranzila kredi işlemi olarak yapılır. Düğme, terminal şifresi girildiğinde ve siparişte yetkilendirme numaralı onaylanmış bir Tranzila işlemi olduğunda kullanılabilir. Başarılı bir iade, Tranzila kredi işlemiyle birlikte sipariş notlarına eklenir.

Tranzila iadeyi kabul etmezse WooCommerce, koduyla birlikte Tranzila declined the refund gibi bir hata gösterir ve hiçbir iade kaydedilmez. Şu anda ayarlarda bulunan terminal dışında bir terminalde (örneğin bir test terminalinde) ödenmiş bir sipariş WooCommerce'ten iade edilemez; o Tranzila terminalinde iade edin. Tranzila terminalinde yapılan iadeler mağazaya bildirilmez. Gerekirse Tranzila düğmesini kullanmadan WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu WooCommerce > Settings > Payments > Tranzila sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir: örneğin lisansın ne zamana kadar aktif olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu siteden kaldırmak için Remove key düğmesini 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. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Tranzila, müşterilere ödeme sayfasında 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. Giriş yapmış mağaza yöneticileri ödeme yöntemini, (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın 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

Tranzila does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, Terminal name (supplier) alanının doldurulduğunu ve mağaza para biriminin (Pay for order sayfasında sipariş para birimi) ILS, USD, EUR veya GBP olduğunu kontrol edin. Terminal adı eksikse veya para birimi desteklenmiyorsa ayarlar sayfası bir uyarı gösterir.

The payment went through, but the order stays Pending payment: bildirim gelmedi ya da 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 WooCommerce > Status > Logs bölümüne, kaynak wcp_tranzila_payment_gateway olarak yazılır. Bir IP adresinin Trusted IP listesinde olmadığı mesajı, Trusted IP ayarının ya da proxy yapılandırmanızın düzeltilmesi gerektiği anlamına gelir: bir proxy veya CDN arkasında, web sunucusu gerçek ziyaretçi IP adresini PHP'ye iletmelidir.

Notification answers Forbidden: bildirim, Trusted IP içinde olmayan bir IP adresinden geldi.

Notification answers Bad request or Not found: bildirimdeki sipariş, sipariş anahtarı, terminal veya işlem indeksi bu mağazanın hiçbir siparişiyle eşleşmiyor.

Notification answers Accepted for manual review: 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.

Notification answers Busy, retry: sipariş aynı anda başka bir istek tarafından işleniyordu ve bildirim uygulanmadı. Ödemeyi Tranzila terminalinde kontrol edin; sipariş hâlâ ödeme bekliyorsa ve ödeme orada onaylıysa durumu manuel olarak değiştirin.

Some paid orders are On hold: sipariş notunu 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.

The payment page does not open with the handshake on: terminal adını ve terminal şifresini, handshake'in Tranzila terminalinde etkin olduğunu ve sunucunuzun IP adresinin orada izinli olduğunu kontrol edin. Kayıt nedeni gösterir.

Refunds fail: iadeler için Terminal password (TranzilaPW) gerekir. Bazı terminallerde ayrı bir kredi şifresi de gerekir; bunu Refund password (CreditPass) alanına girin. Başka bir terminalde ödenmiş siparişler o terminalde iade edilmelidir.

Other currencies: eklenti ILS, USD, EUR ve GBP'yi destekler. Geliştiriciler listeyi tranzila_p_currency_map filtresiyle değiştirebilir.

The license block shows an error: lisans bloğundaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir yuva açı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 eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, siparişlerde saklanan Tranzila verileri ve eklentinin günlükleri (döndürülmüş günlük dosyaları dahil) yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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