VibeFox Ozow 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: Güney Afrika randı (ZAR). Ödeme yöntemi yalnızca ZAR cinsinden sepetler için gösterilir. Ozow tam kuruş cinsinden tahsilat yapar, bu nedenle para biriminde 2 ondalık basamak kullanılmalıdır.

Ozow hesabı: Ozow satıcı panelinizden alınan, Ozow sitenizin Site Code ve Private Key bilgilerini içeren bir Ozow satıcı hesabı. API Key isteğe bağlıdır ancak önerilir. Ozow, test ve canlı ödemelerde aynı Site Code ve anahtarları kullanır.

Erişilebilir site: Ozow bildirimlerinin ulaşabilmesi için mağazanız internetten erişilebilir olmalı; parola koruması olmamalı ve Ozow'u engelleyen bir güvenlik duvarı bulunmamalıdır. Mağaza bakım modunda olsa bile bildirim kabul edilir.

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

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

4. Ozow satıcı panelinizden Site Code ve Private Key bilgilerini, mümkünse API Key bilgisini de girin.

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

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Ozow payment ve Ozow payment on hold. PrestaShop, yeni bir ödeme modülünü tüm para birimleri, ülkeleri ve müşteri gruplarında sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz; orada modül için ZAR'a izin verilmelidir. Daha sonra etkinleştirilen bir ülke de aynı yerde modül için işaretlenmelidir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Ozow Pay > Configure. Save düğmesi bulunan her bölüm tüm sayfayı kaydeder. Alanların üstünde sayfa; Site Code veya Private Key eksikse (bu durumda Ozow ödeme sayfasında gizlenir), mağazanın varsayılan para birimi ZAR değilse, para biriminin 2'den fazla ondalık basamağı varsa (bunu International > Localization > Currencies bölümünde 2 olarak ayarlayın) sizi uyarır ve test modu açık olduğu sürece Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. ifadesini gösterir.

Ozow

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Instant EFT (Ozow).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay instantly and securely from your South African bank account. You will be redirected to Ozow to choose your bank and approve the payment. Test modunda bunun altına TEST MODE: no money will be charged. satırı eklenir (yalnızca açıklama boş değilse).

Ozow kimlik bilgileri

Site Code, Private Key ve API Key bilgilerini Ozow satıcı panelinizden (Merchant details / Sites) kopyalayın. Bu bölüm, hub.ozow.com adresindeki Ozow entegrasyon belgelerine bağlantı içerir.

Site Code: ödemeleri alan Ozow sitesinin Site Code'u. Başka bir Site Code'a ait yanıtlar reddedilir.

Private Key: her ödeme isteğini imzalar ve her Ozow yanıtını doğrular. Gizli tutun. Bu anahtar olmadan ödeme yöntemi gizlenir ve hiçbir Ozow yanıtı kabul edilmez.

API Key (recommended): isteğe bağlı. API Key ile her başarılı ödeme, sipariş ödenmiş olarak işaretlenmeden önce Ozow GetTransaction API ile de doğrulanır. API, ödemenin bu sepet için aynı tutar, para birimi ve Site Code ile tamamlandığını bildirmelidir.

Kayıtlı anahtarlar 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 secrets: kayıtlı bir anahtarı kaldırmak için Private Key veya API Key seçeneğini işaretleyip kaydedin. Boş bir alan, kayıtlı değeri korur.

Test mode: Ozow, testler için aynı Site Code ve anahtarları kullanır: ödemeler IsTest=true ile oluşturulur ve hiçbir para hareket etmez. Test modunda ödenen siparişlere sipariş mesajı eklenir; bunları göndermeyin. Gerçek ödemeleri kabul etmek için test modunu kapatın. Canlı modda bir test ödemesi hiçbir siparişi ödemez. Varsayılan: on.

Ödeme bildirimleri

Bildirim, başarı, iptal ve hata URL'leri her ödemede Ozow'a gönderilir; bu nedenle Ozow panelinde bir şey yapılandırmanız gerekmez, Ozow siteniz sabit URL'lere ayarlanmış değilse. Bölüm dört URL'yi gösterir: Notification URL, Success URL, Cancel URL ve Error URL. Bunlar mağazanızın modül bağlantılarıdır (notify ve return denetleyicileri). Ozow siteniz sabit URL kullanıyorsa, bunları ayarların gösterdiği gibi birebir kopyalayın.

Gelişmiş

Debug log: ödeme isteklerini ve Ozow yanıtlarını modül klasöründeki logs/ozow_p_debug.log.php dosyasına kaydeder (web üzerinden okunamaz). Hatalar ve uyarılar her zaman kaydedilir. Anahtarlar, hash'ler, belirteçler ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: off.

Log: günlüğün mevcut boyutunu ve sonunu, bir Clear log düğmesiyle birlikte gösterir.

Delete data on uninstall: modül kaldırıldığında bu modülün ayarlarını ve günlüklerini siler (siparişlerde kayıtlı Ozow verileri korunur). Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Instant EFT (Ozow)) ve siparişi onaylar. Modül, müşteriyi ZAR cinsinden sepet toplamı için imzalı bir istekle Ozow'un barındırdığı ödeme sayfasına gönderir. Banka ekstresindeki referans Cart ve sepet numarasıdır (en fazla 20 Latin harfi, rakam, boşluk ve tire). Müşterinin adı Ozow'a iletilir. Bu aşamada henüz bir sipariş yoktur. Ozow sayfasında müşteri bir Güney Afrika bankası seçer ve ödemeyi bankacılık uygulamasında onaylar.

Ardından Ozow mağazaya bildirim gönderir ve müşteriyi geri yönlendirir. İkisi de aynı imzalı yanıtı taşır ve aynı şekilde işlenir; bu nedenle biri kaybolsa bile sipariş oluşturulur. Sipariş, yalnızca Ozow onayladıktan sonra ödenmiş olarak işaretlenir: hash, Private Key'iniz ile doğrulanmalı, Site Code sizinki olmalı, yanıt sepetin bu ödeme denemesine ait olmalı ve tutar ile para birimi sepetle eşleşmelidir. API Key ile ödeme ayrıca GetTransaction API ile kontrol edilir.

Başarılı bir ödemeden sonra müşteri standart sipariş onay sayfasını görür. Ozow veya banka ödemeyi hâlâ inceliyorsa sayfa We are waiting for Ozow to confirm your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. der. Sipariş beklemedeyse Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed. der. İncelenen bir ödeme daha sonra başarısız olursa veya ödenmemiş sipariş iptal edilirse Your Ozow payment was not completed. Please contact us about this order. der. Müşteri geri döndüğünde Ozow ödemeyi henüz onaylamamışsa, sayfada bekleme metni ve Check again ile Back to checkout düğmeleri gösterilir.

Müşteri Ozow sayfasında iptal ederse veya ödeme başarısız olursa sipariş oluşturulmaz. Müşteri aynı sepetle ödeme sayfasına döner ve The Ozow payment was cancelled. You can try again or choose another payment method. veya The Ozow payment was not completed. You can try again or choose another payment method. mesajını görür.

Sepet ZAR cinsinden değilse müşteri Ozow accepts payments in South African rand (ZAR) only. Please choose another payment method. mesajını görür.

Modül yalnızca ZAR cinsinden tek seferlik ödemeleri kabul eder. PrestaShop üzerinden iade, abonelik, kayıtlı banka hesabı veya tokenizasyon ve back office'ten ödeme bağlantısı gönderme özellikleri yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Ozow'a yönlendirildi ve ödeme yapmadı, iptal etti veya Ozow ödemeyi henüz onaylamadı. Yalnızca sepet mevcuttur.

Payment accepted: ödeme onaylandı. Sipariş mesajı tutarı ve Ozow işlem kimliğini, ayrıca ödemenin GetTransaction API ile onaylanıp onaylanmadığını gösterir. Sipariş ödemesinin işlem kimliği Ozow TransactionId'dir. Bir test ödemesi TEST MODE — no money was received, do not ship this order. mesajını alır.

Awaiting Ozow payment: Ozow veya banka ödemeyi inceliyor. Ozow nihai durumu gönderdiğinde sipariş güncellenir.

Ozow payment on hold: sipariş mesajı nedeni belirtir: ödenen tutar veya para birimi sepetten farklıdır; zaten iptal edilmiş bir sipariş için ödeme geldi; ya da API Key ile GetTransaction API ödemeyi henüz onaylayamadı veya ödemeyle çelişiyor. Ödemeyi Ozow panelinizde kontrol edin ve sipariş durumunu değiştirin. API yanıt veremediyse, bir sonraki Ozow bildirimi siparişi tamamlar.

Ödeme hatası: incelenmekte olan bir ödeme iptal edildi, terk edildi veya başarısız oldu. Bu ödeme için sonradan gelen başarılı bir Ozow yanıtı yine de siparişi ödenmiş olarak işaretler.

Ödenmiş bir sipariş asla geri alınmaz; iptal edilen veya iade edilen bir sipariş asla yeniden açılmaz. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse, bir mesaj sizden çift ödemeyi Ozow panelinizden iade etmenizi ister. Bir sipariş başka bir nedenle beklemedeyse (örneğin sizin tarafınızdan ayarlandıysa), sonradan gelen bir ödeme yalnızca bir mesaj ekler ve siparişi Payment accepted olarak kendiniz ayarlarsınız.

Ozow ödeme bloğu

Sipariş sayfası, işlem referansı ve denemesi, Ozow işlem kimliği, durum, istenen tutar, Ozow'un bildirdiği tutar, Ozow mesajı ve test ödemeleri için bir TEST MODE işaretiyle birlikte bir Ozow payment bloğu gösterir.

İadeler

PrestaShop üzerinden iadeler desteklenmez. Ödemeyi Ozow satıcı panelinizden iade edin, ardından iadeyi PrestaShop'ta manuel olarak kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Ozow Pay lisans bloğu, Modules > Module Manager > VibeFox Ozow Pay > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı gizlenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar geçerli olduğunu 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-ozow 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. Bloğun metinleri, back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini söyler, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle 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 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 Ozow, ö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 sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Modülün kaldırılması veya sıfırlanması lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Ozow ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, Site Code ve Private Key alanlarının dolu olduğunu ve sepet para biriminin ZAR olduğunu kontrol edin. Payment > Preferences bölümünde modülün ZAR, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu doğrulayın. Ayarlar sayfası bir şey eksik olduğunda uyarı gösterir.

Ödeme geçti, ancak sipariş oluşturulmadı: Ozow bildirimi mağazaya ulaşmadı ve müşteri geri dönmedi. Mağazanızın internetten erişilebilir olduğunu kontrol edin (Ozow'u engelleyen parola koruması veya güvenlik duvarı olmamalı). Ozow siteniz sabit URL'lere ayarlıysa, URL'lerin Payment notifications bölümünde gösterilenlerle birebir aynı olduğunu kontrol edin. Debug log seçeneğini açın ve Configure sayfasındaki günlüğü okuyun.

Bildirim Invalid hash yanıtı veriyor: ayarlardaki Private Key, yanıtı gönderen Ozow sitesine ait değil. Ozow satıcı panelinizden yeniden kopyalayın. Hiçbir şey değişmez.

Bildirim Unknown site yanıtı veriyor: yanıt başka bir Ozow sitesinden geldi. Site Code değerini kontrol edin.

Bildirim Order mismatch veya Order not found yanıtı veriyor: yanıt bu mağazada başlatılmış bir ödemeye ait değil. Hiçbir şey değişmez.

Bildirim Gateway not configured yanıtı veriyor: Site Code veya Private Key eksik. Bunları doldurun; Ozow yeniden deneyebilir.

Bildirim Payment not confirmed yet yanıtı veriyor: yanıt henüz uygulanamadı. API Key ile GetTransaction API ödemeyi onaylayamadı (sipariş beklemede; bir sonraki bildirim tamamlar; hâlâ beklemedeyse Ozow panelinizde API Key'i ve ödemeyi kontrol edin). Bu yanıt ayrıca, aynı sepet için müşterinin geri dönüşü tam o anda işleniyorsa veya sipariş oluşturulamadıysa da verilir; günlüğe bakın.

Bir test ödemesi siparişi ödemedi: modül canlı modda. Test ödemeleri canlı modda hiçbir siparişi ödemez; sipariş mesajı veya günlük bunu belirtir.

Ödemeden sonra sipariş Ozow payment on hold durumunda: sipariş mesajını okuyun ve ödemeyi Ozow panelinizde kontrol edin, ardından siparişi Payment accepted olarak ayarlayın veya ödemeyi Ozow'da iade edin.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Ozow Pay 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 modül ayarları ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için tüm ayarlar korunur. Ozow ödeme kayıtları ile Awaiting Ozow payment ve Ozow payment on hold sipariş durumları her zaman korunur; böylece eski siparişlere ait geç bildirimler yeniden kurulumdan sonra da tanınır. Mevcut siparişler ödeme mesajlarını ve işlem kimliklerini korur.

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