VibeFox EveryPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

EveryPay hesabı: mağazanızın API kullanıcı adı, API secret ve işlem hesabı adına ihtiyacınız vardır. Bunlar EveryPay Merchant Portal'ında, mağaza ayarlarınızda bulunur: test modu için demo portalı (mwt-demo.every-pay.com), canlı ödemeler için canlı portal (portal.every-pay.eu). Test ve canlı ortamların ayrı kimlik bilgileri vardır. Ayrıca her iki portalda da mağazanızın callback URL'sini ayarlarsınız (bkz. Yapılandırma).

Mağaza para birimi: işlem hesabı, tahsil edilecek para birimini belirler; örneğin EUR3D1, EUR tahsil eder. Ödeme yöntemi yalnızca bu para birimindeki siparişler için sunulur.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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_everypay_payment 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 > EveryPay > Manage, ya da Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Demo Merchant Portal'dan test API kullanıcı adını, test API secret'ını ve işlem hesabı adını girin. Test Mode seçeneğini açık bırakın.

6. Ayarlar sayfasında gösterilen callback URL'sini, Merchant Portal'daki mağazanızın Callback notification URL alanına kopyalayın.

7. Enable/Disable seçeneğini açın ve bir test siparişi verin. Her şey çalıştığında canlı kimlik bilgilerini girin, canlı portalda da callback URL'sini ayarlayın ve Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > EveryPay. Alanların üstünde, test modu açıkken sayfa Test mode is on: payments go to the EveryPay demo environment, no real money is charged. uyarısını gösterir. Ağ geçidi etkinken geçerli modun API kullanıcı adı, API secret veya işlem hesabı eksikse uyarır (bu durumda ödeme yöntemi ödeme sayfasında gizlenir); işlem hesabı mağaza para biriminden farklı bir para birimiyle tahsilat yapıyorsa da uyarır. Ödeme yöntemleri listesinde, geçerli mod yapılandırılana kadar EveryPay kurulum gerektiren olarak işaretlenir. Kimlik bilgileriyle birlikte yapıştırılan boşluklar ve satır sonları kaydedilirken silinir.

Genel

Enable/Disable: Enable EveryPay payment gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: EveryPay.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card or bank link on the EveryPay payment page.

EveryPay hesabı

API kullanıcı adı, API secret ve işlem hesabı adı EveryPay Merchant Portal'ında (mağaza ayarları) gösterilir: test modu için demo portal, canlı ödemeler için canlı portal.

Test Mode: Enable test mode, ödemeleri test kimlik bilgileriyle EveryPay demo ortamına gönderir. Gerçek para tahsil edilmez. Varsayılan: açık.

Test API Username: demo ortamının API kullanıcı adı.

Test API Secret: demo ortamının API secret'ı.

Live API Username: canlı ortamın API kullanıcı adı.

Live API Secret: canlı ortamın API secret'ı.

Processing Account Name: EveryPay işlem hesabı, örneğin EUR3D1. Hesap tahsil edilecek para birimini belirler: ağ geçidi yalnızca bu para birimindeki siparişler için sunulur. Her iki modda aynı hesap adı kullanılır.

Ödeme bildirimleri (callback)

Callback, bir ödemenin tamamlandığını mağazanıza bildirir; böylece müşteri tarayıcıyı kapatsa bile siparişler güncellenir. Bu bölümde gösterilen URL'yi, demo ve canlı için EveryPay Merchant Portal'ındaki mağazanızın Callback notification URL alanına kopyalayın. URL şu biçimdedir: https://your-site/wc-api/wc_evp_payment/. Ödeme isteği bir callback URL'si taşımaz, bu nedenle portalda ayarlanmalıdır.

Callback yalnızca ödeme referanslarını içerir. Geldiğinde eklenti, ödemenin oluşturulduğu ortamda EveryPay API'sinden ödeme durumunu sorar ve yanıtın bu siparişe ait olduğunu kontrol eder. Siparişin oluşturmadığı bir ödeme için gelen callback'ler reddedilir. Callback olmadan, müşteri ödemeden sonra mağazaya döndüğünde veya siparişte Check EveryPay payment status çalıştırdığınızda sipariş onaylanır.

Gelişmiş

Debug log: Log payment events, ödeme olaylarını WooCommerce > Status > Logs sayfasına, kaynak wcp_everypay_payment olarak yazar. Hatalar her zaman kaydedilir. API secret'ları ve kart verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak EveryPay) ve siparişi verir. Test modunda ödeme sayfasında TEST MODE: EveryPay demo environment, no real money is charged. gösterilir. Eklenti, müşterinin e-posta ve fatura bilgileriyle sipariş tutarı için tek seferlik bir EveryPay ödemesi oluşturur ve müşteriyi EveryPay ödeme sayfasına gönderir. Ödeme sayfasının dili site diline göre belirlenir (İngilizce, Estonca, Rusça, Letonca, Litvanca, Fince veya Almanca; diğer durumlarda İngilizce). Orada müşteri, EveryPay hesabınız için etkin olan yöntemlerden biriyle öder.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca EveryPay onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, geri dönüşte ve callback'te EveryPay API'sinden ödemenin durumunu sorar. Ödenmiş bir sipariş, incelemedeki bir sipariş veya hâlâ işlenmekte olan bir ödeme, sipariş alındı sayfasına yönlendirir.

Ödeme başarısız olursa müşteri ödeme sayfasına (veya Pay for order sayfasına) döner ve Your EveryPay payment was not successful. Please try again or choose another payment method. mesajını görür. Müşteri EveryPay ödeme sayfasından ödeme yapmadan ayrıldıysa mesaj The EveryPay payment was not completed. You can try again or choose another payment method. olur. Her yeni deneme yeni bir EveryPay ödemesi oluşturur; önceki denemeler kaydedilir, bu nedenle eski bir bağlantıyla yapılan ödeme yine de tanınır.

EveryPay ödemeyi başlatamazsa müşteri kısa bir mesaj görür, örneğin EveryPay is temporarily unavailable. Please try again in a moment or choose another payment method. Ayrıntılar günlüktedir.

Ö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. Müşteriye görünen metinler Estoncaya çevrilmiştir.

Eklenti yalnızca tek seferlik ödemeleri destekler. WooCommerce üzerinden iade veya tahsilat, kayıtlı kart veya tek tıkla ödeme, abonelik veya yinelenen ödeme, gömülü kart alanı yoktur ve çoklu para birimi desteklenmez.

Siparişler

Sipariş durumları

Pending payment: müşteri EveryPay'e yönlendirildi ve henüz ödeme yapmadı ya da ödeme hâlâ işleniyor.

Processing: EveryPay ödemeyi tamamlanmış veya yetkilendirilmiş olarak bildirdi (yalnızca sanal indirilebilir ürün içeren siparişler, WooCommerce varsayılanı olarak Tamamlandı durumuna geçer). Sipariş notu tutarı, para birimini ve ödeme referansını gösterir. Siparişin işlem kimliği EveryPay ödeme referansıdır. Yetkilendirilmiş bir ödemede not, tutarın ayrıldığını belirtir: hesabınız otomatik tahsilat yapmıyorsa ödemeyi EveryPay Merchant Portal'ında tahsil edin. Ödeme daha sonra tamamlandığında bir not bunu bildirir.

On hold after payment: ödeme manuel inceleme gerektiriyor. Ödenen tutar veya para birimi siparişten farklı, sipariş ödeme gelmeden önce iptal edilmiş ya da sipariş artık başka bir ödeme yöntemi kullanıyor. Not bunu açıklar ve siparişin ödenmiş olarak işaretlenmediğini belirtir. Ödemeyi Merchant Portal'ında kontrol edin ve elle tamamlayın veya iade edin. Bu ödeme için sonraki callback'ler siparişi otomatik olarak tamamlamaz.

Failed: ödenmemiş bir siparişin son ödeme denemesi başarısız oldu, yarıda bırakıldı veya iptal (void) edildi. Not, EveryPay'den gelen nedeni gösterir. Müşteri tekrar deneyebilir.

Zaten ödenmiş bir sipariş için ikinci bir ödeme tamamlanırsa sipariş değişmez. Bir not, mükerrer ödemeyi EveryPay Merchant Portal'ında iade etmenizi ister.

Check EveryPay payment status

Sipariş ekranında Check EveryPay payment status sipariş işlemini seçin. Eklenti, siparişin her EveryPay ödemesini API ile kontrol eder, sonucu yukarıda anlatıldığı gibi uygular ve her ödemenin durumunu gösteren bir not ekler. Callback'i hiç gelmeyen siparişler için kullanın.

İadeler

WooCommerce'den yapılan iadeler desteklenmez. EveryPay Merchant Portal'ında iade yapın, ardından WooCommerce'de sipariş durumunu ayarlayın. EveryPay bir ödemeyi iade edilmiş veya chargeback ile geri alınmış olarak bildirdiğinde eklenti yalnızca bir sipariş notu ekler; sipariş durumu değişmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > EveryPay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok 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, 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 yalnızca bir alan adında çalışır. Anahtarın bir siteden kaldırılması, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan EveryPay ö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. Giriş yapmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) etiketiyle görmeye devam eder; böylece bir 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: başlatılmış ödemeler yine onaylanır ve durum kontrolü çalışır.

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

EveryPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun API kullanıcı adı, API secret ve Processing Account Name değerlerinin girildiğini ve mağaza para biriminin (Pay for order sayfasında sipariş para birimi) işlem hesabının para birimi olduğunu kontrol edin. Bu durumlarda ayarlar sayfası uyarı gösterir.

Ödeme başarılı oldu ama sipariş Pending payment durumunda kalıyor: callback çalışmıyor. Ayarlardaki callback URL'sinin, kullandığınız modun (demo veya canlı) Merchant Portal'ında Callback notification URL olarak ayarlandığını kontrol edin. Siparişi açıp Check EveryPay payment status işlemini de çalıştırabilirsiniz. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasına, kaynak wcp_everypay_payment olarak bakın.

Callback şu yanıtı veriyor: Unknown payment reference veya Payment does not belong to this order: ödeme bu sipariş tarafından oluşturulmadı ya da EveryPay yanıtı buna uymuyor. Sipariş değişmez.

Callback şu yanıtı veriyor: Not configured: ödemenin oluşturulduğu ortamın kimlik bilgileri eksik, örneğin test kimlik bilgileri kaldırıldıktan sonra yapılan bir test ödemesi. Bilgileri yeniden girin; EveryPay callback'i yeniden dener.

Callback şu yanıtı veriyor: Payment status unavailable veya Busy, please retry: EveryPay API'sine ulaşılamadı ya da sipariş aynı anda başka bir istek tarafından güncelleniyordu. EveryPay callback'i yeniden dener.

Müşteri EveryPay is temporarily unavailable mesajını görüyor: EveryPay kimlik bilgilerini reddetti ya da ulaşılamadı. Geçerli modun API kullanıcı adını ve API secret'ını kontrol edin.

Müşteri This payment method does not support the order currency mesajını görüyor: sipariş para birimi, işlem hesabının para biriminden farklı.

Sipariş On hold after payment durumunda: sipariş notunu okuyun. Tutar veya para birimi farklıydı ya da sipariş ödeme gelmeden önce iptal edilmişti. Ödemeyi Merchant Portal'ında kontrol edin ve elle tamamlayın veya iade edin.

Lisans bloğu bir hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir yuva boşaltı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.

Geliştiriciler için: eklenti belgelerinde wc_evp_icon, wc_evp_locale, wc_evp_currency_decimals ve wc_evp_oneoff_request filtreleri listelenir.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Uninstall (Delete the gateway settings and logs when the plugin is deleted) açıksa kaldırılır. Aksi halde, sonraki bir yeniden kurulum için kalırlar. Siparişlerde saklanan EveryPay ödeme referansları her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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