VibeFox Satispay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: OpenSSL eklentisi bulunan 8.0 veya üzeri. Modül, eski PHP sürümlerinde ya da OpenSSL olmadan kurulmaz.

Para birimi: EUR. Satispay yalnızca euro tahsil eder, bu nedenle sepetin para birimi EUR değilse ödeme yöntemi gizlenir.

Satispay hesabı: bir Satispay Business hesabı. Hiçbir API anahtarını kopyalamazsınız: modül, Satispay Business Dashboard'da oluşturduğunuz tek kullanımlık bir aktivasyon kodu ile bağlanır (bkz. Yapılandırma). Testler için, Satispay'den geliştiriciler için talep edeceğiniz bir Satispay sandbox hesabına ihtiyacınız vardır.

Herkese açık mağaza: Satispay, bir ödeme değiştiğinde mağazanızı çağırabilmesi için mağazanızın internetten erişilebilir olması gerekir. Bunun için Satispay'de herhangi bir ayar yapmanız gerekmez.

VibeFox lisans anahtarı: vibefox.net'ten 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 ya da daha sonra modül listesinde VibeFox Satispay Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Ortamı seçin: testler için Sandbox Mode seçeneğini açın, gerçek ödemeler için kapalı bırakın.

5. Bu ortamın bir aktivasyon kodunu Activation Code alanına yapıştırın ve Save düğmesine tıklayın. Status alanı bunun üzerine Connected ve Key ID değerini gösterir.

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox'ta bir ödeme deneyin, ardından Sandbox Mode seçeneğini kapatın ve canlı ortamı canlı bir aktivasyon koduyla bağlayın.

Kurulumda modül Satispay 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. Orada modülün euro için izinli olması gerekir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Satispay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder.

Ödeme sayfası

Müşterilerin ödeme yöntemleri listesinde gördükleri.

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

Title: ödeme sayfasında gösterilen ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Satispay. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay bağlantısı

Status: iki ortamın durumu; örneğin Key ID ile Live: Connected ya da Sandbox: Not connected, ve hangi ortamın kullanıldığı. Kullanılan ortam bağlı olmadığı sürece alan Satispay is hidden at checkout until the environment in use is connected. mesajını gösterir.

Sandbox Mode: Satispay sandbox (test) ortamını kullanır. Sandbox ödemeleri tahsil edilmez. Varsayılan: off. Sandbox ve canlı ortamın anahtarları ayrıdır: her ortamı o ortamın bir aktivasyon koduyla bağlayın. Sandbox kullanılırken müşteriler ödeme yönteminin altında Sandbox mode: no real money is charged. mesajını görür.

Activation Code: yukarıda seçilen ortamı bağlamak için yeni bir 6 karakterlik aktivasyon kodu yapıştırın ve Save düğmesine tıklayın. Canlı kodlar Satispay Business Dashboard'da, Online shop bölümünde oluşturulur. Sandbox kodları bir Satispay sandbox hesabıyla birlikte gelir. Kod yalnızca bir kez kullanılır ve saklanmaz. Mevcut bağlantıyı korumak için alanı boş bırakın.

Bir kodla kaydettiğinizde modül bir RSA anahtar çifti oluşturur, genel anahtarı ve kodu Satispay'e gönderir ve Key ID ile o ortamın anahtarlarını mağaza yapılandırmasında saklar. Özel anahtarlar hiçbir zaman gösterilmez. Başarılı olursa sayfa, örneğin Satispay Live connected. Key ID: ve ardından ID'yi gösterir. Satispay kodu reddederse sayfa Satispay activation failed: ve Satispay'in mesajını gösterir ve kodun bu ortama ait olup olmadığını ve daha önce kullanılmadığını kontrol etmenizi ister. Harf ve rakam dışında karakter içeren bir kod, hiçbir şey gönderilmeden reddedilir. Bir ortam için yeni bir kod kaydetmek, o ortamın önceki bağlantısının yerine geçer.

Ödeme bildirimleri

Satispay'de yapılandırılacak bir şey yoktur. Her ödemenin, ödeme değiştiğinde Satispay'in çağırdığı kendi callback URL'si vardır ve modül, bir sipariş oluşturmadan ya da değiştirmeden önce ödemeyi Satispay API'sinden yeniden okur. Callback URL alanı bu URL'nin bir örneğini gösterir. Dostça URL'ler ile şöyle görünür: https://your-shop/module/wcp_satispay_gateway/callback?id_cart={cart}&payment_id={uuid}, başında /en/ gibi bir dil kodu da olabilir. URL internetten erişilebilir olmalıdır: önünde temel kimlik doğrulama (basic authentication) olmamalıdır. Callback, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Gelişmiş

Debug log: API çağrılarını ve ödeme olaylarını modül klasöründeki logs/satispay_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri kaydedilmez. Hatalar, bu seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: off.

Log: günlüğün boyutunu ve 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ırıldığında ayarlar, iki ortamın Satispay anahtarları ve günlük silinir. Siparişler için kaydedilen Satispay ödemeleri ve iadeleri ile Satispay payment on hold sipariş durumu her zaman korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Satispay) seçer ve siparişi onaylar. Modül, sepet toplamı için euro cinsinden bir Satispay ödemesi oluşturur, sepet numarasını referans olarak kullanır ve müşteriyi Satispay ödeme sayfasına yönlendirir. Bilgisayarda müşteri QR kodu Satispay uygulamasıyla tarar. Telefonda müşteri ödemeyi uygulamada onaylar. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Satispay ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: modül ödemeyi Satispay API'sinden okur, bu sepet için oluşturulduğunu doğrular ve durumunu, tutarını (kuruş cinsinden) ve para birimini sepetle karşılaştırır. Bu, Satispay callback URL'sini çağırdığında da müşteri geri döndüğünde de gerçekleşir; hangisi önce gelirse. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür. Müşteri geri döndüğünde Satispay ödemeyi henüz onaylamadıysa, Payment confirmation sayfası Satispay has not confirmed your payment yet. The order will be updated automatically as soon as the confirmation arrives. mesajını ve bir Check again düğmesini gösterir. Callback, geldiği anda siparişi oluşturur.

Müşteri Satispay sayfasını ödeme yapmadan terk ederse, modül ödemeyi Satispay'de iptal eder; böylece terk edilen sayfa artık ödenemez. Müşteri Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Müşteri uygulamada ödemeyi reddettiğinde de aynı mesaj gösterilir. Sepet korunur.

Aynı sepet için yeni bir Satispay ödemesi oluşturulmadan önce öncekisi kontrol edilir: bekleyen bir ödeme Satispay'de iptal edilir ve zaten ödenmişse sipariş o ödemeyle oluşturulur, ikinci bir ödeme yapılmaz.

Ödeme başlatılamazsa müşteri kısa bir mesajla ödeme sayfasında kalır: mağaza bağlı değilse ya da Satispay anahtarları reddederse Satispay is not available at the moment. Please choose another payment method., diğer hatalar için Unable to create the Satispay payment. Please try again or choose another payment method. mesajı gösterilir. Nedeni günlüğe yazılır.

Modül yalnızca euro cinsinden tek seferlik ödemeleri kabul eder. Abonelik, kayıtlı ödeme yöntemi, ön provizyon ya da yemek kartı desteklemez. Bekleyen ödemeler için zamanlanmış bir kontrol yoktur: Ne Satispay callback'i ne de müşterinin dönüşü mağazanıza ulaşırsa sipariş oluşturulmaz ve ödeme Satispay Dashboard'da görünür kalır.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Satispay'e yönlendirildi ve ödeme yapmadı ya da Satispay ödemeyi henüz onaylamadı. Yalnızca sepet ve modülün Satispay ödemesi vardır.

Payment accepted: ödeme onaylandı. Ödeme, işlem kimliği olarak Satispay ödeme ID'si ile kaydedilir ve bir not Satispay ödemesini, tutarı ve doğrulama yöntemini (callback, redirect or checkout) gösterir.

Satispay payment on hold: Satispay, sepet toplamından farklı bir tutar ya da para birimi bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi), ya da ödeme, sipariş iptal edildikten sonra kabul edildi. Alınan para siparişe kaydedilir ve not bunu açıklar. Ödemeyi Satispay Dashboard'da kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin. Aynı sepet için doğru tutarda başka bir ödeme sonradan kabul edilirse sipariş Payment accepted durumuna geçer.

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

Zaten ödenmiş bir sipariş için ikinci bir ödeme kabul edilirse sipariş değişmez. Bir not, çift ödemeyi Satispay Dashboard'dan iade etmenizi ister. Tekrarlanan bir onay, iptal edilmiş ya da iade edilmiş bir siparişi asla yeniden açmaz.

Satispay ödeme bloğu

Sipariş sayfasında Satispay ödeme ID'si, durumu, ödenen ve iade edilen tutar, sandbox ödemeleri için bir Sandbox rozeti, iade geçmişi, her ödeme denemesini ve ortamını içeren Satispay payments of this cart listesi ve siparişin Satispay notes bölümünü gösteren bir Satispay payment bloğu bulunur.

İadeler

Satispay payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Satispay düğmesine tıklayın. Refund this amount through Satispay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine ihtiyacınız vardır; Modules sayfalarına erişim gerekmez. İadeler, Satispay'in ödeme için tahsil ettiği tutarla sınırlıdır; bu nedenle tutar uyuşmazlığından sonra en fazla müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz, sipariş toplamına kadar değil. İade, ödemenin yapıldığı ortama (canlı ya da sandbox) gönderilir; bu nedenle o ortamın hâlâ bağlı olması gerekir. İade ancak Satispay kabul ettiğinde tamamlanmış sayılır: başarılı bir iade, Satispay iade ID'si ve nedenle birlikte iade geçmişine ve notlara eklenir. Satispay iadeyi kabul etmezse 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 Satispay üzerinden para geri göndermez. Satispay Dashboard üzerinden yapılan iadeler PrestaShop'a kaydedilmez. Gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Satispay Gateway, ayarların üstünde, Modules > Module Manager > VibeFox Satispay Gateway > Configure sayfasındaki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarihi ve alan adınızı) ve Check now düğmeleriyle durumu yeniden kontrol edebilir, Change key ile başka bir anahtar girebilir ve Remove key ile anahtarı bu mağazadan kaldırabilirsiniz. Bunların altında Product: presta-payment-satispay 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. 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 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 Satispay, ö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 vitrini, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sırası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 ve iadeler çalışır.

Lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Back office'te çalışırken durum 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

Satispay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, kullanılan ortamın bağlı olduğunu (Status alanı onun için Connected gösteriyor) ve sepet para biriminin EUR olduğunu kontrol edin. Payment > Preferences bölümünde modülün euro, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: sipariş, Satispay mağazanızı çağırdığında ya da müşteri geri döndüğünde oluşturulur. Mağazanızın internetten erişilebilir olduğunu, callback URL'sinin önünde temel kimlik doğrulama olmadığını kontrol edin ve callback'leri Log alanında görmek için Debug log seçeneğini açın. Ödeme, Satispay Dashboard'da görünür.

Callback Payment status unavailable, retry later. ya da Not configured. yanıtı veriyor: modül ödemeyi Satispay'den okuyamadı ya da ödemenin ortamı bağlı değil. Hiçbir sipariş değişmez. Satispay yeniden çağırır. Bağlantı durumunu ve günlüğü kontrol edin.

Callback Busy, retry later. yanıtı veriyor: sepet aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Satispay yeniden çağırır. Günlük nedeni gösterir.

Callback Unknown payment. ya da Missing or invalid payment_id. yanıtı veriyor: ödeme bu mağaza tarafından bu sepet için oluşturulmadı ya da istek bir Satispay callback'i değil. Hiçbir şey değişmez.

Aktivasyon başarısız oluyor: aktivasyon kodları yalnızca bir kez kullanılabilir. Kodun Sandbox Mode seçiminde seçili ortama ait olduğunu kontrol edin (canlı için canlı kod, sandbox için sandbox kodu), yeni bir kod oluşturun ve yeniden kaydedin. Sayfa bir RSA anahtar çifti oluşturulamadığını söylüyorsa barındırma sağlayıcınızdan PHP OpenSSL eklentisini etkinleştirmesini isteyin. Satispay'e ulaşılamıyorsa sunucunuzun giden HTTPS bağlantılarını açabildiğini kontrol edin.

Sandbox'tan canlıya geçtikten sonra Satispay ödeme sayfasından kayboldu: sandbox ve canlı farklı anahtar kullanır. Sandbox Mode kapalıyken canlı bir aktivasyon kodu yapıştırın ve kaydedin.

Müşteri This payment method is not available. mesajını görüyor: ödeme yöntemi sepet için izinli değil (Payment > Preferences içinde ülke, para birimi ya da müşteri grubu), devre dışı ya da kullanılan ortam bağlı değil.

Ödemeden sonra sipariş Satispay payment on hold durumunda: Satispay payment bloğundaki notları okuyun (bkz. Sipariş durumları), ödemeyi Satispay Dashboard'da kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin.

Ortam artık bağlı olmadığı için iade başarısız oluyor: ödeme canlı ya da sandbox ortamında yapıldı ve o ortamın artık anahtarı yok. Bir aktivasyon koduyla yeniden bağlayın ya da ödemeyi Satispay Dashboard'dan iade edin.

Satispay did not accept the refund ile iade başarısız oluyor: Satispay, accepted dışında bir durum döndürdü. PrestaShop iadeyi kaydetmedi ve bir not bunu belirtir. Satispay Dashboard'da kontrol edin.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Satispay 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, iki ortamın Satispay anahtarları ve günlük silinir. Kapalıysa tüm ayarlar ve anahtarlar daha sonra yeniden kurulmak üzere saklanır. Siparişler için kaydedilen Satispay ödemeleri ve iadeleri ile Satispay payment on hold sipariş durumu her zaman korunur; bu nedenle daha önce ödenmiş siparişler, ortam yeniden bağlandıktan sonra yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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