VibeFox SimplePay for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Mağaza para birimi: HUF, EUR veya USD. SimplePay başka para birimlerini kabul etmez ve müşteri başka bir para birimi seçtiğinde ödeme yöntemi sunulmaz.

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

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

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_simplepay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_simplepay_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_simplepay_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox SimplePay Gateway öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

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. Configuration).

5. Ayarlar sayfasında gösterilen IPN URL adresini SimplePay satıcı yönetiminde 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 ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_simplepay_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox SimplePay Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, satıcı hesaplarını ve IPN URL'sini OpenCart 3 için 3 ila 6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca IPN URL'si farklıdır (bkz. IPN URL).

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox SimplePay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde sayfa, mağazanın varsayılan para birimi SimplePay tarafından desteklenmediğinde veya geçerli modda bu para birimi için bir satıcı hesabı olmadığında sizi uyarır. Her iki durumda da ödeme yöntemi o para birimindeki siparişler için sunulmaz. Sandbox mode açıkken sayfa Sandbox mode is on: payments go to the SimplePay sandbox, no real money is charged. gösterir. Eklentiyi değiştirme yetkisi olmadan sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olmamalıdır (en fazla 128 karakter), Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve geo zone ile sipariş durumları mevcut olmalıdır. Bir değer hatalıysa hiçbir şey kaydedilmez.

SimplePay (OTP)

Enable/Disable: Enable SimplePay Gateway ödeme yöntemini açar veya kapatır. Default: off.

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

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Default: Pay securely with your credit or debit card via SimplePay. Macar satıcılar buraya SimplePay veri aktarım beyanını yazabilir.

Sandbox mode: test ödemeleri için sandbox hesaplarıyla SimplePay sandbox'ını kullanır. Hem API adresini hem de satıcı hesaplarını değiştirir. Gerçek para alınmaz. Default: on. Canlı hesaplarla gerçek ödemeleri kabul etmek için kapatın. Açıkken müşteriler Confirm Order adımında Sandbox mode: no real payment is taken. görür. Sandbox'ta başlatılan siparişler her zaman sandbox'ta iade edilir.

Sort Order: SimplePay'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin (negatif değerlere izin verilir).

Geo Zone: SimplePay'i yalnızca seçilen geo zone içindeki ödeme adresleri için sunun. Default: All zones. Geo zone'lar System > Localisation > Geo Zones bölümünde ayarlanır.

Total: SimplePay sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir toplam için SimplePay sunmak üzere boş bırakın.

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önetiminde bulunur (admin.simplepay.hu, bölümlerin bağlantılarının bulunduğu yer), hesap > Technical data bölümünde. 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önetiminden (sandbox.simplepay.hu), hesap > Technical data bölümünden alın.

Kaydedilmiş gizli anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kaydedilmiş bir anahtarı kaldırmak için alanın altındaki Clear the saved secret key kutusunu işaretleyin ve Save düğmesine tıklayın.

IPN URL

IPN, ödeme durumu değiştiğinde SimplePay'in mağazanıza gönderdiği bildirimdir. Bir siparişin durum alması için olağan yoldur. Bu bölüm mağazanızın IPN URL'sini gösterir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_simplepay_gateway/ipn, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_simplepay_gateway/payment/wcp_simplepay_gateway.ipn ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. Bu URL'yi SimplePay satıcı yönetiminde, canlı ve sandbox olmak üzere her satıcı hesabına ayarlayın. URL'yi ayarların gösterdiği gibi birebir kopyalayın, çünkü yönlendirilmiş bir IPN kaybolur.

IPN, adını verdiği satıcı hesabının SECRET KEY değeriyle, ödemenin başlatıldığı modda (sandbox veya canlı) imzalanmalıdır. Geçerli imzası olmayan IPN'ler reddedilir. Eklenti her geçerli IPN'i, SimplePay'in gerektirdiğ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 hiçbir şey ödenmemiş bir sepetin son ödeme denemesi için kaydedilir. Diğer durumlar bir şeyi değiştirmez. IPN olmadan bir sipariş, ancak müşteri başarılı bir ödemeden sonra mağazaya döndüğünde durum alır.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz oluşturur (eksik sipariş, missing order). Sipariş, yalnızca SimplePay ödemeyi onayladıktan sonra bir durum alır. Durum alanları OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: ödenmiş bir siparişin hangi durumu alacağı.

Paid Order Status: Order Status After Payment Processing olduğunda ödenmiş bir siparişin durumu. Default: Processing.

Complete Order Status: Order Status After Payment Completed olduğunda ödenmiş bir siparişin durumu. Default: Complete.

On Hold (Review) Status: ödeme, siparişten farklı bir tutar veya para birimiyle yapıldı (bkz. Order statuses). Default: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Default: Refunded.

Gelişmiş

Logging: API çağrılarını, IPN'leri ve dönüşleri OpenCart günlükler klasöründe (storage/logs) bulunan simplepay_op_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında döndürülür. Anahtarlar ve müşteri verileri günlüğe yazılmaz. Hatalar bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Default: off.

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

Delete Data on Uninstall: açıksa eklentiyi kaldırmak gateway ayarlarını ve günlüğü siler. Sipariş verileri (SimplePay işlemleri ve iadeleri) her zaman korunur. Default: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kaydedilmiş gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak SimplePay (Card Payment)). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the SimplePay payment page to pay by card. notunu görür. OpenCart siparişi bu adımda, yine durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde sipariş toplamı için, geçerli moddaki o para biriminin satıcı hesabıyla bir SimplePay kart ödemesi başlatır ve müşteriyi SimplePay ödeme sayfasına yönlendirir. Müşterinin e-posta adresi ve tamamlanmışsa ödeme adresi SimplePay'e iletilir. Ödeme sayfası, SimplePay destekliyorsa siparişin dilini, aksi halde İngilizceyi kullanır. Başlatılan bir ödeme 30 dakika içinde tamamlanabilir. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Başarılı bir ödemeden sonra müşteri mağazanıza geri döner. Dönüş tek başına hiçbir siparişi ödemez: eklenti işlem durumunu imzalı bir istekle SimplePay'den sorar, bu nedenle IPN gecikse bile sipariş durum alır. Sipariş, yalnızca SimplePay onayladıktan sonra ödenmiş olarak işaretlenir. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesi ile durumunu alır ve müşteri, Successful transaction. SimplePay transaction ID: ve kimliği ile OpenCart sipariş başarı 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ı, Your order will be confirmed as soon as SimplePay confirms the payment — please do not pay again. ifadesini ve Check again ile Back to checkout düğmelerini gösterir; IPN, geldiği anda sipariş durumunu ayarlar.

Ö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 ödeme, müşteriden girdiği bilgileri kontrol etmesini ve kartı çıkaran bankayla iletişime geçmesini ister. Sipariş durumsuz kalır, sepet korunur ve müşteri yeniden deneyebilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur. OpenCart 4, ödeme sürecindeki tek bir siparişi tutar ve günceller; bu nedenle bir sonraki deneme aynı siparişi öder. Her deneme kendi SimplePay referansını alır: OC, sipariş numarası ve deneme numarası, örneğin OC123-1 ve ardından OC123-2. Aynı sepetin başka bir siparişi zaten ödenmişse veya incelemedeyse, müşteri tekrar ödeme yapmak yerine doğrudan başarı sayfasına gider.

SimplePay ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve The SimplePay payment could not be started. Please try again or choose another payment method. mesajını görür. Sipariş para biriminin bir 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. Bir ödeme denemesiyle eşleştirilemeyen bir dönüş We could not match this payment to an order. If you were charged, please contact us. gösterir.

OpenCart 4'te, ödeme sayfasına geri gönderen mesajlar ödeme sayfasının üstünde gösterilir. Ödeme sürecindeki sipariş bu arada kapatıldıysa müşteri, Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir; sipariş bir SimplePay ödemesi içeriyorsa Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. mesajıyla döner. Bir sonraki Confirm Order yeni bir siparişin ödemesini başlatır. Ödeme sürecindeki sipariş zaten ödenmişse ama sepet o zamandan beri değiştiyse (yeni adet dahil), müşteri ödeme sayfasına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

IPN ve müşterinin dönüşü de mağaza bakım modundayken çalışır: OpenCart 3 ödeme eklentisi isteklerine izin verir, OpenCart 4'te ise eklenti bunlar için bir başlangıç eylemi ekler.

Eklenti yalnızca SimplePay sayfasında tahsil edilen tek seferlik kart ödemelerini kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik veya tekrarlayan ödeme ve ayrı yetkilendirme ile tahsilat desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): 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ı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Paid Order Status or Complete Order Status: ödeme onaylandı. Durum Order Status After Payment değerini izler. Bir not, SimplePay işlem kimliğini ve onayı IPN'in mi yoksa durum sorgusunun mu yaptığını gösterir.

On Hold (Review) Status (default Pending): ödeme başlatıldıktan sonra siparişin toplamı veya para birimi değiştirildi, bu nedenle ödenen tutar siparişle eşleşmiyor. Not iki tutarı da gösterir. Siparişi kontrol edin ve SimplePay satıcı yönetiminde siparişi yerine getirin veya ödemeyi iade edin. Aynı sepetin başka bir denemesi sonradan doğru tutarla ödenirse, o ödemenin siparişi ödenmiş durumu alır.

Refunded Status (default Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir sipariş için veya aynı sepetin başka bir siparişi için ikinci bir ödeme başarılı olursa, ödenmiş sipariş değiştirilmez. Bir not, bunu SimplePay yönetiminde kontrol etmenizi ve mükerrerse iade etmenizi ister. Ödenmiş, iade edilmiş veya tamamlanmış bir sipariş, geciken bir IPN ile asla yeniden açılmaz.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox SimplePay Gateway tab

Sales > Orders bölümünde SimplePay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox SimplePay Gateway sekmesi sandbox ödemeleri için Sandbox etiketiyle birlikte Transaction ID değerini, Order reference (orderRef) değerini, Merchant account ve modu, SimplePay Status değerini, Paid / refunded tutarlarını, iade formunu, iade geçmişini, birden fazla varsa Payment attempts of the cart listesini ve siparişin SimplePay notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox SimplePay Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional, order note only) girin 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. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). HUF iadeleri tam forint tutarı olmalıdır. İade, siparişi ödeyen SimplePay işlemi için, o ödemenin satıcı hesabı ve modunda (sandbox veya canlı) gönderilir; mağaza bu arada diğer moda geçmiş olsa bile. Bu hesap ayarlarda bulunmaya devam etmelidir. SimplePay iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, SimplePay iade işlemi ve (girdiyseniz) nedeni ile birlikte geçmişe ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri koymadan Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. Tutar uyuşmazlığından sonra inceleme durumundaki bir sipariş sekmeden iade edilemez: SimplePay satıcı yönetiminde iade edin.

Sales > Returns bölümündeki ürün iadeleri SimplePay üzerinden para göndermez. SimplePay satıcı yönetiminde yapılan iadeler OpenCart ile senkronize edilmez. Bunları manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarı ile çalışır. License — VibeFox SimplePay Gateway lisans bloğu, ayarların üstünde, Extensions > Extensions > Payments > VibeFox SimplePay Gateway > Edit sayfasındaki 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 tarih ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: opencart-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 eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart ayarlarındaki mağaza adresi. 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 SimplePay ö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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza, yönetici panelinde oturum açıldığını görmez; bu yüzden etkin anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim Dashboard sayfasında bir hatırlatma belirir. 7 gün boyunca gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler IPN ile onaylanmaya devam eder ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim Dashboard veya Edit sayfasını açtığınızda 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. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

SimplePay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, müşterinin para biriminin HUF, EUR veya USD olduğunu ve bu para biriminin geçerli modda Merchant ID ve Secret key değerlerine sahip olduğunu kontrol edin: Sandbox mode açıkken sandbox hesapları, kapalıyken canlı hesaplar. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin.

Ödeme geçti ama sipariş durumsuz kaldı: IPN mağazaya ulaşmadı. SimplePay satıcı yönetiminde kullandığınız satıcı hesabının (canlı veya sandbox, siparişin para birimi) IPN URL'sini kontrol edin. Ayarlarda gösterilen URL ile birebir aynı olmalı ve sunucunuz internetten erişilebilir olmalıdır. Sipariş, müşteri ödeme yaptıktan sonra mağazaya döndüğünde de durum alır.

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

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

IPN, Busy, retry. yanıtını veriyor: sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş durumu ayarlanamadı. 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: eklenti 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ına yol açar. SimplePay hataları hata kodlarıyla birlikte günlüğe yazılır.

Müşteri This payment method is not available. mesajını görüyor: ödeme sayfası artık siparişle eşleşmiyor veya bu arada ödeme yöntemi kapatıldı. Müşteri ödeme sayfasını yeniden yükler.

Sandbox ile 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. Açık veya iade edilebilir bu tür ödemeler olduğu sürece, eski modun hesaplarını ayarlarda tutun.

Sipariş ödemeden sonra inceleme durumunda: VibeFox SimplePay Gateway sekmesindeki notları okuyun. Ödeme başlatıldıktan sonra siparişin toplamı veya para birimi değişti. Siparişi yerine getirin veya ödemeyi SimplePay satıcı yönetiminde iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: sipariş bir SimplePay işlemiyle ödenmemiş (örneğin bir tutar uyuşmazlığından sonra), tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme hakkı yok veya ödemenin satıcı hesabı ayarlarda değil.

İade başarısız: sekmedeki mesajı okuyun. SimplePay refunds in HUF must be whole amounts. HUF tutarında ondalık basamak olduğu 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önetiminde kontrol etmenizi ister.

Geliştiriciler için: ödeme başlatılmadan önce eklenti, ödeme verileri ve siparişle birlikte simplepay_op_payment_data OpenCart olayını tetikler. Satıcı, sipariş referansı, para birimi, toplam ve dönüş URL'si orada değiştirilemez.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox SimplePay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve IPN ile müşterinin dönüşüne bakım modunda izin veren başlangıç eylemi de kaldırılır). Delete Data on Uninstall açıksa diğer gateway ayarları (başlık, açıklama, sandbox modu, satıcı hesapları, günlükleme) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanır. SimplePay işlemleri ve iadeleri her zaman korunur, bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox SimplePay Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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