VibeFox Nexi XPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

Para birimi: mağaza veya sipariş para birimi EUR olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Nexi XPay hesabı: "Pagamento Semplice" yönlendirme entegrasyonuna sahip bir Nexi XPay satıcı hesabına, terminalinizin alias (terminal kimliği) ve MAC anahtarına 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ınız etkinleştirildikten sonra Nexi XPay yönetim panelinden alınır. Nexi yönetim panelinde bir şey ayarlamanız gerekmez: bildirim adresi her ödemeyle birlikte gönderilir.

Herkese açık site: bildirim URL'si internetten erişilebilir olmalıdır; bakım modu, temel kimlik doğrulama veya Nexi'yi engelleyen bir güvenlik duvarı kuralı olmamalıdır. Aksi takdirde ö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

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_nexi_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 > Nexi XPay > Manage veya 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. Test Mode seçeneğini açık tutun ve test alias ile MAC anahtarını girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve bir test siparişi verin. Her şey çalıştığında canlı alias ve MAC anahtarını girin ve Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Nexi XPay. Alanların üstünde sayfa, test modu açıkken Test modu açık: ödemeler Nexi XPay test ortamına gider, gerçek para çekilmez. mesajını gösterir; ayrıca ağ geçidi etkin olduğu halde mevcut modun alias veya MAC anahtarı boşsa ya da mağaza para birimi EUR değilse uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Kaydetme sırasında yapıştırılan anahtarların etrafındaki boşluklar ve satır sonları kaldırılır.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi başlığı. Varsayılan: Credit Card (Nexi). Test modunda ödeme sayfası başlığa (TEST MODE) ekler.

Description: müşterinin ödeme sayfasında gördüğü ö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 hiçbir zaman gerçek kartlardan 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: Enable test mode Nexi XPay test ortamını ve test kimlik bilgilerini kullanır. Canlı kimlik bilgileriyle gerçek ödemeleri kabul etmek için işaretini kaldırın. Varsayılan: açık.

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

Ödeme

Bildirim URL'si her ödemeyle birlikte Nexi'ye gönderildiği için yönetim panelinde bir şey yapılandırmanız gerekmez. Bölüm bu adresi gösterir; şu biçimdedir: https://your-site/wp-json/wc-nexi-gateway/v1/s2s/{order_id}, sonunda sipariş kimliği yer alır. 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 sipariş için düzenlenen işlem kodu ile 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. Durum tek bir durum değişikliği ve tek bir e-posta ile hemen ayarlanır.

Gelişmiş

Debug Log: Enable logging ödeme olaylarını WooCommerce > Status > Logs bölümüne, kaynak wcp_nexi_gateway olarak kaydeder. MAC anahtarları, kart bilgileri ve e-posta adresleri kaydedilmez. Başarısız MAC kontrolü gibi hatalar ve uyarılar seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: kapalı.

Delete Data on Uninstall: Remove all plugin settings and logs when uninstalled. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Nexi)) ve siparişi verir. Sonraki sayfa Ödeme için Nexi XPay'e yönlendiriliyor... mesajını gösterir ve müşteriyi otomatik olarak Nexi XPay sayfasına gönderir; yedek seçenek olarak Pay Now düğmesi bulunur. Ödeme, yeni bir işlem kodu, müşterinin e-posta adresi, Order açıklaması, sipariş numarası ve site adınızla EUR cinsinden gönderilir. Mağaza dili İtalyanca, İngilizce, İspanyolca, Fransızca, Almanca, Japonca, Çince, Arapça, Rusça veya Portekizceyse Nexi sayfası mağaza dilinde açılır; aksi takdirde İngilizce açılır.

Müşteri öder ve mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca siparişin tam tutarı ve para birimiyle doğrulanmış bir Nexi sonucu alındığında ödenmiş olarak işaretlenir: sunucudan sunucuya bildirimden veya imzalı müşteri dönüşünden, hangisi önce gelirse.

Ödeme reddedilirse veya müşteri Nexi sayfasında iptal ederse, ödeme sayfasına (sepet boşsa Pay for order sayfasına) döner ve şu mesajlardan birini görür: Ödeme tamamlanamadı. Lütfen tekrar deneyin veya farklı bir ödeme yöntemi seçin., Ödeme iptal edildi. Lütfen tekrar deneyin. veya Ödemeniz onaylanamadı. Kartınızdan tahsilat yapıldıysa, lütfen tekrar ödeme yapmadan önce bizimle iletişime geçin. Nexi sayfasında iptal etmek siparişi değiştirmez, bu nedenle müşteri yeniden ödeme yapabilir.

Eklenti mevcut mod için yapılandırılmamışsa müşteri Bu ödeme yöntemi şu anda kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin. mesajını görür.

Ö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 yalnızca Nexi XPay sayfasında ödeme alır. WooCommerce üzerinden iade, kayıtlı kart veya OneClick, abonelik veya tekrarlayan ödeme, Pay-By-Link, gömülü XPay Build alanları ve WooCommerce'de seçilen ödeme yöntemleri yoktur: Nexi sayfası terminalinizde etkin olan yöntemleri gösterir.

Siparişler ve iadeler

Sipariş durumları

Ödeme bekleniyor: müşteri Nexi'ye yönlendirildi ve henüz ödeme yapmadı ya da Nexi sayfasında iptal etti.

İşleniyor, Tamamlandı veya Beklemede: Nexi ödemeyi onayladı. Durum Order Status After Payment ayarını izler. Sipariş notu yetkilendirme kodunu, işlem kodunu, kart markasını ve Nexi mesajını gösterir. İşlem kimliği Nexi işlem kodudur.

Beklemede (yetkilendirildi): erteleyerek tahsilat seçilmiştir ve ödeme yalnızca yetkilendirilmiştir. Capture Nexi XPay payment sipariş işlemiyle tahsil edin.

Beklemede (bekliyor): Nexi ödemeyi onay beklerken olarak bildirdi. Sipariş son sonuçla güncellenecektir.

Ödemeden sonra beklemede: 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. Sipariş notu nedenini açıklar. Nexi yönetim panelinde ödemeyi kontrol edin ve siparişi işleyin veya iade edin.

Başarısız: son ödeme denemesi reddedildi, iptal edildi veya bir hatayla sonuçlandı. Müşteri yeniden ödeme yapabilir.

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

Erteleyerek tahsilat

Beklemede olan yetkilendirilmiş bir sipariş için siparişi açın, sipariş işlemleri arasından Capture Nexi XPay payment seçeneğini seçin ve oka tıklayın. Eklenti yetkilendirilmiş tutarı ödemenin ortamında tahsil eder ve siparişi Order Status After Payment durumuyla ödenmiş olarak işaretler. Tahsilat başarısız olursa hata sipariş ekranında gösterilir ve sipariş notlarına eklenir; sipariş Beklemede kalır.

İadeler

İadeler WooCommerce üzerinden yapılmaz, bu nedenle Refund via düğmesi yoktur. İadeyi Nexi XPay yönetim panelinde yapın, ardından WooCommerce'e manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Nexi XPay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın ne zamana kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini 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ı 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 Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. 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 bir 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ış ödemeler onaylanmaya devam eder ve ertelenmiş ödemeler tahsil edilebilir.

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 kontrol edilir.

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 iki kimlik bilgisinin de (test modunda Test Alias ve Test MAC Key, canlı modda Live Alias ve Live MAC Key) bulunduğunu ve mağaza ya da sipariş para biriminin EUR olduğunu kontrol edin. Ayarlar sayfası bu durumlarda uyarı gösterir.

Ödeme gerçekleşti ama sipariş Ödeme bekleniyor durumunda kaldı: ne bildirim ne de müşteri dönüşü kabul edilmedi. 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 WooCommerce > Status > Logs bölümünde, kaynak wcp_nexi_gateway, 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. Bunları Nexi test alanından veya yönetim panelinden yeniden kopyalayın.

Bildirim unknown_transaction yanıtı veriyor: işlem kodu, bu mağaza tarafından o sipariş için verilmemiş. Sonuç yok sayılır.

Bildirim not_configured veya busy yanıtı veriyor: ödemenin ortamının alias veya MAC anahtarı boş, ya da başka bir istek o sırada siparişi güncelliyordu. Nexi bildirimi yeniden dener.

Sipariş ödemeden sonra beklemede: sipariş notunu okuyun. Erteleyerek tahsilat seçilmiş (ödemeyi sipariş işlemiyle tahsil edin), tutar veya para birimi eşleşmemiş, iptal edilmiş bir sipariş için ödeme gelmiş, ödeme Nexi'de beklemede olabilir ya da ödeme sonrası durum olarak Beklemede seçilmiş olabilir.

Capture Nexi XPay payment eksik veya başarısız: işlem yalnızca erteleyerek tahsilatla yetkilendirilmiş ve beklemede olan Nexi siparişlerinde gösterilir. Başarısız olursa hatayı sipariş notlarında okuyun; tahsilat, ödemenin yapıldığı ortamın anahtarlarını kullanır.

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 yuva serbest bırakı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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde daha sonra yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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.