VibeFox Niubiz for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Para birimi: Peru solu (PEN) veya ABD doları (USD). Ödeme yöntemi yalnızca bu para birimlerinden birinde olan sepetler için sunulur. Diğer para birimlerinde ödeme adımında gizlenir.

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

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

Kurulum

1. Yönetim panelinde Modules > Module Manager sayfasına 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 Niubiz Payment modülünü bulup Configure düğmesine tıklayın.

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

4. Sandbox mode seçeneğini açık bırakın ve sandbox merchant ID, API user ve API password bilgilerini girin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve Niubiz test kartlarıyla birkaç test ödemesi yapın.

6. Niubiz entegrasyonunuzu onayladıktan sonra canlı ortam kimlik bilgilerini girin ve Sandbox mode seçeneğini kapatın.

Kurulumda modül Niubiz payment on hold sipariş durumunu oluşturur. PrestaShop, yeni bir ödeme modülünü o anda etkin olan tüm para birimlerine, müşteri gruplarına ve ülkelere bağlar. Bunu Payment > Preferences sayfasından değiştirebilirsiniz. Orada PEN veya USD'nin modül için izinli olduğunu kontrol edin.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Niubiz Payment > 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, mağazada etkin bir PEN veya USD para birimi yoksa ya da geçerli modun kimlik bilgileri eksikse sizi uyarır (her iki durumda da ödeme yöntemi ödeme adımında gizlenir). Mağazanın varsayılan para birimi PEN veya USD değilse, sayfa Niubiz'in yalnızca PEN veya USD sepetleri için sunulduğunu belirtir. Sandbox modu açık olduğu sürece sayfa şunu gösterir: Sandbox modu açık: ödemeler Niubiz sandbox'ına gider ve gerçek bir tahsilat yapılmaz.

Niubiz

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

Title: müşterilerin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak saklanır. Varsayılan: Credit or debit card (Niubiz). Zorunlu: boş bir başlık kaydedilmez ve önceki başlık korunur.

Description: ödeme adımı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 bir merchant ID, bir API user ve bir API password verir; sertifikasyondan sonra ise canlı ortam için de verir. Geliştirici belgeleri desarrolladores.niubiz.com.pe adresinde bulunur.

Sandbox mode: Niubiz sandbox (QA) ortamını kullanır, gerçek tahsilat yapılmaz. Hem API uç noktalarını hem de aşağıdaki kimlik bilgisi setini değiştirir. Varsayılan: açık. Gerçek ödemeler için kapatın. Açık olduğu sürece müşteriler, ödeme yönteminin altında ve ödeme sayfasında SANDBOX MODU: Niubiz test kartlarını kullanın — gerçek tahsilat yapılmaz. mesajını görür.

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

Sandbox API user: sandbox API user'ı.

Sandbox API password: sandbox API password'ü.

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

Production API user: canlı ortam API user'ı.

Production API password: canlı ortam API password'ü.

Kaydedilmiş parolalar bir daha gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

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

Ödeme formu

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

Gelişmiş

Debug log: Niubiz API çağrılarını modül klasöründeki logs/niubiz_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, bu anahtar kapalı olsa bile her zaman kaydedilir. Kimlik bilgileri, belirteçler, kart ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete data on uninstall: açıksa modül kaldırıldığında ayarları ve günlük silinir. Siparişler için kaydedilen ödeme verileri (Niubiz denemeleri, sipariş notları) ve sipariş durumu her zaman korunur. Varsayılan: kapalı.

Ödeme adımı

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit or debit card (Niubiz)) ve siparişi verir. Modül, Niubiz'den sepet para biriminde sepet tutarı için bir erişim belirteci ve bir ödeme oturumu ister ve mağazanızın Niubiz payment ödeme sayfasını açar. Bu noktada henüz bir sipariş yoktur.

Ödeme sayfasında Niubiz ödeme formu otomatik olarak açılır. Sayfa şunu söyler: Güvenli Niubiz ödeme formunda ödemeyi tamamlayın — kart bilgileriniz bu siteye değil, Niubiz'e girilir. Ayrıca formu yeniden açmak için sepet tutarını gösteren bir Pay düğmesi ve bir Choose another payment method bağlantısı bulunur. JavaScript gereklidir. Niubiz formu yüklenemezse sayfa şunu gösterir: Niubiz ödeme formu yüklenemedi. Lütfen sayfayı yenileyin veya daha sonra tekrar deneyin.

Müşteri kartını Niubiz formuna girer. Niubiz, mağazanıza tek kullanımlık bir belirteç döndürür ve modül bunu sunucuda, oturumun tutarı, para birimi ve satın alma numarasıyla, oturumun oluşturulduğu ortamda yetkilendirir. Ödeme hemen tahsil edilir. Sipariş, yalnızca Niubiz ödemeyi onayladığında ve yanıt sepetle eşleştiğinde ödenmiş olarak işaretlenir. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Reddedilen kart: sipariş oluşturulmaz. Müşteri, Ödemeniz reddedildi: ve Niubiz'in nedeni ile birlikte ödeme sayfasına döner ve aynı kartla ya da 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), sipariş Niubiz payment on hold durumunda oluşturulur ve onay sayfası Ödemenizi Niubiz ile doğrulayamadık. Lütfen tekrar ödeme yapmayın — mağaza ödemeyi kontrol edecek ve sizinle iletişime geçecek. mesajını gösterir. Niubiz sepetle eşleşmeyen bir ödemeyi onayladıysa sayfa şunu gösterir: Ödemeniz alındı ve mağaza tarafından inceleniyor. Başka bir şey gerekirse sizinle iletişime geçeceğiz.

İstek reddedildi: Niubiz isteğin kendisini reddederse (örneğin geçersiz kimlik bilgileri veya yinelenen bir satın alma numarası), sipariş oluşturulmaz ve müşteri Niubiz ödemeyi işleyemedi ve kartınızdan tahsilat yapılmadı. mesajını görür. Neden günlüğe yazılır.

Sepet değişti: form açıldıktan sonra sepet tutarı değişirse (örneğin tarayıcının başka bir sekmesinde), ödeme yetkilendirilmez ve müşteri Ödeme formu açıldıktan sonra sepetiniz değişti, bu nedenle kartınızdan tahsilat yapılmadı. Lütfen tutarı kontrol edip tekrar ödeme yapın. mesajını görür.

Oturum süresi doldu: bir Niubiz ödeme oturumu en fazla 20 dakika geçerlidir. Oturum zaten kullanılmışsa, 5 dakikadan az süresi kalmışsa, başka bir moda veya satıcı kimliğine aitse ya da sepet tutarı değişmişse, ödeme sayfası yeni bir oturum oluşturur.

Her ödeme denemesi yeni bir satın alma numarası alır: sepet 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.

Modül yalnızca tek seferlik kart ödemelerini kabul eder. PrestaShop üzerinden iade veya iptal yoktur; kayıtlı kart, abonelik veya yinelenen ödeme yoktur, taksit (cuotas) seçimi yoktur, PagoEfectivo, Yape veya diğer cüzdanlar ve QR ödemeleri de desteklenmez. Yanıt kaybolduğu için beklemeye alınan siparişler otomatik olarak yeniden kontrol edilmez.

Siparişler

Sipariş durumları

No order yet: müşteri ödeme sayfasındadır ve henüz ödeme yapmamıştır ya da kart reddedilmiş ya da istek geri çevrilmiştir. Yalnızca sepet vardır. Reddetmeler ve geri çevirmeler modül günlüğüne yazılır.

Payment accepted: Niubiz ödemeyi onaylamış ve yanıt sepetle eşleşmiştir. Ödeme, Niubiz işlem kimliği ile kaydedilir; bir not ortamı, işlem kimliğini, yetkilendirme kodunu, satın alma numarasını ve maskelenmiş numaralı kart markasını gösterir.

Niubiz payment on hold, approved but not matching: Niubiz, satın alma numarası, tutarı veya para birimi sepetten farklı olan ya da yanıtında tutar veya para birimi bulunmayan bir ödemeyi onaylamıştır. Sipariş ödenmiş olarak işaretlenmez. Onay sepet para biriminde ise onaylanan tutar, işlem kimliğiyle birlikte bir ödeme olarak kaydedilir. Not farkları listeler. İşlemi Niubiz konsolunda kontrol edin.

Niubiz payment on hold, no definitive answer: Niubiz net bir yanıt vermedi, bu nedenle kart tahsil edilmiş olabilir. Hiçbir ödeme kaydedilmez. Not satın alma numarasını verir. Bunu Niubiz konsolunda arayın: işlem onaylı ve doğruysa siparişi Payment accepted durumuna getirin; değilse iptal edin.

Zaten siparişi olan bir sepet için ikinci bir ödemeye yanıt gelirse ikinci bir sipariş oluşturulmaz. Siparişteki bir not, satın alma numarasını, işlem kimliğini ve tutarı verir; böylece bunları Niubiz konsolunda kontrol edebilir ve gerekirse iade edebilir veya iptal edebilirsiniz.

Niubiz ödeme bloğu

Sipariş sayfasında satın alma numarası, ortam (sandbox veya canlı), işlem kimliği, yetkilendirme kodu, kart ve siparişin notlarını içeren bir Niubiz payment bloğu gösterilir. Niubiz payment on hold durumundaki bir sipariş için blok, satın alma numarasını Niubiz konsolunda kontrol etmenizi hatırlatır. Blok salt okunurdur.

İadeler

İadeler ve iptaller PrestaShop üzerinden yapılamaz. İşlemi Niubiz konsolunda iade edin veya iptal edin ve siparişi elle güncelleyin. Sipariş sayfasındaki standart PrestaShop iade düğmeleri, Niubiz üzerinden para geri göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Niubiz Payment lisans bloğu, Modules > Module Manager > VibeFox Niubiz Payment > Configure sayfasının en üstündeki ilk bloktur ve ayarların üstünde yer alır. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarihi 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: presta-payment-niubiz satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir, örneğin Anahtar bulunamadı, Bu anahtar başka bir ürüne ait, Alan adı sınırına ulaşıldı veya tarihiyle birlikte Lisans şu tarihte sona erdi. Mağazanın 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 yalnızca bir alan adında çalışır: çoklu mağaza kurulumunda da ana mağazanın alan adında. 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 Niubiz, ödeme adımı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 bir yöntem seçin. mesajını görür. PrestaShop vitrini arka ofise giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, arka ofiste çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün 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

Niubiz ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun merchant ID, API user ve API password bilgilerinin doldurulduğunu (sandbox modunda sandbox alanları, aksi halde canlı alanlar) ve sepet para biriminin PEN veya USD olduğunu kontrol edin. Kimlik bilgileri veya para birimleri yanlışsa ayarlar sayfası bir uyarı gösterir. Payment > Preferences sayfasında modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Niubiz bu ödeme formu için bir webhook kullanmaz; bu nedenle sipariş yalnızca yetkilendirme yanıtıyla oluşturulur. Müşteri formu tamamlamadıysa sipariş yoktur. Aksi halde modül sayfasındaki Log alanına bakın ve satın alma numarasını Niubiz konsolunda arayın. Niubiz yanıt verdi ama sipariş oluşturulamadıysa (örneğin modül kapalıydı), müşteri Ödemeniz alındı, ancak sipariş otomatik olarak tamamlanamadı. Lütfen bizimle iletişime geçin — tekrar ödeme yapmayın. mesajını görür; müşteri ödeme sayfasını yeniden açtığında modül siparişi oluşturmayı yeniden dener.

Müşteri «Niubiz'e bağlanamadık» mesajını görüyor: erişim belirteci alınamadı. Geçerli 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 ödemesi başlatılamadı» mesajını görüyor: Niubiz ödeme oturumunu oluşturmadı. Geçerli 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 ödeme sayfasında ödemeyi yeniden başlatır; kart iki kez tahsil edilmez.

Müşteri «Bu sipariş zaten ödeniyor» mesajını görüyor: başka bir istek bu sepeti şu anda yetkilendiriyor. Müşteri bir süre bekler ve tekrar denemeden önce e-postasını kontrol eder.

Günlükte Niubiz'in yinelenen bir yetkilendirme bildirdiği görünüyor: 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 payment on hold durumunda: Niubiz payment bloğundaki notları okuyun. Niubiz kesin bir yanıt vermedi ya da sepetle eşleşmeyen bir ödemeyi onayladı. Satın alma numarasını Niubiz konsolunda arayın ve siparişi Payment accepted durumuna getirin ya da iptal edin.

Ayarları kaydederken hata: bir merchant ID yalnızca rakamlardan oluşmalıdır ve logo URL'si geçerli bir https:// adresi olmalıdır. Önceki değer korunur.

Geliştiriciler için: Niubiz satıcıya özgü antifraud alanlarının (MDD) gönderilmesini isterse, başka bir modül bunları actionNiubizPMerchantDefineData kancasıyla ekleyebilir. Ödeme oturumuyla gönderilen kart sahibi verileri actionNiubizPCardholderData kancasıyla değiştirilebilir.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Niubiz Payment modülünün yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için korunur. Niubiz ödeme denemeleri (satın alma numaraları, ortam, işlem kimlikleri) ve Niubiz payment on hold sipariş durumu, ödeme geçmişi olarak her zaman korunur. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini saklamayı sürdürür.

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