VibeFox Paytrail for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: EUR. Paytrail yalnızca euro kabul eder. Başka bir para biriminde olan bir sepet için ödeme yöntemi ödeme sayfasında gizlenir. Tutarlar kuruş cinsinden gönderilir.

Mağazanıza internet erişimi: Paytrail her ödemeyi sunucudan sunucuya bir callback ile onaylar, bu nedenle mağazanın internetten erişilebilir olması gerekir. Callback'ler olmadan bile müşteri Paytrail'den döndüğünde siparişler oluşturulur.

Paytrail hesabı: Paytrail Satıcı Paneli'nde (hesap veya entegrasyon bilgileri) görüntülenen Merchant ID ve Secret key'inize ihtiyacınız vardır. Test için hesap gerekmez: 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'ten satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Back Office'te Modules > Module Manager bölümüne 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 Paytrail Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Modülü önce denemek için Test mode seçeneğini açın. Gerçek ödemeler için kapatın ve Merchant ID ile Secret key değerlerinizi girin. Paytrail'de bir callback URL'si yapılandırmanız gerekmez.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Paytrail payment ve Paytrail payment on hold. PrestaShop tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunu Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Paytrail Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Test modu açıkken, alanların üstünde sayfa Test mode is active. Payments use the public Paytrail test account — no real money is charged. uyarısını gösterir. Canlı modda, Merchant ID veya Secret key eksikse ya da Merchant ID herkese açık test hesabı 375917 ise uyarır. Mağaza para birimi EUR değilse de uyarır. Bu durumların hepsinde Paytrail ödeme sayfasında gösterilmez.

Kaydetme sırasında rakamlardan başka bir şey içeren bir Merchant ID kaydedilmez: Paytrail merchant ID must contain digits only. The previous value was kept. hatası gösterilir. Title alanı boş bırakılamaz.

Paytrail

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

Title: ödeme sayfasında müşterilere gösterilen başlık. Aynı zamanda siparişte saklanan ödeme yöntemi adıdır. Varsayılan: Paytrail. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altı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 kimlik bilgileri

Merchant ID ve Secret key'iniz Paytrail Satıcı Paneli'nde (hesap veya entegrasyon bilgileri) gösterilir. Bu bölüm Satıcı Paneli'ne bir bağlantı içerir. Yalnızca EUR ödemeleri desteklenir.

Test mode: yeni ödemeler için kendi kimlik bilgilerinizin yerine Paytrail'in genel test hesabını (Merchant ID 375917) kullanır. Gerçek para çekilmez ve anahtar gerekmez. Müşteriler ödeme yönteminin altında Test mode: no real payment will be made. ifadesini görür. Test hesabının Secret key'i herkese açıktır; bu nedenle test modunda yapılan bir ödemeyi herkes taklit edebilir. Test modunu asla canlı bir mağazada açık bırakmayın. Varsayılan: off.

Merchant ID: Paytrail Merchant ID'niz (yalnızca rakamlar). Test modu kapalıyken kullanılır.

Secret key: Paytrail Secret key'iniz. Test modu kapalıyken kullanılır. Kaydedilen anahtar bir daha asla 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 secret key: Secret key kutusunu işaretleyin ve kayıtlı anahtarı kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

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

Siparişler

Callback URL: Paytrail'in her ödemeyi sunucudan sunucuya onayladığı URL'yi gösterir. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_paytrail_gateway/callback. Her ödemeyle birlikte gönderilir, bu nedenle Paytrail panelinde bir şey yapılandırmanız gerekmez; ancak mağazanın internetten erişilebilir olması gerekir.

Order status after payment: ödenmiş bir siparişin durumu.

Bekleyen ödemeler Awaiting Paytrail payment durumunda bekler. Tutar uyuşmazlıkları ve diğer sorunlar her zaman Paytrail payment on hold durumuna gider.

Gelişmiş

Debug log: API isteklerini ve callback'leri modül klasöründeki logs/ptg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Kişisel veriler ve anahtarlar kaydedilmez. Hatalar ve uyarılar her zaman kaydedilir. Varsayılan: off.

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

Delete data on uninstall: açıksa modül kaldırıldığında ayarlar ve günlük silinir. Modülü devre dışı bırakmak hiçbir şeyi silmez. Siparişlerin Paytrail işlem verileri her zaman saklanır, çünkü eski siparişlerin iadeleri bunlara ihtiyaç duyar. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paytrail) ve onaylar. Modül, sepet toplamı için euro cinsinden bir Paytrail ödemesi oluşturur ve siparişin satırlarını bununla gönderir: sepet kurallarından sonraki ürünler, kargo ve hediye paketi, her biri bir ondalık basamağa kadar KDV oranıyla birlikte. Satırların toplamı her zaman ödeme tutarını verir; yuvarlama farkı bir satıra eklenir veya bir Rounding satırı olarak gönderilir. Fatura ve teslimat adresleri yalnızca eksiksiz olduğunda gönderilir; uzun değerler Paytrail'in sınırlarına göre kısaltılır. Ödeme sayfasının dili, sepetin diline göre Fince, İsveççe veya İngilizcedir. Bu noktada henüz bir sipariş yoktur.

Müşteri Paytrail ödeme sayfasına yönlendirilir, Paytrail hesabınız için etkinleştirilmiş bir ödeme yöntemi seçer ve öder. Paytrail ardından ödemeyi iki kez onaylar: müşteriyi mağazanıza geri gönderir ve sunucudan sunucuya callback URL'sini çağırır. İkisi de yalnızca o ödeme denemesinin kimlik bilgileriyle oluşturulmuş geçerli bir imza ile ve yalnızca o sepet için oluşturulmuş bir deneme için kabul edilir. Ödenen tutar sepet toplamıyla karşılaştırılır. Sipariş, Paytrail bunu bu şekilde onaylamadan ödenmiş olarak işaretlenmez. Modül şu Paytrail durumlarını işler:

Başarılı bir ödemeden sonra müşteri, Your Paytrail payment has been received. ifadesini içeren standart sipariş onay sayfasını görür. Bekleyen bir ödemede sayfa Your Paytrail payment is pending confirmation by the payment provider. The order is updated automatically — please do not pay again. ifadesini gösterir. Callback tam o anda ödemeyi kaydediyorsa, Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve bir Check again düğmesi sunar.

İptal edilen veya başarısız bir ödemeden sonra müşteri, The Paytrail payment was cancelled or failed. You can try again or choose another payment method. mesajıyla ödeme sayfasına geri döner. Ödeme henüz tamamlanmadıysa mesaj The Paytrail payment has not been completed yet. You can try again or choose another payment method. olur. Sepet korunur. Doğrulanamayan bir dönüş Payment verification failed. gösterir ve hiçbir şeyi değiştirmez.

Paytrail ödemeyi başlatamazsa müşteri kısa bir mesajla ödeme sayfasında kalır, örneğin Could not connect to Paytrail. Please try again in a moment., Paytrail is temporarily unavailable. Please choose another payment method. (hatalı kimlik bilgileri) veya Paytrail could not start the payment. Please check your billing details and try again, or choose another payment method. Teknik neden günlüğe yazılır. Paytrail sınırlarının dışındaki bir toplam This order total cannot be paid with Paytrail. Please choose another payment method. mesajını verir.

Paytrail ödemesi API üzerinden iptal edilemez. Sepet için her yeni deneme yeni bir Paytrail ödemesidir. Müşteri hâlâ açık olan eski bir ödeme sayfasını da öderse, ikinci ödeme siparişte iade edilecek mükerrer ödeme olarak bildirilir.

Callback, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Müşteri ödeme yöntemini ödeme sayfanızda değil, Paytrail sayfasında seçer. Modülde kart tokenizasyonu veya kayıtlı kart, abonelik, shop-in-shop, manuel fatura etkinleştirme ve mutabakat raporu yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Paytrail'e gönderildi ve ödeme yapmadı ya da Paytrail ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted or Delivered: ödeme onaylandı. Durum Order status after payment ayarını izler. Ödeme, Paytrail işlem kimliğiyle kaydedilir ve bir not işlemi, Paytrail'de kullanılan ödeme yöntemini ve tutarı gösterir.

Awaiting Paytrail payment: ödeme sağlayıcıda beklemededir (fatura veya gecikmeli ödeme). Paytrail ödemeyi onayladığında sipariş ödenmiş duruma geçer, başarısız olursa Payment error durumuna geçer.

Paytrail payment on hold: ödenen tutar sipariş toplamından farklıdır (gerçekte ödenen tutar kaydedilir), ödeme sipariş iptal edildikten sonra gelmiştir veya mağaza canlıyken bir test ödemesi alınmıştır (gerçek para yok, hiçbir şey kaydedilmez). Not nedeni açıklar. Siparişi kontrol edin, ardından işleyin veya ödemeyi iade edin.

Payment error: bekleyen bir ödeme başarısız oldu veya iptal edildi.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Tekrarlanan veya eşzamanlı callback'ler asla ikinci bir sipariş veya mükerrer notlar oluşturmaz. Zaten ödenmiş bir sepetin ikinci bir denemesi ödenirse sipariş değişmez; bir Duplicate payment notu, bunu Paytrail Satıcı Paneli'nde iade etmenizi ister.

Paytrail ödeme bloğu

Sipariş sayfasında işlem kimliği, mod (test ödemeleri için bir TEST mode rozeti), ödeme yöntemi, Paytrail durumu, ödenen ve iade edilen tutar, iade formu, iade geçmişi, sepetin ödeme denemeleri ve siparişin Paytrail notes bölümünü içeren bir Paytrail payment bloğu gösterilir.

İadeler

Paytrail payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak sipariş notu için bir neden yazın ve Refund via Paytrail düğmesine tıklayın. Refund this amount through Paytrail? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir, yalnızca tutar bazında. Siparişleri düzenleme yetkisine sahip olmanız gerekir; modül sayfalarına erişim gerekli değildir. Paytrail'in gerçekte tahsil ettiği tutara kadar iade yapabilirsiniz; bu nedenle tutar uyuşmazlığından sonra sınır, sipariş toplamı değil müşterinin ödediği tutardır. İade, ödemenin yapıldığı modun kimlik bilgilerini kullanır; bu nedenle canlı bir ödeme için canlı kimlik bilgileri girilmiş olmalıdır. İadeler, Paytrail ödemeyi onayladıktan sonra kullanılabilir.

Ödeme yöntemi doğrudan iadeleri desteklemiyorsa modül e-posta ile iadeyi otomatik olarak başlatır: Paytrail, müşteriden bir banka hesabı girmesini isteyen bir e-posta gönderir. Bunun için siparişte müşterinin e-postası olmalıdır. Not, başlatılan iade türünü belirtir.

İade hemen tamamlanabilir veya daha sonra işlenebilir. Paytrail'in sonraki onayı not olarak eklenir. Paytrail iadeyi tamamlayamadıysa bir not, paranın müşteriye iade edilmediğini belirtir ve iade artık iade edilmiş sayılmaz; müşteriyi başka bir yolla iade edin. Paytrail iadeyi hemen reddederse blok hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Paytrail üzerinden para geri göndermez. Paytrail Satıcı Paneli'nde yapılan iadeler PrestaShop'a geri senkronize edilmez.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paytrail Gateway lisans bloğu, Modules > Module Manager > VibeFox Paytrail Gateway > Configure sayfasında, ayarların üstünde ilk bloktur. Anahtarı License key alanına girin 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 Check now (durumu yeniden kontrol etmek için), Change key (başka bir anahtar girmek için) ve Remove key (anahtarı bu mağazadan kaldırmak için) düğmelerini gösterir. Bunların altında Product: presta-payment-paytrail satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloğun metinleri back office 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 bir 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 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 Paytrail, ö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 mağaza ön yüzü, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: önceden başlatılmış ödemeler callback'ler ve müşterinin dönüşüyle yine onaylanır, iadeler de çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Paytrail ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve ya Test mode seçeneğinin açık olduğunu ya da Merchant ID ve Secret key alanlarının dolu olduğunu kontrol edin (herkese açık test hesabı 375917 değil). Sepet para biriminin EUR olduğunu kontrol edin. 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. Ayarlar sayfası, eksik kimlik bilgileri ve yanlış mağaza para birimi için bir uyarı gösterir.

Ödeme yapıldı ama sipariş oluşturulmadı: callback mağazanıza ulaşamıyor ve müşteri mağazaya geri dönmedi. Siparişler bölümünde gösterilen Callback URL'nin internetten erişilebilir olması gerekir (önünde temel kimlik doğrulama veya güvenlik duvarı olmamalı).

Callback veya dönüş Payment verification failed. yanıtı veriyor: imza geçersiz veya ödeme sepetin bir ödeme denemesine ait değil. Hiçbir şey değişmez. Secret key değerinin doğru olduğunu ve Merchant ID ile eşleştiğini kontrol edin.

Callback Temporarily unavailable yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). Paytrail yeniden çağırır. Nedeni görmek için Log alanına bakın.

Müşteri Paytrail'i seçerken bir hata görüyor: modül sayfasındaki Log alanına bakın. Örneğin Paytrail API error (401) hatalı kimlik bilgileri anlamına gelir. Ayrıntılar için Debug log seçeneğini açın.

Merchant ID kaydedilmiyor: yalnızca rakamlardan oluşmalıdır. Paytrail Satıcı Paneli'nden yeniden kopyalayın.

Sipariş Paytrail payment on hold durumunda: Paytrail payment bloğundaki notları okuyun. Neden farklı bir ödenmiş tutar, iptalden sonra gelen 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. The live Paytrail credentials used for this payment are missing. Enter them in the Paytrail settings. ödemenin canlı modda yapıldığı ve canlı kimlik bilgilerinin girilmediği anlamına gelir. Invalid refund amount: at most … tutarın iade edilebilecek kalan tutardan büyük olduğu anlamına gelir. Ödeme yöntemi yalnızca e-posta ile iadeyi destekliyorsa siparişte müşterinin e-postası olması gerekir.

Geliştirici kancası: actionWcpPaytrailPaymentRequest kancası, ödeme isteğini imzalanıp gönderilmeden önce değiştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Paytrail 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ük kaldırılır. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Paytrail işlemleri ve iadeleri ile Awaiting Paytrail payment ve Paytrail payment on hold sipariş durumları her zaman saklanır; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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