VibeFox SimplePay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Mağaza para birimi: HUF, EUR veya USD. SimplePay diğer para birimlerini kabul etmez ve ödeme yöntemi bu para birimlerindeki sepetler için sunulmaz.

SimplePay satıcı hesapları: SimplePay her para birimi için ayrı bir satıcı hesabı, canlı ve sandbox için de ayrı hesaplar verir. Her hesap için SimplePay satıcı yönetim panelinden (canlı için admin.simplepay.hu, sandbox için sandbox.simplepay.hu) kendi MERCHANT ve SECRET KEY değerlerine ihtiyacınız vardır: account > Technical data. Yalnızca HUF ile satış yapıyorsanız HUF hesabı yeterlidir. Başka anahtar gerekmez.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek 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 SimplePay 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. Sattığınız her para birimi için SimplePay hesaplarınızın MERCHANT ve SECRET KEY değerlerini girin: testler için sandbox hesapları, gerçek ödemeler için canlı hesaplar (bkz. Yapılandırma).

5. Configure sayfasında gösterilen IPN URL'yi SimplePay satıcı yönetim panelindeki her satıcı hesabına (canlı ve sandbox) kopyalayın.

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

Kurulumda modül SimplePay 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 SimplePay 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, mağazanın varsayılan para biriminin SimplePay tarafından desteklenmediğini veya mevcut modda bu para birimi için satıcı hesabı olmadığını uyarır. Her iki durumda da ödeme yöntemi o para birimindeki sepetler için sunulmaz. Sandbox modu açıkken sayfa Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. mesajını gösterir.

SimplePay (OTP)

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

Title: müşterilerin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: SimplePay (Card Payment). Zorunlu.

Description: ödeme sırasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit or debit card via SimplePay. Macar satıcılar buraya SimplePay veri aktarım beyanını (bağlantısıyla birlikte) yazabilir.

Sandbox mode: sandbox hesaplarıyla test ödemeleri için SimplePay sandbox'ını kullanır. Hem API adresini hem de satıcı hesaplarını değiştirir. Gerçek para çekilmez. Varsayılan: açık. Canlı hesaplarla gerçek ödeme almak için kapatın. Açıkken müşteriler ödeme yönteminin altında Sandbox mode: no real payment is taken. mesajını görür. Sandbox'ta başlatılan siparişler her zaman sandbox'ta iade edilir.

Canlı satıcı hesapları

Sandbox mode kapalıyken kullanılan hesaplar. Mağazanızın sattığı para birimlerinin hesaplarını doldurun. MERCHANT ve SECRET KEY değerleri SimplePay satıcı yönetim panelinde (admin.simplepay.hu), account > Technical data altındadır. Bir hesap yalnızca iki alanı da doldurulduğunda kullanılır.

HUF account — Merchant ID: canlı HUF hesabınızın MERCHANT değeri.

HUF account — Secret key: canlı HUF hesabınızın SECRET KEY değeri.

EUR account — Merchant ID ve EUR account — Secret key: canlı EUR hesabınız için aynısı.

USD account — Merchant ID ve USD account — Secret key: canlı USD hesabınız için aynısı.

Sandbox satıcı hesapları

Sandbox mode açıkken kullanılan hesaplar. Alanlar canlı hesaplarla aynıdır: HUF account — Merchant ID, HUF account — Secret key ve EUR ile USD için aynı çiftler. Değerleri SimplePay sandbox satıcı yönetim panelinden (sandbox.simplepay.hu), account > Technical data altından alın.

Kayıtlı gizli anahtarlar 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.

IPN URL

IPN, ödeme durumu değiştiğinde SimplePay'in mağazanıza gönderdiği mesajdır. Sipariş genellikle bu yolla oluşturulur. Bölüm, mağazanızın IPN URL'sini gösterir. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_simplepay_gateway/ipn, gerekirse /en/ gibi bir dil koduyla. Bu URL'yi SimplePay satıcı yönetim panelinde her satıcı hesabına (canlı ve sandbox) tanımlayın. URL'yi ayarların gösterdiği gibi birebir kopyalayın, çünkü yönlendirilen bir IPN kaybolur.

IPN, adını verdiği satıcı hesabının SECRET KEY'i ile ve ödemenin başlatıldığı modda (sandbox veya canlı) imzalanmalıdır. Geçerli imzası olmayan IPN'ler reddedilir. Modül, geçerli her IPN'i SimplePay'in istediği imzalı biçimde SimplePay'e onaylar. Şu IPN durumları kullanılır:

Reddedilen, iptal edilen ve zaman aşımına uğrayan durumlar yalnızca henüz siparişi olmayan bir sepetin son ödeme denemesi için kaydedilir. Diğer durumlar günlüğe yazılır ve hiçbir şeyi değiştirmez. IPN olmadan sipariş yalnızca müşteri başarılı bir ödemeden sonra mağazaya döndüğünde oluşturulur.

Clear saved secret keys: bir gizli anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Siparişler

Order Status After Payment: başarılı ödemeden sonra ayarlanan sipariş durumu.

Siparişten farklı bir tutar veya para birimindeki ödeme her zaman SimplePay payment on hold durumuna gider.

Gelişmiş

Logging: API çağrılarını, IPN'leri ve dönüşleri modül klasöründeki logs/simplepay_op_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: kapalı.

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 ağ geçidi ayarlarını ve günlüğü siler. Sipariş verileri (SimplePay işlemleri ve iadeleri) her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak SimplePay (Card Payment)) ve You will be redirected to the SimplePay payment page to pay by card. notunu görür. Onaylandıktan sonra modül, sepet toplamı için sepetin para biriminde, o para biriminin satıcı hesabıyla ve mevcut modda bir SimplePay kart ödemesi başlatır ve müşteriyi SimplePay ödeme sayfasına gönderir. Müşterinin e-posta adresi ve, tamamlanmışsa, fatura adresi SimplePay'e iletilir. Ödeme sayfası, SimplePay destekliyorsa mağazanın dilini kullanır; aksi halde İngilizce kullanır. Başlatılan bir ödeme 30 dakika içinde tamamlanabilir. Bu aşamada henüz bir sipariş yoktur.

Başarılı bir ödemeden sonra müşteri mağazanıza döner. Yalnızca dönüş hiçbir zaman bir siparişi ödenmiş yapmaz: modül, işlemin durumunu imzalı bir istekle SimplePay'den sorar, bu nedenle IPN geç gelse bile sipariş oluşturulur. Sipariş, SimplePay onaylayana kadar ödenmiş olarak işaretlenmez. Müşteri daha sonra Successful transaction. SimplePay transaction ID: ve kimlik bilgisi ile standart sipariş onay sayfasını görür. SimplePay ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası kimlikle birlikte Your payment is being confirmed by SimplePay. SimplePay transaction ID: mesajını ve bir Check again düğmesini gösterir; IPN geldiği anda siparişi oluşturur.

Ödeme başarısız olursa, iptal edilirse veya zaman aşımına uğrarsa, müşteri SimplePay'in mesajı ve işlem kimliğiyle birlikte ödeme sayfasına döner; örneğin Cancelled payment. You cancelled the payment veya Timeout. The time allowed to complete the payment has expired. Başarısız bir ödemede müşteriden girdiği bilgileri kontrol etmesi ve kartı veren bankayla iletişime geçmesi istenir. Sepet korunur ve müşteri yeniden deneyebilir. Her yeni deneme kendi SimplePay referansını alır: PS, sepet numarası ve deneme numarası; örneğin PS123-1, PS123-2.

SimplePay ödemeyi başlatamazsa müşteri The SimplePay payment could not be started. Please try again or choose another payment method. mesajını görür. Sepetin para biriminde satıcı hesabı yoksa mesaj SimplePay is not available for the currency of this order. Please choose another payment method. olur. Teknik neden günlüğe yazılır.

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

Modül yalnızca SimplePay sayfasında tahsil edilen tek seferlik kart ödemelerini kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik veya yinelenen ödeme ve ayrı yetkilendirme ile tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri SimplePay'e yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu, iptal edildi veya zaman aşımına uğradı ya da SimplePay ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted or Delivered: ödeme onaylandı. Durum Order Status After Payment değerini izler. Ödeme SimplePay işlem kimliğiyle kaydedilir ve bir not, işlem kimliğini ve ödemeyi IPN'in mi yoksa durum sorgusunun mu onayladığını gösterir.

SimplePay payment on hold: ödeme başlatıldıktan sonra sepet toplamı veya para birimi değiştiği için ödenen tutar siparişten farklıdır. Hiçbir ödeme kaydedilmez. Not, her iki tutarı da gösterir. Siparişi kontrol edip işleyin veya ödemeyi SimplePay satıcı yönetim panelinden iade edin. Aynı sepetin başka bir denemesi doğru tutarla ödenirse, sipariş ödenmiş duruma geçer.

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

Ödenmiş, iade edilmiş veya teslim edilmiş bir sipariş geç gelen bir IPN ile asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme başarılı olursa sipariş değişmez. Bir not, bunu SimplePay yönetim panelinde kontrol etmenizi ve bir kopyaysa iade etmenizi ister.

SimplePay ödeme bloğu

Sipariş sayfasında işlem kimliği, sipariş referansı (orderRef), satıcı hesabı ve mod, SimplePay durumu, ödenen ve iade edilen tutarlar, sandbox ödemeleri için bir Sandbox rozeti, sepetin ödeme denemeleri (birden fazla varsa), iade geçmişi ve siparişin SimplePay notes bölümü ile birlikte bir SimplePay payment bloğu görünür.

İadeler

SimplePay payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via SimplePay (OTP) düğmesine tıklayın. Refund this amount via SimplePay? 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. HUF iadeleri tam forint olmalıdır. İade, siparişi ödeyen SimplePay işlemi için, o işlemin tutarı ve para birimiyle, ödemenin satıcı hesabı ve modu (sandbox veya canlı) üzerinden gönderilir; bu nedenle o hesabın ayarlarda kalmış olması gerekir. SimplePay iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, SimplePay iade işlem kimliği ve girdiyseniz nedeniyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. Tutar uyuşmazlığından sonra beklemeye alınmış bir sipariş bloktan iade edilemez: SimplePay satıcı yönetim panelinden iade edin.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri SimplePay üzerinden para göndermez. SimplePay satıcı yönetim panelinde yapılan iadeler PrestaShop ile senkronize edilmez. Bunları elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox SimplePay Gateway, ayarların üstünde, Modules > Module Manager > VibeFox SimplePay 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-simplepay 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 SimplePay ödeme sırası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 IPN ile 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

SimplePay ödeme sırasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, sepet para biriminin HUF, EUR veya USD olduğunu ve bu para biriminin mevcut modda Merchant ID ve Secret key değerlerine sahip olduğunu kontrol edin: Sandbox mode açıkken sandbox hesapları, kapalıyken canlı hesaplar. 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şmadı: IPN mağazaya ulaşmadı. SimplePay satıcı yönetim panelinde kullandığınız satıcı hesabının IPN URL'sini kontrol edin (canlı veya sandbox, sepetin para birimine göre). Ayarlarda gösterilen URL ile tam olarak aynı olmalı ve sunucunuza internetten erişilebilmelidir. Müşteri ödemeden sonra mağazaya döndüğünde de sipariş oluşturulur.

IPN, Invalid signature yanıtı veriyor: IPN, ayarlarda olmayan bir satıcı hesabını gösteriyor, bu hesabın Secret key değeri yanlış veya IPN ödemenin modundan farklı bir modun hesabıyla imzalanmış. MERCHANT ve SECRET KEY değerlerini SimplePay satıcı yönetim panelinde gösterildiği gibi tam olarak girin. SimplePay onaylanmamış IPN'leri yeniden gönderir.

IPN, Order not found veya Unknown transaction yanıtı veriyor: IPN, bu mağazanın başlatmadığı bir ödemeye ait. Hiçbir şey değişmez.

IPN, Busy, retry yanıtı veriyor: sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). SimplePay IPN'i yeniden dener. Neden günlüğe yazılır.

Müşteri The SimplePay payment could not be started mesajını görüyor: modül sayfasındaki Log alanına bakın. Yanlış bir gizli anahtar Invalid response signature from SimplePay. Check the secret key of the merchant account. mesajını verir. SimplePay hataları hata kodlarıyla birlikte günlüğe yazılır.

Sandbox ve canlı arasında geçiş yaptıktan sonra: yeni ödemeler yeni modun hesaplarını kullanır. Daha önce başlatılmış ödemeler, başlatıldıkları satıcı hesabını ve modu korur: IPN'leri, durum sorguları ve iadeleri o hesabı kullanır. Bu tür ödemeler açıkken veya iade edilebilir durumdayken eski modun hesaplarını ayarlarda tutun.

Ödemeden sonra sipariş SimplePay payment on hold durumunda: SimplePay payment bloğundaki notları okuyun. Ödeme başlatıldıktan sonra sepet toplamı veya para birimi değiştirildi. Siparişi işleyin veya ödemeyi SimplePay satıcı yönetim panelinden iade edin.

İade başarısız oluyor: bloktaki mesajı okuyun. SimplePay refunds in HUF must be whole amounts. mesajı, HUF tutarının ondalık içerdiği anlamına gelir. Mesaj bu ödemenin satıcı hesabının yapılandırılmadığını söylüyorsa, ödemenin yapıldığı hesabı (para birimi ve mod) yeniden girin. SimplePay farklı bir tutar iade ettiyse, mesaj iadeyi SimplePay yönetim panelinde kontrol etmenizi ister.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox SimplePay 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 ağ geçidi ayarları ve günlük silinir. Kapalıysa, daha sonra yeniden kurulum için tüm ayarlar korunur. SimplePay işlemleri ve iadeleri ile SimplePay payment on hold sipariş durumu 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.

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