VibeFox Ozow for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Para birimi: Güney Afrika randı (ZAR). Diğer para birimlerinde ödeme yöntemi gizlenir. Ozow tam kuruş tahsil eder, bu nedenle WooCommerce 2 ondalık basamak kullanmalıdır.

Ozow hesabı: Ozow satıcı panelinizdeki 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ı ödemeler için aynı Site Code ve anahtarları kullanır.

Erişilebilir site: Ozow bildirimlerinin ulaşabilmesi için sitenizin internetten erişilebilir olması gerekir; bakım modu, parola koruması veya Ozow'u engelleyen bir güvenlik duvarı olmamalıdır.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_ozow_pay klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Ozow > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. Enable/Disable seçeneğini açın. Test mode açıkken bir test ödemesi yapın, ardından gerçek ödemeleri kabul etmek için test modunu kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Ozow. Alanların üstünde sayfa; Site Code veya Private Key eksik olduğunda (bu durumda Ozow ödeme sayfasında gizlenir), mağaza para birimi ZAR değilse ve WooCommerce 2'den fazla ondalık basamak kullanıyorsa uyarır. Test modu açıkken ayrıca Test mode is on: no real payments are accepted. Do not ship orders paid in test mode. mesajını gösterir. Ödeme yöntemleri listesinde, Site Code ve Private Key girilene kadar Ozow kurulum gerektiren olarak işaretlenir.

Genel

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. 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 altına TEST MODE: no money will be charged. satırı eklenir.

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 üzerindeki Ozow entegrasyon belgelerine bağlantı verir.

Site Code: ödemeleri alan Ozow sitesinin Site Code değeri. Başka bir Site Code için gelen 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ı. Bir API Key ile her başarılı ödeme, sipariş ödenmiş olarak işaretlenmeden önce Ozow GetTransaction API ile de doğrulanır. API, ödemeyi bu sipariş için, aynı tutar, para birimi ve Site Code ile tamamlanmış olarak bildirmelidir.

Test mode: Enable Ozow test mode. Ozow, testler için aynı Site Code ve anahtarları kullanır: ödemeler IsTest=true ile oluşturulur ve para hareket etmez. Test modunda ödenen siparişler bir sipariş notu alır; bunları göndermeyin. Gerçek ödemeleri kabul etmek için test modunu kapatın. Test ödemesi canlı modda hiçbir siparişi ödenmiş yapmaz. Varsayılan: açık.

Ö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 ayarlanmadıkça. Bu bölüm bildirim URL'sini gösterir. Görünümü şöyledir: https://your-site/wc-api/ozow_pay/?ozow_notify=1. Ozow siteniz sabit URL kullanıyorsa, ayarların gösterdiği biçimde birebir kopyalayın.

Gelişmiş

Debug log: Log payment requests and Ozow responses, ayrıntıları WooCommerce > Status > Logs altına, kaynak wcp_ozow_pay olarak yazar. Hatalar ve uyarılar her zaman kaydedilir. Anahtarlar, hash'ler ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Ozow data saved on orders is kept). Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Instant EFT (Ozow)) ve siparişi verir. Eklenti, müşteriyi ZAR cinsinden sipariş toplamı için imzalı bir istekle Ozow'un barındırdığı ödeme sayfasına gönderir. Banka ekstresindeki referans Order ve sipariş numarasıdır (en fazla 20 Latin harfi, rakam, boşluk ve kısa çizgi). Müşterinin adı Ozow'a iletilir. 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. Her ikisi de aynı imzalı yanıtı taşır ve aynı şekilde işlenir; bu nedenle biri kaybolsa bile sipariş güncellenir. Sipariş, Ozow onayladıktan sonra ödenmiş olarak işaretlenir: hash Private Key'iniz ile doğrulanmalı, Site Code sizin olmalı, yanıt bu siparişin anahtarını taşımalı ve tutar ile para birimi siparişle eşleşmelidir. Bir API Key ile ödeme ayrıca GetTransaction API ile kontrol edilir.

Başarılı bir ödemeden sonra müşteri sipariş alındı sayfasına gelir. Ozow ödemeyi henüz onaylamadıysa sayfa şunu gösterir: 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. Sipariş beklemedeyse şu mesaj gösterilir: Your Ozow payment was received and is being reviewed by the store. We will contact you if anything is needed.

Müşteri Ozow sayfasında iptal ederse veya ödeme başarısız olursa, sipariş Failed olur ve müşteri Pay for order sayfasına döner; 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. Müşteri aynı siparişi yeniden ödeyebilir.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır (yalnızca ZAR siparişleri için). WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca ZAR cinsinden tek seferlik ödemeleri kabul eder. WooCommerce üzerinden iade, abonelik, kayıtlı banka hesabı veya tokenizasyon ve yönetici panelinden ödeme bağlantısı gönderme özellikleri yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri Ozow'a yönlendirildi ve henüz ödeme yapmadı ya da Ozow ödemeyi henüz onaylamadı.

Processing: ödeme onaylandı. Bu, ödemeden sonra WooCommerce'in standart durumudur; yalnızca sanal, indirilebilir ürün içeren siparişler Completed durumuna geçer. Sipariş notu tutarı ve Ozow işlem kimliğini, ayrıca ödemenin GetTransaction API ile onaylanıp onaylanmadığını gösterir. Siparişin işlem kimliği Ozow TransactionId değeridir. Bir test ödemesi TEST MODE — no money was received, do not ship this order. notunu alır.

On hold: sipariş notu nedenini açıklar. Ozow veya banka ödemeyi inceliyor (Ozow nihai durumu gönderdiğinde sipariş güncellenir); ödenen tutar veya para birimi siparişten farklı; zaten iptal edilmiş bir sipariş için ödeme geldi; ya da bir API Key ile GetTransaction API ödemeyi henüz onaylayamadı veya ödemeyle çelişiyor. Ozow panelinizde ödemeyi kontrol edin ve sipariş durumunu değiştirin. API yanıt veremediyse, bir sonraki Ozow bildirimi siparişi tamamlar.

Failed: müşteri ödemeyi iptal etti, ödeme terk edildi veya Ozow bir hata bildirdi. Müşteri siparişten yeniden ödeme yapabilir.

Zaten ödenmiş bir sipariş asla geri alınmaz ve iptal edilmiş veya iade edilmiş bir sipariş asla yeniden açılmaz. Zaten ödenmiş bir siparişe ikinci bir ödeme gelirse, bir not sizden kopyayı Ozow panelinizden iade etmenizi ister. Sipariş başka bir nedenle beklemedeyse (örneğin sizin tarafınızdan ayarlandıysa), sonraki bir ödeme yalnızca bir not ekler ve siparişi Processing durumuna siz getirirsiniz.

İadeler

WooCommerce üzerinden iade desteklenmez. Ödemeyi Ozow satıcı panelinizden iade edin ve iadeyi WooCommerce'e elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Ozow sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Alan adı hakkını 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Ödeme sayfasında Ozow 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 mağaza veya sipariş para biriminin ZAR olduğunu kontrol edin. Eksik bir şey olduğunda ayarlar sayfası uyarı gösterir.

Ödeme yapıldı ama sipariş Pending payment durumunda kaldı: Ozow bildirimi mağazaya ulaşmadı ve müşteri geri dönmedi. Sitenizin internetten erişilebilir olduğunu kontrol edin (Ozow'u engelleyen bakım modu, parola koruması veya güvenlik duvarı olmamalı). Ozow siteniz sabit URL'lere ayarlıysa, bildirim URL'sinin ayarlarda gösterilenle birebir aynı olduğunu kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs altında wcp_ozow_pay kaynağına bakın.

Bildirim Invalid hash yanıtı veriyor: ayarlardaki Private Key, yanıtı gönderen Ozow sitesine ait değil. Ozow satıcı panelinden yeniden kopyalayın.

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ğazanın bir siparişine ait değil. Hiçbir şey değiştirilmez.

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

Bildirim Order busy yanıtı veriyor: aynı sipariş için başka bir Ozow yanıtı tam o anda işleniyordu. Yanıt uygulanmaz; bir sonraki bildirim veya müşterinin geri dönüşü bunu uygular.

Bildirim Payment not confirmed yet yanıtı veriyor: bir API Key ile GetTransaction API ödemeyi onaylayamadı. Sipariş beklemede kalır ve bir sonraki bildirim onu tamamlar. Beklemede kalırsa API Key'i ve Ozow panelinizdeki ödemeyi kontrol edin.

Müşteri Ozow accepts payments in South African rand (ZAR) only mesajını görüyor: sipariş başka bir para biriminde. Bu sipariş için Ozow kullanılamaz.

Bir test ödemesi siparişi ödenmiş yapmadı: geçit canlı modda. Test ödemeleri canlı modda hiçbir siparişi ödenmiş yapmaz; siparişteki bir not bunu belirtir.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu okuyun ve Ozow panelinizde ödemeyi kontrol edin; ardından siparişi Processing durumuna getirin veya Ozow'da ödemeyi iade edin.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkı serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, eklentinin diğer seçenekleri ve günlükleri yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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