VibeFox Pesapal for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmaz.

Para birimi: Sepet KES, UGX, TZS, ZMW, RWF veya USD olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme adımında gösterilmez. Sepet kendi para biriminde tahsil edilir; modül para birimi dönüştürmez. Tutarlar ana birim cinsinden gönderilir ve para biriminin hassasiyetine yuvarlanır (UGX ve RWF’de ondalık basamak yoktur).

Pesapal hesabı: Bir Pesapal satıcı hesabının tüketici anahtarına ve gizli anahtarına ihtiyacınız vardır. Test ve canlı anahtarlar farklıdır. Test anahtarları cybqa.pesapal.com üzerindeki bir demo satıcı hesabından alınır (Pesapal, geliştirici portalında demo anahtarları da yayımlar). Canlı anahtarlar Pesapal satıcı panelinizden alınır. Pesapal panelinde başka bir ayar yapmanız gerekmez: modül bildirim URL’sini kendisi kaydeder. Pesapal ödeme bildirimlerini mağazanıza gönderdiği için mağazanızın 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. 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 Pesapal Pay Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Test tüketici anahtarını ve gizli anahtarını girin, Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi verin.

5. Canlı tüketici anahtarını ve gizli anahtarını girin, Sandbox mode seçeneğini kapatın ve gerçek ödemeleri kabul etmek için Save düğmesine tıklayın.

Kurulum sırasında modül Pesapal payment on hold sipariş durumunu oluşturur. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeleri ve müşteri gruplarında etkinleştirir. Bunu Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Pesapal 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 bir rozet modu gösterir: SANDBOX — Test payments on cybqa.pesapal.com — no real money is charged. veya LIVE — Real payments on pay.pesapal.com. Geçerli modun anahtarları eksik olduğunda (Enter the sandbox consumer key and secret — until then Pesapal is not shown at checkout. veya canlı mod için aynısı) ve Pesapal mağazanızın varsayılan para birimini desteklemediğinde bir uyarı görünür.

Pesapal

Enable/Disable: Enable Pesapal ö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: Pesapal (M-Pesa, Airtel Money, cards). Zorunlu: Boş bir başlık kaydedilmez, önceki başlık korunur.

Description: Ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with M-Pesa, Airtel Money, card or bank via Pesapal. You will be redirected to Pesapal to complete the payment.

API kimlik bilgileri

Bu bölüm anahtarların nereden alınacağını açıklar ve cybqa.pesapal.com ile pesapal.com adreslerine bağlantılar içerir. Test ve canlı anahtarlarını her biri kendi alanına girin.

Sandbox mode: Use the Pesapal sandbox (no real money). Açıkken yeni ödemeler test anahtarlarıyla cybqa.pesapal.com üzerinden yapılır. Gerçek ödemeleri canlı anahtarlarla pay.pesapal.com üzerinden kabul etmek için kapatın. Varsayılan: açık.

Sandbox consumer key: Test (demo) satıcı hesabınızın tüketici anahtarı. Yalnızca sandbox modunda kullanılır.

Sandbox consumer secret: Test satıcı hesabınızın gizli anahtarı. Yalnızca sandbox modunda kullanılır.

Live consumer key: Pesapal satıcı panelinizdeki tüketici anahtarı. Sandbox modu kapalıyken kullanılır.

Live consumer secret: Pesapal satıcı panelinizdeki gizli anahtar. Sandbox modu kapalıyken kullanılır.

Kaydedilmiş anahtarlar ve gizli anahtarlar bir daha 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.

Clear saved consumer keys and secrets: Kutucuğu işaretleyin ve kaydedilmiş dört anahtarın tamamını silmek için Save düğmesine tıklayın.

Ayarları kaydetmek, önbelleğe alınmış Pesapal erişim jetonlarını geçersiz kılar. Modu veya anahtarları değiştirmek, diğer modun veya diğer anahtarların erişim jetonunu ya da bildirim kimliğini asla yeniden kullanmaz. Bir modda başlatılan ödeme, mod değiştirilse bile her zaman o modda kontrol edilir.

Ödeme bildirimleri (IPN)

IPN URL: Mağazanızın bildirim URL’sini gösterir. Dostu URL’ler ile şöyle görünür: https://your-shop/module/wcp_pesapal_pay/webhook; başında /en/ gibi bir dil kodu da olabilir. URL, ilk ödemede test ve canlı için ve her anahtar çifti için ayrı ayrı Pesapal’a otomatik olarak kaydedilir; bu yüzden yapılandırılacak bir şey yoktur. İlk ödemeden sonra bölüm, Pesapal’ın döndürdüğü kimlikle birlikte Registered IPN ID: gösterir; öncesinde Not registered yet for the current mode and keys. yazar. URL internetten erişilebilir olmalıdır: önünde güvenlik duvarı veya parola koruması olmamalıdır. Mağaza bakım modundayken de çalışmaya devam eder ve mağazanızın ülke kısıtlamasından etkilenmez.

Gelişmiş

Debug log: Log Pesapal requests and notifications. Ayrıntıları modül klasöründeki logs/pesapal_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar anahtar kapalı olsa bile her zaman kaydedilir. Anahtarlar, jetonlar 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: Delete the module settings and logs when the module is uninstalled. Siparişlerde kaydedilmiş Pesapal verileri (takip kimlikleri, notlar) ödeme geçmişinin parçasıdır ve her zaman saklanır. Modülü devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Pesapal (M-Pesa, Airtel Money, cards)) ve açıklamasını görür. Onaylandıktan sonra modül, fatura adresinin fatura bilgileriyle birlikte sepet toplamı için sepet para biriminde bir Pesapal ödeme isteği oluşturur ve müşteriyi Pesapal ödeme sayfasına gönderir. Pesapal’a gönderilen ödeme açıklaması Cart, sepet numarası ve mağaza adıdır. Müşteri orada M-Pesa, Airtel Money, MTN, kart veya banka gibi Pesapal’ın sunduğu yöntemlerden birini kullanarak öder. Bu noktada henüz bir sipariş yoktur.

Sipariş, ancak Pesapal ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir. Pesapal bildirimleri ve müşterinin geri dönüşü ödeme verisi ve imza içermez; bu nedenle modül bunlara güvenmez: her biri için, ödemenin başlatıldığı modda, kimliği doğrulanmış bir sunucular arası istekle Pesapal’dan işlem durumunu sorgular. Ayrıca işlemin bu sepete ait olduğunu ve ödenen tutar ile para biriminin sepetle eşleştiğini kontrol eder. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür.

Mobil para ödemeleri bir süre alabilir. Müşteri geri döndüğünde Pesapal ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası Your payment is being confirmed by Pesapal. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir. Pesapal’dan gelen bildirim, ödeme onaylanır onaylanmaz siparişi oluşturur. Sipariş beklemeye alınmışsa onay sayfası Your payment was received and is being reviewed by the shop. You will receive an e-mail once the order is confirmed. mesajını gösterir.

Müşteri Pesapal sayfasında iptal ederse, The Pesapal payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme adımına döner. Ödeme başarısız olursa mesaj The Pesapal payment was not successful. Please try again or choose another payment method. olur. Sepet korunur ve müşteri yeniden ödeme yapabilir. Sepetin her ödeme denemesi hatırlandığı için, sepetin daha eski bir Pesapal sayfasında daha sonra yapılan ödeme de kabul edilir.

Pesapal ödemeyi başlatamazsa müşteri ödeme adımında kısa bir mesajla kalır; örneğin Pesapal is temporarily unavailable. Please try again in a few minutes or choose another payment method., Pesapal is not available at the moment. Please choose another payment method. (yanlış anahtarlar) veya Pesapal could not start the payment: ve ardından Pesapal’ın verdiği neden. Teknik neden günlüğe yazılır. Sipariş toplamı sıfırdan büyük olmalıdır.

Modülde kendi sitenizde ödeme formu yoktur (müşteri her zaman Pesapal sayfasında öder), kayıtlı kart, abonelik veya yinelenen ödeme ve para birimi dönüştürme yoktur.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: Müşteri Pesapal’a yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu ya da Pesapal henüz ödemeyi onaylamadı. Yalnızca sepet vardır.

Payment accepted: Pesapal ödemeyi tamamlandı olarak bildirir ve tutar ile para birimi eşleşir. Ödeme, Pesapal takip kimliği işlem kimliği olarak kaydedilir; bir not tutarı, ödeme yöntemini, Pesapal onay kodunu ve takip kimliğini gösterir. Her ödeme yalnızca bir kez uygulanır.

Pesapal payment on hold: Ödenen tutar veya para birimi sepetten farklıdır (Pesapal amount/currency mismatch — held for review notu) ya da iptal edilmiş bir sipariş için para gelmiştir. Sipariş para birimindeyse, gerçekte ödenen tutar siparişe kaydedilir. Ödemeyi Pesapal panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded: Pesapal, siparişi ödeyen ödemenin geri alındığını bildirir. Başka bir denemenin geri alınması yalnızca siparişe not edilir.

Zaten ödenmiş bir sepetin ikinci ödeme denemesi de tamamlanırsa sipariş değişmez. Bir not, ikinci ödemeyi Pesapal panelinde iade etmenizi ister. İptal edilmiş ve iade edilmiş siparişler otomatik olarak yeniden açılmaz.

Pesapal ödeme bloğu

Sipariş sayfasında, Sandbox veya Live rozetiyle birlikte bir Pesapal payment bloğu görünür; bu blokta takip kimliği, satıcı referansı, Pesapal durumu, ödeme yöntemi, onay kodu, istenen ve ödenen tutar, inceleme nedeni, sepetin tüm Payment attempts kayıtları ve siparişin Payment notes notları yer alır. Blok salt okunurdur.

İadeler

Modül Pesapal’a iade göndermez. Ödemeyi Pesapal panelinde iade edin, ardından iadeyi PrestaShop’ta elle kaydedin.

Lisans anahtarı

Modül, vibefox.net’ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Pesapal Pay Gateway başlığıyla, Modules > Module Manager > VibeFox Pesapal 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 blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın hangi tarihe kadar etkin olduğunu ve alan adınızı) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-pesapal 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 çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 License expired on ile birlikte bir tarih. 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 Pesapal, ö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 vitrini yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında deneyemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve mevcut ödemelerle ilgili Pesapal bildirimleri, geri almalar dahil, uygulanmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Pesapal ödeme adımında görünmüyor: Lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun tüketici anahtarının ve gizli anahtarının girildiğini (sandbox modunda Sandbox consumer key ve Sandbox consumer secret, canlı modda Live consumer key ve Live consumer secret) ve sepet para biriminin KES, UGX, TZS, ZMW, RWF veya USD olduğunu kontrol edin. Ayarların üstündeki uyarılar sorunu belirtir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin. Geliştiriciler, actionPesapalSupportedCurrencies hook’u ile para birimi listesini değiştirebilir.

Ödeme geçti ama sipariş oluşturulmadı: Pesapal’dan gelen bildirim mağazanıza ulaşmadı ve müşteri geri dönmedi. IPN URL altında gösterilen URL’nin internetten erişilebilir olduğunu kontrol edin (önünde güvenlik duvarı veya parola koruması olmamalıdır). Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Mağaza bildirimlere nasıl yanıt verir: İşlenen bir bildirim HTTP 200 ile yanıtlanır. Modül bildirimi işleyemezse hata ile yanıtlar ve Pesapal bildirimi daha sonra yeniden gönderir: 400 (takip kimliği eksik veya hatalı), 404 (bu mağazanın hiçbir sepeti bu takip kimliğine sahip değil), 409 (işlem başka bir satıcı referansına ait; hiçbir şey değiştirilmez), 502 (o anda Pesapal API’sine ulaşılamadı veya ödemenin başlatıldığı modun anahtarları eksik) ve 503 (sepet tam o sırada müşterinin geri dönüşüyle güncelleniyordu ya da sipariş oluşturulamadı, örneğin modül devre dışı olduğu için).

Müşteri Pesapal is not available at the moment mesajını görüyor: Pesapal, geçerli modun tüketici anahtarını veya gizli anahtarını reddetti. Anahtarların modla eşleştiğini kontrol edin: test anahtarları yalnızca sandbox’ta, canlı anahtarlar yalnızca canlı modda çalışır. Günlükte Pesapal hatası görünür.

Müşteri Pesapal is temporarily unavailable mesajını görüyor: Pesapal’a ulaşılamadı ya da bildirim URL’si kaydedilemedi. Günlüğü okuyun ve yeniden deneyin.

Mod değiştirildikten sonra eski moddaki ödemeler onaylanmıyor: Bir ödeme, başlatıldığı modun anahtarlarıyla kontrol edilir. O modun ödemeleri onaylanana kadar o modun anahtarlarını girili tutun.

Ödemeden sonra sipariş Pesapal payment on hold durumunda: Pesapal payment bloğundaki notları okuyun. Ödenen tutar veya para birimi sepetten farklıydı ya da ödeme sipariş iptal edildikten sonra geldi. Ödemeyi Pesapal panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Pesapal 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 silinir. Önbelleğe alınmış Pesapal erişim jetonları ve kayıtlı bildirim kimlikleri her zaman silinir. Delete data açıksa modül ayarları ve günlük de silinir. Kapalıysa, sonraki bir yeniden kurulum için tüm ayarlar korunur. Pesapal ödeme denemeleri ve Pesapal payment on hold sipariş durumu her zaman korunur. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve Pesapal takip kimliklerini saklamaya devam eder.

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