VibeFox Netopia for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: OpenSSL ve DOM uzantılarıyla birlikte 8.0 veya üzeri.

Para birimi: mağaza veya sipariş 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ına sahip bir Netopia Payments satıcı hesabına ihtiyacınız vardır. Teknik ayarlarından hesap imzasını ve kullandığınız her ortam (sandbox ve canlı) için 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 site: IPN (onay) URL'si internetten erişilebilir olmalıdır; oturum açma, temel kimlik doğrulama veya bakım sayfasının arkasında olmamalıdır. Siparişler yalnızca Netopia IPN'si ile güncellenir.

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_netopia_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 > Netopia Payments > 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. 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).

6. Enable/Disable seçeneğini açın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Netopia Payments. Alanların üstünde sayfa, etkin ortamın hesap imzası, sertifikası veya özel anahtarı eksikse uyarır (ödeme yöntemi bu durumda ö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. Ödeme yöntemleri listesinde, etkin ortam tamamlanana kadar Netopia kurulum gerektiriyor olarak işaretlenir. Kaydederken geçersiz bir sertifika veya özel anahtar hatayla reddedilir ve önceki değer korunur.

IPN (confirm) URL

Ayarların üstünde salt okunur olarak gösterilir. Şuna benzer: https://your-site/wc-api/netopia_payment_callback/. 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; eklenti bunu etkin ortamın özel anahtarıyla çözer ve hesap imzanızı ile ödeme isteğini doğrular. Netopia şu işlemleri bildirir:

Netopia hata koduyla gelen bir bildirim (örneğin reddedilen kart) ödenmemiş bir siparişi başarısız olarak işaretler. Çözülemeyen, başka bir hesap imzası taşıyan veya o siparişe ait 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: kapalı.

Title: ödeme sayfasında gösterilen ödeme yöntemi başlığı. Varsayılan: Card Payment (Netopia).

Description: ödeme sayfasında gösterilen ödeme yöntemi 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 tam içeriklerini 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: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Ödeme sayfasını ve anahtar çiftini değiştirir. Varsayılan: açık. Canlı anahtarlarla gerçek ödemeleri kabul etmek 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. Kaydedildikten sonra bir daha gösterilmez; alan A private key is saved. ifadesini gösterir. Kayıtlı anahtarı korumak için boş bırakın ya da yenisini yapıştırarak değiştirin.

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

Live private key (.key): canlı ortam özel anahtar dosyasının içeriği. Kaydedildikten sonra bir daha gösterilmez; kayıtlı anahtarı korumak için alanı boş bırakın.

Siparişler

Order status after payment: kargolanması gereken ödenmiş bir siparişin durumu. Yalnızca sanal veya indirilebilir ürün içeren siparişleri WooCommerce zaten tamamlar. Durum tek bir değişiklikle ve müşteriye tek bir e-postayla ayarlanır.

Gelişmiş

Debug log: Log requests and IPN processing seçeneği, WooCommerce > Status > Logs bölümüne, wcp_netopia_gateway kaynağıyla yazar. Kart verileri, anahtarlar ve müşteri ayrıntıları kaydedilmez. Reddedilen IPN'ler gibi hatalar, seçenek kapalı olsa bile her zaman kaydedilir. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept). Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan Card Payment (Netopia)) ve siparişi verir. 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 order düğmeleri bulunur. Ödeme isteği Netopia sertifikanızla şifrelenir ve sipariş toplamını sipariş para biriminde, Order # ile sipariş numarasını ve fatura ile teslimat bilgilerini içerir. Sandbox modunda istek Netopia sandbox ortamına gider.

Müşteri Netopia sayfasında kartla öder ve mağazanızın sipariş alındı sayfasına geri döner. Bu dönüş tek başına siparişi ödenmiş yapmaz. Sipariş, yalnızca Netopia IPN ile onayladıktan sonra ödenmiş olarak işaretlenir. O zamana kadar sipariş alındı sayfası Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. mesajını gösterir. Beklemedeki bir sipariş için Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. gösterilir. Ödeme iptal edildiyse The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time. görünür.

Kart reddedilirse sipariş başarısız olarak işaretlenir ve müşteri siparişin sayfasından yeniden ödeme yapabilir. Eklenti doğru yapılandırılmamışsa ödeme sayfası Netopia gateway is not configured properly. Please contact the store administrator. mesajını gösterir.

Ö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 kart ödemelerini yalnızca Netopia v1 kart protokolü üzerinden kabul eder. WooCommerce üzerinden iade veya tahsilat yoktur; kayıtlı kart veya tek tıkla ödeme, abonelik, taksit, SMS, banka havalesi veya kripto ödeme desteği yoktur ve Netopia API v2 desteklenmez.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Netopia'ya yönlendirildi veya Netopia henüz IPN göndermedi.

Processing or Completed: Netopia ödemeyi onayladı. Durum Order status after payment ayarını izler. Sipariş notu tutarı, maskelenmiş kart numarasını ve Netopia işlemini gösterir; sandbox ödemeleri [sandbox] ile işaretlenir. İşlem kimliği Netopia işlemidir.

On hold: ödeme, Netopia yönetim panelinde tahsil edilmeyi bekleyen bir ön yetkilendirmedir veya Netopia'da incelenmektedir. Netopia onayladığında sipariş ödenmiş olarak işaretlenir. Fatura tutarı veya para birimi siparişten farklıysa, ödemenin yalnızca bir kısmı tahsil edilmişse ya da Netopia iptal edilmiş bir siparişin ödemesini onaylamışsa sipariş ayrıca beklemeye alınır. Sipariş notu nedenini açıklar. İşlemi Netopia yönetim panelinde kontrol edin ve siparişi manuel olarak tamamlayın veya iade edin.

Failed: Netopia bir hata bildirdi, örneğin kart reddedildi. Müşteri yeniden ödeme yapabilir.

Cancelled: Netopia ödemeyi iptal etti veya müşteri Netopia'ya gitmeden önce Cancel order düğmesine tıkladı.

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

İadeler

İadeler WooCommerce üzerinden yapılmaz: Netopia v1 kart protokolünde iade çağrısı yoktur, bu nedenle Refund via düğmesi bulunmaz. İşlemi Netopia yönetim panelinde iade edin. Ardından Netopia bir alacak IPN'si gönderir ve eklenti iadeyi Refund initiated by Netopia. nedeniyle siparişe otomatik olarak kaydeder. Kısmi iadeler sipariş durumunu korur; iade edilecek bir şey kalmadığında WooCommerce siparişi Refunded olarak işaretler. 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 tutarı aşamaz. Stok otomatik olarak geri eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Netopia Payments 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 Netopia 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 Netopia yönetim panelinde yapılan iadeler yine kaydedilir.

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

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 tamam olduğunu (test modunda Account signature ile sandbox sertifikası ve özel anahtarı, canlı modda ise canlı ortamınkiler) ve mağaza veya sipariş para biriminin RON, EUR, USD veya GBP olduğunu kontrol edin. Eksik bir şey olduğunda ayarlar sayfası uyarı gösterir.

Ödeme yapıldı ama sipariş Pending payment durumunda kaldı: IPN mağazanıza ulaşmadı veya reddedildi. Ayarlardaki IPN (onay) URL'sinin internetten erişilebilir olduğunu kontrol edin (bakım modu, temel kimlik doğrulama veya güvenlik duvarı olmamalı). Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde, wcp_netopia_gateway kaynağında IPN satırlarını arayın. Müşterinin dönüşü tek başına siparişi asla ödenmiş yapmaz.

Log shows failed decrypting data: özel anahtar, Netopia'nın kullandığı ortamın sertifikasıyla eşleşmiyor. IPN, etkin ortamın anahtarıyla ve test modu değiştirilmeden önce başlatılan ödemeler için diğer ortamın anahtarıyla çözülür. Netopia isteği yeniden dener.

Log shows signature mismatch: Account signature, IPN'yi gönderen satış noktasıyla uyuşmuyor. Netopia yönetim panelinden yeniden kopyalayın.

Log shows unknown payment request: IPN, mağazanızın bu sipariş için bu ortamda (sandbox veya canlı) yaptığı bir ödeme isteğine yanıt vermiyor. Hiçbir şey değişmez.

Log shows gateway not configured: özel anahtar veya hesap imzası eksik. Netopia IPN'yi yeniden dener ve ayarlar tamamlandığında ödeme kaydedilir.

Error on save about the certificate or private key: yapıştırılan metin geçerli bir sertifika veya anahtar değil. BEGIN/END satırları dahil dosyanın tam içeriğini yapıştırın. Önceki değer korundu.

Order is On hold after payment: sipariş notunu okuyun. Ödeme bir ön yetkilendirme olabilir veya incelemede olabilir, tutar veya para birimi farklı olabilir, yalnızca bir kısmı tahsil edilmiş olabilir, sipariş iptal edilmiş olabilir ya da mağaza canlı moddayken bir sandbox ödemesi onaylanmış olabilir (gerçek para alınmadı). İşlemi Netopia yönetim panelinde kontrol edin.

A refund made in Netopia does not appear on the order: alacak IPN'si mağazaya ulaşmadı veya reddedildi. Günlüğü kontrol edin. Gerekirse WooCommerce'te manuel bir iade oluşturun.

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. Kayıtlı anahtarlar dahil ağ geçidi ayarları ile 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.

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