VibeFox ePay.bg for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Bulgar levası (BGN), euro (EUR) veya ABD doları (USD). Sipariş, kendi para biriminde 2 ondalık basamakla tahsil edilir. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

ePay.bg hesabı: ePay.bg satıcı profilinizden müşteri numarasına (MIN) ve gizli anahtara ihtiyacınız vardır: canlı olanlar www.epay.bg'den, test olanlar demo.epay.bg'den alınır (test hesabı ayrıca kaydedilir). Ayrıca mağazanızın bildirim URL'sini satıcı profiline girmeniz gerekir.

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. wcp_epaybg_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın. WooCommerce etkin olmalıdır.

3. Ayarları açın: WooCommerce > Settings > Payments > ePay.bg > Manage ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Test ve/veya canlı MIN ile gizli anahtarı girin (bkz. Yapılandırma).

6. Payment notifications (IPN) bölümünde gösterilen bildirim URL'sini, hem demo hem de canlı profilde olmak üzere, ePay.bg satıcı profilindeki URL for receiving notifications alanına kopyalayın. Bu olmadan siparişler Ödeme bekleniyor durumunda kalır.

7. Enable/Disable seçeneğini açın. Test modunda bir test siparişi verin, ardından Test Mode işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > ePay.bg. Alanların üstünde sayfa, mağaza para birimi BGN, EUR veya USD değilse bir hata; ağ geçidi etkin olduğu halde seçili modun MIN'i veya gizli anahtarı boşsa bir uyarı (bu durumda ödeme sayfasında gizlenir ve kaydetme aynı hatayı gösterir); test modu açıkken de Test mode is on: payments go to demo.epay.bg and no real money is charged. iletisini gösterir. Ödeme yöntemleri listesinde ePay.bg, seçili modun kimlik bilgileri girilene kadar kurulum gerektiren olarak işaretlenir.

Genel

Enable/Disable: Enable ePay.bg Payment Gateway ö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: ePay.bg.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via ePay.bg with a bank card or your ePay.bg account.

ePay.bg hesabı

Müşteri numarası (MIN) ve gizli anahtar, www.epay.bg (canlı) ve demo.epay.bg (ayrıca kaydedilen test hesabı) üzerindeki satıcı profilinizde gösterilir. Yapıştırılan gizli anahtarlardaki boşluklar ve satır sonları kaydederken kaldırılır.

Test Mode: Enable test mode (use demo.epay.bg and the test credentials). Açıkken müşteriler ePay.bg demo ortamına yönlendirilir ve istekler test kimlik bilgileriyle imzalanır. Varsayılan: açık.

Test Merchant ID (MIN): demo.epay.bg satıcı hesabınızın müşteri numarası (MIN).

Test Secret Key: demo.epay.bg satıcı hesabınızın gizli anahtarı (64 karakter).

Live Merchant ID (MIN): www.epay.bg satıcı hesabınızın müşteri numarası (MIN).

Live Secret Key: www.epay.bg satıcı hesabınızın gizli anahtarı (64 karakter); HMAC-SHA1 imzası için kullanılır.

1.0 sürümünden güncelleme yaparsanız, test modu açıksa bu sürümdeki tek kimlik bilgisi seti test alanlarına taşınır.

Ödeme bildirimleri (IPN)

Bildirim, mağazanıza bir ödeme isteğinin ödendiğini, reddedildiğini veya süresinin dolduğunu bildirir. Bu bölüm bildirim URL'sini gösterir. Şuna benzer: https://your-site/wc-api/epaybg_payment_callback/. Bunu, canlı ve test için, ePay.bg satıcı profilinde URL for receiving notifications olarak girin. Siparişler yalnızca bu imzalı bildirimlerle ödenmiş olarak işaretlenir; müşterinin mağazaya dönmesi bir siparişi ödenmiş olarak işaretlemez.

ePay.bg her fatura için şu sonuçları bildirir:

Her bildirim, seçili modun gizli anahtarıyla kontrol edilir. Geçerli sağlama toplamı olmayan bildirimler reddedilir ve ePay.bg bunları göndermeye devam eder. Satıcı profilinde bildirim URL'si yoksa hiçbir sipariş ödenmiş olarak işaretlenmez.

Ödeme isteği

Invoice Prefix: yalnızca rakamlar (en fazla 10); ePay.bg fatura numarasını oluşturmak için sipariş kimliğinin önüne eklenir, örneğin 00001 + 123 = 00001123. Aynı ePay.bg hesabındaki farklı mağazalar için farklı önekler kullanın. Diğer karakterler kaydederken kaldırılır. Öneki sonradan değiştirmek güvenlidir: bekleyen siparişler, siparişte saklanan fatura üzerinden bulunur. Varsayılan: 00001.

Expiration Time: ödenmemiş bir ödeme isteğinin süresinin dolduğu süre; ePay.bg bunu süresi dolmuş olarak bildirir ve bekleyen sipariş iptal edilir. 1, 3, 6, 12, 24, 48 veya 72 saat seçin. Saat, sitenizin saat diliminden bağımsız olarak Bulgaristan saatiyle gönderilir. Varsayılan: 24 saat.

Language: ePay.bg ödeme sayfasının dili, İngilizce veya Bulgarca. Varsayılan: İngilizce.

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum, ikinci bir durum değişikliği olmadan hemen ayarlanır.

Gelişmiş

Logging: Enable logging, ödeme isteklerini ve bildirimleri gizli anahtarlar veya kart verileri olmadan WooCommerce > Status > Logs altına, kaynak wcp_epaybg_gateway, yazar. Varsayılan: kapalı.

Delete Data on Uninstall: Remove all plugin data when uninstalled. İşaretliyse, eklenti kaldırıldığında ağ geçidi ayarları, siparişlerde saklanan ePay.bg verileri ve eklenti günlükleri silinir. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak ePay.bg) ve siparişi verir. Müşteri Redirecting to ePay.bg for payment... iletisini görür ve sipariş tutarı için sipariş para biriminde, fatura numarası ve son kullanma süresiyle imzalı bir ödeme isteğiyle ePay.bg'ye yönlendirilir. Sayfada ayrıca yönlendirme başlamazsa kullanılacak bir Pay via ePay.bg düğmesi ve bir Cancel order düğmesi bulunur. ePay.bg'de müşteri banka kartı veya bir ePay.bg hesabıyla öder.

Ödeme yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca imzalı ePay.bg bildirimi geldiğinde ödenmiş olarak işaretlenir. Sepet yalnızca sipariş alındı sayfasında boşaltılır.

Müşteri ePay.bg'de iptal ederse sipariş standart WooCommerce yöntemiyle iptal edilir ve sepet korunur; böylece müşteri başka bir ödeme yöntemi seçebilir.

Sipariş ePay.bg ile ödenemiyorsa müşteri kısa bir ileti görür, örneğin ePay.bg payments are temporarily unavailable. Please choose another payment method. ya da ePay.bg'nin sipariş para biriminde ödeme kabul etmediğini belirten bir ileti.

Ö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 ePay.bg üzerinde tek seferlik ödemeleri kabul eder. WooCommerce üzerinden iade yoktur; kayıtlı kart veya tokenleştirme, abonelik veya yinelenen ödeme de yoktur ve EasyPay veya B-Pay nakit ödeme kodları desteklenmez.

Siparişler

Sipariş durumları

Pending payment: müşteri ePay.bg'ye yönlendirildi ve henüz ödeme yapmadı ya da bildirim henüz gelmedi. Sipariş notunda Awaiting ePay.bg payment. yazar.

Processing, Completed or On Hold: ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Sipariş notu fatura numarasını, ödeme tarihini, STAN'ı ve BORICA kodunu gösterir. İşlem kimliği STAN'dır (STAN yoksa fatura numarası).

On hold after payment: ödeme geldi, ancak siparişin şimdi belirttiği şey için değil: toplam veya para birimi ödeme isteğinden sonra değiştirildi, istek diğer modda yapıldı ya da ağ geçidi sonradan test ile canlı arasında değiştirildi, siparişin ödeme yöntemi değiştirildi veya sipariş daha önce iptal edilmişti. Sipariş notu nedenini açıklar. Ödemeyi ePay.bg satıcı panelinde kontrol edin ve siparişi elle tamamlayın veya iade edin.

Cancelled: ePay.bg ödeme isteğinin reddedildiğini veya süresinin dolduğunu bildirdi ya da müşteri ePay.bg'de iptal etti. WooCommerce stoku geri yükler. İptal edilen sipariş yeniden ödenemez, çünkü ePay.bg fatura numarası önek artı sipariş kimliğidir. Müşteri yeni bir sipariş verir.

Geç gelen bir ret veya süre dolumu bildirimi ödenmiş bir siparişi hiçbir zaman değiştirmez. Zaten ödenmiş veya iade edilmiş bir sipariş için ödeme gelirse durum değiştirilmez ve bir not, ePay.bg satıcı panelinde mükerrer ödeme olup olmadığını kontrol etmenizi ister.

İadeler

WooCommerce üzerinden iade yapılamaz, çünkü ePay.bg WEB API'sinde iade çağrısı yoktur. Ödemeyi ePay.bg satıcı panelinde iade edin ve iadeyi WooCommerce'te elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > ePay.bg sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız gibi durumu gösterir. 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ı bir siteden kaldırmak o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar yoksa ePay.bg 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. iletisini görür. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle 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: zaten başlatılmış ödemeler onaylanmaya 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

ePay.bg ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, seçili modun MIN'i ile gizli anahtarının girildiğini ve mağaza para biriminin BGN, EUR veya USD olduğunu kontrol edin. Ayarlar sayfası bu durumların her birinde bir uyarı gösterir.

Ödeme geçti ama sipariş Ödeme bekleniyor durumunda kalıyor: sipariş yalnızca ePay.bg bildirimiyle ödenmiş olarak işaretlenir. Bildirim URL'sinin kullandığınız modun (demo veya canlı) ePay.bg satıcı profiline girildiğini ve etkin modun gizli anahtarının doğru olduğunu kontrol edin. Logging seçeneğini açın ve WooCommerce > Status > Logs altında, kaynak wcp_epaybg_gateway, bakın.

Bildirim ERR=Not valid CHECKSUM yanıtı veriyor: ayarlardaki gizli anahtar, bildirimi gönderen satıcı profiliyle eşleşmiyor. Bildirimler önce şu anda seçili modun anahtarıyla, sonra diğer modun anahtarıyla kontrol edilir; böylece modu değiştirmeden önce yapılan ödeme istekleri hâlâ kabul edilir. ePay.bg yeniden denemeye devam eder, bu nedenle anahtar doğru olur olmaz sipariş güncellenir.

Bildirim ERR=Not configured yanıtı veriyor: seçili modun gizli anahtarı boş. Anahtarı girin.

Bildirim bir fatura için STATUS=NO yanıtı veriyor: fatura bu mağazanın bir ePay.bg siparişine ait değil; örneğin aynı ePay.bg hesabındaki başka bir mağaza tarafından düzenlenmiş olabilir. Her mağazaya kendi Invoice Prefix değerini verin.

Bildirim STATUS=ERR yanıtı veriyor: geçici bir hata; örneğin aynı sipariş için aynı anda iki bildirim gelmesi. ePay.bg bildirimi yeniden gönderir.

Ödemeden sonra sipariş Beklemede: sipariş notunu okuyun. Toplam veya para birimi ödeme isteğinden sonra değişti, istek diğer modda yapıldı ya da mod sonradan değiştirildi, ödeme yöntemi değişti veya sipariş iptal edilmişti. Ödemeyi ePay.bg satıcı panelinde kontrol edin.

Fatura öneki kaydederken değiştirildi: önek yalnızca rakam içerebilir, en fazla 10. Diğer karakterler kaldırılır.

Lisans bloğu bir hata gösteriyor: bloktaki iletiyi izleyin. Örneğin anahtar başka bir alan adında zaten 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şılamazsa eklenti bilinen son durumla çalışmaya devam eder.

Geliştiriciler için readme dosyası, örneğin doğrudan kart sayfasını (PAGE=credit_paydirect) kullanmak amacıyla epay_bp_form_fields filtresinden söz eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. 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ı, siparişlerde saklanan ePay.bg verileri ve günlükler yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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