VibeFox Moneris for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Kanadalı bir Moneris hesabı için CAD, eski bir Moneris USA hesabı için USD. Ağ geçidi yalnızca sipariş para birimi hesapla eşleştiğinde gösterilir.

HTTPS ve PCI DSS: Kart numaraları ödeme sayfanızda girilir ve sunucunuzdan geçer. Canlı ödemeler için HTTPS ve PCI DSS SAQ D uyumluluğu gerekir. Bunu sağlayamıyorsanız barındırılan bir ödeme sayfası çözümü kullanın.

Moneris hesabı: Moneris Merchant Resource Center > Admin > Store Settings bölümünden alacağınız Moneris Gateway mağazanızın Store ID ve API Token bilgilerine ihtiyacınız vardır. Test için herkese açık Moneris test mağazası varsayılan olarak doldurulmuştur. Test kimlik bilgileri ve test kartları Moneris geliştirici portalındadı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_moneris_gateway klasörünü FTP ile /wp-content/plugins/ klasörüne de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Moneris > 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. Hesap ülkesini seçin, Live Store ID ve Live API Token alanlarını doldurun. Test modu varsayılan olarak açıktır ve herkese açık test mağazasını kullanır (Kanada için store5 / yesguy, ABD için monusqa002 / qatoken).

6. Purchase veya Pre-Authorization ile kart logolarını seçin, ardından Enable / Disable seçeneğini etkinleştirin.

7. Bir Moneris test kartıyla test siparişi verin, sonra Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Moneris. Test modu açıkken sayfa alanların üstünde Moneris gateway is in TEST MODE. No real charges will be made. ifadesini gösterir. Canlı modda, canlı alanlar Moneris test kimlik bilgileri içerdiğinde (bu durumda ağ geçidi ödeme sayfasında gizlenir) ve site HTTPS kullanmadığında uyarır. Mağaza para birimi Moneris hesabının para birimi değilse de uyarır; bu durumda ağ geçidi ödeme sayfasında gizlenir.

Genel

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

Title: müşterinin gördüğü ödeme yöntemi adı. Varsayılan: Credit card (Moneris). Test modunda ödeme sayfasında başlığa (Test Mode) eklenir.

Description: ödeme sayfasında kart alanlarının üstünde gösterilen metin. Varsayılan: Pay securely with your credit card.

Moneris hesabı

Store ID ve API Token bilgileriniz, Moneris Merchant Resource Center'da Admin > Store Settings altında bulunur. Test kimlik bilgileri ve test kartları Moneris geliştirici portalındadır. Bu bölüm ikisine de bağlantı içerir.

Moneris account country: Kanada hesapları CAD, ABD hesapları USD ile tahsilat yapar. Ağ geçidi yalnızca sipariş para birimi eşleştiğinde gösterilir. Varsayılan: Canada (CAD).

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). İadeler, tahsilatlar ve iptaller her zaman ödemenin yapıldığı ortama gönderilir. Müşteriler kart alanlarının üstünde TEST MODE: use a Moneris test card, no real charges are made. ifadesini görür. Varsayılan: açık.

Live Store ID: canlı ortam Store ID'si, örneğin monca01234.

Live API Token: canlı ortam API Token'ı.

Test Store ID: herkese açık Moneris test mağazası: store5 (Kanada) veya monusqa002 (ABD). Varsayılan: store5.

Test API Token: herkese açık test token'ı: yesguy (Kanada) veya qatoken (ABD). Varsayılan: yesguy.

Ödeme

Transaction type: kartın nasıl tahsil edileceği. Varsayılan: Purchase.

Card logos: ödeme yöntemi başlığının yanında gösterilen kart markası logoları: Visa, Mastercard, Discover, American Express, JCB. Kabul edilen markalar Moneris hesabınıza bağlıdır. Varsayılan: Visa and Mastercard.

Gelişmiş

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Hatalar her zaman kaydedilir. Günlüğü WooCommerce > Status > Logs bölümünde, kaynak wcp_moneris_gateway olarak görebilirsiniz. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit card (Moneris)) ve kart numarasını, son kullanma tarihini ve güvenlik kodunu ödeme sayfanızdaki WooCommerce kart formuna girer. Sipariş verildiğinde sunucunuz kartı sipariş toplamı için Moneris'e gönderir ve sonucu anında alır. Yönlendirme ya da webhook yoktur. Güvenlik kodu (CVD) her zaman gönderilir, bu nedenle Moneris mağazanızın eFraud kuralları geçerli kalır.

Onaylı bir ödeme, yalnızca Moneris işlemin tamamlandığını bildirdiğinde ve işlenen tutar sipariş toplamına eşit olduğunda ödenmiş olarak işaretlenir. Ardından müşteri sipariş alındı sayfasına gider. Pre-Authorization ile sipariş, tutarı tahsil edene kadar Beklemede kalır.

Kart reddedilirse müşteri Moneris'in bildirdiği nedenle birlikte Your card was declined mesajını görür ve kart bilgilerini kontrol edebilir ya da başka bir kart kullanabilir. Moneris isteği işleyemezse (örneğin yanlış Store ID veya API Token nedeniyle), müşteri The payment could not be processed. Please try again or use another payment method. mesajını görür. Neden, sipariş notlarına ve günlüğe eklenir. Bir ödeme işlenirken ikinci kez tıklanırsa A payment for this order is already being processed. Please wait a moment and check your order status before trying again. mesajı gösterilir. Ödenmiş veya ön provizyonlu bir sipariş asla yeniden tahsil edilmez.

Moneris yanıt vermezse (ağ hatası veya zaman aşımı), eklenti işlemin gerçekleşip gerçekleşmediğini öğrenmek için Moneris'e bir Status Check gönderir. Bu da mümkün değilse sipariş, Moneris sipariş kimliğiyle birlikte Beklemede durumuna geçer ve müşteriden ikinci kez ödeme yapması istenmez.

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

Eklenti kayıtlı kartları ve Moneris Vault'u, WooCommerce Subscriptions'ı, Apple Pay, Google Pay veya Interac Online'ı, Moneris Checkout veya Hosted Tokenization'ı, 3-D Secure, AVS veya Kount'u ve çok para birimli fiyatlandırmayı desteklemez.

Siparişler ve iadeler

Sipariş durumları

Ödeme bekliyor: sipariş oluşturuldu, ancak kart henüz tahsil edilmedi; örneğin reddedilen bir denemeden sonra. Sipariş notu Moneris kodunu ve mesajını gösterir. Müşteri yeniden ödeyebilir.

İşleniyor: satın alma onaylandı. Yalnızca sanal indirilebilir ürün içeren siparişler, WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notu tutarı, Moneris işlem kimliğini ve makbuzu gösterir. İşlem kimliği, Moneris işlem numarasıdır.

Beklemede: ön provizyon onaylandı ve tahsilat bekliyor, işlenen tutar sipariş toplamından farklıydı ya da Moneris sonucu onaylamadı. Sipariş notu bunu açıklar.

İptal edildi: ön provizyonlu bir sipariş için iptal, ayrılan tutarı serbest bırakır (void).

Tahsilat ve iptal (void)

Bir ön provizyonu tahsil etmek için sipariş durumunu İşleniyor veya Tamamlandı olarak değiştirin ya da sipariş işlemlerinden Capture Moneris pre-authorization seçeneğini seçin. Mevcut sipariş toplamından iadeler düşülerek tahsil edilir; ayrılan tutar yetkilendirilen tutarı aşamaz. Moneris tahsilatı reddederse durum bir notla birlikte Beklemede durumuna döner ve işleniyor ya da tamamlandı e-postası gönderilmez. Moneris ön provizyonları birkaç gün içinde sona erer, bu nedenle zamanında tahsil edin.

Tutarları serbest bırakmak için siparişi iptal edin ya da sipariş işlemlerinden Void Moneris pre-authorization (cancel order) seçeneğini seçin. Siparişi İade edildi durumuna getirmek de açık bir ön provizyonu serbest bırakır. Serbest bırakma başarısız olursa bir not, bunu Merchant Resource Center'da yapmanızı ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit card (Moneris) düğmesine tıklayın (düğmede Title alanınız görünür). Tam ve kısmi iadeler desteklenir. Bir ön provizyon yalnızca tahsil edildikten sonra iade edilebilir; bunun öncesinde tutarları serbest bırakmak için siparişi iptal edin. İade, ödemenin yapıldığı ortama ve hesaba gönderilir; bu nedenle o modun kimlik bilgileri girilmiş olmalıdır. Moneris iadeyi kabul etmezse WooCommerce nedeniyle birlikte Refund failed gösterir ve iade kaydedilmez. Başarılı bir iade, Moneris işlem kimliğiyle birlikte sipariş notlarına eklenir.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Moneris sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu) ve alan adınızı gösterir. Durumu yeniden kontrol etmek 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 tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Moneris ö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 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: tahsilatlar, iptaller ve iadeler çalışmaya 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

Moneris ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modda Store ID ile API Token bulunduğunu kontrol edin. Canlı modda canlı alanlar, Moneris test kimlik bilgileri değil, canlı kimlik bilgilerinizi içermelidir. Mağaza para birimini (ya da Pay for order sayfasındaki sipariş para birimini) hesap para birimiyle karşılaştırın: Kanada için CAD, ABD hesabı için USD. Para birimi eşleşmiyorsa ayarlar sayfası bir uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş Ödeme bekliyor veya Beklemede durumunda kaldı: eklentinin webhook'u yoktur; sonuç yalnızca Moneris yanıtından gelir. Sipariş, Moneris'in sonucu onaylamadığını belirten bir notla Beklemede durumundaysa Moneris yanıt vermemiş ve Status Check de başarısız olmuştur. Nottaki Moneris sipariş kimliğini Merchant Resource Center'da arayın: işlem oradaysa siparişi gönderin (gerekirse orada iade edin); yoksa siparişi iptal edin ya da müşteriden yeniden ödeme yapmasını isteyin.

Müşteri Payment gateway is misconfigured. Please contact the store administrator. mesajını görüyor: geçerli modun kimlik bilgileri eksik ya da canlı mod açık ve canlı alanlarda Moneris test kimlik bilgileri var. Canlı Store ID ve API Token bilgilerinizi girin.

Müşteri This payment method does not support the order currency. mesajını görüyor: sipariş para birimi Moneris hesabının para birimi değil.

Müşteri ödeme sırasında bir hata görüyor: sipariş notlarını açın ya da Debug log seçeneğini etkinleştirip WooCommerce > Status > Logs bölümünde kaynak wcp_moneris_gateway kayıtlarına bakın.

Tahsilat başarısız oluyor: siparişte tahsil edilmeyi bekleyen bir ön provizyon yok, sipariş toplamı sıfır ya da tutar yetkilendirilen tutardan büyük. Ayrıca Moneris ön provizyonları birkaç gün içinde sona erer.

İade, tahsilat ya da iptal mod ya da hesapla ilgili bir mesajla başarısız oluyor: ödeme test ya da canlı modda yapıldı ve o modun kimlik bilgileri girilmemiş, ya da ödeme diğer ülkenin bir Moneris hesabıyla yapıldı. Kimlik bilgilerini girin ya da ödemeyi Merchant Resource Center'da işleyin.

Kart deneme saldırıları: doğrudan kart formları kart deneme saldırılarının hedefidir. WooCommerce ödeme sayfası hız sınırlamasını, bir CAPTCHA eklentisini ve Moneris hesabınızdaki eFraud ya da velocity kurallarını etkinleştirin.

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 yer açı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şı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 eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall seçeneği açıksa silinir. Aksi halde ileride yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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