VibeFox Netopia for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: OpenSSL, DOM ve SimpleXML uzantılarıyla birlikte 8.0 veya üzeri. Bu uzantılar olmadan modül kurulmaz.

Para birimi: sepet para birimi RON, EUR, USD veya GBP olmalıdır. EUR, USD ve GBP, Netopia hesabınızda etkinleştirilmiş olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Netopia hesabı: bir satış noktası olan bir Netopia Payments satıcı hesabına ihtiyacınız vardır. Teknik ayarlarından hesap imzasını ve kullandığınız her ortam için (sandbox ve canlı) ortak sertifikayı (.cer) ve özel anahtarı (.key) almanız gerekir. Netopia tarafında herhangi bir ayar yapmanız gerekmez: IPN adresi her ödeme isteğiyle birlikte gönderilir.

Herkese açık mağaza: IPN (onay) URL'si internetten erişilebilir olmalıdır; oturum açma veya temel kimlik doğrulama arkasında olmamalıdır. Siparişler yalnızca Netopia IPN'si ile oluşturulur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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 Netopia Gateway öğesini bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğunda bulunan License key alanına girin ve Activate düğmesini tıklayın (bkz. Lisans anahtarı).

4. Netopia yönetim panelinde satış noktanızı açın, hesap imzasını kopyalayın ve sandbox ile canlı ortamın sertifikasını ve özel anahtarını indirin. İmzayı ve dosyaların tam içeriğini ayarlara yapıştırın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini etkinleştirin ve Save düğmesine tıklayın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting Netopia payment ve Netopia payment on hold. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Netopia 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, etkin ortamın hesap imzası, sertifikası veya özel anahtarı eksikse sizi uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve test modu açıkken Test mode is on: payments go to the Netopia sandbox and no real money is charged. mesajını gösterir. Kaydederken geçersiz bir sertifika veya özel anahtar hatayla reddedilir ve önceki değer korunur; diğer alanlar kaydedilir.

IPN (confirm) URL

Sayfanın üstünde salt okunur olarak gösterilir. Dostu URL'ler etkinken şöyle görünür: https://your-shop/module/wcp_netopia_gateway/notify; gerekirse /en/ gibi bir dil kodu içerebilir. Her ödeme isteğiyle onay URL'si olarak gönderildiği için bunu Netopia yönetim panelinde girmeniz gerekmez. Netopia IPN'yi bu URL'ye gönderir. Modül, IPN'yi ödemenin başlatıldığı ortamın özel anahtarıyla çözer ve hesap imzanızı ile ödeme isteğini doğrular. Netopia şu işlemleri bildirir:

Bir Netopia hata koduyla (örneğin reddedilen bir kart) gelen bildirim, bekleyen bir siparişi Payment error durumuna alır; sipariş yoksa müşteri yeniden ödeme yapabilir. Çözülemeyen, başka bir hesap imzası taşıyan veya o sepetin bir ödeme isteğine yanıt vermeyen bildirimler reddedilir ve hiçbir şeyi değiştirmez.

Ödeme sayfası

Enable/Disable: Enable Netopia Payments ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: ödeme sayfasında gösterilen ödeme yönteminin başlığı. Aynı zamanda siparişte saklanan ödeme yöntemi adıdır. Varsayılan: Card Payment (Netopia).

Description: ödeme sayfasında gösterilen ödeme yönteminin açıklaması. Varsayılan: Pay securely with your credit or debit card via Netopia.

Netopia hesabı

Netopia yönetim panelinde Seller accounts > your point of sale > Technical settings bölümüne gidin: hesap imzasını kopyalayın ve her ortamın ortak sertifikasını (.cer) ve özel anahtarını (.key) indirin. Dosyaları bir metin düzenleyicide açın ve BEGIN/END satırları dahil tüm içeriğini yapıştırın.

Account signature: satıcı hesabının imzası (XXXX-XXXX-XXXX-XXXX-XXXX biçiminde); sandbox ve canlı için aynıdır.

Test mode: Netopia sandbox'ını (sandboxsecure.mobilpay.ro) ve sandbox anahtarlarını kullanır. Varsayılan: on. Gerçek ödemeleri canlı anahtarlarla almak için kapatın.

Sandbox public certificate (.cer): sandbox ortak sertifika dosyasının içeriği. Ödeme isteğini şifrelemek için kullanılır.

Sandbox private key (.key): sandbox özel anahtar dosyasının içeriği. IPN'yi çözmek için kullanılır.

Live public certificate (.cer): canlı ortak sertifika dosyasının içeriği.

Live private key (.key): canlı özel anahtar dosyasının içeriği.

Kayıtlı özel anahtarlar bir daha asla gösterilmez. Alan boş kalır ve yardım metni A private key is saved. ifadesiyle başlar. Kayıtlı anahtarı korumak için alanı boş bırakın ya da onu değiştirmek için yeni bir anahtar yapıştırın. Boş bir sertifika alanı sertifikayı kaldırır.

Clear saved private keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı anahtarı korur.

Siparişler

Order status after payment: ödenmiş bir siparişin durumu.

Gelişmiş

Debug log: istekleri ve IPN işlemesini logs/netopia_p_debug.log.php dosyasına, modül klasörüne yazar. Dosya web üzerinden açılamaz. Kart verileri, anahtarlar ve müşteri verileri günlüğe yazılmaz. Reddedilen IPN'ler gibi hatalar, seçenek kapalı olsa bile her zaman günlüğe yazılır. Varsayılan: off.

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

Delete data on uninstall: modül kaldırıldığında ağ geçidi ayarlarını, modülün Netopia ödeme kayıtlarını ve günlüğü siler. Siparişler korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Card Payment (Netopia)) ve onaylar. Sonraki sayfa Redirecting you to Netopia for secure payment… mesajını gösterir ve müşteriyi otomatik olarak Netopia ödeme sayfasına yönlendirir; yedek olarak Proceed to payment ve Cancel (ödeme sayfasına geri döner) düğmeleri bulunur. Ödeme isteği Netopia sertifikanızla şifrelenir ve sepet toplamını sepet para biriminde, Cart # ile sepet numarasını ve fatura ile teslimat iletişim bilgilerini içerir. Sandbox modunda istek Netopia sandbox'ına gider. Bu noktada henüz bir sipariş yoktur.

Müşteri Netopia sayfasında kartla öder ve mağazanıza geri döner. Bu dönüş kendi başına hiçbir zaman sipariş oluşturmaz veya ödemez. Sipariş, ancak Netopia IPN ile onayladığında ödenmiş olarak işaretlenir. Sipariş varsa müşteri standart sipariş onay sayfasını görür. Bekleyen bir sipariş için Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. gösterilir. Beklemeye alınmış bir sipariş için Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. gösterilir. İptal edilmiş bir sipariş için The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. gösterilir. Ödeme hatası olan bir sipariş için The payment was declined by Netopia. gösterilir.

Müşteri geri döndüğünde IPN henüz gelmemişse Payment confirmation sayfası aynı "henüz onaylanmadı" metnini, Check again ve Back to checkout düğmeleriyle gösterir. IPN gelir gelmez sipariş oluşturulur.

Netopia, herhangi bir sipariş oluşturulmadan önce iptal veya red bildirdiyse müşteri şu mesajlarla ödeme sayfasına geri döner: The payment was cancelled at Netopia. You can try again or choose another payment method. veya The payment was declined by Netopia. You can try again or choose another payment method. Sepet korunur. Her yeni deneme yeni bir ödeme isteğidir; sepetin önceki istekleri geçerli kalır, bu yüzden önceki bir denemenin geç gelen IPN'si yine de kaydedilir.

Modül doğru ayarlanmamışsa müşteri Netopia gateway is not configured properly. Please contact the store administrator. mesajıyla ödeme sayfasında kalır. Diğer mesajlar şunlardır: para biriminin eklendiği Netopia cannot process payments in, This order has nothing to pay. ve Payment encryption failed. Please try again or contact support. Teknik neden günlüğe yazılır.

IPN, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül kart ödemelerini yalnızca Netopia v1 kart protokolü üzerinden kabul eder. PrestaShop üzerinden iade veya tahsilat, kayıtlı kart veya tek tıkla ödeme, abonelik, taksit veya diğer ödeme yöntemleri yoktur ve Netopia API v2 desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Netopia'ya yönlendirildi ve henüz ödeme yapmadı ya da Netopia henüz IPN göndermedi. Yalnızca sepet vardır.

Payment accepted or Delivered: Netopia ödemeyi onayladı. Durum Order status after payment ayarını izler. Ödeme, Netopia işlemini işlem kimliği olarak kullanarak kaydedilir; özel bir not tutarı, maskelenmiş kart numarasını ve Netopia işlemini gösterir; sandbox ödemeleri [sandbox] ile işaretlenir.

Awaiting Netopia payment: ödeme, Netopia yönetim panelinde tahsil edilmeyi bekleyen bir ön provizyondur veya Netopia'da incelemededir. Henüz bir ödeme kaydedilmemiştir. Netopia onayladığında sipariş ödenmiş duruma geçer.

Netopia payment on hold: fatura tutarı veya para birimi sepetten ya da siparişten farklıdır, ödemenin yalnızca bir kısmı tahsil edilmiştir, Netopia iptal edilmiş bir siparişin ya da başka bir ödeme yöntemiyle verilmiş bir siparişin ödemesini onaylamıştır veya mağaza canlı modundayken bir sandbox (test) ödemesi onaylanmıştır (gerçek para alınmadığı için hiçbir ödeme kaydedilmez). Not bunu açıklar. İşlemi Netopia yönetim panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi orada iade edin.

Payment error: bekleyen bir sipariş için Netopia, örneğin reddedilen bir kart gibi bir hata bildirdi.

Canceled: Netopia bekleyen bir siparişin ödemesini iptal etti.

Refunded: ödeme Netopia yönetim panelinde tamamen iade edildi.

Geç gelen bildirimler, ödenmiş veya kapatılmış bir siparişin durumunu asla düşürmez. Netopia, zaten ödenmiş bir sipariş için başka bir ödeme onaylarsa bir not, mükerrer ödemeyi Netopia yönetim panelinden iade etmenizi ister.

Netopia bloğu

Sipariş sayfası, Netopia işlemi, ortam (sandbox veya canlı), ödeme isteği, son IPN işlemi, maskelenmiş kart, ödenen, iade edilen ve kalan tutarlar ile iade geçmişini gösteren bir Netopia Payments bloğu içerir. Blok salt okunurdur.

İadeler

İadeler PrestaShop üzerinden yapılmaz: Netopia v1 kart protokolünde iade çağrısı yoktur. İşlemi Netopia yönetim panelinde iade edin. Netopia bunun üzerine bir kredi IPN'si gönderir ve modül iadeyi Netopia refund processed: notu ve tutarla siparişe otomatik olarak kaydeder. Kısmi bir iade sipariş durumunu korur; iade edilecek bir şey kalmadığında sipariş Refunded durumuna getirilir. EUR, USD ve GBP siparişlerinde, Netopia'nın RON cinsinden bildirdiği iade tutarı sipariş para birimine geri çevrilir. Bir iade asla iki kez kaydedilmez ve kalan tutardan fazla kaydedilmez. Netopia iade için bir hata bildirirse yalnızca bir not eklenir.

Modül kredi notu oluşturmaz ve ürünleri stoğa geri eklemez. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Netopia üzerinden para geri göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Netopia Gateway lisans bloğu, Modules > Module Manager > VibeFox Netopia Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesini tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-netopia satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli 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üğmesini tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 Netopia, ö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. PrestaShop vitrini, yönetim paneline giriş yaptığınızı bilmediğinden ö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 Netopia yönetim panelinde yapılan iadeler yine kaydedilir.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum 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. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Netopia ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, etkin ortamın eksiksiz olduğunu (test modunda sandbox için Account signature ile sertifika ve özel anahtar, canlı modda ise canlı ortam için aynıları) ve sepet para biriminin RON, EUR, USD veya GBP olduğunu kontrol edin. Ayarlar sayfası eksik bir şey olduğunda 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ı: IPN mağazanıza ulaşmadı veya reddedildi. Ayarlardaki IPN (onay) URL'sinin internetten erişilebilir olduğunu kontrol edin (temel kimlik doğrulama veya güvenlik duvarı olmamalı). Modül sayfasındaki Log alanına bakın: reddedilen IPN'ler her zaman günlüğe yazılır. Her IPN'yi görmek için Debug log seçeneğini açın. Müşterinin dönüşü tek başına hiçbir zaman sipariş oluşturmaz.

Günlükte failed decrypting data görünüyor: özel anahtar, Netopia'nın kullandığı sertifikayla eşleşmiyor. IPN, her ortamın kayıtlı özel anahtarıyla çözülür; bu yüzden diğer ortamın ödemeleri açık olduğu sürece onun anahtarını kayıtlı tutun. Netopia IPN'yi yeniden dener.

Günlükte signature mismatch görünüyor: Account signature, IPN'yi gönderen satış noktasından farklıdır. Netopia yönetim panelinden yeniden kopyalayın.

Günlükte unknown payment request görünüyor: IPN, mağazanızın o sepet için o ortamda (sandbox veya canlı) yaptığı bir ödeme isteğine yanıt vermiyor. Hiçbir şey değişmez.

Günlükte gateway not configured görünüyor: kayıtlı özel anahtar veya hesap imzası yok. Netopia IPN'yi yeniden dener ve ayarlar tamamlandığında ödeme kaydedilir.

Günlükte busy, retry later or processing failed görünüyor: sepet aynı anda başka bir istek tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı olduğu için). Netopia IPN'yi otomatik olarak yeniden dener.

Sertifika veya özel anahtar hakkında kaydetme hatası: yapıştırılan metin geçerli bir sertifika veya anahtar değil. Dosyanın BEGIN/END satırları dahil tüm içeriğini yapıştırın. Önceki değer korundu.

Sipariş, ödemeden sonra Netopia payment on hold durumunda: siparişin özel notunu okuyun (bkz. Sipariş durumları). Tutar veya para birimi farklıydı, yalnızca bir kısmı tahsil edildi, sipariş iptal edilmişti ya da mağaza canlı modundayken bir sandbox ödemesi onaylandı. Netopia yönetim panelinde işlemi kontrol edin.

Netopia'da yapılan bir iade siparişte görünmüyor: kredi IPN'si mağazaya ulaşmadı veya reddedildi. Günlüğü kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Netopia 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 ağ geçidi ayarları (kayıtlı anahtarlar dahil), modülün Netopia ödeme kayıtları (siparişlerin Netopia bloğunda gösterilen) ve günlük silinir. Kapalıysa her şey sonraki bir yeniden kurulum için saklanır. Siparişler ve Awaiting Netopia payment ile Netopia payment on hold sipariş durumları hiçbir zaman silinmez. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Netopia Payments ve mobilPay, ilgili sahiplerinin ticari markalarıdır. Bu modül Netopia Payments ile bağlantılı değildir ve onun tarafından onaylanmamıştır.