VibeFox PayFast for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: Güney Afrika randı (ZAR). PayFast yalnızca randla ödeme alır; bu nedenle sepet ZAR olmalıdır. Mağazanızda yoksa International > Localization > Currencies bölümünden para birimini ekleyin. Minimum sipariş tutarı R5,00'dir.

PayFast hesabı: PayFast panelindeki Settings > Developer Settings bölümünden alınan PayFast hesabınızın Merchant ID ve Merchant Key değerleri. Parola ifadesi (passphrase) şiddetle önerilir; PayFast'ta bir parola ifadesi ayarlanmışsa aynısı modüle girilmelidir. Testler için PayFast sandbox kimlik bilgilerine ihtiyacınız vardır.

Erişilebilir mağaza: ödeme bildirim URL'si, basic auth ya da güvenlik duvarı engeli olmadan internetten erişilebilir olmalıdır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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 bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox PayFast Pay Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Merchant ID, Merchant Key ve parola ifadesini girin. Test için Test mode seçeneğini açık bırakın 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 kabul etmek için Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting PayFast payment ve PayFast 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ünde sınırlayabilirsiniz; modülün randa izinli kaldığından emin olun.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox PayFast Pay 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; geçerli modun kimlik bilgileri boşsa (bu durumda PayFast ödeme sayfasında gizlenir), varsayılan mağaza para birimi ZAR değilse, canlı mod genel sandbox Merchant ID'si 10000100'ü kullanıyorsa ve hiçbir parola ifadesi ayarlanmamışsa sizi uyarır. Test modu açık ve modül etkinken şu mesaj gösterilir: Test modu açık: siparişler PayFast sandbox'ında ödenir, gerçek para tahsil edilmez. Boş bir Title alanı şu mesajla reddedilir: Ödeme yöntemi için bir başlık girin.

PayFast

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

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

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: canlı PayFast Merchant ID'niz.

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

Passphrase: PayFast'tan alınan tuz (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 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çıkken müşteri ödeme yönteminin altında şunu görür: TEST MODU: ödemeler PayFast sandbox'ına gider, gerçek para tahsil edilmez. 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.

Kaydedilmiş parola ifadeleri bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

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

Ödeme bildirimleri (ITN)

Notification URL: PayFast, her ödemeyi burada gösterilen URL'ye sunucudan sunucuya bir bildirimle onaylar. Dostça URL'ler etkinse şöyle görünür: https://your-shop/module/wcp_payfast_pay/itn; varsayılan dilin dil koduyla birlikte olabilir. Adres her ödemeyle birlikte gönderilir, bu yüzden PayFast'ta bir şey yapılandırmanız gerekmez; ancak internetten erişilebilir olmalıdır. Siparişler yalnızca bu doğrulanmış bildirimlerle oluşturulur; müşterinin mağazaya dönmesi sipariş oluşturmaz ve sipariş ödemez.

Source check: canlı bildirimleri yalnızca PayFast sunucularından kabul edin. Adresler PayFast'ın DNS kayıtlarından (6 saat önbelleğe alınır) ve PayFast'ın belgelenmiş adres aralıklarından gelir. 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.

Gelişmiş

Debug log: ödeme adımlarını modül klasöründeki logs/payfast_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar, anahtar kapalı olsa bile her zaman kaydedilir. Parola ifadeleri veya müşteri bilgileri 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 module is uninstalled (ayarlar, önbelleğe alınmış PayFast adresleri ve günlük). PayFast ödeme kayıtları, siparişler ve sipariş durumları her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak PayFast) seçer ve onaylar. Siparişiniz için teşekkürler. Ödemeyi tamamlamak için PayFast'a yönlendiriliyorsunuz. mesajını gösteren bir sayfa, imzalı ödeme formunu otomatik olarak PayFast'a gönderir. Tarayıcı kendiliğinden devam etmezse müşteri Pay with PayFast düğmesine tıklar; Cancel ödeme sayfasına geri döndürür. Form; ZAR cinsinden sepet toplamını, sepet numaralı Cart # alanını, müşterinin adını ve e-postasını, ödeme referansını (sepet numarası ve deneme) ve denemeye ait rastgele bir token'ı içerir. Bu aşamada henüz bir sipariş yoktur. Her yeni deneme yeni bir referans ve yeni bir token alır.

PayFast sayfasında müşteri kartla, Instant EFT ile ya da PayFast hesabınızdaki başka bir yöntemle öder. PayFast ardından ödeme bildirimini (ITN) mağazanıza gönderir. Sipariş, PayFast ödemeyi tüm kontrolleri geçen bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez:

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 ve mağazanızın ülke kısıtlaması tarafından engellenmez.

Müşteri geri döndüğünde ve sipariş mevcutsa standart sipariş onay sayfası gösterilir. PayFast ödemeyi beklemede bildirmişse şu mesaj çıkar: PayFast ödemenizi onaylıyor. Onaylandığında size bir e-posta göndereceğiz — tekrar ödeme yapmanıza gerek yok. Sipariş incelemedeyse: Ödemeniz inceleniyor. Başka bir şey gerekirse sizinle iletişime geçeceğiz. Bekleyen bir ödeme daha sonra başarısız olduysa: PayFast ödemeniz tamamlanmadı. Bu sipariş hakkında bizimle iletişime geçin. Bildirim henüz gelmediyse, PayFast'ın ödemeyi onayladığını ve PayFast onaylar onaylamaz siparişin oluşturulacağını belirten bir Payment confirmation sayfası çıkar; Check again ve Back to checkout düğmeleriyle birlikte.

Müşteri PayFast sayfasında iptal ederse ödeme sayfasına PayFast ödemesi iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla döner. PayFast ödemeyi başarısız bildirmişse mesaj Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. şeklindedir. Sepet korunur ve yeniden ödenebilir.

Ödeme yöntemi; geçerli modun kimlik bilgileri eksikse, sepet para birimi ZAR değilse ya da modül için izin verilmemişse veya toplam R5,00'in altındaysa gizlenir. Müşteri yine de ödemeye ulaşırsa kısa bir mesaj durumu açıklar, örneğin PayFast, R5,00 ve üzeri ödemeleri kabul eder. Lütfen başka bir ödeme yöntemi seçin.

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

Siparişler

Sipariş durumları

No order yet: müşteri PayFast'a yönlendirildi ve ödeme bildirimi henüz gelmedi ya da PayFast ödemeyi başarısız bildirdi. Yalnızca sepet mevcuttur.

Payment accepted: PayFast ödemeyi onayladı. Ödeme, işlem kimliği olarak PayFast ödeme kimliğiyle kaydedilir ve bir notta ödeme kimliği gösterilir. Sandbox ödemesi, gerçek para tahsil edilmediğine dair bir not alır.

Awaiting PayFast payment: PayFast ödemeyi beklemede bildirdi. PayFast ödemeyi tamamladığında sipariş Payment accepted durumuna geçer.

Payment error: bekleyen bir ödeme başarısız oldu. PayFast daha sonra tamamlarsa sipariş Payment accepted olur.

PayFast payment on hold: ödenen tutar sepet toplamından farklıdır ya da sepet ZAR değildir; iptal edilmiş bir siparişe ya da artık ödeme yöntemi PayFast olmayan bir siparişe ödeme gelmiştir; ya da gateway canlı modda iken bir sandbox ödemesi gelmiştir. PayFast'ın aldığı tutar siparişe kaydedilir (sandbox ödemesi için değil) ve not durumu açıklar. Siparişi ve PayFast panelinizi kontrol edin, ardından siparişi Payment accepted olarak ayarlayın ya da iptal edip ödemeyi PayFast'ta iade edin.

Aynı ödeme için tekrarlanan bir bildirim hiçbir şeyi değiştirmez. Geç gelen başarısız veya beklemedeki bildirimler ödenmiş bir siparişi asla 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şe gelen ödeme yalnızca bir not ekler.

PayFast ödeme bloğu

Sipariş sayfasında ödeme referansı (m_payment_id), PayFast ödeme kimliği, ortam (canlı ya da sandbox), durum, ZAR cinsinden brüt, komisyon ve net tutarlar ile modülün notlarını içeren bir PayFast payment bloğu gösterilir. İncelemede olan bir sipariş için ödemeyi kontrol etmeniz yönünde bir hatırlatma gösterilir.

İadeler

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

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayFast Pay Gateway lisans bloğu, Modules > Module Manager > VibeFox PayFast Pay Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blokta anahtar maskeli olarak, durum (örneğin lisansın geçerli olduğu tarih ve alan adınız) ile birlikte şu düğmeler görünür: 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-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 modül için Configure izni olan personel değiştirebilir. Bloktaki metinler 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 ya da 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 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 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. PrestaShop vitrini back office'e 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 bölümünde Alerts sekmesinde 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 modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

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 doldurulduğunu, sepetin ZAR cinsinden 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. Payment > Preferences bölümünde modülün randa, müşterinin ülkesine ve müşterinin grubuna izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: PayFast ödeme bildirimini iletemedi ya da bildirim reddedildi. Modül sayfasındaki Log alanına bakın; hatalar ve reddedilen bildirimler her zaman kaydedilir, Debug log ise her adımı ekler. Tipik nedenler: mağazanın internetten erişilememesi (basic auth, güvenlik duvarı), PayFast ile modülde farklı bir parola ifadesi ya da canlı modda bir proxy veya CDN arkasındaysa kaynak kontrolü. Bu durumda Source check seçeneğini kapatın.

Bildirim Invalid signature yanıtı veriyor: modüldeki parola ifadesi, ödemenin yapıldığı mod için PayFast'ta ayarlanmış olan değil.

Bildirim Invalid source yanıtı veriyor: 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.

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

Bildirim Order not found yanıtı veriyor: ödeme referansı bu mağaza için bilinmiyor. Hiçbir şey değiştirilmez.

Bildirim Confirmation unavailable, Busy veya Temporary error yanıtı veriyor: sunucu onayı için PayFast'a ulaşılamadı, aynı sepet için başka bir bildirim tam o sırada işleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışıysa). PayFast bildirimi yeniden dener. Günlük nedeni gösterir.

Bildirim Not configured yanıtı veriyor: ödemenin başlatıldığı modun kimlik bilgileri eksik. Bunları yeniden girin; örneğin bir test ödemesi için sandbox kimlik bilgileri.

Müşteri, PayFast yalnızca Güney Afrika randı (ZAR) cinsinden ödemeleri kabul eder mesajını görüyor: sepet başka bir para biriminde. Müşterinin randla ödeme yapmasını sağlayın ya da başka bir ödeme yöntemi seçmesine izin verin.

Sipariş PayFast payment on hold durumunda: PayFast payment bloğundaki notları (bkz. Sipariş durumları) ve PayFast panelinizi okuyun; ardından siparişi kabul edin ya da ödemeyi iade edin.

Bir sandbox ödemesi siparişi ödemedi: gateway canlı modda. Sandbox ödemeleri canlı modda asla bir siparişi ödemez; siparişteki bir not bunu belirtir.

Geliştiriciler için: actionPayfastPPaymentData kancası, imzalanmadan önce ödeme formu alanlarını değiştirebilir. Satıcı kimlik bilgileri, URL'ler, ödeme referansı, tutar ve token bu kanca ile değiştirilemez.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PayFast Pay 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 the gateway settings when the module is uninstalled açıksa gateway ayarları, önbelleğe alınmış PayFast adresleri ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. PayFast ödeme kayıtları, siparişler ve Awaiting PayFast payment ile PayFast payment on hold sipariş durumları her zaman korunur. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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