VibeFox Paytrail for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalı. Eklenti, WooCommerce olmadan etkinleşmeyi reddeder.

PHP: 8.0 veya üzeri.

Mağaza para birimi: EUR. Paytrail yalnızca avro kabul eder. Diğer tüm para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Tutarlar sent olarak iletilir.

Sitenize internet erişimi: Paytrail her ödemeyi sunucudan sunucuya bir callback ile onaylar, bu nedenle sitenin internetten erişilebilir olması gerekir. Callback olmadan da, müşteri Paytrail'den döndüğünde siparişler yine onaylanır.

Paytrail hesabı: Paytrail Merchant Panel'de (hesap veya entegrasyon ayrıntıları) gösterilen Merchant ID ve Secret key bilgilerinize ihtiyacınız vardır. Test için bir hesaba gerek yoktur: test modu Paytrail'in genel test hesabını kullanır. Ödeme yöntemlerinin kendisi Paytrail hesabınızda etkinleştirilir.

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_paytrail_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 > Paytrail > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings düğmesine tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Eklentiyi önce denemek için Test mode kutusunu işaretleyin. Gerçek ödemeler için işareti kaldırın ve Merchant ID ile Secret key bilgilerinizi girin. Paytrail'de hiçbir callback URL'si yapılandırılması gerekmez.

6. Enable/Disable seçeneğini açın ve kaydedin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Paytrail. Alanların üstünde, test modu açıkken sayfa Test mode is active. uyarısını gösterir. Canlı modda, Merchant ID veya Secret key eksik olduğunda sizi uyarır ve mağaza para birimi EUR olmadığında uyarır. Her iki durumda da Paytrail ödeme sayfasında gösterilmez. Ödeme yöntemleri listesinde, canlı modda kimlik bilgileri bulunmadığı sürece Paytrail kurulum gerektiriyor olarak işaretlenir.

Kaydettiğinizde, yalnızca rakam içermeyen bir Merchant ID kaydedilmez: bir hata gösterilir ve önceki değer korunur.

General

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

Title: ödeme sırasında müşterilere gösterilen başlık. Varsayılan: Paytrail.

Description: ödeme sırasında müşterilere gösterilen metin. Varsayılan: Pay securely with Finnish online banking, card, mobile payment or invoice on the Paytrail payment page.

API credentials

Merchant ID ve Secret key bilgileriniz Paytrail Merchant Panel'de (hesap veya entegrasyon ayrıntıları) gösterilir. Yalnızca EUR ödemeleri desteklenir.

Test mode: Use the Paytrail test account. Yeni ödemeler kendi kimlik bilgileriniz yerine Paytrail'in genel test hesabını (Merchant ID 375917) kullanır. Gerçek para tahsil edilmez. Müşteriler ödeme sırasında Test mode: no real payment will be made. uyarısını görür. Test hesabının gizli anahtarı herkese açıktır, bu nedenle herkes test modunda oluşturulmuş bir sipariş için bir ödeme simülasyonu yapabilir. Canlı bir mağazada test modunu asla açık bırakmayın. Varsayılan: kapalı.

Merchant ID: Paytrail satıcı kimliğiniz (yalnızca rakamlar). Test modu kapalıyken kullanılır.

Secret key: Paytrail gizli anahtarınız. Test modu kapalıyken kullanılır.

Callback'ler ve iadeler her zaman ödemenin yapıldığı modun kimlik bilgilerini kullanır, bu nedenle test ile canlı arasında geçiş yapmak eski siparişleri bozmaz.

Orders

Bu bölüm, https://your-site/wc-api/ptg_paytrail/ benzeri görünen callback URL'sini gösterir. Paytrail, her ödemeyi bu URL üzerinden sunucudan sunucuya onaylar. Her ödemeyle birlikte iletilir, dolayısıyla Paytrail panelinde hiçbir şey yapılandırmak gerekmez, ancak sitenin internetten erişilebilir olması gerekir.

Order status after payment: ödenmiş bir siparişin durumu. Durum tek adımda ayarlanır, böylece müşteri tek bir e-posta seti alır.

Advanced

Debug log: Log API requests and callbacks. Kişisel veriler veya anahtarlar olmadan WooCommerce > Status > Logs konumuna yazılır, kaynak wcp_paytrail_gateway. Hatalar her zaman günlüğe kaydedilir. Varsayılan: kapalı.

Delete data on uninstall: Delete settings, logs and Paytrail order data when the plugin is deleted. Eklentiyi devre dışı bırakmak asla hiçbir şeyi silmez. Paytrail işlem verileri olmadan, eski siparişlerin iadeleri artık WooCommerce üzerinden yapılamaz. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini (varsayılan olarak Paytrail) seçer ve siparişi verir. Eklenti, avro cinsinden sipariş toplamı için bir Paytrail ödemesi oluşturur ve sipariş satırlarını bununla birlikte gönderir: her biri bir ondalık basamağa kadar KDV oranına sahip ürünler, kargo ve ücretler. Satırların toplamı her zaman ödeme tutarını verir; bir yuvarlama farkı bir satıra eklenir veya bir Rounding satırı olarak gönderilir. Fatura ve teslimat adresleri yalnızca eksiksiz olduklarında gönderilir ve uzun değerler Paytrail'in sınırlarına göre kısaltılır. Ödeme sayfası dili, mağaza yerel ayarını takip ederek Fince, İsveççe veya İngilizce olur.

Müşteri Paytrail ödeme sayfasına yönlendirilir, Paytrail hesabınız için etkinleştirilmiş bir ödeme yöntemini seçer ve ödemeyi yapar. Paytrail daha sonra ödemeyi iki kez onaylar: müşteriyi mağazanıza geri gönderir ve callback URL'sini sunucudan sunucuya çağırır. Her ikisi de yalnızca bu ödeme denemesinin kimlik bilgileriyle oluşturulmuş geçerli bir imza ile ve yalnızca bu sipariş için oluşturulan deneme için kabul edilir. Ödenen tutar sipariş toplamıyla karşılaştırılır. Sipariş, ancak Paytrail bunu bu şekilde onayladıktan sonra ödendi olarak işaretlenir. Eklenti şu Paytrail durumlarını işler:

Başarılı bir ödemeden sonra müşteri sipariş alındı sayfasını görür. İptal edilen veya başarısız olan bir ödemeden sonra müşteri, The Paytrail payment was cancelled or failed. You can try again or choose another payment method. mesajıyla birlikte Pay for order sayfasına gider. Ödeme henüz tamamlanmadıysa mesaj The Paytrail payment has not been completed yet. You can try again or choose another payment method. olur.

Paytrail ödemeyi başlatamazsa, müşteri kısa bir mesaj görür, örneğin Could not connect to Paytrail. Please try again in a moment., Paytrail is temporarily unavailable. Please choose another payment method. (yanlış kimlik bilgileri) veya Paytrail could not start the payment. Please check your billing details and try again, or choose another payment method.. Teknik neden sipariş notlarına ve günlüğe eklenir. Paytrail'in maksimum tutarının üzerindeki siparişler Paytrail ile ödenemez.

Bir Paytrail ödemesi API üzerinden iptal edilemez. Müşteri yeni bir ödeme başlatır ve ardından daha eski, hâlâ açık olan bir ödeme sayfasını da öderse, ikinci ödeme sipariş notlarında iade edilecek mükerrer bir işlem olarak bildirilir.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Müşteri ödeme yöntemini kendi ödeme sayfanızda değil, Paytrail sayfasında seçer. Eklentide kart tokenizasyonu veya kayıtlı kartlar, WooCommerce Subscriptions, shop-in-shop, manuel fatura etkinleştirme ve mutabakat raporları bulunmaz.

Siparişler ve iadeler

Sipariş durumları

Pending payment: Paytrail ödemesi oluşturuldu ve müşteri henüz ödeme yapmadı. Sipariş notunda Paytrail işlem kimliği, tutar ve mod gösterilir.

Processing or Completed: ödeme onaylandı. Durum, Order status after payment ayarını takip eder. Sipariş notunda işlem, Paytrail'de kullanılan ödeme yöntemi ve tutar gösterilir. İşlem kimliği Paytrail işlem kimliğidir.

On hold: ödeme sağlayıcıda beklemede (fatura veya gecikmeli ödeme), ödenen tutar sipariş toplamından farklı, ödeme sipariş iptal edildikten sonra ulaştı veya mağaza canlı moddayken bir test ödemesi alındı (gerçek para yok). Sipariş notu nedenini açıklar. Siparişi kontrol edin, ardından işleyin veya ödemeyi iade edin.

Failed: en son ödeme denemesi başarısız oldu veya müşteri tarafından iptal edildi. Müşteri tekrar ödeme yapabilir.

Yinelenen veya paralel callback'ler asla mükerrer notlar, stok düşüşleri veya e-postalar oluşturmaz. Zaten ödenmiş bir siparişin ikinci bir denemesi ödenirse, sipariş yeniden değiştirilmez; bir Duplicate payment notu, bunu Paytrail Satıcı Paneli'nde iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Paytrail düğmesine tıklayın (düğme Title bilginizi gösterir). Yalnızca tutarlar için tam ve kısmi iadeler desteklenir (iade edilecek ürün satırı bulunmaz). Düğme yalnızca onaylanmış bir Paytrail ödemesi olan siparişler için kullanılabilir. İade, ödemenin yapıldığı modun kimlik bilgilerini kullanır, bu nedenle canlı bir ödeme için canlı kimlik bilgilerinin ayarlanmış olması gerekir.

Ödeme yöntemi doğrudan iadeleri desteklemiyorsa, eklenti otomatik olarak bir e-posta ile iade başlatır: Paytrail, müşteriye bir banka hesabı girmesi için bir e-posta gönderir. Bunun için siparişte bir fatura e-postası gerekir. Sipariş notu ne tür bir iadenin başlatıldığını belirtir.

Bir iade hemen tamamlanabilir veya daha sonra işlenebilir. Paytrail'in sonraki onayı bir not olarak eklenir. Paytrail iadeyi tamamlayamadıysa, bir not paranın müşteriye iade edilmediğini belirtir: parayı başka bir yolla iade edin ve WooCommerce iadesini silin. Paytrail iadeyi hemen reddederse, WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez.

Paytrail Satıcı Paneli'nde yapılan iadeler WooCommerce'e geri senkronize edilmez.

Lisans anahtarı

Eklenti, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Paytrail sayfasının en üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, örneğin lisansın geçerli olduğu tarih ve alan adınız gibi durumu gösterir. Durumu tekrar kontrol etmek için Check now, başka bir anahtar girmek için Change key ve bu siteden kaldırmak için Remove key seçeneklerini 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ı yuvasını boşaltmaz. Yuva alanını vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Paytrail ö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. Oturum açmış mağaza yöneticileri, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için (unlicensed — visible to admins only) olarak işaretlenmiş ödeme yöntemini görmeye devam eder. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatıcı görünür. Mevcut siparişler etkilenmez: önceden 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 tekrar kontrol edilir.

Sorun giderme

Paytrail ödeme sırasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve Test mode seçeneğinin açık olduğunu ya da Merchant ID ve Secret key alanlarının doldurulduğunu kontrol edin. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) EUR olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş Pending payment durumunda kalıyor: callback sitenize ulaşamıyor ve müşteri mağazaya geri dönmedi. Orders bölümünde gösterilen callback URL'si internetten erişilebilir olmalıdır (bakım modu, temel kimlik doğrulama veya aradaki güvenlik duvarı engeli olmadan).

Callback veya dönüş yanıtı Payment verification failed.: imza geçersiz veya ödeme siparişin bir ödeme denemesine ait değil. Sipariş değiştirilmez. Secret key değerinin doğru olduğunu ve Merchant ID değerine ait olduğunu kontrol edin.

Ödeme oluşturulmuyor: sipariş notu ve günlük, yanlış kimlik bilgileri için örneğin Paytrail API error (401): … gibi Paytrail hatasını gösterir. Debug log seçeneğini açın ve WooCommerce > Status > Logs, kaynak wcp_paytrail_gateway bölümüne bakın.

Merchant ID kaydedilmiyor: yalnızca rakam içermelidir. Paytrail Merchant Panel'den tekrar kopyalayın.

Sipariş On hold durumunda: sipariş notunu okuyun. Nedeni bekleyen veya gecikmeli bir ödeme, farklı bir ödenen tutar, iptalden sonraki bir ödeme veya canlı modda bir test ödemesidir.

İade başarısız oluyor: mesajı okuyun. This order has no confirmed Paytrail payment. Refund it manually., iade edilecek onaylanmış bir Paytrail ödemesi olmadığı anlamına gelir. Eksik canlı kimlik bilgileriyle ilgili bir mesaj, ödemenin canlı modda yapıldığı ve canlı kimlik bilgilerinin ayarlanmadığı anlamına gelir. Ödeme yöntemi yalnızca e-posta ile iadeleri destekliyorsa, siparişin bir fatura e-postasına ihtiyacı vardır.

Geliştirici kancaları: ptg_payment_request filtresi, ödeme isteğini imzalanıp gönderilmeden önce değiştirir; ptg_icon filtresi ödeme simgesini değiştirir.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin, anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva boşaltı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 bilinen son durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, bu eklentinin günlüğü ve siparişlerde saklanan Paytrail verileri (ödeme denemeleri, işlem verileri, iade kayıtları) yalnızca Delete data on uninstall açık olduğunda kaldırılır. Aksi takdirde daha sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur; Paytrail verileri olmadan eski siparişler artık WooCommerce'den iade edilemez.

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