VibeFox Paysera for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Paysera projesi: Paysera projenizin proje kimliğine ve proje şifresine (imza anahtarı) ihtiyacınız var. Müşterinin gördüğü ödeme yöntemleri, bu projede etkinleştirilenlerdir. Callback için Paysera'da herhangi bir ayar yapmanız gerekmez: URL'si her ödeme isteğiyle birlikte gönderilir.

Erişilebilir site: siparişler Paysera callback'i ile ödenir, bu nedenle sitenizin internetten erişilebilir olması gerekir; oturum açma, bakım modu veya güvenlik duvarının arkasında olmamalı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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_paysera_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Paysera > Manage veya 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. Paysera hesabınızdaki Project ID ve Project password değerlerini girin (bkz. Yapılandırma).

6. İsteğe bağlı: para çekmeden akışı denemek için Paysera projesinde Allow test payments ve eklentide Test payments seçeneklerini etkinleştirin. Satışa başlamadan önce kapatın.

7. Enable/Disable seçeneğini açın ve kaydedin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Paysera. Alanların üstünde sayfa, proje kimliği ve proje şifresi girilene kadar Paysera, proje kimliği ve proje şifresi girilene kadar ödeme sayfasında gizlenir. uyarısını, bunlardan biri eksikken gösterir; ayrıca test ödemeleri veya sandbox açıkken müşterilerden para alınmadığını belirten bir bildirim görüntüler. Ödeme yöntemleri listesinde Paysera, proje yapılandırılana kadar kurulum gerektiren olarak işaretlenir; test ödemeleri veya sandbox açıkken test modu rozeti gösterilir.

Genel

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

Title: ödeme sayfasında gösterilen ödeme yönteminin adı. Varsayılan: Paysera.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Paysera.

Paysera projesi

Proje kimliğini ve proje şifresini Paysera hesabınızda, Projects and activities bölümünde, projenizi seçip General project settings kısmında bulabilirsiniz. Bu bölüm callback URL'sini gösterir; şuna benzer: https://your-site/wc-api/wc_psr_payment/. Her ödemeyle otomatik olarak gönderilir; Paysera'da bir şey yapılandırmanız gerekmez.

Project ID: Paysera projenizin sayısal kimliği.

Project password: proje şifresi (imza anahtarı). Ödeme isteklerini imzalar ve Paysera callback'lerini doğrular.

Test

Test payments: Send payments in test mode (no money is charged). Paysera, müşteriden para almadan başarılı bir test ödemesi döndürür. Önce Paysera projesi ayarlarında Allow test payments seçeneğini etkinleştirin. Bu seçenek açıkken test ödemeleri siparişleri ödenmiş olarak işaretler; kapalıyken bir test ödemesi hiçbir siparişi ödemez. Varsayılan: kapalı.

Environment: müşterinin gönderildiği yer. Normal bir Paysera projesi için, test ödemeleri dahil, Production seçili kalmalıdır. Varsayılan: Production.

Gelişmiş

Debug log: Log payment events. Hatalar her zaman kaydedilir. Günlükler WooCommerce > Status > Logs bölümünde, kaynak wcp_paysera_payment olarak bulunur. Şifreler ve müşteri verileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

Delete data: Delete the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri her zaman saklanır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini (varsayılan olarak Paysera) seçer ve siparişi verir. Test ödemeleri açıkken ödeme sayfasında TEST MODU — hiçbir ücret alınmayacak. görüntülenir. Eklenti, sipariş tutarını sipariş para biriminin en küçük biriminde içeren, müşterinin adı, e-posta adresi ve fatura adresiyle birlikte imzalı bir ödeme isteği oluşturur ve dili sitenizin diline göre seçer (Litvanca, Letonca, Estonca, Rusça, Almanca, Lehçe; diğer durumlarda İngilizce). Müşteri, Paysera ödeme penceresine yönlendirilir ve orada bir banka, kart veya başka bir yöntem seçer.

Ödemeden sonra müşteri sipariş alındı sayfasına döner. Sipariş yalnızca imzalı Paysera callback'i geldiğinde ödenmiş olarak işaretlenir; müşterinin dönüşü hiçbir zaman bir siparişi ödemez.

Müşteri Paysera penceresinde iptal ederse sipariş WooCommerce'in standart yöntemiyle iptal edilir ve müşteri yeniden sipariş verebilir. Ödeme başlatılamazsa müşteri Paysera ödemeleri geçici olarak kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin. mesajını görür. Nedeni günlüğe yazılır.

Ö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 WooCommerce üzerinden iade yapmaz; ödeme sayfasında banka veya ödeme yöntemi seçimi sunmaz; ayrıca abonelik, kayıtlı kart ve Paysera kurye veya teslimat hizmetleri de içermez.

Siparişler

Sipariş durumları

Pending payment: müşteri Paysera'ya yönlendirildi ve callback henüz gelmedi.

Processing: Paysera ödemeyi onayladı (durum 1). Yalnızca indirilebilir sanal ürün içeren siparişler, WooCommerce varsayılanı olan Tamamlandı durumuna geçer. Sipariş notu Paysera isteğini ve ödeme yöntemini gösterir. İşlem kimliği Paysera istek kimliğidir.

On hold: Paysera ödeme talimatını kabul etti ancak henüz yürütmedi (durum 2); Paysera ödemeyi onayladığında sipariş tamamlanır. Ya da ödenen tutar veya para birimi siparişten farklıdır (amount/currency mismatch notu). Ya da test ödemeleri kapalıyken bir TEST ödemesi alındı ve bu nedenle hiçbir ücret alınmadı. Sipariş notu nedenini açıklar.

Cancelled: Müşteri Paysera penceresinde iptal etti ya da siparişi siz ya da stok rezervasyonunun zaman aşımı iptal etti. İptal edilmiş bir siparişe daha sonra gelen onaylı bir ödeme siparişin durumunu değiştirmez: bir not, siparişi geri yüklemenizi (Processing durumuna almanızı) veya ödemeyi Paysera'da iade etmenizi ister.

Diğer Paysera durumları (ödeme yürütülmedi, ek bilgi) yalnızca bir not ekler. Zaten ödenmiş bir siparişe başka bir başarılı ödeme gelirse sipariş değişmez ve bir not, yinelenen ödemeyi Paysera hesabınızdan iade etmenizi ister.

İadeler

WooCommerce üzerinden iade desteklenmez: Paysera ödeme penceresi protokolünün bir iade API'si yoktur. İadeleri Paysera hesabınızdan yapın. Paysera bir iade bildirdiğinde siparişe iade edilen tutarı gösteren bir not eklenir ve sipariş durumu değişmez. Gerekirse iadeyi WooCommerce'de manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Paysera 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 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ı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Paysera, ö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. Oturum açmış mağaza yöneticileri ödeme yöntemini hâlâ (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurabilir ve 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 yine onaylanır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Paysera ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve hem Project ID hem de Project password alanlarının girildiğini kontrol edin. Ayarlar sayfası, bunlardan biri eksik olduğu sürece bir uyarı gösterir.

Ödeme gerçekleşti ama sipariş Pending payment durumunda kalıyor: sipariş, müşterinin dönüşüyle değil, Paysera callback'iyle ödenir. Sitenizin, ayarlarda gösterilen callback URL'sinde internetten erişilebilir olduğunu kontrol edin (oturum açma, bakım modu veya güvenlik duvarının arkasında olmamalı) ve WooCommerce > Status > Logs bölümüne, kaynak wcp_paysera_payment olarak bakın.

Callback Invalid signature yanıtı veriyor: Project password projeyle eşleşmiyor ya da callback Paysera'dan gelmemiş. Proje şifresini yeniden kopyalayın.

Callback Project ID mismatch yanıtı veriyor: ayarlardaki Project ID, ödemeyi yapan projeden farklı.

Callback Gateway not configured veya Busy yanıtı veriyor: proje kimliği veya şifresi boş ya da aynı sipariş için başka bir callback hâlâ çalışıyor. Paysera callback'i yeniden dener.

Paysera ödeme penceresini reddediyor veya proje bulunmadığını söylüyor: Environment ayarını kontrol edin. Normal bir Paysera projesi yalnızca Production ile çalışır; Sandbox ise Paysera sandbox ortamında oluşturulmuş bir proje gerektirir.

Test ödemesi siparişi ödemiyor: bir TEST ödemesi, yalnızca Test payments açıkken bir siparişi öder. Aksi halde sipariş, hiçbir ücret alınmadığını belirten bir notla beklemeye alınır. Ayrıca Paysera projesinde Allow test payments seçeneğini de etkinleştirin.

Ödeme sayfasında simge yok: eklenti varsayılan olarak simge göstermez. Geliştiriciler wc_psr_gateway_icon filtresiyle bir simge tanımlayabilir.

Bir sipariş tutar veya para birimi uyuşmazlığı notuyla On hold durumunda: Paysera, tutarı veya para birimi sipariş toplamıyla eşleşmeyen bir ödemeyi onayladı; örneğin müşteri ödemeye başladıktan sonra sipariş düzenlendiği için. Ödemeyi Paysera hesabınızda karşılaştırın ve siparişi manuel olarak tamamlayın ya da 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 serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adında etkinleştirmek için 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 saklar. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükler yalnızca Delete data seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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