VibeFox Windcave for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin olmalıdır. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Windcave hesabı: REST API kimlik bilgilerine sahip 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. Windcave destek ekibinden veya hesap yöneticinizden isteyin. PxPay anahtarları bu eklentide çalışmaz. Sunmak istediğiniz ödeme yöntemleri (kartlar, cüzdanlar ve diğerleri) Windcave hesabınızda etkin olmalıdır.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_windcave_payment_gateway 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 > Windcave > Manage veya 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. 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ı kimlik bilgilerini girin (bkz. Yapılandırma).

6. İşlem türünü ve ödeme yöntemlerini seçin, Enable/Disable seçeneğini açın ve kaydedin. Test mode açıkken bir test ödemesi yapın, ardından gerçek ödemeleri almak için Test mode seçeneğini kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Windcave. Test modu açıkken sayfa Test mode is on: payments go to the Windcave UAT environment and no real money is taken. mesajını gösterir. Ödeme yöntemleri listesinde Windcave, geçerli modda hem API kullanıcı adı hem de API anahtarı olana kadar kurulum gerektiren olarak işaretlenir. Eklenti sürümü sayfanın en altında gösterilir.

Genel

Enable/Disable: Enable Windcave 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: Credit/Debit Card (Windcave).

Description: ödeme sayfası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 ise yalnızca canlı kimlik bilgilerini kullanır.

Test mode: Use the Windcave UAT test environment (uat.windcave.com). 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).

Ödeme

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ş Beklemede durumuna alınır ve parayı sipariş işlemlerindeki Capture Windcave payment ile tahsil edersiniz ya da tutarın tamamını iade ederek serbest bırakırsınız. Tahsil edilmemiş yetkilendirmeler birkaç gün içinde 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. Bunların Windcave hesabınızda etkin olması gerekir. Hesapta etkin olan tüm yöntemleri göstermek için alanı boş bırakın. Varsayılan: Cards.

Gelişmiş

Debug log: Log API requests and payment events. Günlük, WooCommerce > Status > Logs altında, wcp_windcave_payment_gateway kaynağıyla bulunur. Hatalar ve uyarılar her zaman kaydedilir; bu seçenek API isteklerini ve ödeme olaylarını da ekler. API anahtarları, kart bilgileri ve müşterilerin kişisel verileri maskelenir. Varsayılan: kapalı.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Siparişlerde kaydedilen ödeme verileri (iadeler için gereken Windcave işlem kimlikleri) her zaman korunur. Varsayılan: kapalı.

Bildirim URL'si

Windcave'de bir bildirim URL'si ayarlamanız gerekmez. Eklenti, her ödeme oturumuyla birlikte dönüş adreslerini ve bildirim adresini gönderir. Windcave, bildirimi (Fail-Proof Result Notification) https://your-site/wc-api/windcave_p_notification/ adresine gönderir. Ne müşterinin dönüşü ne de bildirim Windcave tarafından imzalanır; bu yüzden eklenti bunlara tek başına asla güvenmez. Oturum sonucunu her zaman, oturumun oluşturulduğu ortamın kimlik bilgilerinizle Windcave REST API'sinden okur.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Windcave)) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir Windcave ödeme oturumu oluşturur ve müşteriyi Windcave Hosted Payment Page sayfasına gönderir. Sipariş numarası satıcı referansı olarak; mağaza dili, müşterinin adı, e-posta adresi, telefonu ile fatura ve teslimat adresleriyle birlikte gönderilir. Test modunda Ödeme bloğu, ödeme yönteminin altında Test mode: payments go to the Windcave UAT environment, no real money is taken. mesajını gösterir.

Ödeme yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca Windcave onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, müşteri geri döndüğünde ve Windcave bildirimi geldiğinde oturum sonucunu Windcave REST API'sinden ister. Sipariş başına bir kilit, ödemenin yalnızca bir kez uygulanmasını sağlar. Sonuç henüz bilinmiyorsa sipariş alındı sayfası bir kez daha kontrol eder ve 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ı gösterir.

Müşteri ödemesini tamamlamadan geri dönerse ödeme sayfası (ya da denemenin orada başladıysa Pay for order sayfası) şu mesajlardan birini gösterir:

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

Cancelled or expired: ödeme Windcave sayfasında tamamlanmadı. Siparişiniz 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 onayladığı anda onay e-postası alacaksınız.

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

Müşteri ödeme yapmadan önce sepet boşaltılmaz ve stok azaltılmaz. Müşteri, ödenmemiş bir siparişi örneğin Pay for order sayfasından tekrar ödeyebilir. Yeni bir deneme önce önceki oturumu kontrol eder: zaten ödenmişse ikinci bir ödeme oluşturulmaz; müşteri ödeme sayfasını hiç kullanmadıysa ve sipariş değişmediyse aynı sayfaya geri yönlendirilir. Ö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 mesaj görür: Windcave'in bu siparişin bilgileriyle ödemeyi başlatamadığını veya ödeme hizmetinin geçici olarak kullanılamadığını belirten bir mesaj. Nedeni sipariş notlarına eklenir. 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.

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

Eklentide 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

Sipariş durumları

Pending payment: müşteri Windcave'e yönlendirildi ve henüz ödeme yapmadı ya da Windcave ödemeyi henüz onaylamadı. Müşteri iptal ederse veya oturum sona ererse sipariş Ödeme bekleniyor durumunda kalır ve bir not eklenir.

Processing or Completed: bir Purchase ödemesi onaylandı. WooCommerce, her zamanki gibi siparişi İşleniyor veya kargo gerektirmeyen siparişler için Tamamlandı olarak ayarlar. Sipariş notunda tutar, Windcave işlem kimliği, yetkilendirme kodu, maskelenmiş kart numarasıyla kart türü ve ortam (UAT veya canlı) gösterilir. Siparişin işlem kimliği, Windcave işlem kimliğidir.

On hold (authorised): bir Auth ödemesi onaylandı ama henüz tahsil edilmedi. Sipariş notu, tahsil etmenin veya serbest bırakmanın nasıl yapılacağını açıklar.

On hold (does not match): Windcave, siparişten farklı bir tutar, para birimi, satıcı referansı veya işlem türü bildirdi (örneğin ödeme başladıktan sonra sipariş düzenlendi). Not farklılıkları listeler. Kargoya vermeden önce ödemeyi Windcave Payline'da kontrol edin ve gerekirse iade edin.

Failed: ödeme reddedildi. Notta Windcave yanıt metni ve kodu gösterilir. Müşteri tekrar deneyebilir.

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

Tahsilat (Auth modu)

Siparişi açın, sipariş işlemlerinden Capture Windcave payment seçeneğini seçin ve güncelle düğmesine tıklayın. Bu işlem yalnızca henüz tahsil edilmemiş veya serbest bırakılmamış bir yetkilendirmesi olan Beklemede siparişlerde görünür. Siparişin tüm tutarı tahsil edilir, tahsilat sipariş notlarına eklenir ve sipariş ödenmiş bir sipariş olarak ilerler (genellikle İşleniyor). Windcave tahsilatı kabul etmezse sipariş ekranı nedeniyle birlikte Windcave capture failed: mesajını gösterir ve neden sipariş notlarına eklenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Windcave düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (UAT veya canlı) ve 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 sipariş notlarına eklenir.

Tahsil edilmemiş bir Auth ödemesi için yalnızca tam iade mümkündür: yetkilendirmeyi serbest bırakır (iptal eder). Kısmi bir tutar, tam tutarı iade etmenizi ya da önce ödemeyi tahsil etmenizi isteyen bir hata verir.

Windcave iadeyi reddederse WooCommerce nedeniyle birlikte Windcave declined the refund: mesajını gösterir ve iade kaydedilmez. Windcave iadeyi hâlâ işliyorsa WooCommerce Windcave has not confirmed the refund yet. See the order notes. mesajını gösterir ve iade kaydedilmez. İşlemi Windcave Payline'da kontrol edin: onaylandıysa iadeyi elle kaydedin; onaylanmadıysa tekrar deneyin. Aynı iadenin tekrarlanan denemesi Windcave'e iki kez gönderilmez. Windcave Payline'da yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > Windcave sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blokta durum gösterilir; örneğin lisansın hangi tarihe kadar etkin olduğu 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 tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Windcave müşterilere ödeme sayfasında 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 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, iade ve tahsilatlar çalışır.

Lisansın 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

Windcave does not appear at checkout: 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.

The payment went through, but the order stays Pending payment: eklenti henüz Windcave'den sonucu alamadı. Sipariş notlarını açın: bir notta oturumun ne zaman doğrulanamadığı ve nedeni yazar. Ödemenin ortamına ait kimlik bilgilerinin kayıtlı ve doğru olduğundan emin olun. Windcave bildirimi yeniden gönderdiğinde (sonuç doğrulanana kadar eklenti hata yanıtı verir, böylece Windcave yeniden dener) ve müşteri sipariş alındı sayfasını açtığında kontrol tekrarlanır. Sunucunuz, Windcave'den https://your-site/wc-api/windcave_p_notification/ adresine gelen istekleri kabul etmelidir.

Authentication failed in the order notes or the log: REST API kullanıcı adı veya anahtarı yanlış ya da diğer ortama ait. UAT kimlik bilgileri yalnızca test modunda, canlı kimlik bilgileri yalnızca canlı modda çalışır. PxPay anahtarları çalışmaz.

The customer sees that Windcave could not start the payment with the details of this order: Windcave oturum isteğini reddetti; örneğin para birimi nedeniyle ya da hesabınızda etkin olmayan bir ödeme yöntemi yüzünden. Kesin neden sipariş notlarında ve günlükte yazar.

Order is On hold after payment: sipariş notunu okuyun. Ödeme ya tahsil edilmeyi bekleyen bir Auth ödemesidir ya da ödenen tutar, para birimi veya satıcı referansı siparişle uyuşmuyordur. Ödemeyi tahsil edin, kargoya verin veya iade edin.

Test payments and live payments: UAT ve canlı ortam birbirinden ayrıdır. Her oturum, oluşturulduğu ortamda kontrol edilir; iadeler ve tahsilatlar, Test mode seçeneğini daha sonra değiştirseniz bile ödemenin ortamına gönderilir. Eklentinin 1.0 sürümüyle oluşturulan siparişler, eski API URL ayarının ortamını kullanır.

Refund fails with a message about the environment: ödeme UAT veya canlı ortamda yapıldı ve o ortam için kayıtlı kimlik bilgisi yok. Bilgileri girin ve tekrar deneyin.

Capture Windcave payment is missing in the order actions: bu işlem yalnızca Auth ile ödenmiş, henüz tahsil edilmemiş veya serbest bırakılmamış Beklemede siparişlerde gösterilir.

Where to find details: hatalar ve uyarılar her zaman WooCommerce > Status > Logs altında, wcp_windcave_payment_gateway kaynağıyla yazılır. API isteklerini ve ödeme olaylarını da kaydetmek için Debug log seçeneğini açın.

The license block shows an error: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi 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ı, eklenti seçenekleri ve günlükler (döndürülmüş dosyalar dahil günlük dosyaları ve veritabanı günlük kayıtları) yalnızca Clean uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve Windcave işlem kimliklerini korur.

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