VibeFox Nets Nexi for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: cURL uzantılı 8.0 veya üzeri. Modül, eski PHP sürümlerinde veya cURL olmadan kurulmayı reddeder.

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 checkout anahtarları gerekmez.

Para birimleri ve ödeme yöntemleri: modül para birimlerini ve ülkeleri kendi başına kısıtlamaz. Nets hesabınızda etkinleştirilmiş 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, ülkenize ve para biriminize 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 yüzden mağazanızın webhook almak için HTTPS ve dost URL'lere ihtiyacı vardır. Webhook olmadan ödeme, müşteri mağazaya döndüğünde ya da sipariş sayfasındaki durum kontrolüyle yine de 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 Nets Nexi Gateway modülünü 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. 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).

5. Enable/Disable seçeneğini açın, Test Mode seçeneğini açık tutun, Save düğmesine tıklayın ve bir test siparişi verin. Ardından canlı gizli anahtarı girin ve Test Mode seçeneğini kapatın.

Kurulumda modül Nets payment on hold sipariş durumunu oluşturur. PrestaShop, yeni bir ödeme modülünü yalnızca kurulum sırasında aktif olan ülkelere bağlar. Modülün para birimlerini, ülkelerini ve müşteri gruplarını Payment > Preferences bölümünde kontrol edin.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Nets Nexi 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, seçili modun gizli anahtarı eksikse uyarır; örneğin Nets Nexi: enter the Test Secret Key — the payment method is hidden at checkout until the key of the selected mode is set. mesajını gösterir 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.

Nets Nexi (İskandinav ülkeleri)

Bölüm başlığı, seçili mod için TEST veya LIVE gösterir.

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

Title: ödeme sırasında müşterilere gösterilen ödeme yöntemi başlığı. Aynı zamanda siparişte kaydedilen ödeme yöntemi adıdır. Varsayılan: Nets Easy. Zorunlu: boş bir başlık Enter a title for the payment method. hatasını verir ve hiçbir şey kaydedilmez.

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

API anahtarları

Gizli anahtarları Nets Easy portalında Company > Integration altından kopyalayın: test anahtarı için test portalı (test.portal.dibspayment.eu), canlı anahtar için canlı portal (portal.dibspayment.eu). Checkout anahtarları gerekmez.

Test Mode: test modu test gizli anahtarıyla test.api.dibspayment.eu adresini, canlı mod ise canlı gizli anahtarla api.dibspayment.eu adresini kullanır. Bir siparişin iadeleri ve tahsilatları her zaman ödemenin yapıldığı ortamı kullanır. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında Test mode: no real money will be charged. mesajını görür.

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

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

Kaydedilmiş anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: bir anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan, kayıtlı değeri korur.

Ödeme

Webhooks: Nets bildirimleri (webhook'lar) her ödemeyle birlikte otomatik olarak kaydedilir. Nets portalında yapılandırılacak bir şey yoktur. Bölüm, bildirimlerin gönderileceği adresi gösterir. Dost URL'lerle şöyle görünür: https://your-shop/module/wcp_nets_nexi_gateway/webhook, isteğe bağlı olarak /en/ gibi bir dil koduyla. Adres herkese açık bir HTTPS adresi değilse bölüm, mağazanın webhook almadığı konusunda uyarır; bu durumda ödemeler müşteri mağazaya döndüğünde veya sipariş sayfasındaki Nets: check payment status and capture: ile onaylanır. Şu olaylar kaydedilir:

Her webhook, modülün o ödeme için oluşturduğu rastgele gizli değeri taşımalıdır. Doğru gizli değer olmadan gelen webhook'lar reddedilir. Webhook yalnızca modüle hangi ödemenin değiştiğini bildirir: ödemenin kendisi her zaman ödemenin yapıldığı ortamın gizli anahtarıyla Nets API'sinden okunur. Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Order Status After Payment: Nets ödemeyi onayladıktan ve tahsil ettikten sonra siparişin durumu.

Gelişmiş

Debug log: API çağrılarını ve ödeme durumu değişikliklerini modül klasöründeki logs/nng_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri kaydedilmez. Varsayılan: kapalı.

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

Delete Data on Uninstall: modül kaldırıldığında modül ayarlarını ve günlükleri siler. Siparişlerde saklanan ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Nets Easy) ve onaylar. Modül, sepet tutarı için sepet para biriminde bir Nets ödemesi oluşturur; ürünler, kargo, hediye paketi ve indirimler sipariş satırları olarak eklenir ve müşteri Nets'in barındırılan ödeme sayfasına yönlendirilir. Nets'teki ödeme referansı sepet numarasıdır. Müşterinin e-posta adresi, adı, adresi ve telefon numarası, Nets formatlarını kabul ettiğinde Nets'e iletilir. Ödeme sayfanızın şartlar ve koşullar sayfası Nets sayfasına bağlanır (hiçbiri ayarlanmamışsa mağazanın ana sayfası). Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Nets onayladıktan sonra ödenmiş olarak işaretlenir: modül ödemeyi Nets API'sinden okur, ayrılmış tutarı ve para birimini sepetle karşılaştırır, ön ayırmayı tahsil eder ve ancak ondan sonra siparişi oluşturur. Bu, webhook'ta veya müşteri geri döndüğünde, hangisi önce gelirse gerçekleşir. Müşteri ardından standart sipariş onay sayfasını görür. Ödeme henüz onaylanamadıysa (Nets'e ulaşılamadı ya da o anda başka bir istek onaylıyordu), bir Payment confirmation sayfası Your Nets payment is being confirmed. Your order will be created as soon as it is confirmed — please do not pay again. mesajını ve Check again ile Back to checkout düğmelerini gösterir.

Müşteri Nets sayfasında iptal ederse The Nets payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Hiçbir şey ödenmediyse mesaj The payment was not completed. You can try again or choose another payment method. olur. Sepet korunur. Yeni denemede modül önce önceki ödemeyi kontrol eder; zaten ödenmişse yeni ödeme yerine sipariş oluşturulur. Aksi halde yeni bir oturum başlamadan önce önceki Nets oturumu kapatılır.

Nets ödemeyi başlatamazsa müşteri kısa bir mesajla ödeme sayfasında kalı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., This payment method is temporarily unavailable. Please choose another payment method. veya The payment service could not be reached. Please try again in a moment. Sepet tutarı sıfırsa The order total must be greater than zero to pay with Nets. mesajı gösterilir. Ayrıntılar günlüğe yazılır.

Modül yalnızca barındırılan ödeme sayfasını kullanır. Sayfa içi gömülü Nets ödeme sayfası, abonelik veya yinelenen ödeme, kayıtlı kart, fatura ücreti, yalnızca yetkilendirme modu ve gönderi başına kısmi tahsilat desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Nets'e yönlendirildi ve ödeme yapmadı ya da ödeme henüz onaylanmadı. Yalnızca sepet vardır.

Payment accepted or Delivered: Nets ödemeyi onayladı ve tahsil etti. Durum, Order Status After Payment ayarını izler. Ödeme, Nets ödeme kimliğiyle işlem kimliği olarak kaydedilir; bir not ödeme kimliğini, tahsilat kimliğini ve ödeme yöntemini gösterir.

Nets payment on hold: Nets'teki tutar veya para birimi sepetten farklı (tahsil edilmedi), tahsilat reddedildi veya müşteri, sipariş iptal edildikten sonra ödeme yaptı (ayrıldı, tahsil edilmedi). Not durumu açıklar. Hiçbir şey otomatik olarak tahsil edilmez. Siparişi inceledikten sonra Nets: check payment status and capture: ile tahsil edin veya Nets portalında ön ayırmayı iptal edin.

Canceled: beklemedeki bir siparişin ön ayırması iptal edildi; örneğin Nets portalında.

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

Tekrarlanan webhook'lar ve sayfa yenilemeleri asla iki kez tahsilat yapmaz veya yinelenen not eklemez; ödenmiş bir sipariş Nets olaylarıyla bir daha asla değiştirilmez. 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, bunu Nets portalında iade etmenizi ister.

Nets Easy ödeme bloğu

Sipariş sayfası; ödeme kimliği, tahsilat kimliği, ortam (test ödemeleri için Test environment rozetiyle), durum, Nets'te ayrılan ve tahsil edilen tutarlar, sipariş toplamı ve iade edilen tutar, iade geçmişi ve siparişin Nets notes notlarını içeren bir Nets Easy payment bloğu gösterir. Bloğun düğmeleri, siparişleri düzenleyebilen her çalışan için çalışır; Modules sayfalarına erişim gerekmez.

Nets: check payment status and capture: henüz ödenmemiş siparişler için gösterilir. Ödemeyi Nets'ten okur ve siparişle eşleşen bir ön ayırmayı tahsil eder; başarısız bir tahsilattan veya beklemedeki bir siparişi incelediğinizden sonra da. Hiçbir şey değişmezse bir not nedenini açıklar; örneğin müşterinin ödemeyi henüz tamamlamadığını.

İadeler

Nets Easy payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Nets düğmesine tıklayın. Refund this amount through Nets? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler, ödeme tahsil edildikten sonra desteklenir; yalnızca ayrılmış bir ödeme Nets portalında iptal edilebilir. İade, siparişin ödendiği ortamdaki tahsilata yapılır. Nets iadeyi kabul etmezse blok hatayı gösterir ve iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Nets iade kimliğiyle 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, Nets üzerinden para göndermez. Nets portalında yapılan iadeler senkronize edilmez; gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Nets Nexi Gateway lisans bloğu, Modules > Module Manager > VibeFox Nets Nexi 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-nets-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 Nets, 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. 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 iadeler çalışır.

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

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. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme yapıldı ama sipariş oluşturulmadı: webhook mağazanıza ulaşmadı. Mağazanın HTTPS ve dost URL kullandığını, Webhooks altındaki adresin "&" içermeyen herkese açık bir HTTPS adresi olduğunu ve ödemenin ortamının gizli anahtarının ayarlandığını kontrol edin. Müşteri ödemeden sonra mağazaya döndüğünde de sipariş oluşturulur.

Webhook Unauthorized yanıtı veriyor: webhook o ödemenin gizli değerini taşımadı. Webhook'lar yalnızca ödemeyle birlikte kaydedilen gizli değerle kabul edilir.

Webhook Busy, retry later, Payment lookup failed veya Payment not reserved yet yanıtı veriyor: başka bir istek aynı sepeti onaylıyordu, Nets API'sine ulaşılamadı ya da ön ayırma henüz görünür değildi. Nets webhook'u otomatik olarak yeniden dener.

Webhook Order could not be created, retry later yanıtı veriyor: sipariş oluşturulamadı; örneğin modül devre dışı olduğu için. Nedeni görmek için Debug log seçeneğini açın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. Adres yalnızca Nets'ten gelen istekleri kabul eder.

Müşteri Nets'i seçerken hata görüyor: Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış veya eksik bir gizli anahtarı gösterir. Reddedilen bir para birimi günlükte Nets tarafından bildirilir.

Ödemeden sonra sipariş Nets payment on hold durumunda: bloktaki Nets notes notlarını okuyun. Tahsilat reddedildiyse Nets: check payment status and capture: ile 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 eksik veya başarısız: iadeler yalnızca ödeme tahsil edildikten sonra mümkündür; blok o zaman bir tahsilat kimliği gösterir. Bir iade, siparişin ödendiği ortamın gizli anahtarını kullanır; bu nedenle o anahtar ayarlanmış olmalıdır. Aksi halde blok hangi ortam anahtarının eksik olduğunu belirtir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Nets Nexi 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 sonraki yeniden kurulum için tüm ayarlar korunur. Siparişlerdeki Nets ödeme verileri (ödemeler, tahsilatlar ve iadeler) ile Nets payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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