VibeFox PayFast for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Currency: Güney Afrika randı (ZAR). PayFast yalnızca randla ödeme alır, bu nedenle siparişin ZAR cinsinden olması gerekir. Mağazanızda yoksa para birimini System > Localisation > Currencies bölümünden ekleyin. Minimum sipariş tutarı R5.00'dir.

PayFast account: PayFast hesabınızın Merchant ID ve Merchant Key değerleri; PayFast panelindeki Settings > Developer Settings bölümünde bulunur. Parola ifadesi (passphrase) kullanmanız şiddetle önerilir; PayFast'te bir parola ifadesi tanımlıysa, aynısı eklentiye de girilmelidir. Testler için PayFast sandbox kimlik bilgilerine ihtiyacınız vardır.

Reachable store: ödeme bildirim URL'sine internetten erişilebilmeli; temel kimlik doğrulama veya güvenlik duvarı engeli olmamalıdır.

VibeFox license key: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümünün paketlerini içeren tek bir zip dosyasıdır. Bilgisayarınıza çıkartın. İçinde README.txt, OpenCart 3 paketi wcp_payfast_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_payfast_pay.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_payfast_pay-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox PayFast Pay Gateway öğesini bulun ve Install düğmesine (yeşil +) tıklayın.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli) tıklayın. VibeFox lisans anahtarınızı, sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı bölümü).

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

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test ödemesi yapın, ardından gerçek ödemeleri almak için Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_payfast_pay.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox PayFast Pay Gateway öğesini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgeli) tıklayın.

4. Lisans anahtarını ve PayFast kimlik bilgilerini girin, ödemeyi OpenCart 3 için 3 ile 5 arasındaki adımlardaki gibi test edin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Notification URL); o da her ödemeyle birlikte PayFast'e gönderilir.

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklentinin sayfasındadır: Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa; geçerli modun kimlik bilgileri boşsa (bu durumda PayFast ödeme sayfasında gizlenir), varsayılan mağaza para birimi ZAR değilse, canlı modda herkese açık sandbox Merchant ID'si 10000100 kullanılıyorsa ve hiç parola ifadesi tanımlı değilse sizi 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.

Kaydederken Title boş olamaz (128 karaktere kadar), Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Geçerli modun kimlik bilgileri olmadan ödeme yöntemini etkinleştirirseniz, ayarlar bir uyarıyla kaydedilir.

PayFast

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

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

Description: Confirm Order adımında, onay düğmesinin üstünde müşteriye gösterilen metin. Varsayılan: Pay securely by card, Instant EFT and other methods on the PayFast payment page.

Sort Order: PayFast'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: PayFast'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde tanımlanır. OpenCart 4'te, mağaza ödeme adresi istemediğinde teslimat adresi kullanılır.

Total: PayFast'in sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet tutarı. Herhangi bir tutar için PayFast sunmak üzere boş bırakın. PayFast'in kendisi her zaman en az R5.00 ister.

PayFast hesabı (canlı)

Merchant ID ve Merchant Key değerlerinizi PayFast panelinde Settings > Developer Settings altında bulabilirsiniz (ilgili bölümün bağlantıları oradadır). Orada bir parola ifadesi tanımladıysanız, burada tam olarak aynısını girin.

Merchant ID: canlı PayFast Merchant ID'niz.

Merchant Key: canlı PayFast Merchant Key'iniz. Her ödeme formuyla birlikte PayFast'e gönderilir, bu nedenle normal bir metin alanıdır.

Passphrase: PayFast'in Settings > Developer Settings bölümündeki salt parola ifadesi. Şiddetle önerilir: ödemeleri ve bildirimleri imzalar.

Sandbox (test modu)

Test modunda ödemeler PayFast sandbox'ına gider ve gerçek para tahsil edilmez. 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. Açık olduğunda müşteri Confirm Order adımında TEST MODE: payments go to the PayFast sandbox, no real money is charged. ifadesini 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 tanımlıysa.

Kaydedilmiş parola ifadeleri 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. Kayıtlı bir parola ifadesini kaldırmak için alanın altındaki Clear the saved passphrase on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme bildirimleri (ITN)

Notification URL: PayFast her ödemeyi, burada gösterilen URL'ye sunucudan sunucuya bir bildirim göndererek onaylar. Görünümü OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_payfast_pay/itn, OpenCart 4'te https://your-store/index.php?route=extension/wcp_payfast_pay/payment/wcp_payfast_pay.itn gibidir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. Adres her ödemeyle birlikte gönderilir; bu nedenle PayFast'te bir şey yapılandırmanız gerekmez, ancak internetten erişilebilir olmalıdır. Siparişler durumlarını yalnızca bu doğrulanmış bildirimlerden alır; müşterinin mağazaya geri dönmesi siparişi değiştirmez.

Source check: canlı bildirimleri yalnızca PayFast sunucularından kabul eder. Adresler PayFast'in DNS kayıtlarından (6 saat önbelleğe alınır; ayarları kaydettiğinizde önbellek sıfırlanır) ve PayFast'in belgelenmiş adres aralıklarından gelir. Yalnızca mağazanız ziyaretçi adresini gizleyen bir proxy veya CDN arkasındaysa kapatın. İmza ve sunucu onayı her zaman kontrol edilir. Sandbox bildirimleri adrese göre kontrol edilmez. Varsayılan: açık.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Yalnızca doğrulanmış bir PayFast bildirimi ile durum alır. İptal edilen, başarısız olan veya yarıda bırakılan bir ödeme siparişi durumsuz bırakır ve müşteri yeniden ödeme yapabilir. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status (paid): PayFast ödemeyi onayladıktan ve tutar ile para birimi eşleştikten sonraki durum. Varsayılan: İşleniyor.

Awaiting PayFast payment: PayFast ödemeyi beklemede olarak bildirdi (örneğin Instant EFT). PayFast ödemeyi tamamladığında ödendi durumuna geçer. Varsayılan: Beklemede.

PayFast payment on hold: incelemenizi gerektiren bir ödeme (bkz. Sipariş durumları bölümü). Böyle bir sipariş ödendi olarak işaretlenmez; bir not nedenini açıklar. Varsayılan: Beklemede, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Payment failed: beklemede olan bir ödeme başarısız oldu. PayFast bunu daha sonra tamamlarsa, sipariş ödendi durumuna geçer. Varsayılan: Başarısız.

Gelişmiş

Debug log: ödeme adımlarını OpenCart günlükleri klasöründe (storage/logs) bulunan payfast_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz; 5 MB'a ulaştığında payfast_p_debug.old.log.php adına taşınır. Hatalar ve uyarılar anahtar kapalı olsa bile her zaman kaydedilir. Parola ifadeleri, anahtarlar ve müşteri verileri yazılmaz. 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.

Uninstall: Delete the gateway settings when the extension is uninstalled (ayarlar, önbelleğe alınmış PayFast adresleri ve günlük). PayFast ödeme kayıtları ve siparişler her zaman saklanır. Varsayılan: kapalı.

İçe aktar / Dışa aktar

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Parola ifadeleri dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı parola ifadeleri korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayFast). Confirm Order adımında müşteri sizin açıklamanızı ve Thank you for your order. You will be redirected to PayFast to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, imzalanmış ödeme formunu PayFast'e gönderir. Form; ZAR cinsinden sipariş tutarını, sipariş numarası ile Order # alanını, müşterinin adını ve e-postasını, ödeme referansını (sipariş numarası ve deneme) ve denemeye ait rastgele bir token'ı içerir. Her yeni deneme yeni bir referans ve yeni bir token alır.

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ş, PayFast'in tüm kontrollerden geçen bir bildirimle ödemeyi onaylamasından sonra ödendi olarak işaretlenir:

Sipariş ardından, OpenCart'ın standart yoluyla, olağan sipariş e-postaları ve stok güncellemesiyle durum alır. Aynı sepete ait bildirimler tek tek işlenir; aynı sepetin başka bir bildirimi işleniyorsa PayFast bir hata yanıtı alır ve bildirimi yeniden gönderir. Bildirim URL'si mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerini geçirir, OpenCart 4'te ise eklenti, bildirimin ve müşterinin PayFast'ten dönüşünün geçmesini sağlayan bir başlangıç eylemi (startup action) ekler.

Müşteri geri döndüğünde ve siparişin bir durumu olduğunda OpenCart sipariş başarı sayfası gösterilir. PayFast ödemeyi beklemede olarak bildirdiyse, ayrıca PayFast is confirming your payment. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mesajı gösterilir. Sipariş incelemedeyse Your payment is being reviewed. We will contact you if anything else is needed. gösterilir. Beklemedeki bir ödeme daha sonra başarısız olduysa Your PayFast payment was not completed. Please contact us about this order. gösterilir (OpenCart 4'te müşteri bunun yerine ödeme sayfasına geri gönderilir, aşağıya bakın). Bildirim henüz ulaşmadıysa, Payment confirmation sayfası PayFast'in ödemeyi onayladığını belirtir ve Check again ile Back to checkout düğmelerini içerir.

Müşteri PayFast sayfasında iptal ederse, The PayFast payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme sayfasına geri döner. PayFast ödemeyi başarısız olarak bildirdiyse mesaj The payment was not completed. You can try again or choose another payment method. olur. Sepet korunur ve yeniden ödenebilir. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sürecinde tek bir sipariş tutar ve onu günceller, bu nedenle iptal edilen ya da başarısız olan bir ödemeden sonra müşteri aynı siparişi yeni bir denemeyle öder. Aynı sepetin başka bir siparişi PayFast tarafından zaten işlendiyse (örneğin ikinci bir tarayıcı sekmesinde), müşteri yeniden ödeme yapmak yerine başarı sayfasına yönlendirilir.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Bu sipariş ödeme yapılmadan kapatıldıysa (örneğin beklemedeki ödemesi başarısız oldu ya da siz iptal ettiniz), müşteri Your previous order was cancelled or its payment failed. Please confirm the order again. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi yeni bir sipariş öder. Bu siparişin zaten bir durumu varsa ve sepette artık başka ürünler ya da adetler varsa, mesaj şöyledir: Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again.

Ödeme yöntemi; geçerli modun kimlik bilgileri eksik olduğunda, ödeme para birimi ZAR değilken veya toplam R5.00'in altındayken gizlenir. Müşteri yine de ödemeye ulaşırsa, düğmenin üstündeki kısa bir mesaj nedenini açıklar, örneğin PayFast accepts payments from R5.00. Please choose another payment method.

Eklenti yalnızca ZAR cinsinden tek seferlik ödemeleri kabul eder. Sipariş sayfasından iade, abonelik, kayıtlı (tokenlaştırılmış) kart ve bölünmüş ödeme desteği yoktur.

Siparişler

Sipariş durumları

No status (missing order): müşteri PayFast'e yönlendirildi ve ödeme bildirimi henüz ulaşmadı ya da PayFast ödemeyi başarısız olarak bildirdi. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

OpenCart 4'te, müşteri Confirm Order adımına döndüğünde, ödeme sürecindeki ödenmemiş bir sipariş OpenCart 4 tarafından Voided durumuna alınabilir. Eklenti böyle bir siparişi durumsuz sipariş olarak ele alır ve sonraki bir ödeme yine de onu onaylar.

Order Status (paid) (default Processing): PayFast ödemeyi onayladı. Bir not PayFast ödeme kimliğini gösterir. Sandbox ödemesi, gerçek para tahsil edilmediğini belirten bir not alır.

Awaiting PayFast payment (default Pending): PayFast ödemeyi beklemede olarak bildirdi. PayFast ödemeyi tamamladığında sipariş ödendi durumuna geçer; ödeme başarısız olursa Payment failed durumuna geçer. Müşteri bu değişikliklerden e-postayla bilgilendirilir.

Payment failed (default Failed): beklemedeki bir ödeme başarısız oldu. PayFast bunu daha sonra tamamlarsa, sipariş ödendi durumuna geçer.

PayFast payment on hold (default Pending): ödenen tutar sipariş toplamından farklıdır veya sipariş ZAR cinsinden değildir; durumunu bu arada değiştirdiğiniz (örneğin iptal ettiğiniz) bir sipariş için ödeme geldi ya da ödeme yöntemi artık PayFast değil; ya da geçit canlı modda çalışırken bir sandbox ödemesi geldi. Not bunu açıklar. Siparişi ve PayFast panelinizi kontrol edin, ardından siparişi ödendi durumuna getirin ya da siparişi iptal edip ödemeyi PayFast'te iade edin.

Aynı ödemeye ait tekrarlanan bir bildirim hiçbir şeyi değiştirmez. Geç gelen başarısız veya beklemedeki ödeme bildirimleri, ödenmiş bir siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için veya zaten ödenmiş bir sepetin ikinci bir siparişi için başka bir tamamlanmış ödeme gelirse, ödenmiş siparişteki bir not, mükerrer ödemeyi PayFast'te iade etmenizi ister.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır.

VibeFox PayFast Pay Gateway sekmesi

Sales > Orders bölümünde PayFast ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox PayFast Pay Gateway sekmesi; Payment reference (m_payment_id), PayFast payment ID, Environment (canlı veya sandbox), istenen tutarı, durumu, ZAR cinsinden brüt, komisyon ve net tutarları ile PayFast notes alanlarını gösterir. İncelemede olan bir sipariş için ödemeyi gözden geçirme hatırlatması gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sipariş sayfasından yapılan iadeler desteklenmez. Ödemeyi PayFast panelinizden iade edin, ardından siparişi OpenCart'ta elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayFast Pay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox PayFast Pay Gateway > Edit 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) ile birlikte gösterir; ayrıca 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 düğmelerini içerir. Altında Product: opencart-payment-payfast satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini takip eder (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihiyle birlikte License expired on. Mağaza adresini değiştirdikten 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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan PayFast, ö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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. Mevcut siparişler etkilenmez: 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, yönetim Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

PayFast does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun Merchant ID ve Merchant Key değerlerinin doldurulduğunu, ödeme 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. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda tanımlı Total değerine ulaştığını kontrol edin.

The payment went through, but the order stays without a status: PayFast ödeme bildirimini teslim edemedi ya da bildirim reddedildi. Eklenti sayfasındaki Log alanına bakın; hatalar ve reddedilen bildirimler her zaman kaydedilir ve Debug log her adımı ekler. Tipik nedenler: mağazanın internetten erişilemez olması (temel kimlik doğrulama, güvenlik duvarı), PayFast ile eklentide farklı bir parola ifadesi veya canlı modda bir proxy ya da CDN arkasında kaynak kontrolü. Bu durumda Source check seçeneğini kapatın.

The notification answers Invalid signature: eklentideki parola ifadesi, ödemenin yapıldığı mod için PayFast'te tanımlanmış olanla aynı değil.

The notification answers Invalid source: bildirim bir PayFast adresinden gelmedi ya da bir proxy veya CDN gerçek adresi gizliyor. Mağazanız bir proxy veya CDN arkasındaysa Source check seçeneğini kapatın.

The notification answers Merchant mismatch or Order mismatch: ödeme başka bir PayFast hesabına yapılmış ya da bu ödeme denemesine ait değil. Hiçbir şey değişmez.

The notification answers Order not found: ödeme referansı bu mağaza tarafından bilinmiyor. Hiçbir şey değişmez.

The notification answers Confirmation unavailable, Busy or Temporary error: sunucu onayı için PayFast'e ulaşılamadı, aynı sepete ait başka bir bildirim tam o anda işleniyordu ya da sipariş durumu ayarlanamadı. PayFast bildirimi yeniden dener. Günlük nedeni gösterir.

The notification answers Not configured: ödemenin başlatıldığı modun kimlik bilgileri eksik. Bunları yeniden girin, örneğin bir test ödemesi için sandbox kimlik bilgileri.

The customer sees PayFast accepts payments in South African rand (ZAR) only: sipariş başka bir para biriminde. Müşterinin randla ödeme yapmasını sağlayın ya da başka bir ödeme yöntemi seçmesini isteyin.

The customer sees This payment method is not available. Please reload the checkout page. Ödeme oturumu artık siparişle eşleşmiyor ya da ödeme yöntemi bu arada kapatıldı. Müşteri ödeme sayfasını yeniden yüklemelidir.

Order is in the on-hold status: VibeFox PayFast Pay Gateway sekmesindeki notları (bkz. Sipariş durumları bölümü) ve PayFast panelinizi okuyun, ardından ödendi durumunu ayarlayın ya da ödemeyi iade edin.

A sandbox payment did not pay the order: geçit canlı modda. Sandbox ödemeleri canlı modda hiçbir zaman bir siparişi ödemez; siparişteki bir not bunu belirtir.

Geliştiriciler için: ödeme formu imzalanmadan önce eklenti, form alanları ve sipariş ile birlikte OpenCart olayı payfast_p_payment_data'yı tetikler. Satıcı kimlik bilgileri, URL'ler, ödeme referansı, tutar ve token bu olayla değiştirilemez.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox PayFast Pay Gateway yanındaki Uninstall düğmesine (kırmızı −) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ise olayları ile bakım modunda bildirimin ve müşterinin PayFast'ten dönüşünün geçmesini sağlayan başlangıç eylemi (startup action) da kaldırılır). Delete the gateway settings when the extension is uninstalled açıksa, diğer ağ geçidi ayarları (başlık, açıklama, kimlik bilgileri, parola ifadeleri, test modu, kaynak kontrolü, günlükleme), önbelleğe alınmış PayFast adresleri ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. PayFast ödeme kayıtları ve siparişler her zaman korunur. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te, eklentinin dosyalarını da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox PayFast Pay Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu simgeli) tıklayın.

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