VibeFox Moneris for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: SimpleXML uzantılı 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde ya da SimpleXML olmadan kurulmaz.

Mağaza para birimi: Kanada Moneris hesabı için CAD, eski bir Moneris USA hesabı için USD. Ödeme yöntemi yalnızca sepet para birimi hesap para birimiyle aynı olduğunda 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 bunun yerine barındırılan bir ödeme sayfası çözümü kullanın.

Moneris hesabı: Moneris Gateway mağazanızın Store ID ve API Token bilgilerine ihtiyacınız var; bunları Moneris Merchant Resource Center > Admin > Store Settings bölümünde bulabilirsiniz. Test için Moneris'in herkese açık 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 bir alan adında çalışır.

Kurulum

1. Back Office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Moneris Gateway öğesini 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, ardından Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Hesap ülkesini seçin ve Live Store ID ile 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).

5. Purchase veya Pre-Authorization ile kart logolarını seçin, ardından Enable / Disable seçeneğini açın ve Save düğmesine tıklayın.

6. Moneris test kartıyla bir test siparişi verin, ardından Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Moneris payment authorized ve Moneris payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için varsayılan olarak etkinleştirir. Bunu Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Moneris 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 sayfa, alanların üstünde Moneris gateway is in TEST MODE. No real charges will be made. uyarısını gösterir. Canlı modda, canlı alanlar Moneris test kimlik bilgileri içeriyorsa (bu durumda ödeme yöntemi sipariş ödeme adımında gizlenir) ve mağaza için SSL etkin değilse uyarır. Mağazanın varsayılan para birimi Moneris hesabının para birimi değilse de uyarır; bu durumda ödeme yöntemi diğer para birimleri için sipariş ödeme adımında gizlenir.

Moneris

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

Title: müşteriye gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit card (Moneris). Test modunda başlığa (Test Mode) eklenir. Zorunlu.

Description: sipariş ödeme adımı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 bilgilerinizi Moneris Merchant Resource Center'da Admin > Store Settings altında bulabilirsiniz. Test kimlik bilgileri ve test kartları Moneris geliştirici portalındadır. Bölümde ikisine de bağlantılar vardır.

Moneris hesap ülkesi: Kanada hesapları CAD, ABD hesapları USD ile tahsilat yapar. Ödeme yöntemi yalnızca sepet para birimi eşleştiğinde gösterilir. Varsayılan: Canada (CAD).

Test mode: Moneris QA geçidini ve test kimlik bilgilerini kullanır; gerçek tahsilat yapılmaz. Tahsilatlar, iptaller ve iadeler 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: üretim Store ID'si, örneğin monca01234.

Live API Token: üretim API Token'ı.

Test Store ID: Moneris'in herkese açık 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.

Kaydedilmiş API token'lar bir daha asla 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 tokens: bir token'ı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Ödeme

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

Card logos: sipariş ödeme adımında ödeme yöntemiyle birlikte gösterilen kart markaları: Visa, Mastercard, Discover, American Express, JCB. Kabul edilen markalar Moneris hesabınıza bağlıdır. Varsayılan: Visa ve Mastercard.

Gelişmiş

Debug log: API isteklerini ve yanıtlarını modül klasöründeki logs/wc_mng_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Kart numarası, CVV, son kullanma tarihi ve API token maskelenir. Hatalar bu seçenek kapalıyken de her zaman kaydedilir. 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.

Delete data on uninstall: açıksa modül kaldırıldığında geçit ayarları ve günlük silinir. Siparişlerin Moneris verileri (iadeler için gerekir) ve sipariş durumları her zaman korunur. Varsayılan: kapalı.

Sipariş ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan Credit card (Moneris)) ve seçeneğin altındaki kart formunda Card number, Expiry (MM/YY) ve Card code (CVC) alanlarını doldurur. Üç alan da zorunludur. Sipariş verildiğinde sunucunuz kartı sepet toplamı için Moneris'e gönderir ve sonucu anında alır. Yönlendirme ve webhook yoktur. Kart verileri yalnızca bu tek istek için kullanılır; hiçbir zaman saklanmaz ve günlükte yalnızca son dört hane görünür.

Sipariş yalnızca onaylı bir Moneris yanıtından oluşturulur. Müşteri ardından standart sipariş onay sayfasını görür. Pre-Authorization ile sipariş, tutarı tahsil edene kadar Moneris payment authorized durumunda bekler. Moneris sepet toplamından farklı bir tutar işlediyse ya da ödeme sırasında sepet değiştiyse sipariş, bir notla birlikte Moneris payment on hold durumunda oluşturulur.

Kart reddedilirse müşteri Your card was declined ve Moneris'in verdiği nedenle birlikte ödeme sayfasında kalır; kart bilgilerini kontrol edebilir veya başka bir kart kullanabilir. Sipariş oluşturulmaz. 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 günlüğe yazılır. Hatalı kart bilgileri Invalid card number. veya Invalid card expiry date. gibi kısa mesajlar verir ve Moneris'e hiçbir şey gönderilmez.

Bir ödeme işlenirken ikinci bir tıklama ya da ikinci bir tarayıcı sekmesi A payment for this order is already being processed. Please wait a moment and check your order status before trying again. mesajını gösterir. Zaten siparişi olan bir sepet bir daha asla tahsil edilmez; müşteri mevcut siparişe yönlendirilir.

Moneris yanıt vermezse (ağ hatası veya zaman aşımı), modül işlemin tamamlanıp tamamlanmadığını öğrenmek için aynı Moneris sipariş kimliğiyle Moneris'e bir Status Check gönderir. Moneris'te böyle bir işlem yoksa müşteri yeniden ödeme yapabilir. Status Check da yanıt alamazsa sipariş, Moneris sipariş kimliğiyle birlikte Moneris payment on hold durumunda oluşturulur ve müşteriden ikinci kez ödeme yapması istenmez.

Modül kayıtlı kartları ve Moneris Vault'u, abonelikleri, 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ı

No order yet: kart reddedildi ya da işlenmedi. Yalnızca sepet ve günlükteki deneme vardır. Müşteri yeniden ödeme yapabilir.

Payment accepted: satın alma onaylandı. Ödeme, Moneris işlem numarası işlem kimliği olarak kaydedilir.

Moneris payment authorized: ön provizyon onaylandı ve tahsilat bekliyor. Henüz bir ödeme kaydedilmedi.

Moneris payment on hold: işlenen tutar sepet toplamından farklıydı, ödeme sırasında sepet değişti, Moneris sonucu onaylamadı veya tahsilat başarısız olmasına rağmen PrestaShop ödenmiş bir durum yazdı. Notlar bunu açıklar. Farklı tutarlı bir satın almada ödeme, Moneris'in işlediği tutarla kaydedilir.

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

Refunded: ödeme modül üzerinden tamamen iade edildi.

Moneris ödeme bloğu

Sipariş sayfasında Moneris payment bloğu görünür: Moneris sipariş kimliği, hesap ülkesi ve modu, test ödemeleri için Test mode rozeti, Trans ID (ve tahsilattan sonra ön provizyon Trans ID'si), işlem türü ve durumu (tahsil edilmedi, tahsil edildi veya serbest bırakıldı), makbuz ve kart türü, işlenen tutar, sipariş toplamı ve iade edilen tutar, iade geçmişi ve siparişin Moneris notes bölümü görünür. Onaylanmamış bir ödeme için blok, Merchant Resource Center'da Moneris sipariş kimliğini aramanızı ister. Bloktaki tüm işlemler yalnızca sipariş düzenleme yetkisi gerektirir.

Tahsilat ve iptal

Bir ön provizyonu tahsil etmek için bloktaki Capture payment düğmesine tıklayın ve onaylayın ya da siparişi Ödeme kabul edildi, Kargoya verildi veya Teslim edildi gibi ödenmiş bir duruma getirin. Sipariş toplamı, iadeler düşülerek tahsil edilir; onaylanan tutardan fazla olamaz. Düğmeyle tahsilattan sonra sipariş Payment accepted olur; ödeme, tahsilatın Trans ID'siyle kaydedilir. Moneris tahsilatı reddederse durum değişmez, ödenmiş durum e-postası gönderilmez ve bir not nedenini açıklar: Status not changed: the Moneris pre-authorization could not be captured, ardından neden. Moneris ön provizyonları birkaç gün içinde sona erer, bu yüzden zamanında tahsil edin.

Tutarı serbest bırakmak için Void pre-authorization (cancel order) düğmesine tıklayın ya da siparişi Canceled durumuna getirin. Siparişi Refunded 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

Moneris payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Moneris düğmesine tıklayın. Refund this amount through Moneris? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İadeler, Moneris'in gerçekten tahsil ettiği tutarla sınırlıdır; bu yüzden tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin ödediği tutara kadar iade yapabilirsiniz. Ön provizyon yalnızca tahsil edildikten sonra iade edilebilir; bundan önce tutarı serbest bırakmak için siparişi iptal edin. İade, ödemenin yapıldığı ortama ve hesaba gönderilir, bu nedenle o modun kimlik bilgileri doldurulmuş olmalıdır. Moneris iadeyi kabul etmezse blok nedenle birlikte Refund failed gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Moneris Trans ID'siyle eklenir. Tam iade siparişi Refunded durumuna getirir; kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Moneris üzerinden para geri göndermez.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Moneris Gateway lisans bloğu, Modules > Module Manager > VibeFox Moneris Gateway > Configure 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 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, anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-moneris 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 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 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: çok mağazalı kurulumda ana mağazanın alan adında. 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 Moneris, sipariş ö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 sipariş ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: önceki ödemelerin tahsilatları, iptalleri ve iadeleri çalışmaya devam eder.

Lisans süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum 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 her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Moneris sipariş ö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 Store ID ve API Token içerdiğini kontrol edin. Canlı modda canlı alanlar, Moneris test kimlik bilgileri değil, üretim kimlik bilgilerinizi içermelidir. Sepet para biriminin hesap para birimi olduğunu kontrol edin: Kanada için CAD, ABD hesabı için USD. Payment > Preferences bölümünde modülün bu para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş Moneris payment on hold durumunda: modülde webhook yoktur; sonuç yalnızca Moneris yanıtından gelir. Bloktaki Moneris notes bölümünü okuyun. Moneris sonucu onaylamadıysa Moneris yanıt vermemiş ve Status Check de başarısız olmuştur. Merchant Resource Center'da Moneris sipariş kimliğini arayın: işlem oradaysa siparişi gönderin (gerekirse orada iade edin); yoksa siparişi iptal edin veya müşteriden yeniden ödeme yapmasını isteyin. Tutar farklıysa siparişi kontrol edin ve yerine getirin ya da ödemeyi iade edin.

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, canlı alanlarda Moneris test kimlik bilgileriyle açık. Üretim Store ID'nizi ve API Token'ınızı girin.

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

Müşteri ödeme yaparken bir hata görüyor: modül sayfasındaki Log alanına bakın. Hatalar her zaman yazılır; tam istekleri ve yanıtları görmek için Debug log seçeneğini açın.

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

İade, tahsilat veya iptal mod ya da hesapla ilgili bir mesajla başarısız oluyor: ödeme test veya 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 veya ödemeyi Merchant Resource Center'da işleyin.

Kart deneme saldırıları: doğrudan kart formları kart deneme saldırılarının hedefidir. Moneris hesabınızdaki eFraud veya velocity kurallarını ve mağazanız için bir CAPTCHA ya da istek sınırlama modülünü kullanın.

Kaldırma

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

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