VibeFox Nexi XPay 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.

Para birimi: sepetin para birimi EUR olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Nexi XPay hesabı: terminalinizin alias (terminal kimliği) ve MAC anahtarına sahip bir Nexi XPay satıcı hesabına ("Pagamento Semplice" yönlendirme entegrasyonu) ihtiyacınız vardır. Test ve canlı kimlik bilgileri ayrıdır: test bilgileri Nexi XPay test alanından veya geliştirici portalından (developer.nexi.it) alınır, canlı bilgiler ise satıcı hesabı etkinleştirildikten sonra Nexi XPay yönetim panelinden alınır. Nexi yönetim panelinde herhangi bir ayar yapılması gerekmez: bildirim adresi her ödemeyle birlikte gönderilir.

Herkese açık site: bildirim URL'sine internetten erişilebilmelidir; Nexi'yi engelleyen temel kimlik doğrulama veya güvenlik duvarı kuralı olmamalıdır. Mağazanın bakım modu bunu engellemez. Bildirim mağazaya ulaşamazsa, ödeme yine de imzalı müşteri dönüşüyle onaylanır.

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

Kurulum

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

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

4. Test Mode seçeneğini açık tutun ve test alias ile MAC anahtarını girin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi oluşturun. Her şey çalıştığında canlı alias ve MAC anahtarını girin ve Test Mode seçeneğini kapatın.

Kurulum sırasında modül iki sipariş durumu oluşturur: Awaiting Nexi XPay payment ve Nexi XPay payment on hold. 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. Modül kurulduktan sonra mağazada etkinleştirilen bir ülke de orada işaretlenmelidir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Nexi XPay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, test modu açıkken Test mode is on: payments go to the Nexi XPay test environment, no real money is charged. mesajını gösterir. Ağ geçidi etkinken ancak geçerli modun alias veya MAC anahtarı boşsa ya da mağazanın varsayılan para birimi EUR değilse uyarır. Bu durumlarda ödeme yöntemi ödeme sayfasında gizlenir. Yapıştırılan değerlerin etrafındaki boşluklar ve satır sonları kaydetme sırasında silinir.

Nexi XPay

Enable/Disable: Enable Nexi XPay Gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit Card (Nexi). Test modunda ödeme sayfası ve sipariş başlığa (TEST MODE) ekler.

Description: ödeme sayfasında müşteriye gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely with your credit card via Nexi XPay.

Test ortamı

Test ödemeleri int-ecommerce.nexi.it adresine gider ve gerçek kartlardan asla tahsilat yapmaz. Test alias ve MAC anahtarını Nexi XPay test alanından veya geliştirici portalından (developer.nexi.it) alın.

Test Mode: Nexi XPay test ortamını ve test kimlik bilgilerini kullanır. Canlı kimlik bilgileriyle gerçek ödemeleri kabul etmek için kapatın. Varsayılan: on.

Test Alias: Nexi XPay test terminalinizin alias (terminal kimliği) değeri.

Test MAC Key: Nexi XPay test terminalinizin MAC hesaplama anahtarı.

Canlı ortam

Canlı alias ve MAC anahtarı, satıcı hesabınız etkinleştirildikten sonra Nexi XPay yönetim panelinizde (ecommerce.nexi.it) gösterilir.

Live Alias: Nexi XPay canlı terminalinizin alias (terminal kimliği) değeri.

Live MAC Key: Nexi XPay canlı terminalinizin MAC hesaplama anahtarı.

Kayıtlı MAC anahtarları 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.

Kayıtlı gizli bilgileri temizle: kayıtlı bir anahtarı silmek için Test MAC Key veya Live MAC Key seçeneğini işaretleyin ve Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Ödeme

Notification URL: bilgi amaçlı gösterilir. Her ödemeyle birlikte Nexi'ye gönderildiği için Nexi yönetim panelinde bir şey yapılandırmanız gerekmez. Dostça URL'ler kullanıldığında şuna benzer: https://your-shop/module/wcp_nexi_gateway/s2s?id_cart={id_cart}; başında /it/ gibi bir dil kodu ve sonunda sepet numarası olabilir. Nexi, ödeme sonucunu bu URL'ye sunucudan sunucuya gönderir ve müşterinin dönüşüyle de iletir. İkisi de aynı şekilde imzalanır ve ödemenin yapıldığı ortamın MAC anahtarı, o ortamın alias değeri ve o sepet için düzenlenmiş işlem koduyla doğrulanır. Doğrulamayı geçemeyen sonuçlar reddedilir ve hiçbir şeyi değiştirmez.

Capture: paranın ne zaman tahsil edileceği.

Order Status After Payment: başarılı bir ödemeden sonra siparişin durumu.

Gelişmiş

Debug Log: ödeme olaylarını modül klasöründeki logs/nexi_ip_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. MAC anahtarları, MAC değerleri, kart bilgileri ve e-posta adresleri kaydedilmez. Hatalar ve uyarılar, örneğin başarısız bir MAC doğrulaması, seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: off.

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

Delete Data on Uninstall: açıkken modülü kaldırmak tüm modül ayarlarını ve günlüğü siler. Siparişlerdeki Nexi XPay ödeme verileri ve sipariş durumları korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak Credit Card (Nexi)) seçer ve onaylar. Sonraki sayfa Redirecting to Nexi XPay for payment... mesajını gösterir ve müşteriyi otomatik olarak Nexi XPay sayfasına gönderir; alternatif olarak bir Pay Now düğmesi bulunur. Ödeme, sepet toplamı için EUR cinsinden, yeni bir işlem koduyla, müşterinin e-posta adresi, Cart açıklaması, sepet numarası ve mağazanızın adıyla gönderilir. Nexi sayfası, sepet dili İtalyanca, İngilizce, İspanyolca, Fransızca, Almanca, Japonca, Çince, Arapça, Rusça veya Portekizce ise o dilde açılır; aksi halde İngilizce açılır. Bu noktada henüz bir sipariş yoktur.

Müşteri öder ve mağazanıza geri döner. Sipariş, sepet tutarı ve para birimiyle doğrulanmış bir Nexi sonucu alındığında ödenmiş olarak işaretlenir: sunucudan sunucuya bildirimden ya da imzalı müşteri dönüşünden, hangisi önce gelirse. Ardından sipariş oluşturulur ve müşteri Your Nexi XPay payment has been received. mesajının yer aldığı standart sipariş onay sayfasını görür. Nexi ödemeyi beklemede olarak bildirirse sayfa Your payment is pending confirmation from Nexi XPay. We will update your order as soon as the payment is confirmed. mesajını gösterir. Beklemedeki (ertelenmiş tahsilat veya manuel inceleme) bir sipariş için We have received your Nexi XPay payment authorization. Your order will be processed shortly. mesajını gösterir. Bekleyen bir ödeme daha sonra başarısız olursa sayfa The payment was not completed. Please contact us. mesajını gösterir.

Müşteri döndüğünde sonuç henüz işlenmemişse We have not received the payment confirmation from Nexi XPay yet. If you completed the payment, your order will be updated shortly. mesajını ve Check again düğmesini içeren bir sayfa açılır. Bildirim geldiği anda siparişi oluşturur.

Ödeme reddedilirse veya müşteri Nexi sayfasında iptal ederse, ödeme sayfasına döner ve şu mesajlardan birini görür: The payment was not completed. Please try again or choose a different payment method., Payment was cancelled. Please try again. veya We could not confirm the payment. If your card was charged, please contact us before paying again. Sipariş oluşturulmaz ve sepet korunur; böylece müşteri yeniden ödeme yapabilir. Sepetin zaten bir siparişi varsa (örneğin başka bir sekmede ödenmişse), müşteri yeni bir ödeme yerine sipariş onayına yönlendirilir.

Modül geçerli mod için yapılandırılmamışsa müşteri This payment method is not available right now. Please choose another payment method. 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ül ödemeleri yalnızca Nexi XPay sayfasında kabul eder. PrestaShop üzerinden iade, kayıtlı kart veya OneClick, abonelik veya tekrarlayan ödeme, Pay-By-Link, XPay Build gömülü alanları ve PrestaShop'ta seçilen ödeme yöntemleri yoktur: Nexi sayfası, terminalinizde etkin olan yöntemleri gösterir.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: Müşteri Nexi'ye yönlendirildi ve ödeme yapmadı, iptal etti veya reddedildi ya da Nexi henüz ödemeyi onaylamadı. Yalnızca sepet vardır.

Payment accepted, Delivered or Nexi XPay payment on hold: Nexi ödemeyi onayladı. Durum, Order Status After Payment ayarını izler. Ödeme, Nexi işlem kodu işlem kimliği olarak kaydedilir ve bir notta yetkilendirme kodu, işlem kodu, kart markası ve Nexi mesajı gösterilir.

Nexi XPay payment on hold (authorized): ertelenmiş tahsilat seçilidir ve ödeme yalnızca yetkilendirilmiştir. Sipariş sayfasında Capture Nexi XPay payment ile tahsil edin.

Awaiting Nexi XPay payment: Nexi ödemeyi onay beklerken olarak bildirdi. Sipariş, nihai sonuçla güncellenir.

Nexi XPay payment on hold after payment: Nexi'den alınan tutar veya para birimi sepetle uyuşmadı (sipariş ödenmiş olarak işaretlenmez) ya da zaten iptal edilmiş bir sipariş için başarılı bir ödeme geldi. Not nedenini açıklar. Nexi XPay yönetim panelinde ödemeyi kontrol edin ve siparişi işleyin ya da iade edin.

Ödeme hatası: Bekleyen bir ödeme başarısız oldu. Aynı sepet yeniden ödenemez; bu nedenle müşterinin yeni bir sipariş vermesi gerekir.

Ödenmiş bir sipariş, sonradan gelen bir hatayla asla düşürülmez. Zaten ödenmiş bir sipariş için başka bir başarılı ödeme gelirse, bir not bunun bir kopya olması durumunda Nexi XPay yönetim panelinden iade etmenizi ister.

Nexi XPay ödeme bloğu

Sipariş sayfasında Nexi XPay payment bloğu gösterilir; bu blok işlem kodunu (codTrans), durumu ve Nexi sonucunu, tahsilat modunu, Nexi'ye gönderilen ve alınan tutarı, yetkilendirme kodunu, kart markasını, Nexi mesajını ve tarihi, test ödemeleri için bir Test environment rozetini ve siparişin Nexi XPay notes bölümünü içerir.

Ertelenmiş tahsilat

Beklemedeki yetkilendirilmiş bir sipariş için bloktaki Capture Nexi XPay payment düğmesine tıklayın (düğme tutarı gösterir) ve Capture the authorized amount through Nexi XPay? sorusunu onaylayın. Siparişleri düzenleme yetkisine sahip olmanız gerekir. Modül, yetkilendirilmiş tutarı ödemenin ortamında, o ortamın anahtarlarıyla tahsil eder, ödemeyi kaydeder ve durumu Order Status After Payment ayarına göre belirler. Tahsilat başarısız olursa blok hatayı gösterir, bir not eklenir ve sipariş beklemede kalır. Aynı ödemenin ikinci kez tahsil edilmesi reddedilir.

İadeler

İadeler PrestaShop'tan yapılmaz; bu nedenle Nexi XPay için bir iade düğmesi yoktur. İadeyi Nexi XPay yönetim panelinde yapın, ardından PrestaShop'a elle kaydedin. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Nexi üzerinden para göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Nexi XPay Gateway lisans bloğu, Modules > Module Manager > VibeFox Nexi XPay 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, maskelenmiş anahtarı, durumu (örneğin lisansın geçerli olduğu son tarihi ve alan adınızı) ve 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 düğmelerini gösterir. Bunların altında Product: presta-payment-nexi satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya 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: ana mağazanın alan adında; çok mağazalı kurulumda da durum böyledir. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Nexi XPay, ö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. PrestaShop vitrini, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfası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 yine onaylanır ve yetkilendirilmiş ödemeler tahsil edilebilir.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Nexi XPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda her iki kimlik bilgisinin de bulunduğunu (test modunda Test Alias ve Test MAC Key, canlı modda Live Alias ve Live MAC Key) ve sepet para biriminin EUR olduğunu kontrol edin. Ayarlar sayfası bu durumlarda uyarı gösterir. Payment > Preferences bölümünde modülün EUR, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: ne bildirim ne de müşterinin dönüşü kabul edildi. Mağazanın internetten erişilebilir olduğunu, MAC anahtarı ve alias değerinin ödemenin ortamıyla (test veya canlı) eşleştiğini kontrol edin ve modül sayfasındaki Log alanında Nexi'nin ne gönderdiğini görmek için Debug Log seçeneğini açın.

Bildirim invalid_mac veya invalid_alias yanıtı veriyor: Ayarlardaki MAC anahtarı veya alias, sonucu gönderen terminalle eşleşmiyor. Nexi test alanından veya yönetim panelinden yeniden kopyalayın.

Bildirim unknown_transaction yanıtı veriyor: İşlem kodu, bu mağaza tarafından o sepet için düzenlenmemiş. Sonuç yok sayılır.

Bildirim not_configured veya busy yanıtı veriyor: Ödemenin ortamının alias veya MAC anahtarı boş ya da sipariş tam o sırada başka bir istek tarafından güncelleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Nexi bildirimi yeniden dener.

Bildirim URL'si tarayıcıda method_not_allowed gösteriyor: Bu normaldir. URL yalnızca Nexi'den gelen isteklerini kabul eder.

Sipariş, ödeme sonrası Nexi XPay payment on hold durumunda: Sipariş bloğundaki Nexi XPay notes bölümünü okuyun. Ertelenmiş tahsilat seçilidir (ödemeyi düğmeyle tahsil edin), tutar veya para birimi uyuşmadı, iptal edilmiş bir sipariş için ödeme geldi ya da ödeme sonrası durum olarak Nexi XPay payment on hold seçilidir.

Capture Nexi XPay payment eksik veya başarısız: Düğme yalnızca ertelenmiş tahsilatla yetkilendirilmiş olarak beklemede olan Nexi XPay siparişlerinde ve yalnızca siparişleri düzenleyebilen çalışanlara gösterilir. Ödemenin ortamının alias veya MAC anahtarı boşsa blok bunu belirtir. Tahsilat başarısız olursa bloktaki ve notlardaki hatayı okuyun; örneğin Nexi kodu ve mesajıyla birlikte Nexi XPay refused the capture.

Test ödemeleri canlı bir ödemeyi onaylamıyor: Her ödeme, başlatıldığı ortamın anahtarlarıyla kontrol edilir. Test Mode seçeneğini istediğiniz moda getirin ve o modun alias ile MAC anahtarını kullanın.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Nexi XPay 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. Delete Data on Uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerdeki Nexi XPay ödeme verileri ve Awaiting Nexi XPay payment ile Nexi XPay payment on hold sipariş durumları her zaman korunur; böylece yetkilendirilmiş ödemeler yeniden kurulumdan sonra da tahsil edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Nexi ve XPay, ilgili sahiplerinin ticari markalarıdır. Bu modül Nexi ile bağlantılı değildir ve Nexi tarafından onaylanmamıştır.