VibeFox PayPlug for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül eski PHP sürümlerinde kurulmayı reddeder.

Para birimi ve tutarlar: euro (EUR), ödeme başına 0,99 ile 20.000,00 arası; PayPlug'ın varsayılan değerleri. Sepetin para birimi farklıysa veya bu sınırların dışındaysa ödeme yöntemi gizlenir.

PayPlug hesabı: PayPlug hesabınızın gizli anahtarlarına ihtiyacınız var: test anahtarı (sk_test_...) ve/veya canlı anahtar (sk_live_...). Başka anahtar gerekmez ve PayPlug'da bildirim kurulması gerekmez. Bildirim alabilmek için mağazanızın internetten erişilebilir olması gerekir; aksi halde müşteri PayPlug'dan döndüğünde siparişler oluşturulur.

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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox PayPlug Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test Mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için kapatın.

Kurulumda modül PayPlug payment on hold sipariş durumunu oluşturur. PrestaShop yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. 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 PayPlug Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa, ödeme yöntemi etkin ama geçerli modun gizli anahtarı boşsa ve mağazanın varsayılan para birimi EUR değilse sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir.

Ödeme

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

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

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 portala bir bağlantı vardır.

Test Mode: yeni ödemeler için test gizli anahtarını kullanır. Gerçek ödeme işlenmez. Diğer modda yapılan ödemeler, durum sorguları ve iadeler için kendi modlarının anahtarını kullanmaya devam eder. Varsayılan: on. Açıkken müşteriler ödeme yönteminin altında Test mode: no real payment will be made. ifadesini görür.

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ış önekle başlayan bir anahtar kaydedilmez. Sayfa örneğin Test Secret Key must start with "sk_test_". The previous value was kept. uyarısını gösterir. Kaydedilmiş anahtarlar bir daha asla 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.

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

Notification URL: modülün her ödemeyle birlikte PayPlug'a gönderdiği adres. Okunabilir URL'ler etkinse şöyle görünür: https://your-shop/module/wcp_payplug_gateway/webhook. PayPlug portalına hiçbir şey girmeniz gerekmez. URL internetten erişilebilir olmalıdır; aksi halde müşteri PayPlug'dan döndüğünde siparişler oluşturulur.

Siparişler

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

Gelişmiş

Logging: API çağrılarını ve bildirimleri modül klasöründeki logs/ppg_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. Gizli anahtarlar, kart verileri ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: off.

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

Delete Data on Uninstall: açıksa modül kaldırıldığında modül ayarları ve günlüğü silinir. Siparişlerle birlikte kaydedilen PayPlug ödeme kimlikleri ve PayPlug payment on hold sipariş durumu korunur. Varsayılan: off.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayPlug logosuyla birlikte PayPlug). Test modunda seçenek Test mode: no real payment will be made. ifadesini gösterir. Onaylandıktan sonra modül, sepet tutarı için kuruş cinsinden bir PayPlug ödemesi oluşturur ve müşteriyi PayPlug ödeme sayfasına gönderir. Fatura ve teslimat adresleri, e-posta ve sepetin dili PayPlug'a iletilir. Müşteri orada kartla öder. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş yalnızca PayPlug onayladıktan sonra ödenmiş olarak işaretlenir: modül, bildirim geldiğinde ve müşteri geri döndüğünde ödemeyi PayPlug API'sinden okur. Sipariş daha sonra oluşturulur ve müşteri Your payment with PayPlug has been received. ifadesinin yer aldığı standart sipariş onay sayfasını görür. Sipariş beklemedeyse sayfa We are confirming your payment with PayPlug. The order will be updated automatically — please do not pay again. der. Sipariş Payment error durumundaysa veya ödeme yapılmadan iptal edildiyse sayfa Your PayPlug payment was not completed. Please contact us about this order. der. Müşteri geri döndüğünde PayPlug'a sorulamadıysa, Payment confirmation sayfası aynı "we are confirming" metnini ve Check again düğmesini gösterir; bildirim geldiği anda sipariş oluşturulur.

Müşteri PayPlug sayfasında iptal ederse ödeme sayfası PayPlug'da kapatılır, böylece daha sonra yanlışlıkla ödenemez. Müşteri şu mesajla ödeme adımına döner: You cancelled the PayPlug payment. You can try again or choose another payment method., The PayPlug payment session has expired. Please try again or choose another payment method., The PayPlug payment failed. Please try again or choose another payment method. veya ödeme açık bırakıldıysa Your PayPlug payment was not completed. You can try again or choose another payment method. Sepet korunur.

Müşteri aynı sepeti yeniden öderse modül önce önceki denemeyi kontrol eder. Bu arada ödenmişse sipariş yeni bir ödeme olmadan oluşturulur. 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 ödeme adımında kalır ve kısa bir mesaj görür, örneğin PayPlug could not accept your billing details (postcode). Please check them and try again. veya The payment provider could not be reached. Please try again in a moment. Teknik neden günlüğe yazılır.

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

Ödemeler hemen tahsil edilir. Modülde Oney taksitleri, tek tıkla kaydedilen kartlar, gömülü ödeme formu, abonelikler ve ertelenmiş tahsilat yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri PayPlug'a yönlendirildi ve ödeme yapmadı ya da PayPlug henüz ödemeyi onaylamadı. Yalnızca sepet vardır.

Payment accepted or Delivered: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Ödeme, PayPlug ödeme kimliği (pay_...) işlem kimliği olarak kaydedilir ve bir not PayPlug ödemesini ve modunu gösterir.

PayPlug payment on hold: ödenen tutar veya para birimi sepetten farklı (amount/currency mismatch notu; örneğin ödeme başladıktan sonra sepet değiştirildi); veya mağaza canlı modda iken bir test ödemesi yapıldı, bu yüzden para alınmadı ve ödeme kaydedilmez; veya ödeme iptal edilmiş bir sipariş için geldi; veya bir ödeme yetkilendirildi ama tahsil edilmedi (PayPlug portalında tahsil edin; PayPlug ödendi bildirdiğinde sipariş ödenmiş olarak işaretlenir). Not, neyi kontrol etmeniz gerektiğini açıklar.

Payment error: beklemedeki bir siparişin yetkilendirilmiş ödemesi başarısız oldu veya iptal edildi.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Zaten ödenmiş bir sepetin ikinci denemesi de ödenirse sipariş değişmez. Bir not, mükerrer ödemeyi PayPlug portalından iade etmenizi ister. Ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş, sonraki bir bildirimle asla yeniden açılmaz.

PayPlug ödeme bloğu

Sipariş sayfasında PayPlug ödeme kimliği, ödeme durumu, ödenen ve iade edilen tutar, test ödemeleri için Test mode rozeti, iade geçmişi ve siparişin PayPlug notes bölümü içeren bir PayPlug payment bloğu gösterilir.

İadeler

PayPlug payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via PayPlug düğmesine tıklayın. Refund this amount through PayPlug? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modüller sayfalarına erişim gerekmez. İadeler, PayPlug'ın gerçekten tahsil ettiği tutara kadar yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamı değil, müşterinin ödediği tutar iade edilebilir. İade, siparişi gerçekten ödeyen ödemeye ve iadenin yapıldığı modun (test veya canlı) gizli anahtarıyla gönderilir; bu nedenle o anahtarın ayarlanmış olması gerekir. PayPlug iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, PayPlug iade kimliği ve nedeniyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler yalnızca PayPlug ödemeyi ödendi olarak bildirdikten sonra kullanılabilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri PayPlug üzerinden para geri göndermez.

PayPlug portalında yapılan iadeler bildirimle gelir ve notlara bir kez eklenir. Blokta sayılmazlar ve sipariş durumunu veya kredi notlarını değiştirmezler. Gerekirse bunları elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayPlug Gateway lisans bloğu, Modules > Module Manager > VibeFox PayPlug Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın 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-payplug 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 için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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ı hakkı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 tek bir alan adında çalışır: çok mağazalı kurulumda da ana mağazanın alan adında. Anahtarı mağazadan kaldırmak alan adı hakkını serbest bırakmaz. Alan adı hakkını vibefox.net hesabınızda 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. PrestaShop vitrini yönetim paneline giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

Lisans süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında 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

PayPlug ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda gizli anahtar bulunduğunu (test modunda Test Secret Key, canlı modda Live Secret Key), sepet para biriminin EUR olduğunu ve sepet toplamının 0,99 ile 20.000,00 EUR arasında olduğunu kontrol edin. 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. Geliştiriciler para birimlerini ve sınırları actionWcpPayplugSupportedCurrencies ve actionWcpPayplugAmountLimits kancalarıyla değiştirebilir (değerler kuruş cinsindendir).

Ödeme yapıldı ama sipariş oluşturulmadı: bildirim mağazanıza ulaşmadı ve müşteri geri dönmedi. Mağazanızın ayarlarda gösterilen Notification URL adresinden internete erişilebilir olduğunu kontrol edin; örneğin bir güvenlik duvarı veya parola koruması bunu engellemiyor olmalı. Logging seçeneğini açın ve reddedilen bildirimler için Log alanına bakın.

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

Bildirim Temporarily unavailable. yanıtı veriyor: sepet aynı anda başka bir istek tarafından güncelleniyordu, örneğin müşterinin dönüşü, veya sipariş oluşturulamadı (örneğin modül devre dışı). PayPlug bildirimi yeniden gönderir. Günlük nedeni gösterir.

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

Bildirim URL'si tarayıcıda Method not allowed. gösteriyor: bu normaldir. URL yalnızca PayPlug'dan gelen istekleri kabul eder.

Müşteri PayPlug'ı seçerken bir hata görüyor: Logging seçeneğini açın ve Log alanına bakın. Yanlış bir anahtar This payment method is temporarily unavailable. Please choose another payment method. mesajını verir; diğer mesajlar PayPlug'ın reddettiği fatura alanını belirtir.

Sipariş ödemeden sonra PayPlug payment on hold durumunda: PayPlug payment bloğundaki notları okuyun (bkz. Sipariş durumları), ardından 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 yeniden deneyin.

İade Unexpected response from PayPlug. ile başarısız oluyor: PayPlug geçerli bir iade olmadan yanıt verdi. Hiçbir şey kaydedilmedi. Yeniden denemeden önce iadeyi PayPlug portalında kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PayPlug Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete Data on Uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. PayPlug ödeme ve iade kayıtları ile PayPlug payment on hold sipariş durumu her zaman saklanır; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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