VibeFox Nexi XPay for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: müşteri ödemeyi EUR olarak yapmalıdır, bu nedenle System > Localisation > Currencies bölümünde EUR para birimi etkin olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Nexi XPay hesabı: Terminalinizin takma adına (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 kimlik bilgileri Nexi XPay test alanından veya geliştirici portalından (developer.nexi.it) alınır, canlı kimlik bilgileri ise satıcı hesabınız etkinleştirildikten sonra Nexi XPay arka ofisinizden alınır. Nexi arka ofisinde herhangi bir ayar yapmanız gerekmez: dönüş ve bildirim adresleri her ödemeyle birlikte gönderilir.

Herkese açık mağaza: Bildirim URL'sine internet üzerinden erişilebilmelidir; temel kimlik doğrulama veya Nexi'yi engelleyen bir güvenlik duvarı kuralı olmamalıdır. Bildirim mağazaya ulaşamazsa ödeme yine de müşterinin imzalı 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

İndirme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_nexi_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_nexi_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_nexi_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Nexi XPay Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli düğme) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı bölümü).

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

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

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_nexi_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır, yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Nexi XPay Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgeli düğme) tıklayın.

4. Lisans anahtarını, takma adları ve MAC anahtarlarını OpenCart 3 için 3-5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Notification URL).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Nexi XPay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde, test modu açıkken sayfa Test mode is on: payments go to the Nexi XPay test environment, no real money is charged. ifadesini gösterir. Ağ geçidi etkinken mevcut modun takma adı veya MAC anahtarı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi EUR değilse (bu durumda ödeme yöntemi yalnızca EUR cinsinden ödeme yapan müşterilere gösterilir) sayfa sizi uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve geo zone ile sipariş durumları mevcut olmalıdır; bunlardan biri yanlışsa hiçbir şey kaydedilmez. Yapıştırılan takma adların ve anahtarların çevresindeki boşluklar silinir.

Nexi XPay

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

Title: ödeme sayfasında müşteriye gösterilen ödeme yöntemi başlığı. Siparişte kayıtlı olan ödeme yöntemi adı da budur. Varsayılan: Credit Card (Nexi); boş bir başlık varsayılanı kullanır. En fazla 128 karakter. Test modunda ödeme sayfası ve sipariş başlığa (TEST MODE) ekler; çok uzun bir başlık, (TEST MODE) eklenmiş adın siparişin 128 karakterine sığması için kısaltılır.

Description: müşterinin Confirm Order adımında gördüğü metin. Varsayılan: Pay securely with your credit card via Nexi XPay.

Sort Order: ödeme sayfasında Nexi XPay'in ödeme yöntemleri arasındaki konumu. Boş bırakın veya tam sayı girin.

Geo Zone: Nexi XPay'i yalnızca seçili geo zone içindeki ödeme adresleri için sunun. Varsayılan: All zones. Geo zone'lar System > Localisation > Geo Zones bölümünde tanımlanır.

Total: Nexi XPay'in sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Her tutar için sunmak istiyorsanız boş bırakın.

Test ortamı

Test ödemeleri int-ecommerce.nexi.it adresine gider ve gerçek kartlardan asla tahsilat yapmaz. Test takma adını ve test MAC anahtarını Nexi XPay test alanında veya geliştirici portalında (developer.nexi.it, bölümde bağlantılı) alın.

Test Mode: Nexi XPay test ortamını ve test kimlik bilgilerini kullanır. Gerçek ödemeleri canlı kimlik bilgileriyle almak için kapatın. Varsayılan: açık. Açık olduğu sürece müşteriler Confirm Order adımında TEST MODE: the payment goes to the Nexi XPay test environment, no real money is charged. ifadesini görür.

Test Alias: Nexi XPay test terminalinizin takma adı (terminal kimliği).

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

Canlı ortam

Canlı takma ad ve canlı MAC anahtarı, satıcı hesabınız etkinleştirildikten sonra Nexi XPay arka ofisinizde (ecommerce.nexi.it) gösterilir.

Live Alias: Nexi XPay canlı terminalinizin takma adı (terminal kimliği).

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

Kaydedilmiş 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ı bir anahtarı silmek için alanın altındaki Clear the saved MAC key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme

Notification URL: başvuru amacıyla gösterilir. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_nexi_gateway/s2s&nexi_order={order_id}, OpenCart 4'te https://your-store/index.php?route=extension/wcp_nexi_gateway/payment/wcp_nexi_gateway.s2s&nexi_order={order_id} gibi görünür, sonunda sipariş numarası bulunur ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Her ödemeyle birlikte Nexi'ye gönderildiği için Nexi arka ofisinde herhangi bir ayar yapmanız gerekmez. Nexi, ödeme sonucunu sunucudan sunucuya bu URL'ye gönderir ve müşterinin dönüşüyle birlikte de iletir. İkisi de aynı şekilde imzalanır ve ödemenin yapıldığı ortamın MAC anahtarı, o ortamın takma adı ve o sipariş için verilen işlem kodu ile doğrulanır. Doğrulamayı geçemeyen sonuçlar reddedilir ve hiçbir şeyi değiştirmez.

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

Order Status After Payment: başarılı bir ödemeden sonra siparişin durumu. Her seçenek için kullanılan OpenCart durumları Orders bölümünde ayarlanır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş, missing order). Sipariş yalnızca doğrulanmış bir Nexi sonucundan durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler. OpenCart'ta On hold durumu yoktur: varsayılan olarak Pending kullanılır ve bir sipariş notu nedenini açıklar. System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilir ve burada seçebilirsiniz.

Status: Processing: Order Status After Payment Processing olduğunda kullanılır. Varsayılan: Processing.

Status: Completed: Order Status After Payment Completed olduğunda kullanılır. Varsayılan: Complete.

Status: awaiting payment: Nexi, ödemeyi beklemede olarak bildirir (esito PEN). Varsayılan: Pending.

Status: on hold: tutar veya para birimi uyuşmazlığı, iptal edilmiş bir sipariş için alınan ödeme, ertelenmiş tahsilat (onaylandı, henüz tahsil edilmedi) veya Order Status After Payment değerinin On hold olarak ayarlanması. Varsayılan: Pending.

Status: payment failed: beklemede olan ve daha sonra başarısız olan bir ödeme. Varsayılan: Failed.

Status of cancelled orders: mağazanızın iptal edilmiş siparişler için kullandığı durum. Böyle bir sipariş için alınan ödeme beklemeye alınır, asla ödenmiş olarak işaretlenmez. Eklenti bu durumu yalnızca okur, hiçbir zaman ayarlamaz. Varsayılan: Canceled.

Gelişmiş

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

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Delete Data on Uninstall: açıksa eklentiyi kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin Nexi XPay ödeme kayıtları her zaman saklanır. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. MAC anahtarları dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı MAC anahtarları değişmez.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Nexi)). OpenCart 4'te müşteri yöntemi, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve sayfanın altındaki Confirm Order düğmesine tıklar. Confirm Order adımında müşteri sizin açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında sayfa Redirecting to the Nexi XPay payment page... ve Please do not close this window. mesajlarını gösterir, bir saniye sonra müşteriyi otomatik olarak Nexi XPay sayfasına yönlendirir; yedek olarak Pay with Nexi XPay düğmesi de bulunur. Ödeme, sipariş toplamı için yeni bir işlem koduyla, müşterinin e-posta adresi ve Order açıklamasıyla, sipariş numarası ve mağaza adınızla EUR cinsinden gönderilir. Nexi sayfası, müşterinin mağaza 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.

Müşteri öder ve mağazanıza döner. Sipariş, yalnızca siparişin tam tutarı ve para birimiyle doğrulanmış bir Nexi sonucu alındıktan sonra ödenmiş olarak işaretlenir: sunucudan sunucuya bildirimden veya imzalı müşteri dönüşünden, hangisi önce gelirse. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postası ve stok güncellemesiyle durum alır ve müşteri Your Nexi XPay payment has been received. mesajıyla OpenCart sipariş başarı 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. Beklemeye alınmış bir sipariş için (ertelenmiş tahsilat veya elle inceleme) Your Nexi XPay payment has been received and is being reviewed. We will contact you if anything is needed. gösterilir.

Müşteri döndüğünde sonuç henüz işlenmemişse, Payment confirmation sayfası 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 gösterir. Bildirim geldiği anda sipariş durumunu ayarlar.

Ödeme reddedilirse, beklemedeki bir ödeme başarısız olursa veya müşteri Nexi sayfasında iptal ederse, müşteri ö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. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Durumsuz bir sipariş durumsuz kalır ve sepet korunur, böylece müşteri yeniden ödeme yapabilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir siparişi tutar ve aynı siparişi yeni bir işlem koduyla yeniden öder; aynı sepetin başka bir siparişi zaten ödenmişse, ödeme bekliyorsa veya beklemedeyse, müşteri yeni bir ödeme yerine başarı sayfasına gider.

OpenCart 4, siparişi başarı sayfası gösterilene kadar ödeme sürecinde tutar. Bu sipariş bu arada bir ödeme olmadan kapatıldıysa (örneğin beklemedeki bir ödeme başarısız olduysa veya siz iptal ettiyseniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir; bu, Nexi'den döndüğünde de geçerlidir ve bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Sipariş ödendikten sonra mağaza tarafından kapatılmışsa (örneğin iade edilmişse) mesaj Your previous order #(number) was closed by the store. Please confirm the order again to pay with a new order. olur. Ödeme sürecindeki sipariş zaten oluşturulmuşsa ve bundan sonra sepet değiştiyse mesaj Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. olur. Miktar değişikliği dahil sepetteki her değişiklik, kendi ödemesi gereken yeni bir sepet sayılır.

Eklenti mevcut mod için ayarlanmamışsa müşteri This payment method is not available right now. Please choose another payment method. mesajını görür.

Mağaza bakım modundayken de bildirim çalışır, çünkü OpenCart 3 ödeme eklentisi isteklerini geçirir ve OpenCart 4'te eklenti bunun için bir başlangıç eylemi ekler; bu eylem müşterinin Nexi'den dönüşüne de izin verir.

Eklenti ödemeleri yalnızca Nexi XPay sayfasında kabul eder. OpenCart'tan iade, kayıtlı kart veya OneClick, abonelik veya yinelenen ödeme, Pay-By-Link, XPay Build gömülü alanları ve OpenCart'ta ödeme yöntemi seçimi desteklenmez: Nexi sayfası terminalinizde etkin olan yöntemleri gösterir.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Nexi'ye yönlendirildi ve ödeme yapmadı, iptal etti veya ödeme reddedildi ya da Nexi ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Status: Processing, Completed or on hold: Nexi ödemeyi onayladı. Durum, Order Status After Payment değerini izler. Bir not onay kodunu, işlem kodunu, kart markasını ve Nexi mesajını gösterir.

Status: on hold (authorized): ertelenmiş tahsilat seçilidir ve ödeme yalnızca onaylanmıştır. Sipariş sekmesindeki Capture Nexi XPay payment ile tahsil edin.

Status: awaiting payment: Nexi, ödemeyi onay bekliyor olarak bildirdi. Sipariş nihai sonuçla güncellenir.

Status: on hold after payment: Nexi'den alınan tutar veya para birimi siparişle eşleşmedi (sipariş ödenmiş olarak işaretlenmez) ya da zaten iptal edilmiş bir sipariş için başarılı bir ödeme geldi. Not bunu açıklar. Nexi XPay arka ofisinde ödemeyi kontrol edin ve siparişi işleyin veya iade edin.

Status: payment failed: beklemede olan bir ödeme başarısız oldu.

Ödenmiş bir sipariş, sonradan gelen bir başarısızlıkla asla düşürülmez. Zaten ödenmiş bir sipariş veya aynı sepetin başka bir siparişi için başka bir başarılı ödeme gelirse, ödenmiş siparişteki bir not, bunun bir çift kayıt olması durumunda Nexi XPay arka ofisinde iade etmenizi ister; ikinci sipariş ödenmiş olarak işaretlenmez. Beklemedeki bir ödeme daha sonra başarılı olur veya başarısız olursa OpenCart, müşteriyi yeni durum hakkında bilgilendirir.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Nexi XPay Gateway sekmesi

Sales > Orders bölümünde Nexi XPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Nexi XPay Gateway sekmesi; işlem kodunu (codTrans), test ödemeleri için Test environment etiketini, durumu ve Nexi sonucunu, tahsilat modunu ve durumunu, Nexi'ye gönderilen ve alınan tutarı, onay kodunu, kart markasını, Nexi mesajını, tarihi ve siparişin Nexi XPay notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

Ertelenmiş tahsilat

Onaylanmış ve beklemeye alınmış bir sipariş için sekmede 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. Eklentiyi değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Eklenti, onaylanan tutarı ödemenin ortamında, o ortamın anahtarlarıyla tahsil eder ve durumu bir notla birlikte Order Status After Payment değerinden ayarlar. Durum, elle yapılan bir durum değişikliği gibi doğrudan değiştirilir; e-posta gönderilmez ve stok hareketi olmaz. Tahsilat başarısız olursa sekme hatayı gösterir, bir not eklenir ve sipariş beklemede kalır. Aynı ödemenin ikinci tahsilatı reddedilir.

İadeler

İadeler OpenCart'tan yapılmaz, bu nedenle Nexi XPay için iade düğmesi yoktur. İadeyi Nexi XPay arka ofisinde yapın, ardından OpenCart'ta elle kaydedin. Sales > Returns bölümündeki ürün iadeleri Nexi üzerinden para geri göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Nexi XPay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Nexi XPay Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş 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: opencart-payment-nexi satırı ve hesabınızda vibefox.net'i açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir, ö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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır. 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 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. Aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma belirir. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve onaylanmış ödemeler hâlâ tahsil edilebilir.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard ekranını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak 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, mevcut 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 müşterinin EUR cinsinden ödeme yaptığını kontrol edin. Ayarlar sayfası bu durumlarda bir uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş durumsuz kaldı: ne bildirim ne de müşterinin dönüşü kabul edildi. Mağazaya internet üzerinden erişilebildiğini, MAC anahtarı ve takma adın ödemenin ortamıyla (test veya canlı) eşleştiğini kontrol edin ve eklenti 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 takma ad, sonucu gönderen terminale uymuyor. Bunları Nexi test alanından veya arka ofisinden yeniden kopyalayın.

Bildirim unknown_transaction veya order_not_found yanıtı veriyor: işlem kodu bu mağaza tarafından o sipariş için verilmedi veya sipariş mevcut değil. Sonuç yok sayılır.

Bildirim not_configured veya busy yanıtı veriyor: ödemenin ortamının takma adı veya MAC anahtarı boş ya da sipariş aynı anda başka bir istek tarafından güncelleniyordu. Nexi bildirimi yeniden dener.

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

Müşteri This payment method is not available. Please reload the checkout page.: mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor veya bu arada ödeme yöntemi kapatılmış. Müşteri ödeme sayfasını yeniler.

Sipariş ödemeden sonra beklemedeki durumda: sekmedeki Nexi XPay notes kayıtlarını okuyun. Ertelenmiş tahsilat seçilidir (ödemeyi düğmeyle tahsil edin), tutar veya para birimi eşleşmedi, iptal edilmiş bir sipariş için ödeme geldi ya da Order Status After Payment değeri On hold olarak ayarlı.

Capture Nexi XPay payment eksik veya başarısız oluyor: düğme yalnızca ertelenmiş tahsilatla onaylanmış olarak beklemede olan Nexi XPay siparişlerinde ve yalnızca eklentiyi değiştirebilen kullanıcılara gösterilir. Ödemenin ortamının takma adı veya MAC anahtarı boşsa sekme bunu belirtir. Tahsilat başarısız olursa sekmedeki ve notlardaki hatayı okuyun, örneğin Nexi kodu ve mesajıyla birlikte Nexi XPay refused the capture.

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

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Nexi XPay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. OpenCart, eklentinin kendi ayarlarını her zaman siler: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki durumlar; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda bildirimi geçiren başlangıç eylemi de kaldırılır). Delete Data on Uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, takma adlar, MAC anahtarları, tahsilat, ödemeden sonra sipariş durumu, hata ayıklama günlüğü) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Siparişlerin Nexi XPay ödeme kayıtları (ödemeler, tahsilatlar ve iadeler) her zaman saklanır; bu nedenle yeniden kurulumdan sonra da onaylanmış ödemeler tahsil edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, yüklü eklentiler listesinde VibeFox Nexi XPay Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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