VibeFox Paystack for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: sepet, Paystack'in kabul ettiği bir para biriminde olmalıdır: NGN, USD, GHS, ZAR, KES, XOF, EGP veya RWF; Paystack hesabınızda etkinleştirilmiş olmalıdır. Diğer para birimlerinde ödeme yöntemi gizlenir. XOF ve RWF'de Paystack yalnızca tam tutarları kabul eder.

Paystack hesabı: Paystack hesabınızın gizli anahtarlarına ihtiyacınız vardır: test gizli anahtarı (sk_test_...) ve/veya canlı gizli anahtar (sk_live_...). Ödeme Paystack'in barındırılan sayfasında yapıldığı için genel anahtarlar (pk_...) gerekli değildir. Paystack panelinde ayrıca mağazanızın webhook URL'sini de ayarlarsınız (bkz. Yapılandırma). Webhook'ları alabilmek için mağazanızın internetten erişilebilir olması 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Paystack Payment öğesini bulup Configure düğmesine tıklayın.

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

4. Paystack panelinden gizli anahtarlarınızı yapıştırın ve Paystack panelinde webhook URL'sini ayarlayın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test ödemesi yapana kadar Test Mode seçeneğini açık tutun, ardından gerçek ödemeleri kabul etmek için kapatın.

Kurulum sırasında modül iki sipariş durumu oluşturur: Awaiting Paystack payment ve Paystack payment on hold. PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Paystack Payment > Configure. Alan içeren her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde bir durum kutusu modu gösterir: Test modu: gerçek para tahsil edilmez. veya Canlı mod: gerçek ödemeler kabul edilir. Ayrıca geçerli modun gizli anahtarı boş olduğunda, bir gizli anahtar alanına genel anahtar (pk_...) girildiğinde, canlı modda test anahtarı (sk_test_...) veya test modunda canlı anahtar (sk_live_...) olduğunda ve Paystack mağazanızın varsayılan para birimini kabul etmediğinde uyarır. Bir anahtar sorunu olduğu sürece ödeme yöntemi ödeme adımında gizlenir.

Paystack

İlk bölümün başlığı Paystack'tir ve geçerli modun TEST ya da LIVE rozeti bulunur.

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

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

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely using your debit card, credit card, or bank account via Paystack.

API anahtarları

Gizli anahtarları Paystack panelinden, Settings > API Keys & Webhooks sayfasından kopyalayın. Bölüm bu sayfaya bir bağlantı içerir.

Test Mode: yeni ödemeler için test gizli anahtarını kullanır ve gerçek para tahsil edilmez. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için kapatın. Diğer modda yapılan ödemeler, doğrulama ve iadeler için kendi modunun anahtarını kullanmaya devam eder. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında TEST MODU ETKİN. Gerçek tahsilat yapılmayacaktır. ifadesini görür.

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

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

Kayıtlı anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

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

Webhook

Webhook, müşteri mağazaya dönmese bile mağazanıza bir ödemenin yapıldığını bildirir. Paystack panelinde, Settings > API Keys & Webhooks sayfasında, bu bölümdeki Webhook URL alanında gösterilen URL'yi hem Test Webhook URL hem de Live Webhook URL olarak ayarlayın. Kullanıcı dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_paystack_payment/webhook, belki /en/ gibi bir dil koduyla. URL'yi ayarların gösterdiği biçimde birebir kopyalayın.

Paystack her webhook'u gizli anahtarınızla imzalar, bu nedenle başka bir şey yapılandırmanız gerekmez. Geçerli bir imzası olmayan webhook'lar reddedilir. Modül charge.success olayını kullanır:

Diğer olaylara OK yanıtı verilir ve yok sayılır. Webhook olmadan bir sipariş, yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır. Daha sonra tamamlanan banka havaleleri ve USSD ödemeleri yalnızca webhook ile onaylanır.

Siparişler

Autocomplete Order: açıkken ödenen siparişler, tek bir durum değişikliğiyle Payment accepted yerine Delivered durumunu alır. Varsayılan: kapalı.

Gelişmiş

Debug log: Paystack olaylarını ve API çağrılarını modül klasöründeki logs/paystack_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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çıkken modül kaldırıldığında modül ayarları ve günlük silinir. Siparişlerde kaydedilen ödeme verileri her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paystack) ve siparişi onaylar. Modül, sepet toplamı için sepet para biriminde, müşterinin e-posta adresiyle bir Paystack işlemi başlatır ve müşteriyi Paystack'in barındırılan ödeme sayfasına gönderir. Orada müşteri, Paystack hesabınızda etkinleştirilmiş kanallardan biriyle öder. Ödeme ekranında sepet numarası ve müşteri adı gösterilir. Bu noktada henüz bir sipariş yoktur.

Ödemeyi yaptıktan sonra müşteri mağazanıza döner. Sipariş, yalnızca Paystack onayladıktan sonra ödenmiş olarak işaretlenir: müşteri döndüğünde ve webhook geldiğinde modül işlemi Paystack API'sinden okur ve referansı, durumu, tutarı ve para birimini kontrol eder. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Ödeme hâlâ işleniyorsa, örneğin banka havalesi, müşteri döndüğünde sipariş Awaiting Paystack payment durumunda oluşturulur ve onay sayfasında Ödemeniz Paystack tarafından onaylanıyor. Onaylandığı anda size bir e-posta gönderilecektir. mesajı gösterilir. Webhook siparişi daha sonra tamamlar. Müşteri döndüğünde Paystack'e ulaşılamazsa, bir Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ve Back to checkout seçeneklerini sunar; webhook geldiği anda siparişi oluşturur. Bir inceleme altındaki sipariş için onay sayfası Ödemeniz alındı ve siparişiniz inceleniyor. Gerekirse sizinle iletişime geçeceğiz. mesajını gösterir.

Müşteri Paystack sayfasında iptal ederse veya ödeme yapmadan çıkarsa sipariş oluşturulmaz ve sepet korunur. Müşteri, örneğin Ödeme iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz., Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. ya da Ödemeniz reddedildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. gibi bir mesajla ödeme adımına döner. Her yeni deneme yeni bir Paystack işlemi başlatır. Sepetin daha eski bir ödeme sayfası geçerli kalır: sonradan ödenirse ödeme yine kabul edilir.

Sipariş onay sayfası yalnızca müşterinin kendi tarayıcısında açılır. Dönüş bağlantısı başka bir yerde açılırsa ödeme yine de kontrol edilir, ancak sipariş gösterilmez: ziyaretçi ödeme adımında nötr bir mesaj görür.

Paystack ödemeyi başlatamazsa müşteri kısa bir mesajla ödeme adımında kalır, örneğin Paystack ödemeyi başlatamadı: ardından Paystack'in verdiği neden, ya da Paystack geçici olarak kullanılamıyor. Lütfen birazdan tekrar deneyin veya başka bir ödeme yöntemi seçin. Sepet toplamı sıfırdan büyük olmalı ve müşterinin geçerli bir e-posta adresi bulunmalıdır.

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

Modülün PrestaShop'ta gömülü veya açılır pencere ödeme formu, kayıtlı kart, abonelik, bölünmüş ödeme veya alt hesap yoktur ve ödeme kanalı seçimi sunmaz.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri Paystack'e yönlendirildi ve ödeme yapmadı, Paystack sayfasından ayrıldı veya Paystack ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Awaiting Paystack payment: müşteri, Paystack ödemeyi hâlâ işlerken, örneğin banka havalesi veya USSD sırasında döndü. Paystack ödemeyi onayladığında sipariş ödenmiş duruma geçer. Böyle bir ödeme hiç tamamlanmazsa, siz değiştirene kadar sipariş bu durumda kalır.

Payment accepted veya Delivered: ödeme onaylandı. Autocomplete Order açıksa durum Teslim edildi olur. Ödeme, işlem kimliği olarak Paystack referansıyla (pscart_...) kaydedilir. Bir not; tutarı, referansı, işlem numarasını, modu (test veya canlı), ödeme kanalını, kart türünü ve kartlı ödemeler için son hanelerini, ayrıca müşterinin ödediği Paystack ücretlerini gösterir.

Paystack payment on hold: ödenen tutar veya para birimi siparişle eşleşmiyor (Paystack tutarı veya para birimi uyuşmazlığı notu); örneğin ödeme başladıktan sonra sepet değiştirildiği veya sipariş iptal edildikten sonra ödeme geldiği için. Not, nelerin kontrol edilmesi gerektiğini açıklar. Siparişi karşılayın veya ödemeyi iade edin.

Ödeme hatası: Paystack, Awaiting Paystack payment durumundaki bir siparişin son ödeme denemesinin başarısız olduğunu veya geri alındığını bildirir. Daha eski bir denemenin başarısızlığı siparişi değiştirmez.

Siparişi zaten ödenmiş olan bir sepet için ikinci bir ödeme gelirse sipariş değişmez. Bir not, yinelenen ödemeyi Paystack panelinden iade etmenizi ister. Başka bir durumdaki bir sipariş için gelen ödeme, örneğin Kargolandı, yalnızca siparişe not edilir.

Paystack payment bloğu

Sipariş sayfasında referans, işlem kimliği, test ödemeleri için Test mode rozetiyle birlikte mod, ödeme durumu, kanal ve kart, ödeme tarihi, ödenen ve iade edilen tutarlar, iade geçmişi ve siparişin Payment notes bölümünü içeren bir Paystack payment bloğu gösterilir.

İadeler

Paystack payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Paystack düğmesine tıklayın. Bu tutar Paystack üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme yetkisine ihtiyacınız vardır; modül sayfalarına erişim gerekmez. İade, siparişi ödeyen işleme gönderilir ve iade hangi modda (test veya canlı) yapıldıysa o modun gizli anahtarı kullanılır; bu nedenle o anahtarın ayarlanmış olması gerekir. İadeler, Paystack'in tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar veya para birimi uyuşmazlığından sonra beklemedeki bir sipariş için, sipariş toplamını değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. XOF ve RWF'de iadeler tam tutar olmalıdır. Paystack iadeleri kuyruğa alır: not ve iade geçmişi, Paystack'in döndürdüğü durumu (örneğin pending) ve iade kimliğini gösterir. Paystack iadeyi kabul etmezse blok, nedeniyle birlikte Paystack iadesi başarısız: mesajını gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, Paystack ödemeyi onayladıktan sonra kullanılabilir.

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

Paystack panelinde yapılan iadeler ve Paystack'in kuyruğa aldığı iadelerin nihai durumu PrestaShop'a geri senkronize edilmez. Gerekirse bunları elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paystack Payment lisans bloğu, Modules > Module Manager > VibeFox Paystack Payment > Configure sayfasında, ayarların üstünde 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 Check now (durumu yeniden kontrol etmek için), Change key (başka bir anahtar girmek için) ve Remove key (anahtarı bu mağazadan kaldırmak için) düğmelerini gösterir. Bunların altında Product: presta-payment-paystack satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisine sahip personel değiştirebilir. Bloğun metinleri back office 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 tek 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Paystack, ödeme adımı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 mağaza ön yüzü, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: önceden başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Back office'te ç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 job gerekmez. Modülü kaldırmak veya sıfırlamak, lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Paystack ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda doğru bir gizli anahtar bulunduğunu (test modunda sk_test_... ile Test Secret Key, canlı modda sk_live_... ile Live Secret Key) ve sepet para biriminin Paystack tarafından kabul edildiğini kontrol edin. Ayarların üstündeki durum kutusu sorunu belirtir. 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 yapıldı ama sipariş oluşturulmadı: webhook mağazanıza ulaşmadı ve müşteri geri dönmedi. Paystack panelinde Test Webhook URL ve Live Webhook URL'nin Webhook URL alanında gösterilen URL ile birebir aynı olduğunu ve bir güvenlik duvarı ya da parola korumasının bunu engellemediğini kontrol edin. Debug log seçeneğini açın ve reddedilen webhook'lar için Log alanına bakın.

Webhook Invalid signature yanıtı veriyor: webhook, ayarlarda girilen test veya canlı gizli anahtarla imzalanmamış; örneğin anahtarlar başka bir Paystack hesabına ait olabilir. Webhook'u gönderen hesabın anahtarlarını girin.

Webhook Secret key not configured yanıtı veriyor: hiçbir gizli anahtar ayarlanmamış. Ayarlarda gizli anahtarları girin.

Webhook Verification failed, Busy, retry later veya Order could not be created, retry later yanıtı veriyor: işlem o anda Paystack API'sinden okunamadı, sepet aynı anda müşterinin dönüşü tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı olduğu için). Paystack webhook'u yeniden gönderir. Günlük nedeni gösterir.

Webhook OK - unknown reference yanıtı veriyor: ödeme bu mağazanın bir sepeti için yapılmamış; örneğin aynı hesaptaki bir Paystack ödeme sayfası veya başka bir entegrasyon. Yok sayılır.

Webhook URL'si tarayıcıda Empty body gösteriyor: bu normaldir. URL yalnızca Paystack'ten gelen istekleri kabul eder.

Müşteri «Ödeme ağ geçidi doğru yapılandırılmamış» mesajını görüyor: geçerli modun gizli anahtarı eksik veya hatalı. Ayarların üstündeki durum kutusundaki yönergeleri izleyerek düzeltin.

Ödemeden sonra sipariş Paystack payment on hold durumunda: Paystack payment bloğundaki ödeme notlarını okuyun (bkz. Sipariş durumları), ardından siparişi karşılayın veya ödemeyi iade edin.

Sipariş Awaiting Paystack payment durumunda kalıyor: Paystack ödemeyi henüz onaylamadı. Paystack panelinde işlemi ve webhook ayarlarını kontrol edin. Müşteri ödemeyi hiç tamamlamadıysa durumu elle değiştirin.

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

Geliştiriciler, işlem isteğini ve para birimi listesini modülün hook'ları actionWcpPaystackPaymentRequest, actionWcpPaystackSupportedCurrencies ve actionWcpPaystackCurrencyDecimals ile değiştirebilir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Paystack Payment 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 korunur. Siparişlerdeki Paystack ödeme verileri, iadeler ve Awaiting Paystack payment ile Paystack payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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