VibeFox ePay.bg for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmaz.

Para birimi: Bulgar levası (BGN), euro (EUR) veya ABD doları (USD). Sepet kendi para biriminde, 2 ondalık basamakla tahsil edilir. Diğer para birimlerindeki sepetler için ödeme yöntemi ödeme sayfasında gizlenir.

ePay.bg hesabı: ePay.bg satıcı profilinizdeki müşteri numarası (MIN) ve gizli anahtara ihtiyacınız var: 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 tek bir alan adında çalışır.

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne 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 ePay.bg Gateway öğesini bulup Configure düğmesine tıklayın.

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

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

5. Payment notifications (IPN) bölümünde gösterilen URL'yi, hem demo hem de canlı satıcı profilinde ePay.bg satıcı profilindeki URL for receiving notifications alanına kopyalayın. Bu olmadan sipariş oluşturulmaz.

6. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir deneme siparişi verin, ardından Test Mode seçeneğini kapatın.

Kurulumda modül ePay.bg payment on hold sipariş durumunu oluşturur. 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ırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox ePay.bg Gateway > Configure. Her Save düğmesi tüm sayfayı kaydeder. Alanların üzerinde sayfa; mağazanın varsayılan para birimi BGN, EUR veya USD değilse bir hata, ağ geçidi etkinken seçili modun MIN veya gizli anahtarı boşsa bir uyarı gösterir (bu durumda ödeme sayfasında gizlenir ve kaydetme sırasında aynı uyarı görünür); ayrıca test modu açıkken Test mode is on: payments go to demo.epay.bg and no real money is charged. uyarısını gösterir.

ePay.bg

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kayıtlı ödeme yöntemi adı da budur. Varsayılan: ePay.bg. Zorunlu.

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, satıcı profilinizde www.epay.bg (canlı) ve demo.epay.bg (test hesabı, ayrıca kaydedilir) üzerinde gösterilir.

Test Mode: test modunu etkinleştirir. 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.

Kayıtlı gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Yapıştırılan anahtarlardaki boşluklar ve satır sonları kaydedilirken silinir.

Clear saved secret keys: bir anahtarı işaretleyin ve kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Payment notifications (IPN)

Bildirim, mağazanıza bir ödeme isteğinin ödendiğini, reddedildiğini veya süresinin dolduğunu bildirir. Notification URL alanı, ePay.bg satıcı profilinde URL for receiving notifications olarak girilecek URL'yi gösterir; canlı ve test için geçerlidir. Dostça URL'ler etkinse şu biçimdedir: https://your-shop/module/wcp_epaybg_gateway/notify; başında /en/ gibi bir dil kodu da olabilir. URL'yi ayarların gösterdiği gibi birebir kopyalayın. Siparişler yalnızca bu imzalı bildirimlerle oluşturulur; müşterinin mağazaya dönmesi sipariş oluşturmaz veya ödemez.

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

Geçerli bir sağlama toplamı olmayan bildirimler reddedilir ve ePay.bg bunları göndermeye devam eder. Sağlama toplamı, gizli anahtarı olan her modun anahtarıyla kontrol edilir; bu nedenle test ve canlı arasında geçiş yapmadan önce başlatılan ödemeler yine onaylanır. Ödeme, isteğin yapıldığı modda gelmelidir; aksi halde sipariş ePay.bg payment on hold durumuna geçer. Satıcı profilinde bildirim URL'si yoksa sipariş oluşturulmaz.

Payment request

Invoice Prefix: yalnızca rakamlar (en fazla 10), ePay.bg fatura numarasını oluşturmak için sepet 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 kaydedilirken bir uyarıyla kaldırılır. Öneki daha sonra değiştirmek güvenlidir: açık ödeme istekleri, her biri için kayıtlı faturayla bulunur. Varsayılan: 00001.

Expiration Time: ödenmemiş bir ödeme isteğinin süresinin dolacağı süre; ePay.bg bunu süresi dolmuş olarak bildirir ve sipariş oluşturulmaz. 1, 3, 6, 12, 24, 48 veya 72 saat seçin. Süre, mağazanızın saat dilimi ne olursa olsun 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.

Advanced

Logging: ödeme isteklerini ve bildirimleri modül klasöründeki logs/epay_bp_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Gizli anahtarlar ve kart verileri kaydedilmez. Varsayılan: kapalı. Hatalar, kapalıyken de her zaman kaydedilir.

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

Delete Data on Uninstall: açıksa modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. ePay.bg ödeme kayıtları, ePay.bg payment on hold sipariş durumu ve siparişler her zaman saklanır. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak ePay.bg) ve onaylar. Müşteri Redirecting to ePay.bg for payment... ifadesini görür ve sepet para biriminde sepet toplamı için fatura numarası ve son kullanma süresi ile imzalı bir ödeme isteğiyle ePay.bg'ye yönlendirilir. Ödeme ePay.bg'de Cart ve sepet numarasıyla görünür. Sayfada yönlendirme başlamazsa kullanılacak bir Pay via ePay.bg düğmesi ve bir Cancel düğmesi de bulunur. ePay.bg'de müşteri banka kartı veya bir ePay.bg hesabıyla öder. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza döner. Sipariş yalnızca imzalı ePay.bg bildirimi geldiğinde oluşturulur. Bildirim zaten geldiyse müşteri standart sipariş onay sayfasını görür. Gelmediyse, Payment confirmation sayfasında Thank you. Your payment is being confirmed by ePay.bg — your order will be created as soon as ePay.bg confirms it, and you will receive an e-mail. metni ve Check again ile Back to checkout düğmeleri görünür.

Müşteri ePay.bg'de iptal ederse The ePay.bg payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. ePay.bg isteği reddedilmiş veya süresi dolmuş olarak bildirdiyse mesaj The payment was not completed. You can try again or choose another payment method. olur. Sepet korunur. Aynı sepet için yeni bir deneme aynı fatura numarasını kullanır.

Sepet ePay.bg ile ödenemiyorsa müşteri kısa bir mesajla ödeme sayfasında kalır; örneğin ePay.bg payments are temporarily unavailable. Please choose another payment method. ya da ePay.bg'nin sepet para biriminde ödeme kabul etmediği bilgisi.

Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül yalnızca ePay.bg üzerinden tek seferlik ödemeleri kabul eder. PrestaShop üzerinden iade, kayıtlı kart, abonelik veya yinelenen ödeme yoktur; EasyPay veya B-Pay nakit ödeme kodları da desteklenmez.

Siparişler

Sipariş durumları

No order yet: müşteri ePay.bg'ye yönlendirildi ve ödeme yapmadı, bildirim henüz gelmedi veya ePay.bg isteği reddedilmiş ya da süresi dolmuş olarak bildirdi. Yalnızca sepet vardır.

Payment accepted, Delivered or ePay.bg payment on hold: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Ödeme, işlem kimliği olarak STAN ile kaydedilir (STAN yoksa fatura numarasıyla); bir notta fatura numarası, ödeme tarihi, STAN ve BORICA kodu gösterilir.

ePay.bg payment on hold after payment: ödeme geldi, ancak sepetin şu anki durumuna uymuyor: sepet toplamı veya para birimi ödeme isteğinden sonra değiştirildi ya da bildirim, istekten farklı bir modda (test veya canlı) geldi. Ödeme ödenmiş olarak kaydedilmez. Sepetin zaten ödenmemiş bir siparişi olması durumunda da aynısı olur; örneğin iptal edilmiş bir sipariş veya başka bir ödeme yöntemiyle verilmiş bir sipariş. Not nedenini açıklar. Ödemeyi ePay.bg satıcı panelinde kontrol edin, ardından siparişi manuel olarak tamamlayın veya iade edin.

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

ePay.bg ödeme bloğu

Sipariş sayfasında fatura, istenen tutar ve para birimi, bildirim sonucu, ödeme tarihi, STAN, BORICA kodu, test ödemeleri için bir Test mode rozeti ve siparişin ePay.bg notes bölümünü içeren bir ePay.bg payment bloğu gösterilir.

İadeler

ePay.bg WEB API'sinde iade çağrısı bulunmadığı için PrestaShop üzerinden iade yapılamaz. Ödemeyi ePay.bg satıcı panelinde iade edin ve siparişi PrestaShop'ta manuel olarak güncelleyin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox ePay.bg Gateway lisans bloğu, Modules > Module Manager > VibeFox ePay.bg Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. 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 tarih 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-epaybg satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modülün Configure izni olan çalışanlar değiştirebilir. Bloğun metinleri arka ofis 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 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 bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan ePay.bg ö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, arka ofise giriş yaptığınızı bilmediği için ödeme yöntemi sizden de gizlenir: modülü 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: zaten başlatılmış ödemeler yine onaylanır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Arka ofiste çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından 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

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 ve gizli anahtarının girildiğini ve sepet para biriminin BGN, EUR veya USD olduğunu kontrol edin. Kimlik bilgileri eksikse ayarlar sayfası bir uyarı gösterir. 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 gerçekleşti, ancak sipariş oluşturulmadı: sipariş yalnızca ePay.bg bildirimiyle oluşturulur. Kullandığınız modun (demo veya canlı) ePay.bg satıcı profilinde bildirim URL'sinin, Notification URL alanında gösterildiği gibi birebir girildiğini ve bu modun gizli anahtarının doğru olduğunu kontrol edin. Modül sayfasındaki Log alanına bakın; her bildirimi görmek için Logging seçeneğini açın.

Bildirim ERR=Not valid CHECKSUM yanıtı veriyor: kayıtlı hiçbir gizli anahtar, bildirimi gönderen satıcı profiliyle eşleşmiyor. ePay.bg yeniden denemeye devam eder; bu nedenle anahtar doğru olduğunda sipariş oluşturulur.

Bildirim ERR=Not configured yanıtı veriyor: kayıtlı gizli anahtar yok. Girin.

Bildirim bir fatura için STATUS=NO yanıtı veriyor: fatura bu mağaza tarafından düzenlenmedi; ö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ı sepet için aynı anda iki bildirim ya da siparişin oluşturulamaması (örneğin modül devre dışıysa). ePay.bg bildirimi yeniden gönderir. Nedeni günlükte görünür.

Bildirim URL'si tarayıcıda ERR=Method not allowed in the browser gösteriyor: bu normaldir. URL yalnızca ePay.bg'den gelen istekleri kabul eder.

Sipariş ödemeden sonra ePay.bg payment on hold durumunda: ePay.bg payment bloğundaki notları okuyun (bkz. Sipariş durumları), ödemeyi ePay.bg satıcı panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi orada iade edin.

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

Geliştiriciler için: readme, actionEpayBpFormFields kancasından (WooCommerce sürümünün epay_bp_form_fields filtresi) bahseder; örneğin doğrudan kart sayfasını (PAGE=credit_paydirect) kullanmak için.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox ePay.bg Gateway yanındaki menüyü açın ve Uninstall seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete Data on Uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar, sonraki bir yeniden kurulum için saklanır. ePay.bg ödeme kayıtları ve ePay.bg payment on hold sipariş durumu her zaman saklanır; bu nedenle yeniden kurulumdan önce başlatılmış bir ödeme yine onaylanır. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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