VibeFox PayFast for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Para birimi: Güney Afrika randı (ZAR), WooCommerce > Settings > General bölümünde ayarlanır. PayFast yalnızca rand cinsinden ödeme alır. Asgari sipariş toplamı R5.00'dır.

PayFast hesabı: PayFast panelindeki Settings > Developer Settings bölümünden alınan Merchant ID ve Merchant Key. Parola ifadesi (passphrase) şiddetle önerilir; PayFast'ta ayarlıysa aynı parola ifadesi eklentiye de girilmelidir. Testler için PayFast sandbox kimlik bilgileri gerekir.

Erişilebilir site: ödeme bildirim URL'si internetten erişilebilir olmalıdır; bakım modu, temel kimlik doğrulama veya güvenlik duvarı engeli 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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_payfast_pay klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. WooCommerce > Settings > General bölümünden mağaza para birimini Güney Afrika randı olarak ayarlayın.

4. Ayarları açın: WooCommerce > Settings > Payments > PayFast > Manage ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

5. Sayfanın üst kısmındaki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

6. Merchant ID, Merchant Key ve parola ifadesini girin. Testler için Test mode seçeneğini açık tutun ve sandbox kimlik bilgilerinizi girin.

7. Enable/Disable seçeneğini açın ve kaydedin. Bir test ödemesi yapın, ardından gerçek ödemeleri almak için test modunu kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > PayFast. Alanların üstünde sayfa; geçerli modun kimlik bilgileri boşsa (bu durumda PayFast ödeme sayfasında gizlenir), mağaza para birimi ZAR değilse, canlı mod herkese açık sandbox Merchant ID'si 10000100'ü kullanıyorsa ve bir parola ifadesi ayarlanmamışsa uyarır. Test modu açık olduğu sürece Test mode is on: orders are paid in the PayFast sandbox, no real money is charged. mesajını gösterir. Ödeme yöntemleri listesinde, geçerli modun Merchant ID ve Merchant Key değerleri girilene kadar PayFast kurulum gerektiriyor olarak işaretlenir.

Genel

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

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

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

PayFast hesabı (canlı)

Merchant ID ve Merchant Key değerlerinizi PayFast panelinde Settings > Developer Settings altında bulabilirsiniz. Orada bir parola ifadesi ayarladıysanız, burada tam olarak aynısını girin.

Merchant ID: PayFast canlı Merchant ID'niz.

Merchant Key: PayFast canlı Merchant Key'iniz. Her ödeme formuyla PayFast'a gönderilir.

Passphrase: PayFast'tan gelen salt parola ifadesi, Settings > Developer Settings. Şiddetle önerilir: ödemeleri ve bildirimleri imzalar.

Sandbox (test modu)

Test modunda ödemeler PayFast sandbox'ına gider ve gerçek para çekilmez. Sandbox kimlik bilgileri, PayFast sandbox'ına giriş yaptıktan sonra gösterilir (herkese açık test satıcısı 10000100 / 46f0cd694581a'dır).

Test mode: Use the PayFast sandbox and the sandbox credentials below. Ödeme sayfasında müşteri TEST MODE: payments go to the PayFast sandbox, no real money is charged. mesajını görür. Varsayılan: açık.

Sandbox Merchant ID: sandbox hesabınızın Merchant ID'si.

Sandbox Merchant Key: sandbox hesabınızın Merchant Key'i.

Sandbox Passphrase: yalnızca sandbox hesabınızda bir parola ifadesi ayarlıysa.

Test modundayken sürüm 1.0'dan güncelleme yapıyorsanız mevcut kimlik bilgileriniz sandbox alanlarına kopyalanır. Test modunu kapatmadan önce canlı kimlik bilgilerini kontrol edin.

Ödeme bildirimleri (ITN)

PayFast her ödemeyi, bu bölümde gösterilen URL'ye gönderilen sunucudan sunucuya bir bildirimle onaylar. Şu biçimdedir: https://your-site/wc-api/payfast_pay/. Adres her ödemeyle birlikte gönderildiği için PayFast'ta bir şey yapılandırmanız gerekmez; ancak internetten erişilebilir olmalıdır.

Kaynak kontrolü: Accept live notifications only from PayFast servers. Adresler PayFast'ın DNS kayıtlarından alınır. Sitenizin ziyaretçi adresini gizleyen bir proxy veya CDN arkasında olması durumunda bu seçeneği kapatın. İmza ve sunucu onayı her zaman kontrol edilir. Sandbox bildirimleri adrese göre kontrol edilmez. Varsayılan: açık.

Gelişmiş

Debug log: Log payment steps adımları WooCommerce > Status > Logs altına, wcp_payfast_pay kaynağıyla yazar. Hatalar her zaman kaydedilir. Parola ifadeleri ve müşteri ayrıntıları yazılmaz. Varsayılan: kapalı.

Uninstall: Delete the gateway settings and logs when the plugin is deleted. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak PayFast) ve siparişi verir. Müşteri, siparişin Pay for order sayfasına gider; bu sayfa Thank you for your order. You are being redirected to PayFast to complete the payment. mesajını gösterir ve imzalı ödeme formunu otomatik olarak PayFast'a gönderir. Tarayıcı kendi kendine devam etmezse müşteri Pay with PayFast düğmesine tıklar; Cancel order siparişi iptal eder. Form; ZAR cinsinden sipariş tutarını, Order # ve sipariş numarasını, müşterinin adını ve e-posta adresini ve sipariş anahtarını içerir. Sayfa her açıldığında yeniden oluşturulur, bu nedenle müşteri PayFast'tan döndükten sonra yeniden açabilir.

PayFast sayfasında müşteri kartla, Instant EFT ile veya PayFast hesabınızdaki başka bir yöntemle öder. Ardından PayFast, ödeme bildirimini (ITN) mağazanıza gönderir. Sipariş, bildirim tüm kontrolleri geçtiğinde ödenmiş olarak işaretlenir:

Müşterinin sipariş alındı sayfasına dönmesi siparişi değiştirmez. Bildirim gelene kadar sayfada PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. yazar. Sipariş beklemedeyse Your payment is being reviewed. We will contact you if anything else is needed. yazar.

Müşteri PayFast sayfasında iptal ederse sipariş WooCommerce'in standart yöntemiyle iptal edilir. Müşteri ödeme yapmadan ayrılırsa sipariş ödenmemiş kalır ve Pay for order sayfasından yeniden ödenebilir.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. Geçerli modun kimlik bilgileri eksikse, mağaza veya sipariş para birimi ZAR değilse ya da toplam R5.00'ın altındaysa gizlenir. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklenti yalnızca ZAR cinsinden tek seferlik ödemeleri kabul eder. WooCommerce üzerinden iade, abonelik, kayıtlı (tokenize edilmiş) kart, ön sipariş veya bölünmüş ödeme desteği yoktur.

Siparişler

Sipariş durumları

Pending payment: müşteri PayFast'a yönlendirildi ve ödeme bildirimi henüz gelmedi.

Processing: PayFast ödemeyi onayladı. Bu, ödemeden sonraki standart WooCommerce durumudur; yalnızca sanal indirilebilir ürün içeren siparişler Tamamlandı olur. Sipariş notunda, siparişin işlem kimliği de olan PayFast ödeme kimliği gösterilir. Sandbox ödemesi, gerçek para çekilmediğine dair bir not alır. PayFast ücreti ve net tutar siparişte saklanır.

On hold: PayFast ödemeyi beklemede olarak bildirdi; ya da ödenen tutar sipariş toplamından farklı ya da sipariş ZAR cinsinden değil; ya da zaten iptal edilmiş bir sipariş için ödeme geldi. Sipariş notu nedenini açıklar. Siparişi ve PayFast panelinizi kontrol edin, ardından siparişi gönderin veya ödemeyi PayFast'ta iade edin.

Failed: sipariş ödenmemişken PayFast ödemeyi başarısız olarak bildirdi. Müşteri yeniden ödeme yapabilir.

Cancelled: müşteri PayFast sayfasında iptal etti ya da siparişi siz veya WooCommerce stok bekletme zaman aşımı iptal etti.

Aynı ödeme için tekrarlanan bir bildirim hiçbir şeyi değiştirmez. Zaten ödenmiş bir sipariş için başka bir tamamlanmış ödeme gelirse, bir not sizden kopyayı PayFast'ta iade etmenizi ister. İade edilmiş bir sipariş için gelen ödeme yalnızca bir not ekler. Gateway canlı modda çalışırken alınan sandbox ödemesi bir not ekler ve siparişi ödenmiş olarak işaretlemez.

İadeler

WooCommerce üzerinden iadeler desteklenmez. Ödemeyi PayFast panelinizde iade edin, ardından WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > PayFast sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın etkin olduğu tarih 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, o alan adının yerini serbest bırakmaz. Yeri vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan PayFast müşterilere ödeme sayfasında 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 bir anahtar satın almadan önce eklentiyi kurup 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.

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

PayFast ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun Merchant ID ve Merchant Key değerlerinin dolu olduğunu, mağaza para biriminin ZAR olduğunu ve sipariş toplamının en az R5.00 olduğunu kontrol edin. Ayarlar sayfası eksik bir şey olduğunda uyarı gösterir.

Ödeme gerçekleşti ama sipariş Ödeme bekleniyor durumunda kaldı: PayFast ödeme bildirimini iletemedi ya da bildirim reddedildi. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde wcp_payfast_pay kaynağına bakın. Yaygın nedenler: sitenin internetten erişilememesi (bakım modu, temel kimlik doğrulama, güvenlik duvarı), PayFast ile eklentide farklı parola ifadeleri ya da canlı modda bir proxy veya CDN arkasındayken kaynak kontrolü. Bu durumda Source check seçeneğini kapatın.

Bildirim Invalid signature yanıtı veriyor: eklentideki parola ifadesi, bu mod için PayFast'ta ayarlananla aynı değil.

Bildirim Invalid source yanıtı veriyor: bildirim bir PayFast adresinden gelmedi ya da bir proxy veya CDN gerçek adresi gizliyor. Siteniz bir proxy veya CDN arkasındaysa Source check seçeneğini kapatın.

Bildirim Merchant mismatch veya Order mismatch yanıtı veriyor: ödeme başka bir PayFast hesabına yapılmış ya da bu siparişe ait değil. Hiçbir şey değişmez.

Bildirim Confirmation unavailable veya Busy yanıtı veriyor: sunucu onayı için PayFast'a ulaşılamadı ya da aynı siparişe ait başka bir bildirim o anda işleniyordu. PayFast bildirimi yeniden dener.

Bildirim Not configured yanıtı veriyor: siparişin ödendiği modun kimlik bilgileri eksik.

Müşteri PayFast accepts payments from R5.00 mesajını görüyor: sipariş toplamı PayFast'ın asgarisinin altında.

Sipariş On hold durumunda: PayFast siparişle eşleşmeyen bir ödemeyi onayladı (farklı tutar veya ZAR dışı bir para birimi) ya da zaten iptal edilmiş bir sipariş için ödeme geldi. Sipariş notlarını ve PayFast panelinizi kontrol edin.

Sandbox ödemesi siparişi ödemedi: gateway canlı modda. Canlı modda sandbox ödemeleri hiçbir zaman bir siparişi ödemez; siparişteki bir not bunu belirtir.

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 yeri 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman silinir. Ağ geçidi ayarları, eklentinin diğer seçenekleri, önbelleğe alınmış PayFast adresleri ve günlükleri yalnızca Delete the gateway settings and logs when the plugin is deleted açıksa silinir. Aksi halde yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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