VibeFox Pesapal for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti onsuz etkinleştirilemez.

PHP: 8.0 veya üzeri.

Currency: sipariş KES, UGX, TZS, ZMW, RWF veya USD cinsinden olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Sipariş kendi para biriminde tahsil edilir; eklenti para birimi dönüştürmez. Tutarlar ana para biriminde, para biriminin hassasiyetine yuvarlanarak gönderilir (UGX ve RWF ondalıksız).

Pesapal account: bir Pesapal satıcı hesabının tüketici anahtarı ve gizli anahtarı gerekir. 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 da demo anahtarlar yayımlar). Canlı anahtarlar Pesapal satıcı panelinizden alınır. Pesapal panelinde başka bir ayar gerekmez: eklenti bildirim URL’sini kendisi kaydeder. Pesapal ödeme bildirimlerini sitenize gönderdiği için siteniz internetten erişilebilir olmalıdır.

VibeFox license key: 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 yoluna gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_pesapal_pay klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Pesapal > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Test tüketici anahtarını ve gizli anahtarını girin, Enable/Disable seçeneğini açın, kaydedin ve bir test siparişi verin.

6. Canlı tüketici anahtarını ve gizli anahtarını girin, Sandbox mode işaretini kaldırın ve gerçek ödeme kabul etmek için kaydedin.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > Pesapal. Alanların üzerindeki bir rozet modu gösterir: Test payments on cybqa.pesapal.com — no real money is charged. ile SANDBOX veya Real payments on pay.pesapal.com. ile LIVE 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ı uyarı) ve Pesapal mağazanızın para birimini desteklemediğinde uyarı görünür. Test ortamı açıkken ödeme yöntemleri listesinde Pesapal test modu olarak işaretlenir.

Ödeme bildirimleri (IPN)

Bu blok mağazanızın bildirim URL’sini gösterir. https://your-site/wc-api/pesapal_pay/ biçimindedir. URL, ilk ödemede test ve canlı ortamlar ve her anahtar çifti için ayrı ayrı otomatik olarak Pesapal’a kaydedilir; yapılandırmanız gereken bir şey yoktur. İlk ödemeden sonra blok, 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 bakım modu, güvenlik duvarı veya parola koruması olmamalıdır.

Ödeme

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Pesapal (M-Pesa, Airtel Money, cards).

Description: ödeme sayfası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 bağlantılarını içerir. Test ve canlı anahtarlarını kendi alanlarına girin. Tüm anahtar alanları parola alanıdır.

Sandbox mode: Use the Pesapal sandbox (no real money). Açıkken yeni ödemeler test anahtarlarıyla cybqa.pesapal.com kullanır. Canlı anahtarlarıyla pay.pesapal.com üzerinde gerçek ödeme kabul etmek için işaretini kaldırın. Varsayılan: açık.

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

Sandbox consumer secret: test satıcı hesabınızın tüketici gizli anahtarı. Yalnızca test modunda kullanılır.

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

Live consumer secret: Pesapal satıcı panelinizdeki tüketici gizli anahtarı. Test modu kapalıyken kullanılır.

Modu değiştirmek veya anahtarları değiştirmek, diğer moda veya anahtarlara ait erişim jetonunu ya da bildirim kimliğini asla yeniden kullanmaz. Bir modda başlatılan ödeme, mod değiştirildikten sonra bile daima o modda kontrol edilir.

Gelişmiş

Debug log: Log Pesapal requests and notifications, ayrıntıları WooCommerce > Status > Logs içine, wcp_pesapal_pay kaynağıyla yazar. Hatalar ve uyarılar her zaman günlüğe kaydedilir. Anahtarlar, jetonlar ve müşteri verileri asla kaydedilmez. Varsayılan: kapalı.

Delete data: Delete the plugin settings and logs when the plugin is deleted. Siparişlere kaydedilen Pesapal verileri (takip kimlikleri, notlar) ödeme geçmişidir ve her zaman korunur. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Pesapal (M-Pesa, Airtel Money, cards)) ve siparişi verir. Test modunda Ödeme bloğu Sandbox mode: no real money will be charged. gösterir. Eklenti, siparişin fatura bilgileriyle, sipariş para biriminde sipariş toplamı için bir Pesapal ödeme isteği oluşturur ve mod, tutar ve Pesapal takip kimliğini içeren bir sipariş notu ekler. Müşteri Pesapal ödeme sayfasına yönlendirilir ve M-Pesa, Airtel Money, MTN, kart veya banka gibi Pesapal’ın sunduğu yöntemlerden biriyle öder.

Sipariş yalnızca Pesapal onayladıktan sonra ödenmiş olarak işaretlenir. Pesapal bildirimleri ve müşterinin geri dönüşü ödeme verisi veya imza içermez; bu nedenle eklenti 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 siparişe ait olduğunu ve ödenen tutar ile para biriminin siparişle eşleştiğini kontrol eder.

Ödemeden sonra müşteri sipariş alındı sayfasına döner. Mobil para ödemeleri biraz zaman alabilir. Ödeme henüz onaylanmadıysa sayfa 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. gösterir. Pesapal bildirimi siparişi daha sonra tamamlar. Sipariş beklemeye alındıysa sayfa Your payment was received and is being reviewed by the shop. You will receive an e-mail once the order is confirmed. gösterir.

Müşteri Pesapal sayfasında iptal ederse Pay for order sayfasına The Pesapal payment was cancelled. You can try again or choose another payment method. mesajıyla döner. Ödeme başarısızsa mesaj The Pesapal payment was not successful. Please try again or choose another payment method. olur. Müşteri aynı siparişi yeniden ödeyebilir. Siparişin her ödeme denemesi hatırlanır; böylece siparişin eski bir Pesapal sayfasında daha sonra yapılan ödeme de kabul edilir.

Pesapal ödemeyi başlatamazsa müşteri kısa bir mesaj görü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 bildirdiği neden. Teknik ayrıntılar sipariş notlarına ve günlüğe yazılır. Sipariş toplamı sıfırdan büyük olmalıdır.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Eklentide ödeme sayfasının kendisinde ödeme formu (müşteri her zaman Pesapal sayfasında öder), kayıtlı kart, abonelik veya yinelenen ödeme ya da para birimi dönüştürme yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Pesapal’a yönlendirilmiştir ve henüz ödeme yapmamıştır ya da Pesapal ödemeyi henüz onaylamamıştır.

Processing: Pesapal ödemenin tamamlandığını bildirir; tutar ve para birimi eşleşir. Sipariş notu tutarı, ödeme yöntemini, Pesapal onay kodunu ve takip kimliğini gösterir. Siparişin işlem kimliği Pesapal takip kimliğidir. Her ödeme bir kez uygulanır.

On hold: ödenen tutar veya para birimi siparişten farklıdır (not: Pesapal amount/currency mismatch — held for review) ya da ödeme yapılmadan önce iptal edilmiş bir sipariş için para gelmiştir. Ödemeyi Pesapal panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Failed: Pesapal son ödeme denemesinin başarısız olduğunu bildirir. Not, Pesapal’ın bildirdiği nedeni içerir. Müşteri Pay for order sayfasından yeniden dener ve bu deneme de başarısız olursa nedeni içeren başka bir not eklenir. Eski bir denemenin başarısız olması siparişi değiştirmez. Müşteri yeniden ödeme yapabilir.

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 siparişin ikinci ödeme denemesi de tamamlanırsa sipariş değiştirilmez. Bir not, ikinci ödemeyi Pesapal panelinden iade etmenizi ister. İptal edilmiş ve iade edilmiş siparişler hiçbir zaman otomatik olarak yeniden açılmaz.

İadeler

Eklenti Pesapal’a iade göndermez. Ödemeyi Pesapal panelinden iade edin, ardından iadeyi WooCommerce’e elle kaydedin.

Lisans anahtarı

Eklenti vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Pesapal sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu, örneğin lisansın geçerli olduğu son tarihi ve alan adınızı gösterir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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ı siteden kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin anahtar olmadan Pesapal ö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. görür. Oturum açmış mağaza yöneticileri, (unlicensed — visible to admins only) işaretli ödeme yöntemini görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında hatırlatma görünür. Mevcut siparişler etkilenmez: başlamış ödemeler Pesapal bildirimi ve müşterinin geri dönüşüyle onaylanmaya devam eder.

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

Pesapal ödeme sayfasında görünmüyor: lisansın etkin, Enable/Disable seçeneğinin açık, geçerli modun tüketici anahtarı ve gizli anahtarının girilmiş (test modunda Sandbox consumer key ve Sandbox consumer secret, canlı modda Live consumer key ve Live consumer secret) ve sipariş para biriminin KES, UGX, TZS, ZMW, RWF veya USD olduğunu kontrol edin. Ayarların üstündeki uyarılar sorunu belirtir. Geliştiriciler pesapal_p_supported_currencies filtresiyle para birimi listesini değiştirebilir.

Ödeme yapıldı, ancak sipariş Ödeme bekleniyor durumunda kaldı: Pesapal bildirimi mağazanıza ulaşmamış ve müşteri geri dönmemiştir. Payment notifications (IPN) içinde gösterilen URL’nin internetten erişilebilir olduğunu kontrol edin (/wc-api/pesapal_pay/ önünde bakım modu, güvenlik duvarı veya parola koruması olmamalıdır). WooCommerce > Status > Logs, kaynak wcp_pesapal_pay bölümüne bakın.

Mağaza bildirimlere nasıl yanıt verir: işlenen bildirim HTTP 200 ile yanıtlanır. Eklenti bildirimi işleyemediğinde hata yanıtı verir ve Pesapal bildirimi daha sonra yeniden gönderir: 400 (takip kimliği eksik veya hatalı biçimde), 404 (bu mağazadaki hiçbir siparişte bu takip kimliği yok), 409 (işlem başka bir satıcı referansına ait; sipariş değiştirilmez), 502 (o anda Pesapal API’ye ulaşılamadı) ve 503 (sipariş aynı anda müşterinin geri dönüşü tarafından güncelleniyordu).

Müşteri Pesapal is not available at the moment görüyor: Pesapal geçerli modun tüketici anahtarını veya gizli anahtarını reddetmiştir. Anahtarların moda ait olduğunu kontrol edin: test anahtarları yalnızca test ortamında, canlı anahtarlar yalnızca canlı modda çalışır. Sipariş notu Pesapal hatasını gösterir.

Müşteri Pesapal is temporarily unavailable görüyor: Pesapal’a ulaşılamamış veya bildirim URL’si kaydedilememiştir. Sipariş notunu ve günlüğü okuyun ve yeniden deneyin.

Sipariş ödemeden sonra Beklemede durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıdır ya da ödeme sipariş iptal edildikten sonra gelmiştir. Ödemeyi Pesapal panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Lisans bloğu hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızda bir yuva boşaltın ve Check now düğmesine tıklayın. Site adresi değiştiyse anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti bilinen son durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınan Pesapal erişim jetonları ve kayıtlı bildirim kimlikleri her zaman kaldırılır. Eklenti ayarları ve günlükleri (döndürülmüş olanlar dahil günlük dosyaları ve wcp_pesapal_pay kaynağının veritabanı günlük kayıtları) yalnızca Delete data açık olduğunda kaldırılır. Aksi halde daha sonra yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve Pesapal takip kimliklerini korur.

Pesapal ilgili sahibinin ticari markasıdır. Bu eklentinin Pesapal ile bağlantısı yoktur ve Pesapal tarafından onaylanmamıştır.