VibeFox Barion for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Barion mağazası: mağazanızın POSKey'i (gizli anahtar) ile ödemeleri alacak Barion wallet'ının e-posta adresine ihtiyacınız var. Her ikisi de Barion portalında bulunur: canlı için secure.barion.com, test için secure.test.barion.com; My stores ve mağazanız altında. Test ve canlı kimlik bilgileri farklıdır.

Para birimi: sepet para birimi HUF, EUR, USD veya CZK olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Erişilebilir mağaza: Barion her ödemeden sonra mağazanızı çağırır; bu nedenle site, önünde güvenlik duvarı veya temel kimlik doğrulama olmadan internetten erişilebilir olmalıdır.

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 sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Barion Gateway öğesini 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. Test POSKey'ini ve test wallet e-postasını girin, Test Mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test siparişi verin.

5. Her şey çalıştığında canlı kimlik bilgilerini girin ve Test Mode seçeneğini kapatın.

Geri çağırma URL'si her ödemeyle birlikte Barion'a otomatik olarak gönderilir. Barion portalında herhangi bir ayar yapmanız gerekmez.

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

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Barion Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Alanların üstünde sayfa, geçerli modda POSKey veya alıcı e-postası yoksa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanızın varsayılan para birimi Barion tarafından desteklenmiyorsa sizi uyarır; desteklenen para birimlerinin listesi de gösterilir. Test modu açık olduğu sürece şu mesajı gösterir: Test modu açık: ödemeler Barion sandbox ortamına (api.test.barion.com) gider, gerçek para tahsil edilmez.

Barion

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Barion. Zorunlu.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.

Barion mağaza kimlik bilgileri

POSKey'inizi ve wallet e-postanızı Barion portalından alın: secure.barion.com (canlı) veya secure.test.barion.com (test), My stores, mağazanız. Test modu yalnızca test kimlik bilgilerini, canlı mod yalnızca canlı kimlik bilgilerini kullanır.

Test Mode: aşağıda girilen test kimlik bilgilerini ve Barion sandbox ortamını (api.test.barion.com) kullanır. Gerçek para tahsil edilmez. Varsayılan: açık. Gerçek ödeme almak için kapatın. Açık olduğu sürece müşteriler ödeme yönteminin altında Test modu: gerçek ödeme alınmaz. mesajını görür.

Test POSKey: Barion test sistemindeki mağazanızın gizli anahtarı (POSKey) (secure.test.barion.com, My stores).

Test Payee Email: test ödemelerini alan Barion test wallet'ınızın e-posta adresi.

Live POSKey: Barion canlı sistemindeki mağazanızın gizli anahtarı (POSKey) (secure.barion.com, My stores).

Live Payee Email: ödemeleri alan Barion wallet'ınızın e-posta adresi.

Kayıtlı POSKey'ler bir daha asla 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 POSKeys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Callback URL: Barion'un her ödemeden sonra çağırdığı adres; örneğin SEO dostu URL'lerle https://your-shop/module/wcp_barion_gateway/callback, gerekirse /en/ gibi bir dil koduyla. Her ödemeyle birlikte Barion'a gönderildiği için yapılandırılacak bir şey yoktur. Yalnızca internetten erişilebilir olması gerekir.

Siparişler

Order Status After Payment: başarılı ve doğrulanmış bir ödemeden sonra ayarlanan sipariş durumu.

Barion'da hâlâ işlenen ödemeler Awaiting Barion payment durumunda bekler. Tutar veya para birimi uyuşmazlıkları her zaman Barion payment on hold durumuna gider.

Gelişmiş

Logging: Barion isteklerini ve geri çağırmalarını modül klasöründeki logs/barion_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Gizli anahtarlar ve wallet e-postaları günlüğe yazılmaz. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz.

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çıkken modülü kaldırmak, modül ayarlarını ve günlüğü siler. Siparişler, Barion ödeme verileri ve sipariş durumları her zaman korunur. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Barion) ve Güvenli Barion ödeme sayfasına yönlendirileceksiniz. notunu görür. Onaylandıktan sonra modül, sepet toplamı için sepet para biriminde bir Barion ödemesi başlatır ve müşteriyi Barion ödeme sayfasına gönderir. Ödemede ürünler, kargo, hediye paketi ve vergi listelenir; ödeme sepet numarasıyla birlikte Cart olarak görünür; müşterinin e-postası ipucu olarak iletilir ve sayfanın dili, Barion'un desteklediği durumlarda sepetin diline göre belirlenir. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner ve Barion ayrıca geri çağırma URL'sini çağırır. Bu isteklerin hiçbiri tek başına bir şeyi ödenmiş olarak işaretlemez: modül, ödemenin başlatıldığı modun POSKey'ini kullanarak Barion'dan ödeme durumunu sorar. Sipariş yalnızca Barion onayladığında ve tutar ile para birimi sepetle eşleştiğinde ödenmiş olarak işaretlenir. Dönüş bağlantısı sepetin güvenli anahtarını içerir ve yalnızca o sepet için başlatılan ödemeler kontrol edilir.

Ödeme başarılıysa sipariş oluşturulur ve müşteri Barion ile yaptığınız ödeme alındı. mesajını içeren standart sipariş onay sayfasını görür. Ödeme Barion'da hâlâ devam ediyorsa sipariş Awaiting Barion payment durumunda oluşturulur ve sayfa Ödemeniz Barion tarafından onaylanıyor. Onaylandığı anda size bir e-posta gönderilecek. mesajını gösterir. Böyle bir ödeme daha sonra Barion'da iptal edilir, süresi dolar veya başarısız olursa sayfa Barion ödemeniz tamamlanmadı. Bu sipariş hakkında bizimle iletişime geçin. mesajını gösterir. Müşteri döndüğünde Barion'a ulaşılamazsa, aynı «onaylanıyor» metnini ve bir Check again düğmesini gösteren bir Ödeme onayı sayfası açılır; Barion ödemeyi onayladığı anda geri çağırma siparişi oluşturur.

Ödeme tamamlanmadıysa (iptal edildi, süresi doldu veya başarısız oldu), sipariş oluşturulmaz, sepet korunur ve müşteri Ödeme tamamlanmadı. Lütfen tekrar deneyin. mesajıyla ödeme sayfasına döner. Müşteri tekrar deneyebilir. Her deneme kaydedilir; bu nedenle önceki bir denemenin geç gelen ödemesi yine siparişi oluşturur ve süresi dolan önceki bir deneme, daha yeni bir denemenin siparişini iptal etmez.

Ödeme başlatılamazsa müşteri ödeme sayfasında kısa bir mesajla kalır: Barion ödemesi başlatılamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin., Barion, şu para biriminde ödemeleri desteklemiyor: sepet para birimi veya Barion sıfır toplamlı bir siparişi işleyemez. Ayrıntılar, Logging açıksa günlüğe yazılır.

Geri çağırma, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlaması tarafından engellenmez.

Modül yalnızca anlık ödemeleri destekler. Ön provizyonlu veya gecikmeli tahsilatlı ödeme, abonelik veya yinelenen ödeme, kayıtlı kart, Barion Pixel ya da ek 3-D Secure verisi bulunmaz; 3-D Secure'u Barion kendi ödeme sayfasında yönetir.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Barion'a yönlendirildi ve ödeme yapmadı ya da Barion ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Awaiting Barion payment: Barion ödemenin hâlâ devam ettiğini bildirir. Bir notta Barion PaymentId, tutar ve test modunda (test mode) gösterilir. Barion ödemeyi onayladığında sipariş «Ödeme kabul edildi» durumuna geçer.

Payment accepted or Delivered: Barion ödemeyi onaylamıştır. Durum, Order Status After Payment ayarını izler. Ödeme, Barion işlem kimliğiyle kaydedilir ve bir notta tutar, PaymentId ve işlem gösterilir.

Barion payment on hold: Barion, siparişin toplamından farklı bir tutar veya para birimi bildirmiştir; örneğin ödeme başlatıldıktan sonra sepet değiştirildiği için. Not her iki tutarı gösterir. Ödemeyi Barion portalında kontrol edin, ardından siparişi tamamlayın veya ödemeyi Barion portalında iade edin.

Canceled: beklemedeki bir siparişin son ödeme denemesi Barion'da iptal edildi veya süresi doldu.

Payment error: beklemedeki bir siparişin son ödeme denemesi başarısız oldu.

Refunded: ödeme modül üzerinden tamamen iade edildi.

İptal edilmiş veya başarısız olmuş bir siparişin ödemesi hâlâ başarılı olursa sipariş ödenmiş olur. Ödenmiş veya iade edilmiş bir sipariş, sonraki bir geri çağırmayla asla değiştirilmez. Ödenmiş bir sipariş için başka bir ödeme başarılı olursa bir not, bunu Barion portalında kontrol etmenizi ve kopyaysa iade etmenizi ister. Notlar, sipariş sayfasındaki özel mesajlardır.

Barion ödeme bloğu

Sipariş sayfasında PaymentId, Barion işlemi, ödeme durumu, ödenen ve iade edilen tutar, test ödemeleri için Test mode rozeti ve iade geçmişini gösteren bir Barion payment bloğu bulunur.

İadeler

Barion payment bloğuna tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Barion düğmesine tıklayın. Bu tutar Barion üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir. Neden, Barion'a yorum olarak gönderilir. HUF iadeleri tam sayı olmalıdır. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu nedenle o modun POSKey'i girilmiş olmalıdır. Barion iadeyi kabul etmez veya onaylamazsa blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Barion işlemi ve durumuyla birlikte eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

İadeler, Barion ödemeyi onayladıktan ve sipariş bu ödemeyle ödendikten sonra kullanılabilir. Tutar veya para birimi uyuşmazlığı olan bir ödeme PrestaShop'tan iade edilemez; Barion portalında iade edin. Modül kredi notu oluşturmaz ve sipariş sayfasındaki standart PrestaShop iade düğmeleri, Barion üzerinden para geri göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Barion Gateway lisans bloğu, Modules > Module Manager > VibeFox Barion Gateway > Configure 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 tarihi ve alan adınızı) ve 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 düğmelerini gösterir. Bunların altında Product: presta-payment-barion satırı ile 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. Bloktaki metinler yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; ö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 ya da 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: ana mağazanın alan adında, çoklu mağaza kurulumunda da öyle. 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 Barion, ö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ği için ö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: daha önce başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

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, ardından haftada bir kez. Cron job gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Barion ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda POSKey ve alıcı e-postası bulunduğunu (eksik olursa ayarlar sayfası uyarı gösterir) ve sepet para biriminin HUF, EUR, USD veya CZK olduğunu kontrol edin. 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 geçti ama sipariş oluşturulmadı: sipariş, Barion geri çağırma URL'sini çağırdığında veya müşteri mağazanıza döndüğünde oluşturulur. Sitenin internetten erişilebilir olduğundan emin olun (geri çağırma URL'sinin önünde güvenlik duvarı veya temel kimlik doğrulama olmamalı). Ödemenin yapıldığı modun POSKey'inin doğru olduğunu kontrol edin, çünkü modül ödeme durumunu bu anahtarla Barion'dan sorar. Geri çağırmayı görmek için Logging seçeneğini açın.

Geri çağırma Busy, retry yanıtı veriyor: sipariş, müşterinin dönüşü tarafından tam o anda işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). Barion tekrar çağırır. Nedeni görmek için Logging seçeneğini açın.

Geri çağırma API error yanıtı veriyor: mağaza, ödeme durumunu Barion'dan okuyamadı ya da ödemenin yapıldığı modun POSKey'i ayarlanmamış. Bu POSKey'i kontrol edin.

Geri çağırma Order not found yanıtı veriyor: PaymentId bu mağaza tarafından başlatılmamış. Diğer mağazalar veya test sistemleri için yapılan Barion çağrıları yok sayılır.

Müşteri «Ödeme doğrulaması başarısız» görüyor: dönüş bağlantısı sepetle eşleşmiyor; örneğin başka bir tarayıcı oturumunda açıldı veya düzenlendi. Ödeme durumu yine de geri çağırma tarafından onaylanır.

Müşteri Barion'u seçerken hata görüyor: Logging seçeneğini açın ve modül sayfasındaki Log alanına bakın. Hatalı bir POSKey veya alıcı e-postası Barion ödemesi başlatılamadı. hatasına yol açar.

Sipariş Barion payment on hold durumunda: siparişteki uyuşmazlık notunu okuyun, ödemeyi Barion portalında kontrol edin, ardından siparişi tamamlayın veya Barion portalında iade edin.

10,50 HUF neden iade edilemiyor?: Barion, HUF'u ondalıksız işler. Tam bir tutar girin.

İade, bu siparişin modu için Barion POSKey'inin yapılandırılmadığını söylüyor: ödeme test veya canlı modda yapıldı ve o modun POSKey'i boş. Girin ve tekrar deneyin.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Barion 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 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. Siparişlerin Barion ödeme verileri ile Awaiting Barion payment ve Barion payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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