VibeFox Windcave 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.

Windcave hesabı: REST API kimlik bilgileri bulunan bir Windcave satıcı hesabına ihtiyacınız vardır: bir API kullanıcı adı ve bir API anahtarı. Windcave bunları UAT test ortamı (uat.windcave.com) ve üretim (sec.windcave.com) için ayrı ayrı verir. Windcave desteğinden veya hesap yöneticinizden isteyin. PxPay anahtarları bu eklentiyle çalışmaz. Sunmak istediğiniz ödeme yöntemleri (kartlar, cüzdanlar ve diğerleri) Windcave hesabınızda etkin olmalıdır.

Bildirim: Windcave ödeme bildirimini gönderebilmesi için mağazanıza internetten erişilebilmelidir. Bunun için Windcave tarafında herhangi bir ayar yapılması gerekmez.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_windcave_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_windcave_payment_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_windcave_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi 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 sayfasına gidin ve Payments türünü seçin. VibeFox Windcave Payment Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin 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 kısmındaki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. License key).

4. REST API kullanıcı adınızı ve anahtarınızı girin: test modu için UAT kimlik bilgilerini, gerçek ödemeler için üretim kimlik bilgilerini (bkz. Configuration).

5. İşlem türünü ve ödeme yöntemlerini seçin, 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 almak için Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_windcave_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

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

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

4. Lisans anahtarını, Windcave kimlik bilgilerini ve ayarları OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Windcave REST API).

Yeni bir kurulum, ödeme yöntemi kapalı olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Test modu açıkken sayfa Test mode is on: payments go to the Windcave UAT environment and no real money is taken. ifadesini gösterir. Ödeme yöntemi etkin ama geçerli modda API kullanıcı adı veya anahtarı yoksa sayfa, yöntemin ödeme adımında gizlendiğini uyarır; örneğin Windcave is enabled but the UAT API username / key are empty — the payment method is hidden at checkout. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve en fazla 128 karakter olmalıdır (Enter a title for the payment method (at most 128 characters).), Sort Order tam sayı olmalıdır (Sort Order must be a whole number.), Total 0 veya daha büyük bir sayı olmalıdır (Total: enter a number, 0 or greater.), seçilen coğrafi bölge ve sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez ve sayfa hatayı gösterir.

Windcave

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

Title: müşterinin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte de bu ad kaydedilir. Varsayılan: Credit/Debit Card (Windcave). Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında onay düğmesinin üzerinde müşteriye gösterilen metin. Varsayılan: You will be redirected to the secure Windcave payment page to complete your payment.

Sort Order: Windcave'in ödeme adımındaki ödeme yöntemleri arasındaki konumu. Boş bırakabilir veya tam sayı girebilirsiniz; negatif sayılara izin verilir.

Geo Zone: Windcave'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Windcave'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme toplamı: 0 veya daha büyük bir sayı. Herhangi bir tutar için sunmak amacıyla boş bırakın.

Windcave REST API

Windcave tarafından verilen REST API kimlik bilgilerini (kullanıcı adı ve API anahtarı; PxPay anahtarları değil) girin. Üretim ve UAT kimlik bilgileri yan yana kaydedilebilir. Test modu yalnızca UAT kimlik bilgilerini, canlı mod yalnızca üretim kimlik bilgilerini kullanır. Bölüm, Windcave REST API belgelerine bağlantı verir.

Test mode: Windcave UAT test ortamını (uat.windcave.com) kullanır. Gerçek para tahsil edilmez. Yeni ödemeler UAT kimlik bilgilerini kullanır. İadeler ve tahsilatlar her zaman siparişin ödendiği ortama gider. Varsayılan: off.

Production API username: sec.windcave.com için REST API kullanıcı adı.

Production API key: sec.windcave.com için REST API anahtarı.

UAT API username: uat.windcave.com için REST API kullanıcı adı (test modu).

UAT API key: uat.windcave.com için REST API anahtarı (test modu).

Kaydedilmiş API 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. Kaydedilmiş bir anahtarı kaldırmak için alanın altındaki Clear the saved key on save seçeneğini işaretleyin ve Save düğmesine tıklayın.

Notification URL: Windcave'in ödeme bildirimini (Fail-Proof Result Notification) gönderdiği adresi gösterir. OpenCart kurulumunuzun vitrin adresinden oluşturulur ve OpenCart 3'te şöyle görünür: https://your-store/index.php?route=extension/payment/wcp_windcave_payment_gateway/notify, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_windcave_payment_gateway/payment/wcp_windcave_payment_gateway.notify. Windcave tarafında yapılandırılacak bir şey yoktur: eklenti, her ödeme oturumunda kendi dönüş adreslerini ve bu bildirim adresini gönderir. Adres internetten erişilebilir olmalıdır; aksi halde siparişler yalnızca müşteri Windcave'den döndüğünde onaylanır. Ne müşterinin dönüşü ne de bildirim Windcave tarafından imzalanır; bu nedenle eklenti bunlara tek başına asla güvenmez: oturumun sonucunu her zaman, oturumun oluşturulduğu ortamın kimlik bilgileriyle Windcave REST API'sinden okur.

Payment

Transaction type: ödemenin nasıl tahsil edileceği. Varsayılan: Purchase.

Payment methods: Windcave ödeme sayfasında gösterilen yöntemler: Cards, Account2Account (Yeni Zelanda banka havalesi), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Birden fazla seçebilirsiniz. Yöntemler Windcave hesabınızda etkin olmalıdır. Hesapta etkin olan tüm yöntemleri göstermek için alanı boş bırakın (Every method enabled on the account). Varsayılan: Cards.

Orders

OpenCart siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, Windcave ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: onaylanmış bir Purchase veya tahsilattan sonra ayarlanır. Varsayılan: Processing.

Windcave Payment On Hold Status: provizyonu alınmış ama henüz tahsil edilmemiş bir Auth ödemesi ya da siparişle eşleşmeyen onaylanmış bir ödeme (tutar, para birimi, referans). Bir not nedeni açıklar; sevkiyattan önce kontrol edin. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Cancelled Order Status: eklenti tarafından ayarlanmaz. Bu durumdaki bir sipariş için gelen onaylanmış bir ödeme siparişi değiştirmez; bir not, bunu Windcave Payline'da iade etmenizi veya siparişi geri yüklemenizi ister. Varsayılan: Canceled.

Refunded Status: ödeme tamamen iade edildikten veya provizyon serbest bırakıldıktan sonra sipariş sayfasından ayarlanır. Varsayılan: Refunded.

Advanced

Debug log: API isteklerini ve ödeme olaylarını OpenCart günlük klasöründeki (storage/logs) windcave_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu kapalıyken yalnızca hatalar ve uyarılar günlüğe yazılır. API anahtarları, kart verileri ve müşterilerin kişisel verileri asla günlüğe yazılmaz. Varsayılan: off.

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

Clean uninstall: eklenti kaldırıldığında eklentinin ayarlarını ve günlükleri siler. Siparişlerle birlikte kaydedilen ödeme verileri (iadeler için gerekli Windcave işlem kimlikleri) her zaman korunur. Varsayılan: off.

Eklenti sürümü bölümün altında gösterilir.

Import / Export

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API 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ş API anahtarları korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Windcave)). Confirm Order adımında müşteri sizin açıklamanızı görür; test modunda ayrıca Test mode: payments go to the Windcave UAT environment, no real money is taken. ifadesini görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş tutarı için sipariş para biriminde bir Windcave ödeme oturumu oluşturur ve müşteriyi Windcave Hosted Payment Page sayfasına gönderir. OpenCart sipariş numarası, sipariş dili ile müşterinin adı, e-postası, telefonu ve fatura adresiyle birlikte satıcı referansı olarak gönderilir (sipariş kargo gerektiriyorsa teslimat adresi de gönderilir). OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve sayfanın altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Windcave onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, hem müşteri döndüğünde hem de Windcave bildirimi geldiğinde oturumun sonucunu Windcave REST API'sinden ister. Sepet başına bir kilit, ödemenin yalnızca bir kez uygulanmasını sağlar. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri Your Windcave payment has been received. mesajıyla OpenCart sipariş başarı sayfasını görür. Bekletilen bir sipariş için (provizyon veya siparişle eşleşmeyen bir ödeme) sayfa Your payment was received by Windcave. The store will check it before processing your order — please do not pay again. ifadesini gösterir.

Müşteri onaylanmış bir ödemeden döndü ama sonuç henüz bilinmiyorsa, Payment confirmation sayfası We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again. mesajını ve bir Check again düğmesini gösterir. Bildirim, Windcave ödemeyi onayladığı anda sipariş durumunu ayarlar.

Müşteri tamamlanmış bir ödeme olmadan dönerse sipariş durumsuz kalır, sepet saklanır ve ödeme sayfası şu mesajlardan birini gösterir:

OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

Müşteri aynı sepetle yeniden deneyebilir (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir sipariş tutar ve onu günceller, böylece aynı sipariş yeni bir Windcave oturumunda ödenir). Yeni bir deneme önce sepetin önceki oturumlarını kontrol eder: biri zaten ödenmişse o ödeme uygulanır, müşteri başarı sayfasına gider ve ikinci bir ödeme başlatılmaz; müşteri ödeme sayfasını hiç kullanmadıysa ve sipariş değişmediyse aynı sayfaya geri gönderilir. Önceki ödeme o anda onaylanıyorsa müşteri Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again. mesajını görür.

Windcave ödemeyi başlatamazsa müşteri, düğmenin üzerinde bir mesajla Confirm Order adımında kalır: Windcave could not start the payment with the details of this order. Please check your billing details and try again, or choose another payment method. veya The payment could not be started because the payment service is temporarily unavailable. Please try again in a moment or choose another payment method. Neden günlüğe yazılır. Geçerli modda kimlik bilgisi yoksa müşteri This payment method is not available at the moment. Please choose another payment method or contact us. mesajını görür.

OpenCart 4'te, ödeme sürecindeki sipariş bir Windcave ödemesi olmadan bir duruma kavuştuysa ya da mağaza bu arada onu kapattıysa, bir sonraki Confirm Order müşteriyi, ödeme sayfasının üstünde gösterilen This order can no longer be paid. Please check your cart and confirm the order again. mesajıyla ödeme adımına geri gönderir ve sepet yeni bir siparişle ödenir. Ödeme sürecindeki sipariş zaten ödenmişse ama sepet o zamandan beri değiştiyse (yeni adet dahil), müşteri ödeme adımına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

Bildirim 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.

Eklentinin abonelikleri veya tekrarlayan ödemeleri, kayıtlı kartları, sitenizde gömülü bir kart formu yoktur (müşteri her zaman Windcave sayfasında öder), PxPay 2.0 API'si desteği yoktur ve ek ücret eklemez. Windcave bir ek ücret eklerse sipariş ana işlemle eşleştirilir.

Siparişler ve iadeler

Order statuses

Durum yok (eksik sipariş): müşteri Windcave'e yönlendirildi ve ödeme yapmadı, Windcave ödemeyi henüz onaylamadı ya da ödeme reddedildi, iptal edildi veya süresi doldu. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): bir Purchase ödemesi onaylandı ve siparişle eşleşiyor. Bir not, tutarı, işlem kimliğini, yetkilendirme kodunu, maskelenmiş kart numarasıyla kart türünü ve ortamı (UAT veya üretim) gösterir.

Windcave Payment On Hold Status, yetkilendirilmiş (varsayılan Pending): bir Auth ödemesi onaylandı ama henüz tahsil edilmedi. Not, nasıl tahsil edileceğini veya serbest bırakılacağını açıklar.

Windcave Payment On Hold Status, eşleşmiyor (varsayılan Pending): Windcave, siparişten farklı bir tutar, para birimi, satıcı referansı veya işlem türü bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi) ya da sipariş zaten başkası tarafından bir durum almıştı. Not farkları listeler. Onaylanmış para yine de sipariş sekmesinden iade edilebilir. Sevkiyattan önce ödemeyi Windcave Payline'da kontrol edin ve gerekiyorsa iade edin.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden tamamen iade edildi veya provizyon serbest bırakıldı.

Cancelled Order Status durumundaki bir sipariş için onaylanmış bir ödeme gelirse ya da zaten ödenmiş bir sipariş veya sepet için ikinci bir onaylanmış ödeme gelirse sipariş değişmez. İşlem kimliğini içeren bir not, bunu Windcave Payline'da iade etmenizi (veya iptal edilmiş siparişi elle geri yüklemenizi) ister.

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

VibeFox Windcave Payment Gateway tab

Sales > Orders bölümünde, Windcave ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Windcave Payment Gateway sekmesi Transaction ID, Session ID, ortamla birlikte Type / status, Amount paid, Auth code / card, Capture transaction veya serbest bırakılmış provizyonu, Payment total / refunded değerlerini, test ödemeleri için Test mode (UAT) etiketini, tahsilat düğmesini, iade formunu ve geçmişini, Windcave sessions of this cart kayıtlarını ve siparişin Windcave notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Capture (Auth mode)

Henüz tahsil edilmemiş veya serbest bırakılmamış bir provizyonu olan Windcave Payment On Hold Status durumundaki bir sipariş için sekme Capture Windcave payment düğmesini gösterir. Düğmeye tıklayın ve Capture the authorised amount through Windcave now? ifadesini onaylayın. Yetkilendirilmiş tutar tahsil edilir, sipariş Order Status After Payment durumuna geçer ve tahsilat işlemi sekmede gösterilir. Windcave tahsilatı kabul etmezse sekme Windcave capture failed: ve nedenini gösterir, neden notlara eklenir ve sipariş bekletilmeye devam eder. Tahsilat, eklentiyi değiştirme yetkisi ve ödemenin ortamının kimlik bilgilerini gerektirir.

Refunds

VibeFox Windcave Payment Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Windcave düğmesine tıklayın. Refund this amount through Windcave? 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). İadeler, Windcave'in onayladığı tutar ve para birimi üzerinden sayılır; bu nedenle bir uyuşmazlıktan sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. Tahsilattan sonraki bir iade, tahsilat işlemine gider. İade, ortama (UAT veya üretim) ve ödemenin yapıldığı hesaba gönderilir; bu nedenle o ortamın kimlik bilgileri kaydedilmiş olmalıdır. Başarılı bir iade, Windcave işlem kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan, manuel bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi iade durumu değiştirmez.

Tahsil edilmemiş bir Auth ödemesi için düğme Release authorisation (void) olur ve yalnızca tam tutar serbest bırakılabilir. Kısmi bir tutar, tam tutarı iade etmenizi veya önce ödemeyi tahsil etmenizi isteyen bir hata verir.

Windcave iadeyi reddederse sekme Windcave declined the refund: ve nedenini gösterir, hiçbir iade kaydedilmez. Windcave iadeyi hâlâ işliyorsa sekme Windcave has not confirmed the refund yet. See the order notes. mesajını gösterir ve iade kaydedilmez. Windcave Payline'da işlemi kontrol edin: onaylanmışsa iadeyi elle kaydedin; değilse yeniden deneyin. Aynı iadenin tekrar denemesi Windcave'e iki kez gönderilmez.

Sales > Returns bölümündeki ürün iadeleri Windcave üzerinden para geri göndermez. Windcave Payline'da yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Eklentinin lisans bloğu License — VibeFox Windcave Payment Gateway, Extensions > Extensions > Payments > VibeFox Windcave Payment Gateway > Edit sayfasında ayarların üstündeki 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üğmesini gösterir; bu düğme durumu yeniden kontrol eder, Change key ile başka bir anahtar girersiniz ve Remove key ile anahtarı bu mağazadan kaldırırsınız. Altında Product: opencart-payment-windcave satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetim paneli 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 tarihle birlikte License expired on. 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırması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 Windcave ödeme adımında müşterilere gösterilmez. Bir ödeme yine de 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 yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler bildirim veya müşterinin dönüşü ile yine onaylanır, iadeler ve tahsilatlar çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelindeki 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

Windcave ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun her iki kimlik bilgisine sahip olduğunu kontrol edin: test modunda UAT API username ve UAT API key, canlı modda Production API username ve Production API key. Eksikse ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kalıyor: eklenti, Windcave'den sonucu henüz alamadı. Eklenti sayfasındaki Log alanına bakın: hatalar her zaman günlüğe yazılır; örneğin oturum doğrulanamadığında. Ödemenin ortamının kimlik bilgilerinin kaydedildiğini ve doğru olduğunu kontrol edin. Kontrol, Windcave bildirimi yeniden gönderdiğinde (eklenti, Windcave'in yeniden denemesi için bir hata koduyla payment could not be verified yet, retry later yanıtı verir), müşteri Check again düğmesine tıkladığında ve müşteri aynı sepet için yeni bir ödeme başlattığında tekrarlanır. Sunucunuz, ayarlarda gösterilen Notification URL adresine Windcave'den gelen istekleri kabul etmelidir.

Bildirim order not found yanıtı veriyor: oturum bu mağaza tarafından oluşturulmamış, örneğin aynı Windcave hesabını kullanan başka bir mağazanın oturumu. Yok sayılır.

Günlükte Authentication failed: REST API kullanıcı adı veya anahtarı hatalı ya da diğer ortama ait. UAT kimlik bilgileri yalnızca test modunda, üretim kimlik bilgileri yalnızca canlı modda çalışır. PxPay anahtarları çalışmaz.

Müşteri, Windcave'in bu siparişin ayrıntılarıyla ödemeyi başlatamadığını görüyor: Windcave oturum isteğini reddetti; örneğin para birimi nedeniyle veya hesabınızda etkin olmayan bir ödeme yöntemi yüzünden. Tam neden günlüktedir.

Müşteri Confirm Order sonrasında This payment method is not available. görüyor: ödeme oturumu artık siparişle eşleşmiyor ya da bu arada ödeme yöntemi kapatıldı. Müşteri ödeme adımını yeniler.

Ödemeden sonra sipariş inceleme durumunda: VibeFox Windcave Payment Gateway sekmesindeki notları okuyun. Ya ödeme tahsilat bekleyen bir Auth ödemesidir ya da ödenen tutar, para birimi veya satıcı referansı siparişten farklıydı. Ödemeyi tahsil edin, tamamlayın veya iade edin.

Test ödemeleri ve gerçek ödemeler: UAT ve üretim ayrıdır. Her oturum oluşturulduğu ortamda doğrulanır; iadeler ve tahsilatlar, daha sonra Test mode seçeneğini değiştirseniz bile ödemenin ortamına gider.

İade, ortamla ilgili bir mesajla başarısız oluyor: ödeme UAT veya üretimde yapıldı ve o ortam için kayıtlı kimlik bilgisi yok. Bunları girin ve yeniden deneyin.

Sipariş sekmesinde Capture Windcave payment yok: düğme yalnızca Windcave Payment On Hold Status durumundaki, Auth ile ödenmiş ve henüz tahsil edilmemiş veya serbest bırakılmamış siparişler için gösterilir; yalnızca ödemenin ortamının kimlik bilgileri kaydedildiğinde ve yalnızca eklentiyi değiştirebilen kullanıcılara.

Ayrıntıların bulunduğu yer: hatalar ve uyarılar her zaman günlüğe yazılır; API isteklerini ve ödeme olaylarını da kaydetmek için Debug log seçeneğini açın.

Geliştiriciler için: Windcave oturumu oluşturulmadan önce eklenti, oturum parametreleri ve siparişle birlikte windcave_p_session_request OpenCart olayını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Windcave Payment 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 olayları ve bakım modunda bildirimi ile müşterinin dönüşünü geçiren başlangıç eylemi de kaldırılır). Clean uninstall açıksa diğer ayarlar (başlık, açıklama, test modu, API kimlik bilgileri, işlem türü, ödeme yöntemleri, günlüğe kaydetme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Windcave oturumları, işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir ve tahsil edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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