VibeFox PayPlug for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

Para birimi ve tutarlar: euro (EUR), ödeme başına 0,99 ile 20.000,00 arası; PayPlug'ın varsayılan değerleri. Başka bir para birimiyle ya da bu sınırların dışında ödeme yöntemi gizlenir.

PayPlug hesabı: PayPlug hesabınızın gizli anahtarlarına ihtiyacınız vardır: test anahtarı (sk_test_...) ve/veya canlı anahtar (sk_live_...). Başka anahtar gerekmez ve PayPlug'da bildirim kurmanız gerekmez. Bildirim almak için sitenizin internetten erişilebilir olması gerekir; aksi halde müşteri PayPlug'dan döndüğünde siparişler güncellenir.

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_payplug_gateway 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 > PayPlug > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üst kısmındaki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. PayPlug portalından gizli anahtarlarınızı yapıştırın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve kaydedin. Test Mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > PayPlug. Alanların üzerinde sayfa; ödeme yöntemi etkinken geçerli modun gizli anahtarı boşsa ve mağaza para birimi EUR değilse sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde PayPlug, test modunda bir test modu rozeti gösterir ve geçerli modun gizli anahtarı olana kadar kurulum gerektiren olarak işaretlenir.

Ödeme sayfası

Enable/Disable: Enable PayPlug Gateway ödeme yöntemini açar veya kapatır. Varsayılan: off.

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

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

API anahtarları

Gizli anahtarlarınızı PayPlug portalında Developers > API keys altında bulabilirsiniz. Bu bölümde ayrıca eklentinin her ödemeyle birlikte gönderdiği bildirim URL'si de gösterilir. Şuna benzer: https://your-site/wc-api/ppg_payplug_webhook/. PayPlug'da bildirim kurulumu gerekmez.

Test Mode: Enable test mode, yeni ödemeler için test gizli anahtarını kullanır. Gerçek ödeme işlenmez. Diğer modda yapılan ödemeler, durum kontrolleri ve iadeler için kendi modlarının anahtarını kullanmaya devam eder. Varsayılan: on.

Test Secret Key: PayPlug test gizli anahtarınız. sk_test_ ile başlar.

Live Secret Key: PayPlug canlı gizli anahtarınız. sk_live_ ile başlar.

Yanlış önekli bir anahtar kaydedilmez. Sayfa, örneğin Test Secret Key "sk_test_" ile başlamalıdır. Önceki değer korundu. mesajını gösterir.

Siparişler

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 debug logging, API çağrılarını ve bildirimleri WooCommerce > Status > Logs bölümüne, wcp_payplug_gateway kaynağıyla kaydeder. Hatalar her zaman kaydedilir. Gizli anahtarlar, kart verileri ve müşteri verileri asla kaydedilmez. Varsayılan: off.

Delete Data on Uninstall: Remove all plugin data when uninstalling. İşaretliyse, eklenti silindiğinde eklenti ayarları ve günlükleri silinir. Siparişlerde saklanan PayPlug ödeme kimlikleri korunur. Varsayılan: off.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak PayPlug) ve siparişi verir. Test modunda ödeme sayfasında Test modu: Gerçek bir ödeme yapılmayacak. mesajı görünür. Eklenti, sipariş toplamı için kuruş cinsinden bir PayPlug ödemesi oluşturur ve müşteriyi PayPlug ödeme sayfasına yönlendirir. Siparişin fatura ve teslimat bilgileri ile sitenizin dili PayPlug'a iletilir. Müşteri orada kartla öder.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca PayPlug onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, bildirim geldiğinde ve müşteri geri döndüğünde ödemeyi PayPlug API'sinden okur. Başarılı bir ödeme müşteriyi sipariş alındı sayfasına götürür.

Müşteri PayPlug sayfasında iptal ederse, ödeme sayfası PayPlug'da kapatılır; böylece daha sonra yanlışlıkla ödenemez. Müşteri, örneğin PayPlug ödemesini iptal ettiniz. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz., PayPlug ödeme oturumunun süresi doldu. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. ya da PayPlug ödemesi başarısız oldu. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. gibi bir mesajla Pay for order sayfasına geri döner.

Müşteri aynı siparişi tekrar öderse, eklenti önce önceki denemeye bakar. Bu arada ödenmişse sipariş yeni bir ödeme olmadan tamamlanır. Aynı tutar için hâlâ açıksa aynı ödeme sayfası yeniden kullanılır. Aksi halde eski sayfa PayPlug'da kapatılır ve yeni bir ödeme oluşturulur.

PayPlug ödemeyi başlatamazsa müşteri kısa bir mesaj görür, örneğin PayPlug fatura bilgilerinizi (posta kodu) kabul edemedi. Lütfen kontrol edip tekrar deneyin. veya Ödeme sağlayıcısına ulaşılamadı. Lütfen birkaç dakika sonra tekrar deneyin. Teknik neden sipariş notlarına eklenir.

Ö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.

Ödemeler hemen tahsil edilir. Eklentide Oney taksitleri, Bancontact, Apple Pay veya American Express, tek tıkla kaydedilen kartlar, gömülü ödeme formu, abonelikler ve ertelenmiş tahsilat yoktur.

Siparişler ve iadeler

Order statuses

Pending payment: Müşteri PayPlug'a yönlendirildi ve henüz ödeme yapmadı ya da PayPlug henüz ödemeyi onaylamadı.

Processing or Completed: Ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Sipariş notunda PayPlug ödemesi ve modu gösterilir. İşlem kimliği, PayPlug ödeme kimliğidir (pay_...).

On hold: Ödenen tutar veya para birimi siparişle eşleşmiyor (amount/currency mismatch notu); ya da mağaza canlıyken bir test ödemesi yapıldı, bu nedenle para alınmadı; ya da iptal edilmiş bir siparişe ödeme geldi; ya da bir ödeme yetkilendirildi ama tahsil edilmedi (PayPlug portalında tahsil edin; PayPlug ödemeyi ödenmiş olarak bildirdiğinde sipariş ödenmiş olarak işaretlenir). Sipariş notu neyi kontrol etmeniz gerektiğini açıklar.

Failed: Bekleyen bir siparişin son ödeme denemesi başarısız oldu veya iptal edildi. Daha eski bir denemenin başarısızlığı siparişi değiştirmez. Müşteri yeniden ödeyebilir.

Zaten ödenmiş bir siparişin ikinci bir denemesi de ödenirse sipariş değişmez. Bir not, mükerrer ödemeyi PayPlug portalında iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via PayPlug düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, siparişi gerçekte ödeyen ödemeye gönderilir ve ödemenin yapıldığı modun (test veya canlı) gizli anahtarını kullanır; bu nedenle o modun anahtarı girilmiş olmalıdır. PayPlug iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayPlug iade kimliğiyle birlikte sipariş notlarına eklenir.

PayPlug portalında yapılan iadeler bildirimle gelir ve sipariş notlarına eklenir. WooCommerce'de otomatik olarak oluşturulmazlar. Gerekirse elle kaydedin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > PayPlug sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölümde durum, örneğin lisansın geçerli olduğu son tarih ve alan adınız görünür. 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ın bir siteden kaldırılması alan adı hakkını serbest bırakmaz. Bunu vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan PayPlug, ö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) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirler. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve iadeler ç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

PayPlug ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun gizli anahtarının (test modunda Test Secret Key, canlı modda Live Secret Key) girildiğini, mağaza para biriminin EUR olduğunu ve sipariş toplamının 0,99 ile 20.000,00 EUR arasında olduğunu kontrol edin. Farklı sınırları olan hesaplar bunları ppg_amount_limits filtresiyle değiştirebilir (kuruş cinsinden değerler).

Ödeme yapıldı ama sipariş Ödeme bekleniyor durumunda kaldı: Bildirim mağazanıza ulaşmadı ve müşteri geri dönmedi. Sitenizin, ayarlarda gösterilen bildirim URL'sinde internetten erişilebilir olduğunu kontrol edin; örneğin bakım modu, güvenlik duvarı veya parola koruması engelliyor olabilir mi. Reddedilen bildirimler için WooCommerce > Status > Logs bölümünde, wcp_payplug_gateway kaynağına bakın.

Bildirim Verification failed yanıtı veriyor: Ödeme PayPlug API'sinden okunamadı; örneğin PayPlug yanıt vermedi. Sipariş değişmez ve PayPlug bildirimi yeniden gönderir.

Bildirim Busy, retry yanıtı veriyor: Sipariş, aynı anda başka bir istek tarafından güncelleniyordu; örneğin müşterinin geri dönüşü. PayPlug bildirimi yeniden gönderir.

Bildirim Unknown payment veya Payment does not belong to the order yanıtı veriyor: Ödeme bu mağaza tarafından oluşturulmamış ya da bu sipariş için değil; örneğin aynı PayPlug hesabındaki başka bir mağazanın ödemesi. Yok sayılır.

Müşteri Payment could not be initiated mesajını görüyor: Siparişin önceki ödeme denemesi o anda onaylanıyor ya da PayPlug isteği reddetti. Bir süre bekleyip tekrar deneyin; sipariş notları PayPlug hatasını gösterir.

Sipariş ödemeden sonra Beklemede durumunda: Sipariş notunu okuyun. Ödenen tutar veya para birimi siparişle eşleşmedi, mağaza canlıyken test ödemesi yapıldı ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi işleyin veya ödemeyi iade edin.

İade, mod ile ilgili bir mesajla başarısız oluyor: Ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı yapılandırılmamış. Anahtarı girin ve tekrar 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ı serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı 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. Kaldırmak için 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 on Uninstall seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve PayPlug ödeme kimliklerini korur.

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