VibeFox Niubiz for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Mağaza para birimi: Peru solu (PEN) veya ABD doları (USD). Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Niubiz hesabı: Niubiz her ortam için bir merchant ID (código de comercio), bir API user ve bir API password verir. Sandbox kimlik bilgilerini Niubiz entegrasyon ekibi sağlar; canlı kimlik bilgileri ise Niubiz entegrasyonunuzu onayladıktan sonra verilir. Bir webhook kurmanız gerekmez: Niubiz yetkilendirmeye hemen yanıt verir.

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

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

3. Ayarları açın: WooCommerce > Settings > Payments > Niubiz > Manage veya 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. Sandbox mode seçeneğini açık tutun ve sandbox merchant ID, API user ve API password bilgilerini girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve Niubiz test kartlarıyla birkaç test ödemesi yapın.

7. Niubiz entegrasyonunuzu onayladıktan sonra canlı kimlik bilgilerini girin ve Sandbox mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Niubiz. Alanların üstünde sayfa; mağaza para birimi PEN veya USD değilse ya da mevcut modun kimlik bilgileri eksikse uyarır (her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir) ve sandbox modu açıkken Sandbox modu açık: ödemeler Niubiz sandbox ortamına gider ve gerçek bir tahsilat yapılmaz. mesajını gösterir. Ödeme yöntemleri listesinde, mevcut mod tam kimlik bilgilerine sahip olana kadar Niubiz kurulum gerektiriyor olarak işaretlenir.

Genel

Enable/Disable: Enable Niubiz payments ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: Credit or debit card (Niubiz).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with Visa, Mastercard, American Express or Diners Club in the Niubiz payment form.

Niubiz kimlik bilgileri

Niubiz, sandbox için ve sertifikasyondan sonra canlı ortam için size bir merchant ID, bir API user ve bir API password verir. Geliştirici belgeleri desarrolladores.niubiz.com.pe adresindedir.

Sandbox mode: Use the Niubiz sandbox (QA) environment — no real charges. Hem API uç noktalarını hem de aşağıdaki kimlik bilgisi kümesini değiştirir. Varsayılan: açık. Gerçek ödemeler için işaretini kaldırın.

Sandbox merchant ID: sandbox hesabınızın satıcı kodu, yalnızca rakam. Boşluklar kaldırılır. Değer başka karakterler içeriyorsa ayarlar sayfası bir hata gösterir ve önceki değeri korur.

Sandbox API user: sandbox API user değeri.

Sandbox API password: sandbox API password değeri.

Production merchant ID: canlı (bağlı) hesabınızın satıcı kodu, yalnızca rakam.

Production API user: canlı API user değeri.

Production API password: canlı API password değeri.

Ödeme formu

Logo URL: Niubiz ödeme formunda gösterilen logonuzun isteğe bağlı HTTPS adresi, yaklaşık 187 × 40 px. Bu alan yoksa mağaza adı gösterilir. https:// ile başlamayan bir adres reddedilir ve önceki değer korunur.

Gelişmiş

Debug log: Log API calls Niubiz isteklerini WooCommerce > Status > Logs bölümüne, kaynak wcp_niubiz_payment olarak yazar. Hatalar her zaman kaydedilir. Kimlik bilgileri, belirteçler ve kart ile müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kayıtlı ödeme verileri korunur. Varsayılan: kapalı.

Tek bir kimlik bilgisi kümesi bulunan 1.0 sürümünün ayarları otomatik olarak taşınır: test modu açıksa sandbox alanlarına, aksi halde canlı alanlara.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit or debit card (Niubiz)) ve siparişi verir. Eklenti, Niubiz'den sipariş tutarı için bir erişim belirteci ve bir ödeme oturumu ister ve müşteriyi mağazanızın sipariş ödeme sayfasına gönderir. Sandbox modunda ödeme sayfası ve ödeme ekranı SANDBOX MODU: Niubiz test kartlarını kullanın. Gerçek bir tahsilat yapılmaz. mesajını gösterir.

Ödeme sayfasında Niubiz ödeme formu otomatik olarak açılır. Sayfada ayrıca formu yeniden açmak için sipariş tutarını gösteren bir Pay düğmesi, bir Cancel order düğmesi ve bir Choose another payment method bağlantısı bulunur. JavaScript gereklidir. Niubiz formu yüklenemezse sayfa Niubiz ödeme formu yüklenemedi. Lütfen sayfayı yenileyin veya daha sonra tekrar deneyin. mesajını gösterir.

Müşteri kartını Niubiz formuna girer. Niubiz mağazanıza tek kullanımlık bir belirteç döndürür ve eklenti bunu siparişin kendi tutarı, para birimi ve satın alma numarasıyla sunucuda yetkilendirir. Ödeme hemen tahsil edilir. Sipariş yalnızca Niubiz ödemeyi onayladığında ve yanıt siparişle eşleştiğinde ödenmiş olarak işaretlenir. Müşteri daha sonra sipariş alındı sayfasını görür.

Reddedilen kart: müşteri, Niubiz'in nedeniyle birlikte Ödemeniz reddedildi: mesajıyla ödeme sayfasına döner ve aynı veya başka bir kartla tekrar deneyebilir. Form mesajın üzerinde yeniden açılmaz; müşteri Pay düğmesine tıklar.

Niubiz'den yanıt yok: Niubiz kesin bir yanıt vermezse (zaman aşımı, sunucu hatası, okunamayan yanıt), müşteri Niubiz ile ödemenizi doğrulayamadık. Lütfen tekrar ödeme yapmayın — mağaza ödemeyi kontrol edecek ve sizinle iletişime geçecektir. mesajıyla sipariş alındı sayfasını görür.

Oturum süresi doldu: ödeme oturumu en fazla 20 dakika geçerlidir. Oturum kullanıldığında veya sona ermek üzereyken ya da sipariş tutarı veya mod değiştiğinde ödeme sayfası yeni bir oturum oluşturur.

Her ödeme denemesi yeni bir satın alma numarası alır: sipariş kimliği ve ardından üç haneli bir deneme numarası (en fazla 12 karakter), çünkü Niubiz her yetkilendirme için benzersiz bir satın alma numarası ister. Müşteri, ödenmemiş veya başarısız bir siparişi Pay for order sayfasından yeniden ödeyebilir.

Ö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 tek seferlik kart ödemelerini kabul eder. WooCommerce üzerinden iade veya iptal yoktur; kayıtlı kart, abonelik veya tekrarlayan ödeme, taksit (cuotas) seçimi ve PagoEfectivo, Yape veya diğer cüzdanlar ve QR ödemeleri yoktur. Yanıt kaybolduğu için Beklemede olan siparişler otomatik olarak yeniden kontrol edilmez.

Siparişler

Sipariş durumları

Ödeme bekleniyor: müşteri ödeme sayfasına gönderildi ve henüz ödeme yapmadı.

İşleniyor: Niubiz ödemeyi onayladı ve yanıt siparişle eşleşti. Yalnızca indirilebilir sanal ürün içeren siparişler, WooCommerce'te olduğu gibi Tamamlandı durumuna geçer. Sipariş notu ortamı, işlem kimliğini, yetkilendirme kodunu, satın alma numarasını ve maskelenmiş kart numarasıyla kart markasını gösterir. Siparişin işlem kimliği Niubiz işlem kimliğidir.

Başarısız: kart reddedildi. Sipariş notu Niubiz nedenini, işlem kodunu ve satın alma numarasını gösterir. Müşteri yeniden ödeme yapabilir.

Beklemede, onaylandı ama eşleşmiyor: Niubiz, satın alma numarası, tutarı veya para birimi siparişten farklı olan ya da yanıtında tutar veya para birimi bulunmayan bir ödemeyi onayladı. Sipariş ödenmiş olarak işaretlenmez; not farkları listeler. Niubiz konsolunda işlemi kontrol edin. Müşteri Ödemeniz alındı ve mağaza tarafından inceleniyor. mesajını görür.

Beklemede, kesin yanıt yok: Niubiz net bir yanıt vermedi, bu nedenle kart tahsil edilmiş olabilir. Not satın alma numarasını verir. Bunu Niubiz konsolunda arayın: işlem onaylı ve doğruysa siparişi İşleniyor durumuna getirin; değilse iptal edin.

İptal edildi: müşteri ödeme sayfasında Cancel order düğmesine tıkladı veya sipariş sizin tarafınızdan ya da WooCommerce stok rezervasyonunun zaman aşımı nedeniyle iptal edildi.

Niubiz isteğin kendisini reddederse (örneğin yinelenen satın alma numarası, HTTP 406 veya geçersiz kimlik bilgileri), sipariş durumu değişmez. Bir not kartın tahsil edilmediğini belirtir ve müşteri yeni bir satın alma numarasıyla tekrar deneyebilir.

İadeler

İadeler ve iptaller WooCommerce'ten yapılamaz. İşlemi Niubiz konsolunda iade edin veya iptal edin, ardından siparişi manuel olarak güncelleyin; örneğin WooCommerce'te manuel bir iade yaparak.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Niubiz 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 ne zamana kadar etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key düğmesini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarın bir siteden kaldırılması alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Niubiz ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle yine görür; böylece bir 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: Niubiz formunda zaten başlatılmış ödemeler yetkilendirilmeye devam eder.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Niubiz ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, mevcut modun merchant ID, API user ve API password bilgilerinin doldurulduğunu (sandbox modunda sandbox alanları, aksi halde canlı alanlar) ve para biriminin PEN veya USD olduğunu kontrol edin. Pay for order sayfasında sipariş para birimi geçerlidir. Kimlik bilgileri veya para birimi yanlışsa ayarlar sayfası uyarı gösterir.

Ödeme gerçekleşti ama sipariş Ödeme bekleniyor durumunda kaldı: Niubiz bu ödeme formu için bir webhook kullanmaz, bu nedenle sipariş yalnızca yetkilendirme yanıtıyla güncellenir. Sipariş bir notla Beklemede durumundaysa satın alma numarasını Niubiz konsolunda arayın. Sipariş hâlâ Ödeme bekleniyor durumundaysa müşteri formu tamamlamamıştır; WooCommerce > Status > Logs bölümünde, kaynak wcp_niubiz_payment, kontrol edin.

Müşteri Niubiz'e bağlanamadık mesajını görüyor: erişim belirteci alınamadı. Mevcut modun API user ve API password bilgilerini ve sunucunuzun Niubiz API'sine erişip erişemediğini kontrol edin. Ayrıntılar için Debug log seçeneğini açın.

Müşteri Niubiz ödemesini başlatamadık mesajını görüyor: Niubiz ödeme oturumunu oluşturmadı. Mevcut modun merchant ID bilgisini ve günlüğü kontrol edin.

Müşteri Bu ödeme denemesi zaten işlendi mesajını görüyor: aynı form iki kez gönderildi. Müşteri ödemeyi ödeme sayfasında yeniden başlatır; kart iki kez tahsil edilmez.

Müşteri Ödeme oturumunuz sona erdi ve kartınızdan tahsilat yapılmadı mesajını görüyor: ödeme sayfası çok uzun süre açık kaldı. Müşteri aynı sayfada tekrar dener.

Sipariş notu: Niubiz yinelenen bir yetkilendirme bildirdi: Niubiz bu satın alma numarasını zaten biliyor. Niubiz konsolunda kontrol edin; müşteri yeni bir satın alma numarasıyla tekrar deneyebilir.

Sipariş Niubiz notuyla Beklemede: notu okuyun. Niubiz kesin bir yanıt vermedi veya siparişle eşleşmeyen bir ödemeyi onayladı. Satın alma numarasını Niubiz konsolunda arayın ve siparişi İşleniyor durumuna getirin ya da iptal edin.

Ayarlar kaydedilirken hata: bir merchant ID yalnızca rakam içerebilir ve logo URL'si geçerli bir https:// adresi olmalıdır. Önceki değer korunur.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için: Niubiz, satıcıya özgü anti-fraud alanlarını (MDD) göndermenizi isterse, bunları niubiz_p_merchant_define_data filtresiyle ekleyin. Anahtarlar MDD artı bir sayıdır, değerler en fazla 100 karakter olabilir. Diğer filtreler: niubiz_p_cardholder_data (ödeme oturumuyla gönderilen kart sahibi verileri), niubiz_p_purchase_number (bir denemenin satın alma numarası, 1 ila 12 harf veya rakam, her deneme için benzersiz) ve niubiz_p_icon (ödeme yönteminin simgesi).

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından 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 açıksa kaldırılır. Siparişlerde kayıtlı Niubiz verileri (işlem kimliği, satın alma numarası, maskelenmiş kart) ödeme geçmişinin parçasıdır ve her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Niubiz, sahibinin ticari markasıdır. Bu eklenti Niubiz ile bağlantılı değildir ve Niubiz tarafından onaylanmamıştır.