VibeFox Nets Nexi for OpenCart — Yardım

Gereksinimler

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

PHP: 8.0 veya üzeri.

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

Para birimleri ve ödeme yöntemleri: Eklenti para birimlerini kendisi sınırlamaz. Nets hesabınızda etkin olan para birimlerini kullanın; desteklenmeyen bir para birimi, ödeme oluşturulduğunda 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 mağazanızın webhook'ları alabilmesi için HTTPS gerekir. HTTPS olmasa bile müşteri mağazaya döndüğünde veya sipariş sayfasındaki durum kontrolüyle ödeme yine onaylanır.

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

Kurulum

Bu indirme, 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_nets_nexi_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_nets_nexi_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_nets_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 Nets Nexi 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. 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). Nets portalında herhangi bir ayar yapmanız gerekmez.

5. Enable/Disable seçeneğini açın, Test Mode seçeneğini açık bırakın, 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.

OpenCart 4

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

2. Paket, kurulu eklentilerin listesinde aynı sayfada 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 Nets Nexi 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ı ve gizli anahtarları OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları her iki sürümde de aynıdır. Yalnızca webhook adresi farklıdır (bkz. Webhooks).

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 Nets Nexi Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde, seçili modun gizli anahtarı eksikse sayfa sizi 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. ve test modu açıkken Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged. ifadesini gösterir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş bırakılamaz (en fazla 128 karakter), 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; alanlardan biri hatalıysa hiçbir şey kaydedilmez.

Nets Nexi (Kuzey Ülkeleri)

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

Title: ödeme sayfasında müşterilere gösterilen ödeme yöntemi başlığı. Siparişte kayıtlı olan ödeme yöntemi adı da budur. Varsayılan: Nets Easy. Zorunlu.

Description: müşterinin Confirm Order adımında gördüğü metin. Varsayılan: Pay securely with Nets Easy.

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

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

Total: Nets'in sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde toplam tutar. Nets'i her tutar için sunmak istiyorsanız boş bırakın.

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). Bu bölüm her iki portala bağlantı verir. Checkout anahtarları gerekli değildir.

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 ödemenin yapıldığı ortamı kullanır. Varsayılan: açık. Açık olduğu sürece müşteriler Confirm Order adımında Test mode: no real money will be charged. ifadesini 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. 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 key on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme

Webhooks: Nets bildirimleri (webhook'lar) her ödemeyle birlikte otomatik olarak kaydedilir. Nets portalında yapılandırılacak bir şey yoktur. Alan, bunların gönderileceği adresi gösterir. OpenCart 3'te adres https://your-store/index.php?route=extension/payment/wcp_nets_nexi_gateway/webhook gibi, OpenCart 4'te https://your-store/index.php?route=extension/wcp_nets_nexi_gateway/payment/wcp_nets_nexi_gateway.webhook gibi görünür ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Adres herkese açık bir HTTPS adresi değilse alan, mağazanın webhook almadığı konusunda sizi 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, eklentinin o ödeme 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 eklentiye hangi ödemenin değiştiğini bildirir: ödemenin kendisi her zaman, yapıldığı ortamın gizli anahtarıyla Nets API'sinden okunur.

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş, missing order). Sipariş, ödeme Nets API'sinden geri okunduktan (webhook, müşterinin dönüşü veya sipariş sayfasındaki Nets: check payment status and capture) ve eşleşen bir rezervasyon tahsil edildikten sonra bir durum alır. Aşağıdaki her durum alanı, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Nets ödemeyi onayladıktan ve tahsil ettikten sonra siparişin durumu. Varsayılan: Processing. Ödenmiş siparişleri tamamlanmış olarak işaretlemek için Complete seçin.

Nets Payment On Hold Status: tutar veya para birimi siparişten farklıdır, tahsilat başarısız olmuştur ya da müşteri sipariş iptal edildikten sonra ödeme yapmıştır. Hiçbir şey otomatik olarak tahsil edilmez ve bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Cancelled Status: siparişin rezervasyonu Nets portalında iptal edildiğinde ayarlanır. Varsayılan: Canceled.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: API çağrılarını ve ödeme durumu değişikliklerini OpenCart günlükler klasörünündeki (storage/logs) nng_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Anahtarlar ve müşteri verileri kaydedilmez. Hatalar ve uyarılar, kapalıyken 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 Nets ödeme ve iade kayıtları her zaman saklanır. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli 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ı gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Nets Easy). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to the Nets payment page to pay securely. notunu görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde sipariş toplamı için bir Nets ödemesi oluşturur; ürünleri, kargoyu ve diğer sipariş toplamlarını (kuponlar, hediye çekleri, ücretler) sipariş satırları olarak gönderir ve müşteriyi Nets'in barındırdığı ödeme sayfasına yönlendirir. OpenCart 4'te müşteri ödeme yöntemini, ö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. Nets'teki ödeme referansı OpenCart sipariş numarasıdır. Müşterinin e-posta adresi, adı, teslimat adresi ve telefon numarası, Nets biçimlerini kabul ederse Nets'e iletilir. Mağazanızın ödeme koşulları sayfası Nets sayfasında bağlantı olarak gösterilir (ayarlı değilse mağaza ana sayfası).

Ödemeyi yaptıktan sonra müşteri mağazanıza döner. Sipariş, yalnızca Nets onayladıktan sonra ödenmiş olarak işaretlenir: eklenti ödemeyi Nets API'sinden okur, ayrılmış tutarı ve para birimini siparişle karşılaştırır, rezervasyonu tahsil eder ve ancak bundan sonra sipariş durumunu ayarlar. Bu işlem webhook ile veya müşterinin dönmesiyle, hangisi önce gerçekleşirse onunla yapılır. Sipariş daha sonra OpenCart'ın standart yöntemiyle, olağan sipariş e-postası ve stok güncellemesiyle durum alır ve müşteri OpenCart sipariş başarılı sayfasını görür. Ödeme henüz onaylanamadıysa (Nets'e ulaşılamadıysa veya o sırada başka bir istek onu onaylıyorduysa), bir Payment confirmation sayfası Your Nets payment is being confirmed. Your order will be updated 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. OpenCart 4'te bu mesajlar sayfanın üstünde gösterilir. Sepet korunur. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme için tek bir sipariş tutar ve aynı siparişi yeni bir Nets ödemesiyle yeniden öder. Yeni denemede eklenti önce sepetin önceki ödemelerini kontrol eder; bunlardan biri zaten ödenmişse yeni bir ödeme başlatmak yerine o sipariş onaylanır. Aksi halde yeni bir oturum başlamadan önce eski Nets oturumları kapatılır. Aynı sepetin başka bir siparişi zaten ödenmiş veya beklemedeyse müşteri başarılı sayfasına gider.

OpenCart 4, sipariş başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Bu sipariş ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz, Nets portalında rezervasyonu iptal ettikten sonra da), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme adımına geri gönderilir; Nets'ten döndüğünde de böyle olur ve bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Aynı sepete ait, ödenmiş olup sonra iptal edilen veya iade edilen bir sipariş artık sepeti tutmaz.

Nets ödemeyi başlatamazsa müşteri Confirm Order adımında kısa bir mesajla 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. Sıfır sipariş tutarı The order total must be greater than zero to pay with Nets. mesajını verir. Ayrıntılar günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır, çünkü OpenCart 3 ödeme eklentilerinin isteklerini geçirir; OpenCart 4'te ise eklenti bunun için bir başlangıç eylemi (startup action) ekler ve bu eylem müşterinin Nets'ten dönüşüne de izin verir.

Eklenti yalnızca barındırılan ödeme sayfasını kullanır. Sayfa içine gömülü bir Nets ödemesi, abonelik veya yinelenen ödeme, kayıtlı kart, fatura ücreti, yalnızca yetkilendirme modu ve sevkiyat başına kısmi tahsilat desteklemez.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Nets'e yönlendirildi ve ödeme yapmadı ya da ödeme henüz onaylanmadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (default Processing): Nets ödemeyi onayladı ve tahsil etti. Bir not ödeme kimliğini, tahsilat kimliğini ve ödeme yöntemini gösterir.

Nets Payment On Hold Status (default Pending): Nets'teki tutar veya para birimi siparişten farklıdır (tahsil edilmedi), tahsilat reddedildi veya müşteri sipariş iptal edildikten sonra ödeme yaptı (rezerve edildi, tahsil edilmedi). Not bunu 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 rezervasyonu iptal edin.

Cancelled Status (default Canceled): siparişin rezervasyonu iptal edildi, örneğin Nets portalında.

Refunded Status (default Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Bir webhook veya müşterinin dönüşü siparişi beklemedeki durumdan ödenmiş duruma taşıdığında ya da iptal ettiğinde OpenCart müşteriyi bilgilendirir. Tekrarlanan webhook'lar ve sayfa yenilemeleri hiçbir zaman iki kez tahsilat yapmaz ve yinelenen not eklemez; ödenmiş bir sipariş Nets olaylarıyla bir daha değiştirilmez. Eski bir ödeme bağlantısı, zaten ödenmiş bir sipariş için veya aynı sepetin başka bir siparişi için tamamlanırsa, ikinci rezervasyon otomatik olarak serbest bırakılır; daha önce tahsil edilmişse bir not, Nets portalında iade etmenizi ister. Sipariş başka bir yolla ödenmiş olarak işaretlendiyse, rezerve edilmiş bir Nets ödemesi tahsil edilmez ve bir not bunu belirtir.

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

VibeFox Nets Nexi Gateway sekmesi

Sales > Orders bölümünde Nets ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Nets Nexi Gateway sekmesi Nets Easy payment bloğunu gösterir: ödeme kimliği, tahsilat kimliği, ortam (test ödemeleri için Test environment etiketiyle), durum ve ödeme yöntemi, Nets'te rezerve edilen ve tahsil edilen tutarlar, sipariş toplamı ve iade edilen tutar, iade formu, iade geçmişi ve siparişin Nets notes kayıtları. Sekme, eklentiye erişimi olan kullanıcılara gösterilir; düğmeleri eklentiyi değiştirme iznini gerektirir (System > Users > User Groups bölümünde ayarlanır).

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 rezervasyonu tahsil eder; başarısız bir tahsilattan sonra veya beklemedeki bir siparişi inceledikten sonra da bunu yapar. Hiçbir şey değişmezse bir not nedenini açıklar, örneğin müşterinin ödemeyi henüz tamamlamadığını. Bu düğmenin ayarladığı bir durum, bir iadenin ayarladığı durum gibi, e-posta gönderilmeden ve stok hareketi yapılmadan, doğrudan manuel bir durum değişikliği olarak uygulanır.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Nets düğmesine tıklayın. Refund this amount through Nets? This cannot be undone. sorusunu onaylayın. Ödeme tahsil edildikten sonra sipariş toplamına kadar tam ve kısmi iadeler desteklenir; yalnızca rezerve edilmiş bir ödeme Nets portalında iptal edilebilir. İade, siparişin ödemesinin yapıldığı ortamdaki tahsilata yapılır, bu nedenle o ortamın gizli anahtarı girilmiş olmalıdır. Nets iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Nets iade kimliğiyle eklenir. Tam iade siparişi Refunded Status durumuna getirir; kısmi iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri Nets üzerinden para geri göndermez. Nets portalında yapılan iadeler senkronize edilmez; gerekirse siparişi elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Nets Nexi Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Nets Nexi 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-nets-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 Nets, ö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 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 iadeler çalışır.

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

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 modda bir gizli anahtar bulunduğunu kontrol edin: test modunda Test Secret Key, canlı modda Live Secret Key. Anahtar eksikse ayarlar sayfası 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ı: webhook mağazanıza ulaşmadı. Mağazanın HTTPS kullandığını, böylece Webhooks altındaki adresin herkese açık bir HTTPS adresi olduğunu ve ödemenin ortamının gizli anahtarının girildiğini kontrol edin. Sipariş, müşteri ödemeden sonra mağazaya döndüğünde veya sipariş sekmesindeki Nets: check payment status and capture ile de durum alır.

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

Webhook Unknown payment yanıtı veriyor: ödeme bu mağaza tarafından oluşturulmadı.

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 rezervasyon henüz görünür değildi. Nets webhook'u otomatik olarak yeniden dener.

Webhook Order could not be updated, retry later yanıtı veriyor: sipariş durumu ayarlanamadı. Nets webhook'u yeniden dener. Nedenini görmek için Debug log seçeneğini açın.

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

Müşteri Confirm Order sonrasında bir hata görüyor: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. This payment method is temporarily unavailable. Please choose another payment method. genellikle yanlış veya eksik bir gizli anahtara işaret eder. Reddedilen para birimi Nets tarafından günlükte bildirilir. This payment method is not available. ise ödeme oturumunun artık siparişle eşleşmediği ya da bu arada ödeme yönteminin kapatıldığı anlamına gelir: müşteri ödeme sayfasını yeniler.

Müşteri We could not match this payment to an order mesajını görüyor: dönüş bağlantısı eksik veya başka bir siparişe ait. Müşteriden tahsilat yapıldıysa ödemeyi Nets portalında bulun ve siparişi kontrol edin.

Sipariş ödemeden sonra beklemedeki durumda: sekmedeki Nets notes kayıtlarını okuyun. Tahsilat reddedildiyse Nets: check payment status and capture ile tekrar deneyin ya da Nets portalında tahsil edin. Tutar veya para birimi uyuşmuyorsa ödemeyi Nets portalında kontrol edin. Müşteri iptalden sonra ödeme yaptıysa siparişi inceleyin ve rezervasyonu tahsil edin veya iptal edin.

Refund via Nets yok veya başarısız oluyor: iadeler yalnızca ödeme tahsil edildikten sonra mümkündür; sekmede o zaman bir tahsilat kimliği görünür. İade, siparişin ödendiği ortamın gizli anahtarını kullanır, bu nedenle o anahtar girilmiş olmalıdır; aksi halde sekme hangi ortam anahtarının eksik olduğunu belirtir.

Geliştiriciler için: ödeme oluşturulmadan önce eklenti, istek gövdesi ve siparişle birlikte OpenCart nng_create_payment_payload olayını tetikler; nng_currency_decimals bir para biriminin ondalık basamaklarını değiştirir.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Nets Nexi 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 Payment bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. OpenCart 4'te eklentinin olayları ve bakım modunda webhook'u 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, gizli anahtarlar, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Siparişlerin Nets ödeme verileri (ödemeler, tahsilatlar ve iadeler) her zaman saklanır; bu nedenle daha önce ödenmiş siparişler, yeniden kurulumdan sonra da iade 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, kurulu eklentiler listesinde VibeFox Nets Nexi Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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.