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

Autopay hizmeti: Autopay hizmetinizin Service ID ve Shared key (hash anahtarı) değerlerine ihtiyacınız var. Bunlar Autopay merchant portalında gösterilir: canlı ortam için portal.autopay.eu, test için testportal.autopay.eu. Test hizmetlerinin kendi Service ID ve Shared key değerleri vardır; Autopay'den bir tane açmasını isteyin. Hizmetin hash fonksiyonu SHA-256 olmalıdır.

Para birimi: sepet para birimi PLN, EUR, GBP, USD veya CZK olmalı ve Autopay hizmetiniz tarafından kabul edilmelidir.

Erişilebilir mağaza: Autopay mağazanıza bildirim gönderebilmelidir; bu yüzden mağaza, temel kimlik doğrulama olmadan ve POST isteklerini engelleyen bir güvenlik duvarı olmadan internetten erişilebilir olmalıdır. Mağazanızın bakım modu ve ülke kısıtlaması bildirimleri engellemez.

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 sayfasına 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 Autopay Payment modülünü bulup Configure düğmesine tıklayın.

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

4. Service ID ve Shared key değerlerini (test ve canlı) girin ve hizmetinizin para birimlerini seçin.

5. Autopay portalında hizmetiniz için ITN URL'sini, dönüş URL'sini ve SHA-256 hash fonksiyonunu ayarlayın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir deneme siparişi verin, ardından gerçek ödemeler için Test mode seçeneğini kapatın.

Kurulumda modül Autopay payment on hold sipariş durumunu oluşturur. PrestaShop yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Autopay Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde, seçilen ortamın Service ID veya Shared key değeri boşsa ve mağazanın varsayılan para birimi Currencies bölümünde seçili değilse sayfa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir (seçili olmayan para birimi için).

Autopay

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Autopay. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay online by bank transfer, BLIK or card. You will be redirected to the secure Autopay payment page.

Autopay hizmeti

Service ID ve Shared key, Autopay merchant portalında gösterilir (portal.autopay.eu veya testportal.autopay.eu, bu bölümde bağlantılıdır).

Test mode: Autopay test ortamını (testpay.autopay.eu) ve aşağıdaki test kimlik bilgilerini kullanır. Varsayılan: açık. Gerçek ödemeleri canlı kimlik bilgileriyle pay.autopay.eu üzerinden kabul etmek için kapatın.

Service ID (production): portal.autopay.eu üzerindeki sayısal hizmet kimliği.

Shared key (production): canlı hizmetin hash anahtarı. Gizli tutun.

Service ID (test): testportal.autopay.eu üzerindeki sayısal hizmet kimliği.

Shared key (test): test hizmetinin hash anahtarı.

Kaydederken, harf, rakam, tire veya alt çizgi dışında karakter içeren bir Service ID hata ile reddedilir ve hiçbir şey kaydedilmez. Kaydedilmiş Shared key değerleri bir daha 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 keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan, kayıtlı değeri korur.

Currencies: Autopay hizmetinizin kabul ettiği para birimleri: PLN, EUR, GBP, USD, CZK. Autopay genellikle para birimi başına ayrı bir hizmet açar. Ödeme yöntemi, sepet para birimi burada seçiliyse sunulur. Varsayılan: PLN.

Ödeme bildirimleri (ITN) ve dönüş adresi

Bu adresleri, hizmetiniz için Autopay portalına hem canlı hem test için girin. Tam adresler bu bölümdeki Addresses alanında gösterilir. Okunabilir URL'lerle şöyle görünürler; başlarında /en/ gibi bir dil kodu da olabilir:

Adresleri ayarların gösterdiği gibi birebir kopyalayın. ITN URL'si olmadan siparişler hiçbir zaman oluşmaz, çünkü PrestaShop siparişi yalnızca Autopay ödemeyi onayladığında oluşturur. Her ITN, bildirimde belirtilen hizmetin Shared key değeriyle yapılmış SHA-256 hash ile kontrol edilir. Geçerli hash içermeyen veya bilinmeyen bir Service ID'ye ait bildirimler reddedilir. Bir bildirim, ancak ödemesi aynı Autopay hizmetiyle başlatılmışsa bir sepete uygulanır; bu yüzden bir test bildirimi asla canlı bir ödemeyi onaylamaz. Test mode değiştirilmeden önce başlatılmış ödemelerin bildirimleri, her iki kimlik bilgisi de kayıtlı kaldığı sürece doğru anahtarla doğrulanmaya devam eder.

Modül ITN'de şu ödeme durumlarını işler:

Gelişmiş

Logging: ödeme olaylarını modül klasöründeki logs/wc_ap_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz.

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

Ödeme sayfası

Ödeme adımında müşteri, ödeme yöntemini (varsayılan olarak Autopay) açıklamasıyla birlikte seçer ve onaylar. Sonraki sayfa Thank you. You are being redirected to Autopay to complete the payment. Your order is created as soon as Autopay confirms it. mesajını gösterir ve müşteriyi Autopay ödeme sayfasına gönderir. Müşteri tarayıcının geri düğmesiyle dönerse, sayfa yeniden yönlendirme yapmak yerine Pay with Autopay düğmesini gösterir. Bu noktada henüz bir sipariş yoktur.

Modül, sepet toplamını sepet para biriminde, sepet numarasını sipariş referansı olarak, açıklamayı (Cart ve numara) ve müşterinin e-posta adresini iletir. Autopay sayfasında müşteri ödeme yöntemini seçer ve öder.

Sipariş, ancak Autopay imzalı bir ITN ile onayladığında ve tutar ile para birimi sepetle eşleştiğinde ödenmiş olarak işaretlenir. Ardından sipariş oluşturulur ve müşteri standart PrestaShop sipariş e-postalarını alır. Ödemeden sonra müşteri mağazanıza döner. Dönüş adresi imzalıdır, ama hiçbir zaman sipariş oluşturmaz veya değiştirmez. Sipariş zaten varsa müşteri standart sipariş onay sayfasını görür. ITN henüz gelmediyse, Payment confirmation sayfası Thank you. Your payment is being confirmed by Autopay — your order will be created as soon as Autopay confirms it, and you will receive an e-mail. mesajını ve Check again ile Back to checkout düğmelerini gösterir.

Autopay başarısız bir ödeme bildirdiyse, müşteri The payment was not completed. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur. Ödeme başlatılamazsa müşteri, örneğin Autopay payments are not configured. Please choose another payment method or contact the store. gibi kısa bir mesajla ödeme sayfasında kalır veya Autopay'in bu para biriminde ödeme kabul edemediği bilgisini görür.

Modül PrestaShop'tan iade yapmayı, abonelik veya yinelenen ödemeleri, kayıtlı kartları, ödeme sayfasında BLIK kodu veya kart formunu, ödeme sayfasında banka veya ödeme kanalı seçimini desteklemez ve ortam başına tek bir Service ID kullanır.

Siparişler

Sipariş durumları

No order yet: müşteri Autopay'e yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu veya Autopay henüz ödemeyi onaylamadı. Yalnızca sepet vardır.

Payment accepted: Autopay ödemeyi onayladı ve tutar ile para birimi eşleşiyor. Ödeme, işlem kimliği olarak Autopay işlem kimliğiyle (remoteID) kaydedilir ve bir not tutarı, Autopay işlemini ve ödeme tarihini gösterir.

Autopay payment on hold: Autopay, sepet toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet değiştirildi). Sipariş ödenmiş olarak işaretlenmez. Autopay portalında işlemi kontrol edin ve manuel olarak tamamlayın veya iade edin. Bu sipariş için daha sonra gelen doğru bir bildirim siparişi ödenmiş olarak işaretler. Aynı durum, iptal edilmiş bir sipariş için ödeme geldiğinde de kullanılır: ödeme kaydedilir ve bir not stoku kontrol edip siparişi tamamlamanızı veya ödemeyi iade etmenizi ister.

Ödenmiş bir sipariş, sonradan gelen bir başarısızlık bildirimiyle asla değiştirilmez. Autopay, ödenmiş bir sipariş için başka bir başarılı ödeme bildirirse, bir not müşterinin iki kez ödeme yapmış olabileceği konusunda uyarır. Başka bir Autopay hizmetiyle başlatılmış bir ödemeye ait bildirim uygulanmaz ve bir not bunu açıklar. Notlar yalnızca personele görünür; sipariş sayfasındaki Autopay payment bloğunda yer alır.

Autopay payment bloğu

Sipariş sayfasında Autopay OrderID'si, Service ID ve ortam, tutar ve para birimi, ödeme durumu, Autopay işlem kimliği, test ödemeleri için bir Test mode rozeti ve siparişin Autopay notes bölümü içeren bir Autopay payment bloğu gösterilir. Blok salt okunurdur.

İadeler

Autopay üzerinden yapılan iadeler desteklenmez. Ödemeyi Autopay portalında iade edin, ardından standart sipariş araçlarıyla PrestaShop'ta kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Autopay Payment, Modules > Module Manager > VibeFox Autopay Payment > Configure sayfasının ilk bloğudur ve ayarların üstünde yer alır. 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 son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-autopay satırı ile Manage licenses and domains in your account bağlantısı bulunur; 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 arka ofis 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 tarihli License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvası 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 yalnızca 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 Autopay, ö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. Mağaza arka ofise giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfası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 yine onaylanır.

Lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, arka ofiste ç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 her zaman lisans anahtarını ve lisans durumunu kaldırır.

Sorun giderme

Autopay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçilen ortamda Service ID ve Shared key bulunduğunu ve sepet para biriminin Currencies bölümünde seçili olduğunu kontrol edin. Bunlardan biri eksikse ayarlar sayfası 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ı: Autopay ITN'yi iletmedi veya mağaza bunu reddetti. Ayarlarda gösterilen ITN URL'sinin Autopay portalında hizmet için (canlı veya test) tanımlı olduğunu, hash fonksiyonunun SHA-256 olduğunu ve modüldeki Shared key'in hizmetle eşleştiğini kontrol edin. Mağazanın internetten erişilebilir olduğunu kontrol edin. Logging seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Günlük ITN rejected: invalid hash gösteriyor: Shared key hizmetle eşleşmiyor veya hizmetin hash fonksiyonu SHA-256 değil.

Günlük service ID'nin yapılandırılmadığını gösteriyor: bildirim, Service ID'si modüle girilmemiş veya Shared key'i boş olan bir hizmetten geldi.

Günlük could not lock the cart, Autopay will retry gösteriyor: sepet aynı anda başka bir bildirim tarafından işleniyordu. Mağaza, Autopay'in bildirimi yeniden göndermesi için yanıt verir. Sipariş, örneğin modül devre dışı olduğu için oluşturulamadığında da aynısı olur.

Sipariş, uyuşmazlık notuyla birlikte Autopay payment on hold durumunda: Autopay, sepet toplamından farklı bir tutar veya para birimi bildirdi. Autopay portalında işlemi kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

Bir not bildirimin UYGULANMADIĞINI söylüyor: bu sipariş için ödeme bu Autopay hizmetiyle başlatılmamış; örneğin gerçek bir sipariş için test bildirimi. Autopay portalında işlemi kontrol edin.

Ödemeden sonra müşteri ana sayfaya düşüyor: dönüş adresi doğrulanamadı; örneğin Service ID modüle girilmemiş olabilir. Sipariş etkilenmez; ITN'yi izler.

Müşteri This payment method is not available. mesajını görüyor: ödeme yöntemi bu sepet için sunulmuyor (kapalı, kimlik bilgileri eksik, para birimi seçilmemiş veya Payment > Preferences bölümünde izin verilmemiş).

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Autopay 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. Anahtarlar dahil modül ayarları ve günlük kaldırılır. Modülde ayarları saklama seçeneği yoktur. Autopay ödeme verileri ve Autopay payment on hold sipariş durumu her zaman saklanır. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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