VibeFox MultiSafepay 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: sepet para birimi, MultiSafepay'in kabul ettiği bir para birimi olmalıdır; örneğin EUR, USD, GBP, PLN, CHF, SEK, DKK veya NOK. Diğer para birimleri için ödeme yöntemi ödeme adımında gösterilmez.

MultiSafepay hesabı: MultiSafepay Control'deki web sitenizin API anahtarına ihtiyacınız vardır. Test ve canlı hesapların anahtarları farklıdır. MultiSafepay'de başka hiçbir şey ayarlanmak zorunda değildir: bildirim adresi her ödemeyle birlikte gönderilir.

Herkese açık site: MultiSafepay, bildirim gönderebilmek için mağazanıza erişebilmelidir. Aksi halde müşteri MultiSafepay'den döndüğünde siparişler yine de oluşturulur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesini tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesini tıklayın veya daha sonra modül listesinde VibeFox MultiSafepay Gateway öğesini bulup Configure düğmesini tıklayın.

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

4. MultiSafepay Control'den test ve/veya canlı API anahtarını yapıştırın (bkz. Yapılandırma).

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

Kurulumda modül MultiSafepay 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ünde sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, test modu açıkken Test mode: new payments use the MultiSafepay test environment (no real payments). mesajını gösterir; geçerli modda API anahtarı yoksa uyarır (bu durumda ödeme yöntemi ödeme adımında gösterilmez) ve MultiSafepay mağazanızın varsayılan para birimini kabul etmiyorsa uyarır. Title olmadan sayfa kaydedilmez.

Ödeme

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

Title: müşterinin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte de bu ad kaydedilir. Varsayılan: MultiSafepay. Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API anahtarları

API anahtarını MultiSafepay Control > Manage settings > Website settings bölümünde bulabilirsiniz. Bu bölüm test hesabına (testmerchant.multisafepay.com) ve canlı hesaba (merchant.multisafepay.com) bağlantı verir. Anahtarlar farklıdır. Test modu yalnızca test anahtarını, canlı mod yalnızca canlı anahtarı kullanır.

Test mode: Use the MultiSafepay test environment (no real payments). Hem API adresini hem de API anahtarını değiştirir. Daha önce yapılmış ödemeler, durum kontrolleri ve iadeler için yapıldıkları ortamı kullanmaya devam eder. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında Test mode: no real payment will be made. mesajını görür.

Test API key: MultiSafepay test hesabınızın API anahtarı.

Live API key: MultiSafepay canlı hesabınızın API anahtarı.

Kaydedilmiş anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. yazar. 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üğmesini tıklayın. Boş alan kayıtlı değeri korur.

Bildirimler

Yapılandırılacak bir şey yoktur. Notification URL alanı, her ödemeyle birlikte MultiSafepay'e gönderilen adresi gösterir. Dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_multisafepay_gateway/webhook; başında /en/ gibi bir dil kodu da olabilir. Bildirim modüle yalnızca hangi ödemenin değiştiğini söyler: durum, tutar ve para birimi, sipariş oluşturulmadan veya değiştirilmeden önce her zaman API anahtarınızla MultiSafepay API'sinden okunur. Mağazanızda başlatılmamış ödemelerin bildirimleri yok sayılır. Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Siparişler

Order status after payment: ödenmiş siparişin durumu. Durum tek seferde, tek bir durum değişikliği ve tek bir müşteri e-postasıyla ayarlanır.

Gelişmiş

Debug log: Log API calls and notifications, modül klasöründeki logs/mspg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. API anahtarları ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

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

Delete data on uninstall: açıksa modül kaldırıldığında ayarlar ve günlük silinir. Siparişlerin MultiSafepay ödeme verileri ve sipariş durumu her zaman kalır, bu sayede eski siparişlerin iadeleri mümkün olmaya devam eder. Modülü devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak MultiSafepay, MultiSafepay logosuyla) ve onaylar. Modül, sepet toplamı için sepet para biriminde bir MultiSafepay ödemesi oluşturur ve müşteriyi MultiSafepay ödeme sayfasına yönlendirir. Orada müşteri MultiSafepay hesabınızda etkin olan herhangi bir ödeme yöntemini seçer ve öder. Müşterinin fatura adresi, e-posta, telefon ve dili MultiSafepay'e aktarılır; ödeme Order #, sepet numarası ve mağaza adınızla görünür. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca MultiSafepay onayladıktan sonra ödenmiş olarak işaretlenir: bildirimle veya müşteri döndüğünde MultiSafepay API'si üzerinden kontrolle. Sipariş oluşturulur ve müşteri Your payment with MultiSafepay has been received. mesajını içeren standart sipariş onay sayfasını görür. Beklemedeki bir sipariş için sayfa We are confirming your payment with MultiSafepay. The order will be updated automatically — please do not pay again. mesajını gösterir. Ödeme daha sonra başarısız olursa sayfa Your MultiSafepay payment was not completed. Please contact us about this order. mesajını gösterir. Müşteri döndüğünde MultiSafepay ödemeyi henüz onaylamadıysa (örneğin bir banka havalesi bekleniyorsa), Payment confirmation sayfası aynı onaylama metnini ve bir Check again düğmesini gösterir; MultiSafepay ödemeyi bildirir bildirmez bildirim siparişi oluşturur.

Müşteri MultiSafepay sayfasında iptal ederse veya ödeme reddedilir ya da süresi dolarsa, müşteri sepeti korunmuş halde ödeme adımına döner ve şu mesajlardan biriyle karşılaşır: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. veya The payment session has expired. Please try again.

Aynı sepet için yeni bir ödeme oluşturmadan önce modül, önceki ödemeyi MultiSafepay'de kontrol eder. Zaten ödenmişse veya işleniyorsa, yeni bir ödeme yerine sipariş oluşturulur. Aynı tutarla hâlâ açıksa aynı ödeme sayfası yeniden kullanılır. Tutar değiştiyse eski ödeme MultiSafepay'de iptal edilir, böylece artık ödenemez.

MultiSafepay ödemeyi başlatamazsa müşteri, kısa bir mesajla ödeme adımında kalır; örneğin Could not connect to MultiSafepay. Please try again in a moment. veya MultiSafepay cannot accept this order amount or currency. Please choose another payment method. Teknik neden günlüğe yazılır.

Modül, MultiSafepay sayfasına giden tek bir ödeme yöntemi sunar. Her MultiSafepay ödeme yöntemi için ayrı PrestaShop ödeme yöntemi, gömülü kart alanları, Apple Pay veya Google Pay ekspres düğmeleri, abonelik, yinelenen ödemeler veya kayıtlı kart yoktur; PrestaShop'tan tahsilat veya iptal de yapılamaz. Sepet verisi gönderilmediği için bunu gerektiren ertelemeli ödeme yöntemleri (örneğin Klarna, in3 veya Riverty) bu siparişler için MultiSafepay tarafından sunulmaz.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri MultiSafepay'e yönlendirildi ve ödeme yapmadı ya da MultiSafepay ödemeyi henüz onaylamadı. Yalnızca sepet mevcuttur.

Payment accepted veya Delivered: MultiSafepay ödemeyi onayladı (tamamlandı veya gönderildi). Durum Order status after payment ayarını izler. Ödeme, MultiSafepay sipariş kimliği işlem kimliği olarak kaydedilir; bir not ödemeyi, ödeme yöntemini ve ortamı gösterir.

MultiSafepay payment on hold before payment: ödeme mutabakatı yapılmamış (MultiSafepay tarafından inceleniyor) veya rezerve edilmiş (yetkilendirilmiş). Parayı almak için MultiSafepay Control'de rezerve edilmiş ödemeyi tahsil edin. MultiSafepay ödemeyi tamamlandı olarak bildirdiğinde sipariş otomatik olarak ödenmiş duruma geçer.

MultiSafepay payment on hold after payment: MultiSafepay, sepet toplamından farklı bir tutar veya para birimi onayladı (örneğin ödeme başladıktan sonra sepet değiştirildi), modül canlı modda çalışırken bir test ödemesi tamamlandı (gerçek para alınmadı, ödeme kaydedilmedi) veya sipariş iptal edildikten sonra ödeme tamamlandı. Not bunu açıklar. MultiSafepay Control'de işlemi kontrol edin ve siparişi tamamlayın veya iade edin.

MultiSafepay payment on hold after a chargeback: MultiSafepay, ödenmiş bir sipariş için geri ödeme (chargeback) bildirdi: para hesabınızdan geri alındı.

Payment error: mutabakatı yapılmamış veya rezerve edilmiş bir ödeme daha sonra reddedildi, iptal edildi, süresi doldu veya geçersiz kılındı.

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

Ödenmiş veya iade edilmiş bir sipariş, geciken bir bildirimle asla yeniden açılmaz. Zaten ödenmiş bir sepet için ikinci bir ödeme tamamlanırsa sipariş değişmez. Bir not, MultiSafepay Control'de yinelenen ödemeyi iade etmenizi ister.

MultiSafepay ödeme bloğu

Sipariş sayfasında; MultiSafepay sipariş kimliği, ödeme yöntemi, durum, ödenen ve iade edilen tutar, test ödemeleri için bir Test mode rozeti, iade geçmişi ve siparişin MultiSafepay notes bölümü içeren bir MultiSafepay payment bloğu görünür.

İadeler

MultiSafepay payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via MultiSafepay düğmesini tıklayın. Refund this amount through MultiSafepay? 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, MultiSafepay'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (test veya canlı) gönderilir; bu nedenle o ortamın API anahtarı tanımlı olmalıdır. MultiSafepay iadeyi kabul etmezse blok, MultiSafepay hatasıyla birlikte MultiSafepay refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, MultiSafepay iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, MultiSafepay ödemeyi bildirdikten sonra kullanılabilir.

Modül kredi notu (credit slip) oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri MultiSafepay üzerinden para geri göndermez.

MultiSafepay Control'de yapılan iadeler, MultiSafepay bildirdiğinde notlara eklenir. Sipariş durumu ve kredi notları otomatik olarak değişmez. Gerekirse bunları elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox MultiSafepay Gateway lisans bloğu, Modules > Module Manager > VibeFox MultiSafepay Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesini 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-multisafepay 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 yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; ö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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesini 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ızda serbest bırakın.

Etkin bir anahtar olmadan MultiSafepay, ö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, yönetim paneline giriş yaptığınızı bilmediğinden ödeme yöntemi sizden de gizlenir: modülü bir 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. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

MultiSafepay ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda bir API anahtarı bulunduğunu (test modunda Test API key, canlı modda Live API key) ve sepet para biriminin MultiSafepay tarafından kabul edildiğini kontrol edin. Ayarlar sayfası, anahtar yoksa veya mağaza para birimi kabul edilmiyorsa 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, ancak sipariş oluşturulmadı: bildirim mağazanıza ulaşmadı. Mağazanın internetten erişilebilir olduğunu ve ödemenin ortamının API anahtarının tanımlı olduğunu kontrol edin, çünkü modül durumu MultiSafepay API'sinden okur. API'ye ulaşılamıyorsa veya anahtar yoksa bildirim ERROR yanıtı verir ve MultiSafepay bildirimi yeniden dener. Sipariş ayrıca müşteri mağazaya döndüğünde ve aynı sepeti tekrar ödemeye çalıştığında da oluşturulur.

Bildirim Invalid request yanıtı veriyor: istekte geçerli bir işlem kimliği yoktu. MultiSafepay'den gelen bildirimler her zaman bir işlem kimliği içerir.

Müşteri MultiSafepay'i seçerken bir hata görüyor: Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle hatalı veya eksik bir API anahtarı anlamına gelir. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. ise MultiSafepay'in tutarı veya para birimini reddettiği anlamına gelir.

Sipariş MultiSafepay payment on hold durumunda: MultiSafepay payment bloğundaki notları okuyun. Ödeme mutabakatı yapılmamış veya rezerve edilmiş olabilir, ödenen tutar veya para birimi sepetten farklı olabilir, canlı modda bir test ödemesi gelmiş olabilir, ödeme siparişin iptalinden sonra gelmiş olabilir ya da bir geri ödeme (chargeback) olmuş olabilir. MultiSafepay Control'de işlemi kontrol edin.

Test ödemeleri canlı bir siparişi onaylamaz: modül canlı modda çalışırken bir test ödemesi hiçbir siparişi ödemez; bunun yerine sipariş beklemeye alınır. Canlıya geçtikten sonra da önceki test ödemeleri test anahtarıyla kontrol edilmeye ve iade edilmeye devam eder.

İade, ortamla ilgili bir mesajla başarısız oluyor: ödeme test veya canlı ortamda yapıldı ve o ortamın API anahtarı tanımlı değil. Anahtarı girin ve yeniden deneyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox MultiSafepay 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 silinir. Delete data on uninstall açıksa ayarlar ve günlük silinir. Kapalıysa tüm ayarlar sonraki yeniden kurulum için saklanır. Siparişlerin MultiSafepay ödeme verileri ve MultiSafepay payment on hold sipariş durumu her zaman saklanır; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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