VibeFox Barion for WooCommerce — Yardım
Gereksinimler
WordPress: 6.0 veya üzeri.
WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti yönetici alanında bir uyarı gösterir ve ödeme yöntemi yüklenmez.
PHP: 8.0 veya üzeri.
Barion mağazası: mağazanızın POSKey'ine (gizli anahtar) ve ödemeleri alan Barion wallet'ının e-posta adresine ihtiyacınız var. İkisi de Barion portalındadır: canlı için secure.barion.com, test için secure.test.barion.com; My stores altında mağazanız. Test ve canlı kimlik bilgileri farklıdır.
Para birimi: mağaza para birimi HUF, EUR, USD veya CZK olmalı. 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, /wc-api/ önünde bakım modu, 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. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_barion_gateway 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 > Barion > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.
4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.
5. Test POSKey'inizi ve test wallet e-postanızı girin, Test Mode seçeneğini açık tutun ve Enable/Disable seçeneğini açın. Bir test siparişi verin.
6. Her şey çalıştığında canlı kimlik bilgilerini girin ve Test Mode seçeneğinin işaretini kaldırın.
Geri çağırma URL'si her ödemeyle birlikte Barion'a otomatik gönderilir. Barion portalında hiçbir şeyi yapılandırmanız gerekmez.
Yapılandırma
Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Barion. Mağaza para birimi desteklenmiyorsa sayfa bunu Barion shop credentials bölümünde kırmızı renkte belirtir ve desteklenen para birimlerini listeler; bu durumda ödeme yöntemi ödeme sayfasında gizlenir.
Genel
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ı. Varsayılan: Barion.
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ında alın: canlı için secure.barion.com, test için secure.test.barion.com; My stores ve mağazanız. Bu bölümde geri çağırma URL'si de gösterilir, örneğin https://your-site/wc-api/barion_payment_callback/. Bu adres her ödemeyle Barion'a gönderilir; yalnızca internetten erişilebilir olması gerekir.
Test Mode: Enable Barion test/sandbox mode. Test modu, aşağıdaki test kimlik bilgilerini ve Barion test ortamını (api.test.barion.com) kullanır; gerçek para çekilmez. Varsayılan: açık. Gerçek ödeme almak için işaretini kaldırın.
Test POSKey: Barion test sisteminde (secure.test.barion.com, My stores) mağazanızın gizli anahtarı (POSKey).
Test Payee Email: test ödemelerini alan Barion test wallet'ınızın e-posta adresi.
Live POSKey: Barion canlı sisteminde (secure.barion.com, My stores) mağazanızın gizli anahtarı (POSKey).
Live Payee Email: ödemeleri alan Barion wallet'ınızın e-posta adresi.
Siparişler
Order Status After Payment: başarılı ve doğrulanmış bir ödemeden sonra ayarlanan sipariş durumu.
Gelişmiş
Logging: Enable debug logging. Günlükler WooCommerce > Status > Logs bölümüne, kaynak wcp_barion_gateway olarak kaydedilir. Gizli anahtarlar hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.
Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Siparişler ve Barion ödeme verileri her zaman korunur. Varsayılan: kapalı.
Ödeme süreci
Müşteri ödeme yöntemini seçer (varsayılan olarak Barion) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için bir Barion ödemesi başlatır ve müşteriyi Barion ödeme sayfasına yönlendirir. Sipariş kalemleri, kargo, ek ücretler ve vergi ödemede listelenir; müşterinin fatura e-posta adresi ipucu olarak iletilir ve Barion'un desteklediği durumlarda sayfa dili mağaza diline göre belirlenir.
Ödemeden sonra müşteri mağazanıza döner. Barion ayrıca geri çağırma URL'sini çağırır. Bu isteklerin hiçbiri siparişi tek başına ödenmiş olarak işaretlemez: eklenti, POSKey'inizle Barion'dan ödeme durumunu sorar ve sipariş yalnızca Barion onayladığında ve tutar ile para birimi siparişle eşleştiğinde ödenmiş olarak işaretlenir. Dönüş bağlantısı sipariş anahtarını içerir ve yalnızca o sipariş için başlatılan ödemeler kontrol edilir.
Ödeme başarılıysa veya Barion'da hâlâ işleniyorsa müşteri sipariş alındı sayfasına gelir. Aksi halde müşteri ödeme sayfasına döner ve Payment was not completed. Please try again. mesajını görür. Müşteri yeniden deneyebilir; her deneme kaydedildiği için önceki bir denemenin geç gelen ödemesi siparişi yine tamamlar.
Ödeme başlatılamazsa müşteri The Barion payment could not be started. Please try again or choose another payment method. mesajını görür. Oturum açmış mağaza yöneticileri teknik nedeni de görür. Ayrıntılar günlüğe yazılır.
Ödeme yöntemi klasik ödeme sayfasında ve Ödeme bloğunda çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.
Eklenti yalnızca anlık ödemeleri destekler. Ön provizyonlu veya gecikmeli tahsilatlı ödeme, WooCommerce Subscriptions veya yinelenen ödeme, kayıtlı kart, Barion Pixel ve ek 3-D Secure verisi yoktur; 3-D Secure'u Barion kendi ödeme sayfasında yönetir.
Siparişler ve iadeler
Sipariş durumları
Pending payment: Barion ödemesi başlatıldı ve Barion henüz onaylamadı. Sipariş notunda Barion PaymentId, tutar ve test modundaysa (test mode) gösterilir.
Processing or Completed: Barion ödemeyi onayladı. Durum, Order Status After Payment ayarını izler. Sipariş notunda tutar, PaymentId ve işlem gösterilir. İşlem kimliği, Barion işlem kimliğidir.
On hold: Barion, siparişin toplamından farklı bir tutar veya para birimi bildirdi; örneğin ödeme başlatıldıktan sonra sipariş düzenlendiği için. Ödemeyi Barion portalında kontrol edin ve siparişi elle tamamlayın veya iade edin.
Cancelled: son ödeme denemesi Barion'da iptal edildi veya süresi doldu.
Failed: son ödeme denemesi başarısız oldu.
Ödenmiş veya iade edilmiş bir sipariş, sonradan gelen bir geri çağırmayla hiçbir zaman değiştirilmez. Ödenmiş bir siparişe başka bir ödeme başarılı olursa, bir not sizden bunu Barion portalında kontrol etmenizi ve çift ise iade etmenizi ister.
İadeler
Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Barion düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade nedeni, Barion'a yorum olarak gönderilir. HUF iadeleri tam tutar olmalıdır. İade, siparişin ödendiği modda (test veya canlı) gönderilir; bu nedenle o modun POSKey'i ayarlanmış olmalıdır. Barion iadeyi kabul etmez veya onaylamazsa WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Barion işlemi ve durumuyla birlikte sipariş notlarına eklenir.
Lisans anahtarı
Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Barion sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe 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 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ı bir siteden kaldırmak alan adı hakkını serbest bırakmaz; bu hakkı vibefox.net hesabınızdan serbest bırakın.
Etkin bir anahtar yoksa Barion, ödeme sayfasında müşterilere gösterilmez. Ödeme yine de 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 yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.
Lisans 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
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 bir POSKey ve payee e-postası bulunduğunu ve mağaza para biriminin HUF, EUR, USD veya CZK olduğunu kontrol edin.
Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: sipariş, Barion geri çağırma URL'sini çağırdığında veya müşteri mağazanıza döndüğünde tamamlanır. Sitenin internetten erişilebilir olduğundan emin olun (bakım modu, güvenlik duvarı veya /wc-api/ önünde temel kimlik doğrulama olmadan). Siparişin ödendiği modun POSKey'inin doğru olduğunu kontrol edin, çünkü eklenti ödeme durumunu bununla Barion'dan sorar. Geri çağırmayı görmek için Logging seçeneğini açın.
The callback answers Busy, retry: sipariş, müşterinin dönüşüyle aynı anda işleniyordu. Barion tekrar çağırır.
The callback answers API error: mağaza, Barion'dan ödeme durumunu okuyamadı. Siparişin ödendiği modun POSKey'ini kontrol edin.
Sipariş, uyuşmazlık notuyla On hold durumunda: Barion'un bildirdiği tutar veya para birimi sipariş toplamından farklı. Ödemeyi Barion portalında kontrol edin ve elle tamamlayın veya iade edin.
Neden 10.50 HUF iade edemiyorum: Barion HUF'u ondalıksız işler. Tam bir tutar girin.
The refund says the POSKey for this order's mode is not configured: sipariş test veya canlı modda ödendi ve o modun POSKey'i boş. Girin ve yeniden deneyin.
Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını 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. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Siparişler ve Barion ödeme verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.
Barion, ilgili sahibinin ticari markasıdır. Bu eklenti Barion ile bağlantılı değildir ve Barion tarafından onaylanmamıştır.