VibeFox Nets Nexi for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Nets hesabı: Nets Easy hesabınızın gizli anahtarlarına (test ve canlı) ihtiyacınız var. Yalnızca gizli anahtarlar kullanılır. Müşteriler Nets'in barındırılan ödeme sayfasında ödeme yaptığı için ödeme sayfası anahtarlarına gerek yoktur.

Para birimleri ve ödeme yöntemleri: eklenti para birimlerini veya ülkeleri kısıtlamaz. Nets hesabınızda etkin olan para birimlerini kullanın; desteklenmeyen bir para birimi, ödeme oluşturulurken Nets tarafından bildirilir. Müşterinin hangi ödeme yöntemlerini göreceği Nets sözleşmenize, ülkeye ve para birimine bağlıdır.

Webhook'lar için HTTPS: Nets yalnızca en fazla 256 karakterlik, "&" içermeyen herkese açık HTTPS adreslerini çağırır; bu nedenle sitenizin webhook almak için HTTPS ve sade kalıcı bağlantılara ihtiyacı vardır. Diğer sitelerde ödeme, müşteri mağazaya döndüğünde veya sipariş işlemiyle yine de onaylanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_nets_nexi_gateway klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Nets Nexi (Nordics) > 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. Nets Easy test portalından test gizli anahtarını kopyalayın ve Test Secret Key alanına yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın, Test Mode seçeneğini açık tutun ve bir test siparişi verin. Ardından canlı gizli anahtarı 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 > Nets Nexi (Nordics). Alanların üstünde sayfa, seçili modun gizli anahtarı eksikse uyarır (ödeme yöntemi bu durumda ödeme sayfasında gizlenir) ve test modu açıkken Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. mesajını gösterir. Ödeme yöntemleri listesinde, seçili modun bir gizli anahtarı olana kadar Nets Nexi kurulum gerektiriyor olarak işaretlenir.

Genel

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

Title: müşterilere ödeme sırasında gösterilen ödeme yöntemi başlığı. Varsayılan: Nets Easy.

Description: müşterilere ödeme sırasında gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely with Nets Easy.

API anahtarları

Gizli anahtarları Nets Easy portalında Company > Integration bölümünden kopyalayın: test anahtarı için test portalı (test.portal.dibspayment.eu), canlı anahtar için canlı portal (portal.dibspayment.eu). Ödeme sayfası anahtarları gerekli değildir.

Test Mode: Enable test mode. Test modu, test gizli anahtarıyla test.api.dibspayment.eu adresini kullanır; canlı mod ise canlı gizli anahtarla api.dibspayment.eu adresini kullanır. Bir siparişin iadeleri ve tahsilatları her zaman siparişin ödendiği ortamı kullanır. Varsayılan: açık.

Test Secret Key: Nets test ortamı gizli API anahtarınız.

Live Secret Key: Nets canlı ortam gizli API anahtarınız.

Ödeme

Nets bildirimleri (webhook'lar) her ödemeyle birlikte otomatik olarak kaydedilir. Nets portalında yapılandırılacak bir şey yoktur. Bu bölüm webhook URL'sini gösterir. Şuna benzer: https://your-site/wc-api/nng_nets_nexi/. URL herkese açık bir HTTPS adresi değilse bölüm, sitenin webhook almadığı konusunda uyarır; bu durumda ödemeler, müşteri mağazaya döndüğünde veya Nets: check payment status and capture sipariş işlemiyle onaylanır. Şu olaylar kaydedilir:

Her webhook, eklentinin o sipariş için oluşturduğu rastgele gizli değeri taşımalıdır. Doğru gizli değeri olmayan webhook'lar reddedilir. Webhook yalnızca hangi ödemenin değiştiğini eklentiye bildirir: ödemenin kendisi her zaman gizli anahtarınızla Nets API'sinden okunur.

Order Status After Payment: Nets ödemeyi onayladıktan ve tahsil ettikten sonra siparişin durumu. Durum hemen ayarlanır, böylece müşteri tek bir e-posta alır.

Gelişmiş

Debug log: Enable debug logging API çağrılarını ve ödeme durumu değişikliklerini WooCommerce > Status > Logs bölümüne, wcp_nets_nexi_gateway kaynağıyla kaydeder. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Delete the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde saklanan ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini (varsayılan Nets Easy) seçer ve siparişi verir. Eklenti, sipariş satırları, kargo ve ücretleri sipariş para biriminde içeren bir Nets ödemesi oluşturur ve müşteriyi Nets'in barındırılan ödeme sayfasına gönderir. Müşterinin e-posta adresi, adı, adresi ve telefon numarası, Nets biçimlerini kabul ettiğinde Nets'e iletilir; şartlar ve koşullar sayfanız Nets sayfasında bağlantılıdır. Test modunda ödeme sayfası Test mode: no real money will be charged. mesajını gösterir.

Müşteri ödemeyi yapar ve mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca Nets onayladıktan sonra ödenmiş olarak işaretlenir: eklenti ödemeyi Nets API'sinden okur, ayrılan tutarı ve para birimini siparişle karşılaştırır, ön ayırmayı tahsil eder ve ancak bundan sonra siparişi tamamlar. Bu işlem webhook'ta, müşterinin sipariş alındı sayfasına dönüşünde veya Nets: check payment status and capture sipariş işlemiyle gerçekleşir.

Müşteri Nets sayfasında iptal ederse ödeme sayfasına veya Pay for order sayfasına, The Nets payment was cancelled. You can try again or choose another payment method. mesajıyla döner. Bir müşteri ödenmemiş bir siparişi yeniden ödeyebilir. Eklenti önce önceki ödemeyi kontrol eder; zaten ödenmişse sipariş onaylanır. Aksi halde yeni bir oturum başlamadan önce önceki Nets oturumu kapatılır. Siparişin bir ödemesi sizin incelemeniz için tutulursa müşteri A payment for this order is already being reviewed by the shop. Please contact us instead of paying again. mesajını görür.

Nets ödemeyi başlatamazsa müşteri kısa bir mesaj görür, örneğin Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. ya da The payment service could not be reached. Please try again in a moment. Ayrıntılar günlüğe yazılı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 barındırılan ödeme sayfasını kullanır. Sayfa içi gömülü bir Nets ödeme sayfası, abonelik veya yinelenen ödeme, kayıtlı kart, fatura ücreti, yalnızca yetkilendirme modu ya da gönderi başına kısmi tahsilat desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Nets'e yönlendirildi ve henüz ödeme yapmadı. Sipariş notu Nets ödeme kimliğini, tutarı ve ortamı gösterir.

Processing or Completed: Nets ödemeyi onayladı ve tahsil etti. Durum Order Status After Payment ayarını izler. Sipariş notu ödeme kimliğini, tahsilat kimliğini ve ödeme yöntemini gösterir. İşlem kimliği Nets ödeme kimliğidir.

On hold: Nets'teki tutar veya para birimi siparişten farklı (tahsil edilmedi), tahsilat reddedildi veya müşteri, sipariş iptal edildikten sonra ödeme yaptı (ayrıldı, tahsil edilmedi). Sipariş notu bunu açıklar. Siparişi inceledikten sonra Nets: check payment status and capture sipariş işlemiyle tahsil edin veya Nets portalında ön ayırmayı iptal edin.

Cancelled: siparişin son ödemesinin ön ayırması iptal edildi, örneğin Nets portalında.

Tekrarlanan webhook'lar ve sayfa yenilemeleri asla iki kez tahsilat yapmaz, yinelenen notlar, stok düşüşleri veya e-postalar eklemez; ödemeden sonra ödenen, iade edilen veya iptal edilen bir sipariş asla yeniden açılmaz. Zaten ödenmiş bir sipariş için eski bir ödeme bağlantısı tamamlanırsa ikinci ön ayırma otomatik olarak serbest bırakılır; zaten tahsil edilmişse bir not, Nets portalında iade etmenizi ister.

Sipariş işlemi

Nets ödemesi olan ödenmemiş siparişler için sipariş işlemleri listesinde Nets: check payment status and capture bulunur. Ödemeyi Nets'ten okur ve eşleşen bir ön ayırmayı tahsil eder. Hiçbir şey değişmezse bir not nedenini açıklar; örneğin müşterinin henüz ödemeyi tamamlamadığı gibi.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Nets Easy düğmesine tıklayın (düğme ödeme yönteminin başlığını kullanır). Ödeme tahsil edildikten sonra tam ve kısmi iadeler desteklenir; yalnızca ayrılmış bir ödeme Nets portalında iptal edilebilir. İade, siparişin ödendiği ortamdaki tahsilata uygulanır. Nets iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Nets iade kimliğiyle birlikte sipariş notlarına eklenir.

Doğrudan Nets portalında yapılan iadeler WooCommerce iadesine dönüşmez. Gerekirse Refund via Nets Easy kullanmadan WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Nets Nexi (Nordics) 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 hangi tarihe kadar etkin olduğu ve alan adınız. 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 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 Nets Nexi müşterilere ödeme sayfasında 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) ibaresiyle 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: başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Nets Nexi ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve seçili modun gizli anahtarı olduğunu kontrol edin: test modunda Test Secret Key, canlı modda Live Secret Key. Anahtar eksikse ayarlar sayfası uyarı gösterir.

Ödeme yapıldı ama sipariş Pending payment durumunda kaldı: webhook mağazanıza ulaşmadı. Sitenin HTTPS ve sade kalıcı bağlantılar kullandığını kontrol edin; böylece Payment bölümündeki webhook URL'si "&" içermeyen herkese açık bir HTTPS adresi olsun ve ödemenin ortamının gizli anahtarı ayarlı olsun. Ardından Nets: check payment status and capture sipariş işlemini kullanın. Müşteri sipariş alındı sayfasına döndüğünde de sipariş onaylanır.

Webhook answers Unauthorized: webhook bu siparişin gizli değerini taşımadı. Webhook'lar yalnızca ödemeyle kaydedilen gizli değerle kabul edilir.

Webhook answers Busy, retry later, Payment lookup failed veya Payment not reserved yet: başka bir istek siparişi güncelliyordu, Nets API'sine ulaşılamadı veya ön ayırma henüz görünür değildi. Nets webhook'u otomatik olarak yeniden dener.

Müşteri sipariş verirken hata görüyor: Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, wcp_nets_nexi_gateway kaynağıyla bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış veya eksik bir gizli anahtar anlamına gelir. Reddedilen para birimi Nets tarafından günlükte bildirilir.

Order is On hold after payment: sipariş notunu okuyun. Tahsilat reddedildiyse Nets: check payment status and capture sipariş işlemiyle yeniden deneyin veya Nets portalında tahsil edin. Tutar veya para birimi farklıysa ödemeyi Nets portalında kontrol edin. Müşteri iptalden sonra ödediyse siparişi inceleyin ve ön ayırmayı tahsil edin ya da iptal edin.

Refund via Nets Easy eksik veya başarısız: iadeler yalnızca ödeme tahsil edildikten sonra mümkündür. Sipariş notunda tahsilatı kontrol edin. Bir iade, siparişin ödendiği ortamın gizli anahtarını kullanır; bu nedenle o anahtarın ayarlı olması gerekir.

The license block shows an error: lisans bloğundaki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için 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 Plugins sayfasında devre dışı bırakın ve 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 seçeneği açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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