VibeFox TrustPay 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.

finby (TrustPay) hesabı: finby Merchant Portal'da Project ID ve Secret key bilgileriyle bir projeye ihtiyacınız var. Test ödemeleri için kendi Project ID ve Secret key bilgileriyle ayrı bir test (playground) projesi gerekir. Başka anahtar gerekmez: Secret key hem API erişimi almak hem de ödeme bildirimlerinin imzasını doğrulamak için kullanılır.

Erişilebilir bildirim URL'si: finby, mağazanıza internetten ulaşabilmelidir. Mağazanın önündeki bir güvenlik duvarı, bakım girişi veya HTTP kimlik doğrulaması ödeme bildirimlerini engeller.

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 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox TrustPay Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Test projenizin ve, gerçek ödemeler için canlı projenizin Project ID ve Secret key bilgilerini girin (bkz. Yapılandırma).

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir test ödemesi yapın, ardından gerçek ödemeleri almak için Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting TrustPay payment ve TrustPay payment on hold. PrestaShop, yeni bir ödeme modülünü kurulum sırasında aktif olan ülkelere bağlar. Daha sonra eklediğiniz ülkeler için modülü Payment > Preferences bölümünde işaretleyin. Burada modülü para birimine ve müşteri grubuna göre de sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox TrustPay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Alanların üstünde sayfa, modül etkinken mevcut modun Project ID veya Secret key bilgisi boşsa ve mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme adımında gizlenir.

TrustPay / finby

Enable / Disable: Enable TrustPay / finby card payments ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterinin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Card payment (TrustPay). Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card on the TrustPay / finby payment page.

API kimlik bilgileri

Projenizin Project ID ve Secret key bilgilerini finby (TrustPay) Merchant Portal'dan kopyalayın. Bölümde Merchant Portal'a bir bağlantı bulunur. Test ödemeleri, kendi Project ID ve Secret key bilgileri olan ayrı bir test (playground) projesi kullanır. Orada gerçek para tahsil edilmez.

Test mode: test projesini kullanır (gerçek ödeme alınmaz). Yeni ödemeler ve iadeler test kimlik bilgilerini kullanır. Bir siparişin iadeleri her zaman siparişin ödendiği projeye yapılır. Varsayılan: on. Açıkken müşteriler ödeme yönteminin altında Test mode: no real payment will be taken. mesajını görür.

Live Project ID: canlı projenizin sayısal Project ID değeri.

Live Secret key: canlı projenin Secret key değeri. API erişim jetonlarını almak ve ödeme bildirimlerini doğrulamak için kullanılır.

Test Project ID: test (playground) projenizin sayısal Project ID değeri.

Test Secret key: test projesinin Secret key değeri.

Project ID yalnızca rakamlardan oluşmalıdır. Başka bir değer kaydederseniz sayfa must contain digits only — the previous value was kept. mesajını gösterir ve diğer alanlar kaydedilir. Secret key değerleri girdiğiniz gibi kaydedilir; yalnızca başta ve sonda kalan boşluklar silinir. Kaydedilmiş Secret key değerleri bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Ayarları kaydetmek, önbelleğe alınmış API erişim jetonlarını da temizler; böylece yeni kimlik bilgileri hemen kullanılır.

Clear saved secrets: bir Secret key'i işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan kaydedilmiş değeri korur.

Ödeme bildirimleri

Sipariş, finby imzalı bir bildirimle onaylamadan ödenmiş olarak işaretlenmez. Modül, bildirim URL'sini her ödemeyle birlikte otomatik olarak gönderir; bu yüzden onu ayrıca kurmanız gerekmez. Bölüm URL'yi Notification URL altında gösterir. Dostu URL'ler etkinse şöyle görünür: https://your-shop/module/wcp_trustpay_gateway/callback; başında bir dil kodu da olabilir. Bunu Merchant Portal'daki projelerinizin bildirim URL'si olarak da girebilirsiniz. Geçerli bir imzası olmayan bildirimler reddedilir.

Modül, ödeme durumunu kendi başına finby'den sorgulamaz. Bir bildirim mağazanıza ulaşamazsa, finby bildirimi iletene kadar sipariş oluşturulmaz. finby bildirimleri yeniden dener.

Gelişmiş

Order status after payment: başarılı ödemeden sonra ayarlanan sipariş durumu. Durum tek adımda ayarlanır; böylece müşteri tek bir e-posta alır.

Debug logging: API isteklerini ve bildirimleri modül klasöründeki logs/trustpay_p_debug.log.php dosyasına ekler. Dosya web üzerinden açılamaz. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Günlük anahtar, jeton, kart verisi veya müşteri bilgisi içermez. Varsayılan: off.

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

Delete data on uninstall: açıkken modül kaldırıldığında modül ayarları ve günlük silinir. Sipariş verileri korunur: siparişler, TrustPay ödeme kayıtları ve iadeler ile sipariş durumları. Varsayılan: off.

Ödeme adımı

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Card payment (TrustPay)) ve siparişi onaylar. Ödeme yöntemi yalnızca desteklenen para birimlerinde sunulur: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF ve USD. HUF tutarları ondalıksız gönderilir.

Kart ödemeleri için bir adres gerekir. Cadde, şehir, posta kodu veya ülke eksikse müşteri Please enter your billing address (street, city, postcode and country) — it is required for card payments. mesajını görür.

Modül, finby'de sepet para biriminde sepet tutarı için bir kart ödeme talebi oluşturur. Müşterinin adı, adresi ve e-posta adresi 3-D Secure için gönderilir; sepet numarası referans olarak iletilir. Bu noktada henüz bir sipariş yoktur. Müşteri finby ödeme sayfasına yönlendirilir ve kartla orada öder. Sayfa, finby destekliyorsa sepetin dilinde, desteklemiyorsa İngilizce açılır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, finby imzalı bildirimle onaylamadan ödenmiş olarak işaretlenmez. Geri dönüşün kendisi ödeme durumunu hiçbir zaman değiştirmez. Bildirim zaten geldiyse müşteri standart sipariş onay sayfasını görür. Gelmediyse, finby'nin kart ödemesini onayladığını ve onay gelir gelmez siparişin oluşturulacağını bildiren bir Payment confirmation sayfası açılır. Bu sayfada bir Check again düğmesi ve bir Back to checkout düğmesi bulunur. Sipariş Awaiting TrustPay payment veya TrustPay payment on hold durumundayken onay sayfası Your card payment is being confirmed by TrustPay / finby. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mesajını gösterir. finby ödemeyi reddettiyse veya ödenmemiş sipariş iptal edildiyse Your card payment was not completed. Please contact us about this order. mesajını gösterir.

Müşteri ödeme sayfasında iptal ederse The card payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme adımına döner. Ödeme sayfası bir hata döndürürse veya finby ödemeyi zaten reddetmişse mesaj The card payment was not completed. Please try again or choose another payment method. olur. Sepet korunur ve müşteri yeniden ödeyebilir.

finby ödemeyi başlatamazsa müşteri We could not start the card payment. Please try again in a moment or choose another payment method. mesajıyla ödeme adımında kalı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.

Modül yalnızca kart ödemelerini kabul eder; finby sayfasında tek adımlık bir satın alma olarak çalışır. Banka havalesi veya finby'nin diğer ödeme yöntemleri, sitenizde Apple Pay veya Google Pay düğmeleri, kayıtlı kartlar, abonelikler veya yinelenen ödemeler, ayrı yetkilendirme ve tahsilat ile durum sorgulama özellikleri yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri finby'ye yönlendirildi ve ödeme yapmadı ya da bildirim henüz gelmedi. Yalnızca sepet vardır.

Payment accepted or Delivered: finby ödemeyi onayladı; tutar ve para birimi ödeme talebi ve sepet tutarıyla eşleşiyor. Durum Order status after payment ayarını izler. Ödeme, işlem kimliği olarak finby ödeme talebi kimliğiyle kaydedilir; bir not tutarı, ödeme talebini ve projeyi (test veya canlı) gösterir.

Awaiting TrustPay payment: finby, son ödemenin beklemede olduğunu bildirdi. Sipariş, finby ödemeyi onayladığında ödenmiş duruma geçer.

TrustPay payment on hold: iki durumda ayarlanır. Ödeme yalnızca yetkilendirildi, tahsil edilmedi: finby Merchant Portal'da tahsil edin veya iptal edin, sonra siparişi güncelleyin. Ya da ödenen tutar veya para birimi ödeme talebinden ya da sepet tutarından farklıdır; örneğin müşteri ödeme sayfasına gönderildikten sonra sepet değiştirildiyse. Gönderimden önce ödemeyi kontrol edin. Not durumu açıklar.

Payment error: finby, beklemede olan bir siparişin son ödemesini reddetti. finby bildirdiğinde not nedeni gösterir. Daha sonra onaylanan bir ödeme siparişi yine ödenmiş duruma taşır.

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

İptal edilen veya iade edilen siparişler, geciken bir ödemeyle asla yeniden açılmaz. Bir not, siparişi geri yüklemenizi veya ödemeyi Merchant Portal'da iade etmenizi ister. Zaten ödenmiş bir siparişe ikinci bir ödeme gelirse sipariş değişmez ve bir not, yinelenen ödemeyi Merchant Portal'da iade etmenizi ister. finby'nin bildirdiği chargeback'ler ve itirazlar not olarak eklenir.

TrustPay / finby ödeme bloğu

Sipariş sayfasında ödeme talebi kimliği, finby ödeme kimliği, proje, ödeme durumu, talep edilen ve ödenen tutarlar, iade edilen tutar, test ödemeleri için bir Test project rozeti, iade geçmişi ve siparişin TrustPay notes bölümü içeren TrustPay / finby payment bloğu gösterilir.

İadeler

TrustPay / finby payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via TrustPay düğmesine tıklayın. Refund this amount through TrustPay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modüller sayfalarına erişim gerekmez. İadeler, finby'nin ödeme için bildirdiği tutar ve para biriminde yapılır. Bu nedenle tutar uyuşmazlığından sonra, sipariş toplamına değil müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. HUF iadeleri tam tutar olmalıdır.

İade, moduyu değiştirmiş olsanız bile siparişin ödendiği projeye (test veya canlı) gider. O projenin Project ID ve Secret key bilgileri ayarlı olmalı ve Project ID'si değişmemiş olmalıdır. Bir iade yalnızca finby kabul ettiğinde kaydedilir. Aksi halde blok, nedeniyle birlikte TrustPay refused the refund: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notları oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri finby üzerinden para geri göndermez. finby Merchant Portal'da yapılan iadeler iade olarak kaydedilmez. finby bunlarla ilgili bir bildirim gönderirse not olarak eklenir ve sipariş durumu değişmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox TrustPay Gateway lisans bloğu, Modules > Module Manager > VibeFox TrustPay 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 blokta anahtar maskelenmiş olarak, durum (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve şu düğmeler görünür: 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. Bunların altında Product: presta-payment-trustpay satırı ve hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler 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 License expired on ve bir tarih. Mağaza adresi değiştikten sonra ya da 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, bilinen son durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çok mağazalı kurulumda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan kart ödemesi ödeme adımı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 sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme adımı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 TrustPay bildirimi ve mağazaya dönüşle onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken 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

Card payment (TrustPay) ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve mevcut modun Project ID ve Secret key bilgisine sahip olduğunu kontrol edin: test modunda Test Project ID ve Test Secret key, canlı modda Live Project ID ve Live Secret key. Sepet para birimi desteklenen para birimlerinden biri olmalıdır. Kimlik bilgileri 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 gerçekleşti ama sipariş oluşturulmadı: bildirim mağazanıza ulaşmadı. Notification URL altında gösterilen URL'nin internetten erişilebilir olduğunu kontrol edin (güvenlik duvarı, bakım girişi veya HTTP kimlik doğrulaması olmamalı). finby bildirimi yeniden dener ve bildirim geldiğinde sipariş oluşturulur. Debug logging seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Günlükte Notification rejected: invalid signature or unknown project görünüyor: bildirim, Project ID'si ayarlarda bulunmayan bir projeden geldi ya da o projenin Secret key bilgisi yanlış. Mağaza Invalid signature yanıtı verir ve hiçbir şey değişmez. Ödemenin yapıldığı modun Project ID ve Secret key bilgilerini kontrol edin.

Günlükte Notification ignored görünüyor: bildirim, bu mağazanın o sepet için oluşturmadığı bir ödeme talebiyle, ya da ödemenin başlatıldığından farklı bir proje veya modla ilgili. Hiçbir şey değişmez.

Bildirim Busy, retry later veya Temporary error yanıtı alıyor: sepet o anda başka bir bildirim tarafından güncelleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışıysa). finby bildirimi yeniden dener. Günlük nedeni gösterir.

Müşteri We could not start the card payment mesajını görüyor: günlüğü açın. Yanlış Project ID veya Secret key, finby'nin projenin kimlik bilgilerini reddettiği mesajını verir. Test kimlik bilgilerinin test alanlarında, canlı kimlik bilgilerinin canlı alanlarında olduğunu kontrol edin.

Card payment is temporarily unavailable: müşteri bunu, mevcut modda Project ID veya Secret key olmadığında görür. Bunları girin ve kaydedin.

Sipariş TrustPay payment on hold durumunda: TrustPay / finby payment bloğundaki notları okuyun (bkz. Sipariş durumları). Gönderimden önce ödemeyi Merchant Portal'da kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

İade, proje ile ilgili bir mesajla başarısız oluyor: sipariş test veya canlı projeyle ödendi ve o modun Project ID veya Secret key bilgisi ayarlı değil ya da orada artık başka bir Project ID kayıtlı. O projenin kimlik bilgilerini girin ya da ödemeyi finby Merchant Portal'da iade edin.

Invalid refund amount: at most … can be refunded: tutar, ödenen tutardan modül üzerinden yapılmış iadeler çıkarıldıktan sonra kalan tutardan fazla.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox TrustPay 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. Önbelleğe alınmış API erişim jetonları her zaman kaldırılır. Delete data on uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için korunur. TrustPay ödeme kayıtları ve iadeler ile Awaiting TrustPay payment ve TrustPay payment on hold sipariş durumları 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.

TrustPay ve finby, ilgili sahiplerinin ticari markalarıdır. Bu modül TrustPay veya finby ile bağlantılı değildir ve onlar tarafından onaylanmamıştır.