VibeFox CorvusPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Para birimi: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK veya USD. Başka herhangi bir para biriminde ödeme yöntemi ödeme sayfasında gizlenir. Tutarlar 2 ondalıkla gönderilir; daha fazla ondalığı olan bir toplam (örneğin 3 ondalıklı BHD kullanan bir mağazada) yuvarlanmak yerine reddedilir.

CorvusPay hesabı: bir CorvusPay satıcı hesabına ihtiyacınız var. CorvusPay her mağaza için, test ve canlı mağaza ayrı olmak üzere bir Store ID ve bir Secret Key verir; bunlar CorvusPay Merchant Center'da gösterilir. Eklentinin Success URL ve Cancel URL adreslerinin orada girilmesi gerekir (bkz. Yapılandırma).

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. wcp_corvuspay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > CorvusPay > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. CorvusPay test mağazanızın (ve canlı ödemeler için canlı mağazanın) Store ID ve Secret Key bilgilerini girin. Ayarlar sayfasında gösterilen Success URL ve Cancel URL adreslerini test ve canlı mağaza için CorvusPay Merchant Center'a kopyalayın.

6. Enable/Disable seçeneğini açın, bir test siparişi verin, ardından canlıya geçmek için Test Mode işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > CorvusPay. Sayfa, alanların üstünde test modu açıkken Test mode is on. ifadesini gösterir; ayrıca ağ geçidi etkin olduğu halde geçerli modun Store ID veya Secret Key alanı boşsa (bu durumda doldurulana kadar ödeme sayfasında gizlenir) ve mağaza para birimi CorvusPay tarafından desteklenmiyorsa sizi uyarır.

Genel

Enable/Disable: Enable CorvusPay Gateway ö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 (CorvusPay).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit or debit card via CorvusPay. Test modunda buna (Test mode — no real payment is taken.) eklenir.

Mağaza kimlik bilgileri

Store ID ve Secret Key, CorvusPay tarafından her mağaza için (test ve canlı ayrı ayrı) verilir ve CorvusPay Merchant Center'da gösterilir.

Test Mode: Enable test mode CorvusPay test ortamını (wallet.test.corvuspay.com) ve test Store ID ile Secret Key'i kullanır. Varsayılan: açık.

Test Store ID: CorvusPay test mağazanızın sayısal Store ID'si.

Test Secret Key: CorvusPay test mağazanızın HMAC-SHA256 imzaları için kullanılan Secret Key'i.

Live Store ID: CorvusPay canlı mağazanızın sayısal Store ID'si.

Live Secret Key: CorvusPay canlı mağazanızın HMAC-SHA256 imzaları için kullanılan Secret Key'i.

Store ID yalnızca rakamlardan oluşmalıdır. Başka bir şey girerseniz bir hata gösterilir ve önceki değer korunur. Bir ödeme her zaman yapıldığı mağazanın Secret Key'i ile doğrulanır; bu yüzden test siparişleri hâlâ açıkken test anahtarını dolu bırakın.

Success URL ve Cancel URL

Bu bölümde gösterilen iki adresi test ve canlı mağaza için CorvusPay Merchant Center'a kopyalayın. CorvusPay, ödemeden sonra müşteriyi bu adreslere geri yönlendirir.

Success URL: şuna benzer: https://your-site/wc-api/corvuspay_payment_success/. CorvusPay bu isteği imzalar; sipariş yalnızca imza doğrulandıktan sonra ödenmiş olarak işaretlenir.

Cancel URL: şuna benzer: https://your-site/wc-api/corvuspay_payment_cancel/. CorvusPay bunu imzalamaz; bu nedenle yalnızca bu mağaza tarafından verilmiş bir CorvusPay sipariş numarasına sahip, ödenmemiş bir siparişi iptal edebilir.

Ödeme

Transaction Type: kartın nasıl tahsil edileceği.

Sale (capture immediately): kart hemen tahsil edilir (varsayılan).

Authorize only (capture in Merchant Center): tutar yalnızca ayrılır. Sipariş beklemeye alınır; ödemeyi CorvusPay Merchant Center'da tahsil eder (tamamlar), ardından siparişi İşleniyor durumuna getirirsiniz.

Payment Page Language: CorvusPay ödeme sayfasının dili. Site language (varsayılan), CorvusPay destekliyorsa sitenizin geçerli dilini, desteklemiyorsa İngilizceyi kullanır. Ayrıca Hırvatça, İngilizce, Almanca, İtalyanca, Sırpça veya Slovence de seçebilirsiniz.

Order Status After Payment: başarılı bir Sale ödemesinden sonra siparişin durumu. Durum, ikinci bir durum değişikliği olmadan hemen ayarlanır.

Processing (WooCommerce default): varsayılan.

Completed: ödenen her sipariş Tamamlandı olur.

On Hold: ödenen her sipariş sizin elle incelemenizi bekler.

Gelişmiş

Logging: Enable debug logging WooCommerce > Status > Logs bölümüne, wcp_corvuspay_gateway kaynağıyla yazar. Hatalar her zaman günlüğe kaydedilir; gizli bilgiler ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). Devre dışı bırakma hiçbir şeyi silmez. Siparişlerde saklanan ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (CorvusPay)) ve siparişi verir. Sipariş Ödeme bekleniyor durumunda kalır; Pay for order sayfası Redirecting to CorvusPay for payment. Please wait... mesajını gösterir ve imzalı formu CorvusPay ödeme sayfasına gönderir. Yönlendirme başlamazsa müşteri Pay via CorvusPay düğmesine tıklar. Sipariş toplamı, para birimi, kısa bir sepet açıklaması ve fatura bilgileri (ödeme sayfasını önceden doldurmak için) gönderilir. Tutar değişmediği sürece aynı CorvusPay sipariş numarası yeniden kullanılır ve CorvusPay bunun için ikinci bir ödemeyi kabul etmez.

Ödemeden sonra CorvusPay müşteriyi Success URL'ye geri yönlendirir. Sipariş yalnızca CorvusPay onayladığında ödenmiş olarak işaretlenir: CorvusPay sipariş numarası bu sipariş için verilmiş olmalı, imza ödemenin yapıldığı mağazanın Secret Key'i ile eşleşmeli, tutar ve para birimi de siparişle uyuşmalıdır. Ardından müşteri sipariş alındı sayfasına ulaşır. Stok, ödeme onaylandığında düşürülür ve sepet sipariş alındı sayfasında boşaltılır.

Müşteri CorvusPay sayfasında iptal ederse ödenmemiş sipariş iptal edilir ve müşteri sepeti bozulmadan The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Ödeme Pay for order sayfasından başlatıldıysa ve sepet boşsa WooCommerce sepet sayfasında The CorvusPay payment was cancelled and the order was not paid. mesajını gösterir. Success URL isteği doğrulanamazsa müşteri We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again. mesajını görür ve sipariş değiştirilmez.

Ö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. Metinler Hırvatçaya çevrilmiştir.

Sipariş yalnızca CorvusPay müşteriyi Success URL'ye geri yönlendirdiğinde onaylanır; sunucudan sunucuya bildirim yoktur. Müşteri ödemeden hemen sonra tarayıcıyı kapatırsa sipariş Ödeme bekleniyor durumunda kalır. Eklentide WooCommerce üzerinden iade, tahsilat (capture) veya iptal (void) yoktur (CorvusPay sunucu API'si bir istemci sertifikası gerektirir); ayrıca kayıtlı kart, abonelik, taksit, IBAN / PIS veya CorvusWallet seçenekleri de yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri CorvusPay'e yönlendirildi ve henüz geri dönmedi. Müşteri ödeme yaptığı halde geri dönmediyse ödemeyi CorvusPay Merchant Center'da kontrol edin ve siparişi elle tamamlayın.

Processing, Completed veya On Hold: Sale ödemesi onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notu CorvusPay sipariş numarasını, onay kodunu ve kart türünü gösterir. Siparişin işlem kimliği, CorvusPay işlem kimliğidir; CorvusPay bir kimlik göndermezse, ödemenin Merchant Center'da bulunabileceği CorvusPay sipariş numarasıdır.

On hold, yetkilendirildi: Authorize only seçilidir. Ödemeyi CorvusPay Merchant Center'da tahsil edin, ardından siparişi İşleniyor durumuna getirin.

On hold, tutar/para birimi uyuşmazlığı: ödenen tutar veya para birimi siparişle uyuşmuyor. Ödemeyi CorvusPay Merchant Center'da doğrulamadan göndermeyin.

On hold, iptal edilmiş sipariş için ödeme: sipariş, örneğin ödenmemiş sipariş zaman aşımı nedeniyle iptal edildikten sonra başarılı bir ödeme geldi. Siparişi yerine getirin veya ödemeyi CorvusPay Merchant Center'da iade edin.

Cancelled: müşteri ödemeyi CorvusPay sayfasında iptal etti.

Zaten ödenmiş veya kapatılmış bir sipariş için başka, farklı bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, CorvusPay Merchant Center'ı kontrol etmenizi ve gerekirse mükerrer ödemeyi iade etmenizi ister.

Refunds: WooCommerce üzerinden iade, tahsilat ve iptal desteklenmez. Bunları CorvusPay Merchant Center'da yapın ve iadeyi WooCommerce'te elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > CorvusPay sayfasının üst kısmındadır. 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 denetlemek için Check now, başka bir anahtar girmek için Change key, 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. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan CorvusPay, 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 yine görür; 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ış ödemelerden dönen müşteriler işlenmeye devam eder.

Bir 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 denetlenir.

Sorun giderme

CorvusPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun Store ID ve Secret Key alanlarının dolu olduğunu (test modunda Test Store ID ve Test Secret Key, canlı modda Live Store ID ve Live Secret Key) ve mağaza para biriminin CorvusPay tarafından desteklendiğini kontrol edin. Ayarlar sayfası her durumda bir uyarı gösterir.

Ödeme gerçekleşti ama sipariş Ödeme bekleniyor durumunda kalıyor: büyük olasılıkla Success URL CorvusPay Merchant Center'a girilmemiştir veya WooCommerce'teki Secret Key mağazayla eşleşmiyordur. Logging seçeneğini açın ve WooCommerce > Status > Logs içinde, wcp_corvuspay_gateway kaynağında INVALID signature arayın. Müşteri geri dönmeden önce tarayıcıyı kapattıysa sipariş yine beklemede kalır; bu durumda ödemeyi Merchant Center'da kontrol edin ve siparişi elle tamamlayın.

Müşteri We could not confirm this CorvusPay payment mesajını görüyor: Success URL isteği reddedildi: gerekli alanlar eksikti, CorvusPay sipariş numarası bu sipariş için verilmemişti, o mağazanın Secret Key'i boş veya imza eşleşmedi. Sipariş değiştirilmez. Günlük nedeni gösterir.

Müşteri This order total cannot be paid via CorvusPay mesajını görüyor: toplam sıfırdır veya 2'den fazla ondalığa sahiptir.

Müşteri CorvusPay is not configured veya CorvusPay does not accept payments in … mesajını görüyor: geçerli modun Store ID veya Secret Key alanı eksik ya da sipariş para birimi desteklenmiyor.

Sipariş On hold durumunda: sipariş notunu okuyun. Authorize only seçilidir, ödenen tutar veya para birimi siparişle uyuşmadı ya da ödeme sipariş iptal edildikten sonra geldi.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar zaten başka bir alan adında kullanılıyorsa vibefox.net hesabınızda bir 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şılamazsa eklenti bilinen son 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ıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlük dosyaları yalnızca Delete Data açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için kalır. Siparişlerde saklanan ödeme verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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