VibeFox Windcave for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

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

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

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

Kurulum

1. Yönetim panelinde 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Windcave Payment Gateway modülünü bulup Configure düğmesine tıklayın.

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

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 canlı ortam kimlik bilgilerini girin (bkz. Yapılandırma).

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.

Kurulumda modül Windcave payment on hold sipariş durumunu oluşturur. PrestaShop, yeni ö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.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Windcave Payment Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Test modu açıkken sayfada Test mode açık: ödemeler Windcave UAT ortamına gider ve gerçek para tahsil edilmez. mesajı görünür. Modül etkin olduğu halde geçerli modun API kullanıcı adı veya anahtarı yoksa, sayfa ödeme yönteminin ödeme adımında gizlendiği konusunda uyarır; örneğin Windcave etkin ancak UAT API kullanıcı adı / anahtarı boş — ödeme yöntemi ödeme adımında gizlenir. Title boş bırakılamaz: bu durumda sayfa Ödeme yöntemi için bir başlık girin. mesajını gösterir ve hiçbir şey kaydedilmez.

Windcave

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

Title: müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kayıtlı ödeme yöntemi adı da budur. Varsayılan: Credit/Debit Card (Windcave). Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

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

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 gönderilir. Varsayılan: kapalı.

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.

Clear saved keys: Production API key veya UAT API key kutusunu işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Notification URL: Windcave'in ödeme bildirimini gönderdiği adresi gösterir (Fail-Proof Result Notification). Okunabilir URL'ler etkinken şuna benzer: https://sizin-magazaniz/module/wcp_windcave_payment_gateway/notification. Windcave tarafında yapılandırılacak bir şey yoktur: modül, her ödeme oturumuyla birlikte dönüş adreslerini ve bu bildirim adresini gönderir. Adrese internetten erişilebilmelidir; 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 yüzden modül 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.

Purchase (capture immediately): müşteri ödeme yaptığında para tahsil edilir.

Auth (authorise now, capture later): para yalnızca ayrılır. Sipariş Windcave payment on hold durumuna alınır ve parayı siparişin Windcave bloğundaki Capture Windcave payment ile tahsil edersiniz ya da tutarın tamamını iade ederek ayrılan tutarı serbest bırakırsınız. Tahsil edilmemiş yetkilendirmeler birkaç gün sonra sona erer.

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çmek için Ctrl veya Cmd tuşuna basılı tutup tıklayın. 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. Varsayılan: Cards.

Advanced

Debug log: API isteklerini ve ödeme olaylarını modül klasöründeki logs/windcave_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Bu seçenek kapalıyken yalnızca hatalar ve uyarılar kaydedilir. API anahtarları, kart bilgileri ve müşterilerin kişisel verileri asla kaydedilmez. Varsayılan: kapalı.

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

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

Modül sürümü sayfanın altında gösterilir.

Ödeme

Ödeme adımında müşteri, açıklamasıyla birlikte ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Windcave)). Test modunda müşteri ayrıca Test mode: ödemeler Windcave UAT ortamına gider, gerçek para tahsil edilmez. mesajını görür. Onaydan sonra modül, sepet toplamı için sepet para biriminde bir Windcave ödeme oturumu oluşturur ve müşteriyi Windcave Hosted Payment Page sayfasına yönlendirir. Sepet numarası satıcı referansı olarak; mağazanın dili ve müşterinin adı, e-posta adresi, telefonu ve fatura adresiyle birlikte gönderilir (sepetin kargo gerektirmesi durumunda teslimat adresi de gönderilir). Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, ancak Windcave ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: modül, müşteri döndüğünde de Windcave bildirimi geldiğinde de oturumun sonucunu Windcave REST API'sinden ister. Sepet başına bir kilit, ödemenin yalnızca bir kez uygulanmasını sağlar. Ardından sipariş oluşturulur ve müşteri Your Windcave payment has been received. mesajıyla standart sipariş onay sayfasını görür. Beklemedeki bir sipariş için (bir yetkilendirme veya sepetle eşleşmeyen bir ödeme) sayfa Your payment was received by Windcave. The shop will check it before processing your order — please do not pay again. mesajını gösterir.

Müşteri onaylanmış bir ödemeden sonra dönmüş ama sonuç henüz bilinmiyorsa, bir 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 onaylar onaylamaz siparişi oluşturur.

Müşteri tamamlanmış bir ödeme olmadan dönerse, ödeme sayfası şu mesajlardan birini gösterir. Sepet korunur.

Declined: Ödemeniz reddedildi. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin.

Cancelled or expired: Ödeme Windcave sayfasında tamamlanmadı. Sepetiniz kaydedildi — tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz.

Not confirmed yet: Ödemenizi henüz onaylayamadık. Ödemeyi tamamladıysanız lütfen tekrar ödeme yapmayın — Windcave onaylar onaylamaz bir onay e-postası alacaksınız.

Return could not be processed: Ödeme sayfasından dönüşünüzü işleyemedik. Hesabınızdan tahsilat yapıldıysa, tekrar ödeme yapmadan önce lütfen bizimle iletişime geçin.

Müşteri aynı sepetle yeniden deneyebilir. Yeni bir deneme önce önceki oturumu kontrol eder: oturum zaten ödenmişse sipariş oluşturulur ve ikinci bir ödeme başlatılmaz; müşteri ödeme sayfasını hiç kullanmadıysa ve sepet 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 kısa bir mesajla ödeme adımında kalır: Windcave'in bu siparişin bilgileriyle ödemeyi başlatamadığı ya da ödeme hizmetinin geçici olarak kullanılamadığı. 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.

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

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

Siparişler ve iadeler

Order statuses

No order yet: müşteri Windcave'e yönlendirildi ve ödeme yapmadı, Windcave ödemeyi henüz onaylamadı ya da ödeme reddedildi, iptal edildi veya süresi doldu. Yalnızca sepet mevcuttur.

Payment accepted: bir Purchase ödemesi onaylandı ve sepetle eşleşiyor. Ödeme, Windcave işlem kimliğiyle kaydedilir; bir not tutarı, işlem kimliğini, onay kodunu, maskelenmiş kart numarasıyla kart türünü ve ortamı (UAT veya canlı) gösterir.

Windcave payment on hold (authorised): bir Auth ödemesi onaylandı ama henüz tahsil edilmedi. Tahsil edilene kadar siparişe hiçbir ödeme kaydedilmez. Not, nasıl tahsil edileceğini veya serbest bırakılacağını açıklar.

Windcave payment on hold (does not match): Windcave, sepetten 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). Not, farklılıkları listeler. Sepet para biriminde bir Purchase için ödeme, Windcave'in gerçekten tahsil ettiği tutarla kaydedilir. Sipariş kargoya verilmeden önce ödemeyi Windcave Payline üzerinde kontrol edin ve gerekiyorsa iade edin.

Refunded: ödeme tamamen iade edildi veya yetkilendirme modül üzerinden serbest bırakıldı.

İptal edilmiş bir siparişe onaylı bir ödeme gelirse ya da zaten var olan bir siparişe ikinci bir onaylı ödeme gelirse, sipariş değiştirilmez. İşlem kimliğini içeren bir not, bunu Windcave Payline üzerinden iade etmenizi (ya da iptal edilmiş siparişi elle geri yüklemenizi) ister.

Windcave payment block

Sipariş sayfasında işlem kimliği, oturum kimliği, işlem türü ve ortamla birlikte durum, ödenen tutar, onay kodu ve kart, tahsilat veya iptal işlemi, ödeme toplamı ve iade edilen tutar, test ödemeleri için bir Test mode (UAT) rozeti, iade geçmişi, sepetin tüm Windcave oturumları ve siparişin Windcave notes notlarını içeren bir Windcave payment bloğu görünür.

Capture (Auth mode)

Henüz tahsil edilmemiş veya serbest bırakılmamış bir yetkilendirmesi olan Windcave payment on hold durumundaki bir sipariş için blok, tutarıyla birlikte Capture Windcave payment seçeneğini gösterir. Tıklayın ve Capture the authorised amount through Windcave now? sorusunu onaylayın. Yetkilendirilen tutar tahsil edilir (ödeme siparişle eşleşmediği sürece sipariş toplamı), sipariş Payment accepted durumuna geçer ve ödeme tahsilat işlem kimliğiyle kaydedilir. Windcave tahsilatı kabul etmezse blok nedenle birlikte Windcave capture failed: mesajını gösterir, neden notlara eklenir ve sipariş beklemede kalır.

Refunds

Windcave payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden 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. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modüller sayfalarına erişim gerekli değildir. İadeler, Windcave'in onayladığı tutar ve para birimine göre sayılır; bu yüzden 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, ödemenin yapıldığı ortama (UAT veya canlı) ve hesaba gönderilir; bu yüzden 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 Refunded durumuna getirir. 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 ya da önce ödemeyi tahsil etmenizi isteyen bir hata verir.

Windcave iadeyi reddederse blok, nedenle birlikte Windcave declined the refund: mesajını gösterir ve hiçbir iade kaydedilmez. Windcave iadeyi hâlâ işliyorsa blok Windcave has not confirmed the refund yet. See the order notes. mesajını gösterir ve iade kaydedilmez. Windcave Payline üzerinde işlemi kontrol edin: onaylandıysa iadeyi elle kaydedin; onaylanmadıysa tekrar deneyin. Aynı iadenin tekrarlanan bir denemesi Windcave'e iki kez gönderilmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri, Windcave üzerinden para geri göndermez. Windcave Payline'da yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Windcave Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox Windcave Payment Gateway > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-payment-windcave 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 yetkisine sahip çalışanlar değiştirebilir. Bloktaki metinler 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 tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar yalnızca 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 boşaltın.

Etkin bir anahtar olmadan Windcave, ödeme adımı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 yönetim paneline 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 adımında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler bildirim veya müşterinin dönüşüyle onaylanmaya devam eder; tahsilatlar ve iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelinde çalışırken 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

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 modda iki kimlik bilgisinin de bulunduğunu kontrol edin: test modunda UAT API username ve UAT API key, canlı modda Production API username ve Production API key. Ayarlar sayfası eksik olduklarında bir uyarı gösterir. 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 yapıldı ama sipariş oluşturulmadı: modül Windcave'den sonucu henüz alamadı. Modül sayfasındaki Log alanına bakın: oturum doğrulanamadığında olduğu gibi hatalar her zaman kaydedilir. Ödemenin ortamına ait kimlik bilgilerinin kayıtlı ve doğru olduğunu kontrol edin. Kontrol, Windcave bildirimi yeniden gönderdiğinde (modül, Windcave'in yeniden denemesi için bir hata koduyla birlikte 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, Windcave'in ayarlarda gösterilen Notification URL adresine gönderdiği istekleri kabul etmelidir.

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

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

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

Ödemeden sonra sipariş Windcave payment on hold durumunda: Windcave payment bloğundaki notları okuyun. Ya ödeme tahsilat bekleyen bir Auth ödemesidir ya da ödenen tutar, para birimi veya satıcı referansı sepetten farklıydı. Ödemeyi tahsil edin, sevk edin veya iade edin.

Test ödemeleri ve canlı ödemeler: UAT ve canlı ortam ayrı tutulur. Her oturum, oluşturulduğu ortamda kontrol edilir ve iadeler ile tahsilatlar, Test mode seçeneğini daha sonra değiştirseniz bile ödemenin ortamına gider.

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

Sipariş bloğunda Capture Windcave payment yok: düğme yalnızca Auth ile ödenmiş, henüz tahsil edilmemiş veya serbest bırakılmamış Windcave payment on hold durumundaki siparişlerde ve yalnızca siparişleri düzenlemeye yetkili çalışanlara gösterilir.

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.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Windcave Payment 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 silinir. Clean uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Windcave oturumları, işlemleri ve iadeleri ile Windcave payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir ve tahsil edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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