VibeFox Paystack for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

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

PHP: 8.0 veya üzeri.

Para birimi: sipariş, 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 var: 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 mağazanızın webhook URL'sini de ayarlarsınız (bkz. Yapılandırma). Webhook'ları alabilmek için sitenizin internetten erişilebilir olması gerekir.

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_paystack_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 > Paystack > 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. Paystack panelinden gizli anahtarlarınızı yapıştırın ve Paystack panelinde webhook URL'sini ayarlayın (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın ve kaydedin. Gerçek ödemeleri kabul etmek için bir test ödemesi yapana kadar Test Mode seçeneğini açık tutun, sonra işareti kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Paystack. Alanların üstünde bir durum kutusu modu gösterir: Test modu: gerçek para çekilmez. veya Canlı mod: gerçek ödemeler kabul edilir. Ayrıca geçerli modun gizli anahtarı boş olduğunda, bir genel anahtar (pk_...) gizli anahtar alanına girildiğinde, canlı modda test anahtarı (sk_test_...) veya test modunda canlı anahtar (sk_live_...) olduğunda ve Paystack mağaza para biriminizi kabul etmediğinde uyarır. Bir anahtar sorunu varken ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde Paystack, geçerli modun bir gizli anahtarı olana kadar kurulum gerektiren olarak işaretlenir.

Ödeme

Enable/Disable: Enable Paystack Payment ö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: Paystack.

Description: ödeme sayfası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 bağlantı verir.

Test Mode: Enable Test Mode, yeni ödemeler için test gizli anahtarını kullanır ve gerçek para çekilmez. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için işareti kaldırın. Diğer modda yapılan ödemeler, doğrulama ve iadeler için kendi modlarının anahtarını kullanmaya devam eder. Varsayılan: açık.

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.

Webhook

Webhook, müşteri mağazaya geri dönmese bile mağazanıza bir ödemenin yapıldığını bildirir. Paystack panelinde, Settings > API Keys & Webhooks sayfasında, bu bölümde gösterilen URL'yi hem Test Webhook URL hem de Live Webhook URL olarak ayarlayın. Şuna benzer: https://your-site/wc-api/paystack_p_webhook/. URL'yi ayarlarda gösterildiği gibi aynen kopyalayın.

Paystack her webhook'u gizli anahtarınızla imzalar, bu nedenle başka bir şey yapılandırmanız gerekmez. Test webhook'ları test gizli anahtarıyla, canlı webhook'lar canlı gizli anahtarla doğrulanır. Geçerli imzası olmayan webhook'lar reddedilir. Eklenti 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: Automatically mark orders as completed after successful payment. İşaretlendiğinde, ödenen siparişler Processing yerine Tamamlandı olur; tek bir durum değişikliği ve müşteriye tek bir e-posta gönderilir. Varsayılan: kapalı.

Gelişmiş

Debug log: Log Paystack events and API calls for debugging, ayrıntıları WooCommerce > Status > Logs bölümüne, kaynak wcp_paystack_payment olarak yazar. Hatalar her zaman kaydedilir. Anahtarlar ve müşteri verileri hiçbir zaman günlüğe yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlerde kayıtlı ödeme verileri her zaman saklanır. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini (varsayılan olarak Paystack) seçer ve siparişi verir. Test modunda ödeme sayfasında TEST MODU ETKİN. Gerçek bir tahsilat yapılmayacak. görüntülenir. Eklenti, sipariş para biriminde sipariş toplamı için ve siparişin fatura 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.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, ancak Paystack onayladıktan sonra ödenmiş olarak işaretlenir: müşteri döndüğünde ve webhook geldiğinde eklenti, işlemi ödemenin başlatıldığı modun gizli anahtarıyla Paystack API'sinden okur ve referansı, durumu, tutarı ve para birimini kontrol eder. Ödeme hâlâ işleniyorsa, örneğin bir banka havalesi, sipariş alındı sayfası Ödemeniz Paystack tarafından onaylanıyor. Onaylandığında size bir e-posta göndereceğiz. mesajını gösterir. Webhook siparişi daha sonra tamamlar.

Müşteri Paystack sayfasında iptal ederse ya da ödemeden ayrılırsa sipariş ödeme beklemeye devam eder. Müşteri, bir mesajla birlikte ödeme sayfasına ya da Pay for order sayfasına döner; örneğin Ödeme iptal edildi. Yeniden deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz., Ödeme tamamlanmadı. Yeniden deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. ya da Ödemeniz reddedildi. Yeniden deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. Müşteri aynı siparişi yeniden ödeyebilir. Siparişin önceki bir ödeme sayfası geçerli kalır: daha sonra ödenirse ödeme yine kabul edilir.

Sipariş alındı sayfası yalnızca siparişin müşterisi için açılır: imzalı dönüş bağlantısı, siparişi oluşturan ödeme oturumu ya da müşteri hesabı aracılığıyla. Başkaları, nötr bir mesajla ödeme sayfasına yönlendirilir ve sipariş sayfası gösterilmez.

Paystack ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin Paystack ödemeyi başlatamadı: ardından Paystack'in bildirdiğ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. Sipariş toplamı sıfırdan büyük olmalı ve siparişin geçerli bir e-posta adresi bulunmalıdı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.

Eklentinin gömülü veya açılır pencere ödeme formu, kayıtlı kartı, aboneliği, bölünmüş ödemesi veya alt hesabı yoktur; WooCommerce'de ödeme kanalı seçimi de yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Paystack'e yönlendirildi ve henüz ödeme yapmadı, Paystack sayfasından ödeme yapmadan ayrıldı ya da ödeme hâlâ Paystack tarafından işleniyor. Müşteri ödeme yapmadan döndüğünde, bir not siparişin hâlâ ödeme beklediğini belirtir.

Processing or Completed: ödeme onaylandı. Autocomplete Order açıksa durum Tamamlandı olur. Sipariş notu tutarı, Paystack referansını, işlem numarasını, modu (test veya canlı), ödeme kanalını, kart ödemeleri için kart tipini ve son hanelerini ile müşterinin ödediği Paystack ücretlerini gösterir. Siparişin işlem kimliği Paystack referansıdır (order_...).

On hold: ödenen tutar veya para birimi siparişten farklı (Paystack amount or currency mismatch notu) ya da ödeme, sipariş iptal edildikten sonra geldi. Sipariş notu neyin kontrol edilmesi gerektiğini açıklar. Siparişi işleyin ya da ödemeyi iade edin.

Failed: Paystack, bekleyen bir siparişin son ödeme denemesinin başarısız olduğunu ya da geri alındığını bildirir. Daha eski bir denemenin başarısız olması siparişi değiştirmez. Müşteri yeniden ödeyebilir.

Zaten ödenmiş bir siparişin ikinci bir ödeme denemesi de ödenirse sipariş değişmez. Bir not, yinelenen ödemeyi Paystack panelinde iade etmenizi ister. Başka bir durumdaki (örneğin Refunded) bir sipariş için gelen ödeme yalnızca siparişe not düşülür.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Paystack düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade düğmesi yalnızca doğrulanmış bir Paystack işlemiyle ödenmiş siparişler için sunulur. İade, siparişi ödeyen işleme gönderilir ve bu işlemin yapıldığı modun (test veya canlı) gizli anahtarı kullanılır; bu nedenle o anahtarın ayarlı olması gerekir. XOF ve RWF'de iadeler tam tutar olmalıdır. Paystack iadeleri kuyruğa alır: sipariş notu, Paystack'in döndürdüğü durumu (örneğin pending) ve iade kimliğini gösterir. Paystack iadeyi kabul etmezse WooCommerce, nedeniyle birlikte Paystack refund failed: mesajını gösterir ve hiçbir iade kaydedilmez.

Paystack panelinde yapılan iadeler ve Paystack'in kuyruğa aldığı iadelerin nihai durumu WooCommerce ile senkronize edilmez. Gerekirse bunları manuel olarak kaydedin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Paystack 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 Paystack, ö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 ve iadeler çalışmaya devam eder.

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

Paystack ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun doğru bir gizli anahtarı olduğunu (test modunda sk_test_... ile Test Secret Key, canlı modda sk_live_... ile Live Secret Key) ve sipariş para biriminin Paystack tarafından kabul edildiğini kontrol edin. Ayarların üstündeki durum kutusu sorunu belirtir.

Ödeme gerçekleşti ama sipariş Pending payment durumunda kalıyor: webhook mağazanıza ulaşmadı ve müşteri geri dönmedi. Paystack panelinde Test Webhook URL ve Live Webhook URL alanlarının ayarlarda gösterilen URL ile tam olarak aynı olduğunu ve bakım modu, güvenlik duvarı ya da parola koruması tarafından engellenmediğini kontrol edin. Reddedilen webhook'lar için WooCommerce > Status > Logs bölümüne, kaynak wcp_paystack_payment olarak bakın.

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

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

Webhook Verification failed veya Busy, retry later yanıtı veriyor: işlem o anda Paystack API'sinden okunamadı ya da sipariş aynı anda müşterinin dönüşüyle güncelleniyordu. Sipariş değişmez ve Paystack webhook'u yeniden gönderir.

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

Müşteri Payment gateway is not properly configured mesajını görüyor: geçerli modun gizli anahtarı eksik ya da yanlış. Ayarların üstündeki durum kutusunda belirtildiği gibi düzeltin.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi işleyin ya da ö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ı ayarlanmamış. Anahtarı girip yeniden deneyin. No verified Paystack payment was found for this order mesajı, siparişin doğrulanmış bir Paystack işlemiyle ödenmediği anlamına gelir. Paystack panelinde 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 on uninstall 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ı, işlem kimliklerini ve Paystack referanslarını korur.

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