VibeFox Tpay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder. Bildirimlerin JWS imza kontrolü için OpenSSL eklentisi ve secure.tpay.com adresine giden HTTPS bağlantısı gerekir.

Mağaza para birimi: yalnızca Polonya złotisi (PLN). Tpay ödemeleri PLN olarak tahsil eder ve Open API'de para birimi alanı yoktur; bu nedenle sepet başka bir para birimi kullanıyorsa ödeme yöntemi gizlenir.

Mağazanıza internet erişimi: Tpay ödeme bildirimlerini mağazanıza gönderir; bu nedenle bildirim adresi internetten erişilebilir olmalıdır (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemelidir).

Tpay hesabı: Tpay satıcı panelinden şu değerlere ihtiyacınız vardır: Merchant ID (Tpay hesap kimliğiniz), Open API anahtarları Client ID ve Client secret (Integration, API) ve güvenlik kodu (Settings, Notifications). Sandbox anahtarları ayrı bir Tpay sandbox hesabından alınır.

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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Tpay Payment modülünü bulup Configure düğmesine tıklayın.

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

4. Sandbox anahtarlarını ve Production anahtarlarını girin (bkz. Configuration). Tpay panelinde güvenlik kodu dışında hiçbir şey ayarlamanız gerekmez: bildirim adresi her işlemle birlikte gönderilir.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğini kapatın.

Kurulumda modül Tpay payment on hold sipariş durumunu oluşturur. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz; modül için PLN'nin izinli kalması gerekir.

Configuration

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Tpay Payment > 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, sandbox modu açıkken sayfa Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. mesajını gösterir. Geçerli modun anahtarları eksikse (bu durumda Tpay ödeme sayfasında gösterilmez), mağazanın varsayılan para birimi PLN değilse ve JWS kontrolü açıkken PHP OpenSSL eklentisi yoksa (bu durumda ödemeler onaylanmaz) uyarı verir. Merchant ID veya Client ID ile birlikte yapıştırılan boşluklar kaydedilirken silinir.

Tpay

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

Title: ödeme sırasında müşterilere gösterilen ödeme yöntemi başlığı. Aynı zamanda siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Tpay. Zorunlu.

Description: ödeme sırasında müşterilere gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: Tpay sandbox'ını (test ödemeleri, gerçek para yok) Sandbox anahtarları ve openapi.sandbox.tpay.com ile kullanır. Gerçek ödemeleri Production anahtarlarıyla kabul etmek için kapatın. İadeler her zaman siparişin ödendiği ortama gönderilir. Varsayılan: açık.

Production keys

Nerede bulunur: Tpay satıcı panelinde Integration, API altında (Open API anahtarları: Client ID ve Secret); Merchant ID Tpay hesap kimliğinizdir; güvenlik kodu Settings, Notifications altındadır.

Merchant ID: Tpay hesap kimliğiniz (rakamlar). Tpay bunu her bildirimde gönderir.

Client ID: Open API Client ID.

Client secret: Open API Client secret.

Security code: Tpay bildirimlerinin MD5 sağlama toplamını doğrulamak için kullanılır.

Sandbox keys

Sandbox, kendi anahtarlarına sahip ayrı bir Tpay test hesabıdır (Tpay API belgelerine bakın). Yalnızca Sandbox mode açıkken kullanılır.

Sandbox Merchant ID: sandbox hesabının Merchant ID'si.

Sandbox Client ID: sandbox hesabının Open API Client ID'si.

Sandbox Client secret: sandbox hesabının Open API Client secret'ı.

Sandbox Security code: sandbox hesabının bildirim güvenlik kodu.

Kayıtlı gizli bilgiler (her iki ortamın Client secret ve Security code 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.

Clear saved secrets: bir gizli bilgiyi işaretleyin ve silmek için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Payment notifications

Notification URL: Tpay, ödemeleri burada gösterilen adrese onaylar. Dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_tpay_payment/notify, isteğe bağlı olarak /en/ gibi bir dil kodu içerebilir. Adres her işlemle otomatik olarak gönderilir; Tpay panelinde güvenlik kodu dışında bir şey ayarlanmasına gerek yoktur. Sipariş, yalnızca geçerli sağlama toplamı ve imzaya sahip ve tutarı eşleşen bir bildirimden sonra (veya müşteri geri döndüğünde eşleşen bir durum sorgulamasından sonra) oluşturulur. Mağazanız kabul edene kadar Tpay bildirimi tekrarlar.

JWS signature: bildirimlerin X-JWS-Signature değerini Tpay sertifikasıyla da doğrular (önerilir). PHP OpenSSL eklentisini ve secure.tpay.com adresine giden HTTPS bağlantısını gerektirir. Sertifikalar bir gün önbelleğe alınır. MD5 sağlama toplamı her zaman doğrulanır. Varsayılan: açık.

Advanced

Debug log: ödeme olaylarını kaydeder: yalnızca teknik olaylar (anahtar yok, müşteri verisi yok), modül klasöründeki logs/wc_tp_debug.log.php dosyasına. Dosya web üzerinden açılamaz. Varsayılan: kapalı. Kapalıyken hiçbir şey yazılmaz, hatalar dahil; bu nedenle bir sorunun nedenini aramadan önce açın.

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çıkken modülü kaldırmak modül ayarlarını ve günlüğü siler. Siparişler ve Tpay ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Tpay). Sandbox modunda ödeme seçeneği Sandbox mode - no real money is charged. mesajını gösterir. Onaylandıktan sonra modül, sepet tutarı için PLN cinsinden Cart # açıklamasıyla ve sepet numarasıyla bir Tpay işlemi oluşturur, müşterinin adını, e-postasını, fatura adresini ve telefonunu iletir ve müşteriyi Tpay ödeme sayfasına yönlendirir. Sayfa, mağaza diline göre Lehçe, İngilizce veya Ukraynaca gösterilir (diğer diller İngilizce alır). Orada müşteri BLIK, banka havalesi, kart veya Tpay hesabınızda etkin olan diğer yöntemlerden birini seçer ve öder. Bu noktada henüz bir sipariş yoktur.

Sipariş, yalnızca Tpay onayladıktan sonra ödenmiş olarak işaretlenir. Tpay mağazanıza bir bildirim gönderir; modül, ödemenin başlatıldığı ortamın anahtarlarını kullanarak MD5 sağlama toplamını güvenlik kodu, Merchant ID ve (açıksa) JWS imzasıyla kontrol eder, ardından tutarı kontrol eder: bu ödeme denemesi için istenen tutara ve sepet toplamına eşit olmalı ve ödenen tutar daha düşük olmamalıdır. Geçerli sağlama toplamı veya imzası olmayan bildirimler reddedilir. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Ödemeden sonra müşteri mağazanıza geri döner. Yalnızca geri dönmek hiçbir şeyi ödenmiş olarak işaretlemez. Bildirim henüz gelmediyse modül Tpay API'den işlemin durumunu sorar (en fazla her 10 saniyede bir) ve aynı kontrolleri uygular. Ödeme onaylanmadığı sürece Payment confirmation sayfası Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: mesajını, bir Refresh düğmesi ve ödeme sayfasına geri dönen bir Pay again düğmesiyle gösterir. Bildirim geldiği anda sipariş oluşturulur.

Tpay ödemenin başarısız olduğunu bildirirse müşteri Tpay reports that the payment did not go through. Please try again or choose another payment method. mesajıyla ödeme sayfasına geri döner. Ödeme Tpay sayfasında başarısız olursa Tpay müşteriyi ödeme sayfasına geri gönderir. Her iki durumda da sepet korunur. Sipariş beklemeye alındıysa onay sayfası Your payment is being verified. We will contact you as soon as it is confirmed. mesajını gösterir.

Her ödeme denemesinin kendi referansı vardır. Müşteri yeniden ödeme yaptığında, sepetin daha önce ödenmemiş Tpay işlemleri Tpay'de iptal edilir; önceki bir bağlantı üzerinden zaten gerçekleşmiş bir ödeme yine kabul edilir. Sepetin zaten bir siparişi varsa müşteri yeni bir ödeme başlatmak yerine o siparişin onay sayfasına gider.

Tpay ödemeyi başlatamazsa müşteri The Tpay payment could not be started. Please try again or choose another payment method. mesajıyla ödeme sayfasında kalır ve nedeni günlüğe yazılır (Debug log açıksa).

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

Modül yalnızca PLN ile çalışır. Mağazada banka veya BLIK kodu seçimi yoktur (müşteri Tpay sayfasında seçer); kayıtlı kart, abonelik, mağazada Apple Pay veya Google Pay düğmesi ve taksit hesaplayıcısı yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Tpay'e yönlendirildi ve ödeme yapmadı ya da Tpay henüz ödemeyi onaylamadı. Yalnızca sepet vardır. Başarısız bir ödeme de sipariş oluşturmaz.

Payment accepted: Tpay ödemeyi onayladı. Ödeme, işlem kimliği olarak Tpay işlem başlığıyla (TR-...) kaydedilir. Bir not, ödemenin bildirimle mi yoksa durum sorgulamasıyla mı onaylandığını, ortamı ve varsa fazla ödemeyi belirtir.

Tpay payment on hold: bir ödeme geldi, ancak tutarı istenen tutardan veya sepet toplamından farklıydı (örneğin ödeme başladıktan sonra sepet değiştirildi), yalnızca bir kısmı ödendi veya ödeme sipariş iptal edildikten sonra geldi. Not bunu açıklar. Ödemeyi Tpay panelinde kontrol edin, ardından siparişi tamamlayın veya iade edin. Müşteri yeni bir denemeyle doğru tutarı öderse sipariş Payment accepted durumuna geçer.

Refunded: ödeme modül aracılığıyla tamamen iade edildi.

Tpay, zaten ödenmiş veya iade edilmiş bir sipariş için başka bir ödeme bildirirse sipariş değiştirilmez; bir not, gerekirse fazla ödemeyi Tpay panelinden iade etmenizi ister. Tpay tarafından bildirilen bir chargeback bir not ekler.

Tpay ödeme bloğu

Sipariş sayfası, Tpay işlem başlığı ve kimliği, ödeme referansı (CRC), ortam (sandbox ödemeleri için Sandbox rozetiyle), ödeme durumu ve nasıl onaylandığı, ödenen tutar, sipariş toplamı ve iade edilen tutar, iade geçmişi, sepetin tüm Payment attempts kayıtları ve siparişin Payment notes bölümünü içeren bir Tpay payment bloğu gösterir.

İadeler

Tpay payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Tpay düğmesine tıklayın. Refund this amount through Tpay? This cannot be undone. sorusunu onaylayın. Tpay üzerinden alınmış ödemesi olan siparişler için tam ve kısmi iadeler desteklenir; beklemedeki siparişler dahil. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modules sayfalarına erişim gerekmez. Ödemeyi yapan Tpay işleminin tahsil ettiği tutara kadar iade yapabilirsiniz, ancak en fazla sipariş toplamı kadar: kısmi bir ödemeden veya değiştirilmiş bir sepetten sonra blok Refundable (paid through Tpay) değerini gösterir. İade, siparişin ödendiği ortama (sandbox veya canlı) gönderilir; bu nedenle o ortamın anahtarları ayarlanmış olmalıdır. İade, yalnızca Tpay onayladığında tamamlanmış sayılır; Tpay'in reddettiği veya onaylamadığı bir iade hata olarak gösterilir ve kaydedilmez. Başarılı bir iade, girdiğiniz nedenle birlikte iade geçmişine ve notlara eklenir (neden Tpay'e gönderilmez). İade edilebilir tutarın tamamını iade etmek siparişi Refunded durumuna getirir. Kısmi bir iade durumu değiştirmez.

Modül kredi notası oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Tpay üzerinden para geri göndermez. Tpay satıcı panelinde yapılan iadeler PrestaShop'a otomatik olarak eklenmez.

Lisans anahtarı

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

Anahtar kabul edilmezse blok nedenini söyler; ö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 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 Tpay müşterilere ödeme sırası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. 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, ancak ödeme adımında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde 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 kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Tpay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun dört anahtarının da girildiğini kontrol edin (Merchant ID, Client ID, Client secret, Security code). Sepet para biriminin PLN olduğunu ve modülün PLN, müşterinin ülkesi ve müşteri grubu için Payment > Preferences bölümünde izinli olduğunu kontrol edin. Ayarlar sayfası eksik anahtarlar ve PLN dışında bir mağaza para birimi için uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş oluşturulmadı: Tpay bildirimi iletemedi veya bildirim reddedildi. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. Yaygın nedenler, ödemenin ortamı için yanlış bir güvenlik kodu veya Merchant ID, engellenmiş bir bildirim adresi (güvenlik duvarı, HTTP kimlik doğrulaması) veya JWS kontrolü için OpenSSL'i olmayan ya da giden HTTPS bağlantısı bulunmayan bir sunucudur. Müşteri ödeme yaptıktan sonra mağazaya döndüğünde de sipariş oluşturulur.

Notification answered FALSE - invalid checksum: ayarlardaki Merchant ID veya güvenlik kodu, ödemenin Tpay hesabıyla (sandbox veya canlı) eşleşmiyor.

Notification answered FALSE - invalid JWS signature: imza doğrulanamadı; örneğin OpenSSL eksik olduğu ya da Tpay sertifikası indirilemediği için. Sunucuyu düzeltin veya gerekirse JWS signature seçeneğini kapatın; MD5 sağlama toplamı yine de kontrol edilir.

Notification answered FALSE - busy, retry later or FALSE - order could not be created: sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı olduğu için). Tpay bildirimi otomatik olarak yeniden dener. Nedeni görmek için Debug log seçeneğini açın.

Bildirim URL'si FALSE - POST only in the browser gösteriyor: bu normaldir. URL yalnızca Tpay'den gelen bildirimleri kabul eder.

Sipariş Tpay payment on hold durumunda: Tpay payment bloğundaki notları okuyun (bkz. Sipariş durumları), ödemeyi Tpay panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Müşteri The Tpay payment could not be started mesajını gördü: geçerli modun anahtarları yanlış veya Tpay isteği reddetti. Debug log seçeneğini açın; günlükte Tpay hatası görünür.

Müşteri We could not match this payment to an order mesajını gördü: dönüş bağlantısı müşterinin sepetine ait değildi. Müşteriden tahsilat yapıldıysa bildirim yine de siparişi oluşturur; Tpay panelini kontrol edin.

İade başarısız oluyor: mesaj anahtarların eksik olduğunu söylüyorsa siparişin ödendiği ortamın anahtarlarını girin. Mesaj tutarın çok yüksek olduğunu söylüyorsa en fazla gösterilen tutar iade edilebilir. Tpay iadeyi onaylamadıysa tekrar denemeden önce işlemi Tpay satıcı panelinde kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Tpay Payment 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ış Tpay erişim belirteçleri ve sertifikalar her zaman kaldırılır. Delete data on uninstall açıksa modül ayarları ve günlük de kaldırılır. Kapalıysa ayarlar sonraki bir yeniden kurulum için saklanır. Tpay işlemleri ve iadeleri ile Tpay payment on hold sipariş durumu her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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