VibeFox Pesapal for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: siparişin KES, UGX, TZS, ZMW, RWF veya USD cinsinden olması gerekir. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Sipariş kendi para biriminde tahsil edilir; uzantı para birimi dönüşümü yapmaz. Tutarlar ana birimlerde gönderilir ve para biriminin hassasiyetine göre yuvarlanır (UGX ve RWF için ondalık basamak yoktur).

Pesapal hesabı: bir Pesapal satıcı hesabının consumer key ve consumer secret bilgilerine ihtiyacınız vardır. Sandbox ve canlı anahtarlar farklıdır. Sandbox anahtarları cybqa.pesapal.com adresindeki 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 şey ayarlamanız gerekmez: uzantı bildirim URL'sini kendisi kaydeder. Pesapal ödeme bildirimlerini mağazanıza gönderdiği için mağazanıza internetten erişilebilmelidir.

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

Kurulum

İndirme dosyası, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_pesapal_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_pesapal_pay.ocmod.zip bulunur. Yalnızca OpenCart sürümünüz için olan paketi kurun. Lisans anahtarı her iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pesapal_pay-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketin 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 Payments türünü seçin. VibeFox Pesapal Pay Gateway öğesini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgeli düğme) tıklayın. VibeFox lisans anahtarınızı, sayfanın üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. Sandbox consumer key ve consumer secret bilgilerini girin, Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve bir test siparişi verin.

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

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_pesapal_pay.ocmod.zip dosyasını seçin. Dosya adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

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

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

4. Lisans anahtarını ve Pesapal anahtarlarını OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca IPN URL farklıdır (bkz. Ödeme bildirimleri).

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

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Pesapal Pay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde bir rozet modu gösterir: SANDBOX — cybqa.pesapal.com üzerinde test ödemeleri — gerçek para tahsil edilmez. veya LIVE — pay.pesapal.com üzerinde gerçek ödemeler. Geçerli modun anahtarları eksikse (Sandbox consumer key ve secret bilgisini girin — o zamana kadar Pesapal ödeme sayfasında gösterilmez. ya da canlı mod için aynı uyarı) ve Pesapal mağazanızın varsayılan para birimini desteklemiyorsa bir uyarı görünür. Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydetme sırasında boş bir Title kabul edilmez: önceki başlık bir hatayla korunur, diğer alanlar kaydedilir. Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve Geo Zone ile sipariş durumları mevcut olmalıdır; aksi halde o alan bir hatayla önceki değerini korur. Kaydetme, önbelleğe alınmış Pesapal erişim jetonlarını siler.

Pesapal

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

Title: müşterinin ödeme sayfası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, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü 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.

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

Geo Zone: Pesapal'ı 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 ayarlanır.

Total: Pesapal'ın sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet tutarı. Herhangi bir tutar için Pesapal'ı sunmak üzere boş bırakın.

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ı verir. Sandbox ve canlı anahtarları, her biri kendi alanına girin.

Sandbox mode: Use the Pesapal sandbox (no real money). Açıkken yeni ödemeler sandbox 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: sandbox (demo) satıcı hesabınızın consumer key değeri. Yalnızca sandbox modunda kullanılır.

Sandbox consumer secret: sandbox satıcı hesabınızın consumer secret değeri. Yalnızca sandbox modunda kullanılır.

Live consumer key: Pesapal satıcı panelinizden alınan consumer key değeri. Sandbox modu kapalıyken kullanılır.

Live consumer secret: Pesapal satıcı panelinizden alınan consumer secret değeri. Sandbox modu kapalıyken kullanılır.

Kaydedilmiş anahtarlar ve gizli değerler bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved consumer keys and secrets: bir anahtar kaydedildiğinde görünür. Kutuyu işaretleyin ve kayıtlı dört anahtarın ve gizli değerin tamamını kaldırmak için Save düğmesine tıklayın.

Modu veya anahtarları değiştirmek, diğer mod veya anahtarların bir 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.

Sipariş durumları

OpenCart siparişi Confirm Order adımında durum olmadan oluşturur (eksik sipariş). Sipariş, Pesapal ödemeyi «Completed» olarak bildirdikten sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Pesapal ödemeyi onayladığında ayarlanan durum. Varsayılan: Processing.

Pesapal Payment On Hold Status: tutarı veya para birimi siparişle eşleşmeyen ödemeler ile bir iptalden sonra alınan ödemeler. Bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Cancelled Order Status: bu durumdaki (veya iade edilmiş durumdaki) bir sipariş için gelen Pesapal ödemesi, siparişi sessizce yeniden açmak yerine beklemeye alır. Varsayılan: Canceled.

Refunded Status: Pesapal siparişin ödemesinin geri alındığını bildirdiğinde ayarlanır. Varsayılan: Refunded.

Ödeme bildirimleri (IPN)

IPN URL: mağazanızın bildirim URL'sini gösterir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_pesapal_pay/ipn, OpenCart 4'te https://your-store/index.php?route=extension/wcp_pesapal_pay/payment/wcp_pesapal_pay.ipn ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL, ilk ödemede Pesapal'a otomatik olarak kaydedilir; sandbox ve canlı için ayrı ayrı ve her consumer key için ayrı 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; ondan önce Geçerli mod ve anahtarlar için henüz kaydedilmedi. 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, çünkü OpenCart ödeme uzantısı isteklerine izin verir (OpenCart 4'te uzantı bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin Pesapal'dan dönüşüne de izin verir).

Gelişmiş

Debug log: Pesapal isteklerini ve bildirimlerini OpenCart günlükler klasöründeki (storage/logs) pesapal_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz; 5 MB'a ulaştığında pesapal_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar, anahtar kapalı olsa bile her zaman günlüğe yazılır. Anahtarlar, jetonlar ve müşteri verileri asla günlüğe yazılmaz. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data: uzantı kaldırıldığında uzantı ayarlarını ve günlükleri siler. Siparişlerde kaydedilen Pesapal verileri (izleme kimlikleri, notlar) ödeme geçmişinin parçasıdır ve her zaman saklanır. Uzantıyı devre dışı bırakmak hiçbir şeyi silmez. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Consumer key ve secret bilgileri 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ı consumer key ve secret bilgileri korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Pesapal (M-Pesa, Airtel Money, cards)). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle ve Payment method options penceresinde seçer, ardından ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında uzantı, sipariş para biriminde sipariş tutarı için bir Pesapal ödeme isteği oluşturur; fatura bilgilerini ödeme adresinden alır (OpenCart 4'te, ödeme sayfası ödeme adresi istemiyorsa teslimat adresinden) ve müşteriyi Pesapal ödeme sayfasına yönlendirir. Pesapal'a gönderilen ödeme açıklaması Order, sipariş 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 biriyle öder. Siparişteki bir not ödeme isteğini kaydeder.

Sipariş, yalnızca Pesapal onayladıktan sonra ödenmiş olarak işaretlenir. Pesapal bildirimleri ve müşterinin dönüşü ödeme verisi veya imza içermez, bu yüzden uzantı bunlara güvenmez: her biri için ödemenin başlatıldığı modda, kimliği doğrulanmış sunucudan sunucuya bir istekle Pesapal'dan işlemin durumunu sorar. Ayrıca işlemin bu siparişe ait olduğunu, ödenen tutarın ve para biriminin siparişle eşleştiğini kontrol eder. Sipariş ardından OpenCart'ın standart yöntemiyle durum alır; olağan sipariş e-postaları ve stok güncellemesi yapılır ve müşteri OpenCart sipariş başarı sayfasını görür.

Mobil para ödemeleri bir süre alabilir. Müşteri geri döndüğünde Pesapal ödemeyi henüz onaylamadıysa, Payment confirmation sayfasında Ödemeniz Pesapal tarafından onaylanıyor. Onaylandığında size bir e-posta gönderilecek — tekrar ödeme yapmanız gerekmez. mesajı ve Check again ile Back to checkout düğmeleri görünür. Pesapal'ın bildirimi, ödeme onaylanır onaylanmaz sipariş durumunu ayarlar. Sipariş beklemeye alındıysa başarı sayfası Ödemeniz alındı ve mağaza tarafından inceleniyor. Sipariş onaylandığında size bir e-posta gönderilecek. mesajını gösterir. Daha sonraki bir ödeme siparişi beklemeye alınan durumdan ödenmiş duruma taşıdığında müşteriye e-posta ile bildirilir.

Müşteri Pesapal sayfasında iptal ederse Pesapal ödemesi iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla ödeme sayfasına döner. Ödeme başarısız olursa mesaj Pesapal ödemesi başarılı olmadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. olur ve siparişteki bir not nedeni belirtir. Sepet korunur ve müşteri yeniden ödeme yapabilir. 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 sayfasındaki siparişi günceller; bu yüzden yeni bir ödemeden önce uzantı, sepetin önceki denemelerini Pesapal'da kontrol eder: bunlardan biri bu arada ödendiyse, o sipariş durumunu alır ve müşteri iki kez ödeme yapmadan başarı sayfasına gider. Sepetin daha eski bir Pesapal sayfasında daha sonra yapılan bir ödeme yine de kabul edilir. Sepetteki bir değişiklik, yeni miktar dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, ödeme sayfasındaki siparişi başarı sayfası gösterilene kadar saklar. Bu sipariş bu arada kapatıldıysa (örneğin siz iptal ettiyseniz) ya da daha önce önceki bir sepet için ödendiyse ve sepet o zamandan beri değiştiyse, müşteri Önceki siparişiniz zaten kapatıldı. Lütfen siparişi yeniden onaylayın: sepet yeni bir siparişle ödenecektir. mesajıyla ödeme sayfasına geri gönderilir. Bir sonraki Confirm Order yeni bir siparişi öder. Kapatılmış bir sipariş asla ödenmiş olarak gösterilmez.

Pesapal ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür; örneğin Pesapal geçici olarak kullanılamıyor. Birkaç dakika içinde tekrar deneyin veya başka bir ödeme yöntemi seçin., Pesapal şu anda kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin. (yanlış anahtarlar) ya da Pesapal ödemeyi başlatamadı: ardından Pesapal'ın verdiği neden. Teknik neden günlüğe ve sipariş notlarına yazılır. Sipariş tutarı sıfırdan büyük olmalıdır.

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

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Pesapal'a yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu veya Pesapal ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order Status After Payment (varsayılan Processing): Pesapal ödemeyi Completed olarak bildirir ve tutar ile para birimi eşleşir. Bir not tutarı, ödeme yöntemini, Pesapal onay kodunu ve izleme kimliğini gösterir. Her ödeme yalnızca bir kez uygulanır.

Pesapal Payment On Hold Status (varsayılan Pending): ödenen tutar veya para birimi siparişten farklıdır (Pesapal amount/currency mismatch — held for review notu) ya da iptal edilmiş veya iade edilmiş durumdaki bir sipariş için para gelmiştir. Ödemeyi Pesapal panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded Status (varsayılan Refunded): Pesapal, siparişi ödeyen ödemenin geri alındığını bildirir. Başka bir denemenin geri alınması yalnızca siparişte not olarak kaydedilir.

Zaten ödenmiş bir sipariş veya sepet için ikinci bir ödeme de tamamlanırsa sipariş değişmez. Ödenmiş siparişteki bir not, ikinci ödemeyi Pesapal panelinde iade etmenizi ister. İptal edilmiş ve iade edilmiş siparişler asla otomatik olarak yeniden açılmaz.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Pesapal Pay Gateway tab

Sales > Orders bölümünde Pesapal ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Pesapal Pay Gateway sekmesi; Sandbox veya Live etiketli izleme kimliğini, satıcı referansını, Pesapal durumunu, ödeme yöntemini, onay kodunu, istenen ve ödenen tutarı, bir incelemenin nedenini, siparişin tüm Payment attempts kayıtlarını (birden fazla olduğunda) ve Payment notes bilgilerini gösterir. Sekme salt okunurdur ve uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

Uzantı Pesapal'a iade göndermez. Ödemeyi Pesapal panelinde iade edin, ardından iadeyi OpenCart'ta elle kaydedin. Sales > Returns bölümündeki ürün iadeleri Pesapal üzerinden para geri göndermez.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Pesapal Pay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Pesapal Pay Gateway > Edit sayfasının ayarların üstündeki ilk bloğudur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınızı) ve 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 gösterir. Bunların altında Product: opencart-payment-pesapal satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify iznine sahip yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici 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 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 uzantı 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Pesapal müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (lisanssız — yalnızca yöneticilere görünür) işaretiyle görür; böylece bir anahtar satın almadan önce uzantıyı kurabilir ve test edebilirsiniz. OpenCart 4'te bu önizleme yoktur: mağaza yönetici girişini görmez, bu yüzden etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır ve iadeler dahil, mevcut ödemelerle ilgili Pesapal bildirimleri yine uygulanır.

Bir lisansın süresi dolduğunda uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetim paneli Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron işi gerekmez. Uzantıyı kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Pesapal ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun consumer key ve secret bilgilerinin girildiğini (sandbox 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. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: Pesapal'ın bildirimi mağazanıza ulaşmadı ve müşteri geri dönmedi. IPN URL alanı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 uzantı sayfasındaki Log alanına bakın.

Mağazanın bildirimlere nasıl yanıt verdiği: işlenen bir bildirim HTTP 200 ile yanıtlanır. Uzantı bildirimi işleyemezse hata ile yanıt verir ve Pesapal bildirimi daha sonra yeniden gönderir: 400 (izleme kimliği eksik veya hatalı), 404 (bu mağazanın hiçbir siparişi bu izleme 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ı ya da ödemenin başlatıldığı modun anahtarları eksik) ve 503 (sipariş aynı anda müşterinin dönüşü tarafından işleniyordu ya da sipariş durumu ayarlanamadı).

Müşteri «Pesapal is not available at the moment» mesajını görüyor: Pesapal, geçerli modun consumer key veya secret bilgisini reddetti. Anahtarların moda uygun olduğunu kontrol edin: sandbox anahtarları yalnızca sandbox modunda, 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ı veya bildirim URL'si kaydedilemedi. Günlüğü okuyun ve tekrar deneyin.

Müşteri «This payment method is not available. Please reload the checkout page.» mesajını görüyor: ö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ükler.

Müşteri «We could not verify the Pesapal payment» mesajını görüyor: Pesapal'dan gelen dönüş bağlantısı mağazanın hiçbir siparişiyle eşleşmedi. Tahsilat yapıldıysa ödemeyi Pesapal panelinde bulun ve müşteri yeniden ödeme yapmadan önce siparişi kontrol edin.

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

Sipariş ödemeden sonra beklemeye alınmış durumda: VibeFox Pesapal Pay Gateway sekmesindeki notları okuyun. Ödenen tutar veya para birimi siparişten 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.

Geliştiriciler için: uzantı OpenCart olaylarını tetikler: pesapal_p_supported_currencies (para birimi listesi) ve pesapal_p_submit_order_payload (Pesapal'a gönderilmeden önceki ödeme isteği).

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Pesapal Pay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Sipariş durumları bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Uzantının OpenCart olayı, önbelleğe alınmış Pesapal erişim jetonları ve kayıtlı bildirim kimlikleri de her zaman kaldırılır. OpenCart 4'te ayrıca uzantının olayları ve bakım modunda bildirimlerin ve müşterinin dönüşünün geçmesine izin veren başlangıç eylemi de kaldırılır. Delete data açıksa diğer ayarlar (başlık, açıklama, sandbox modu, anahtarlar, hata ayıklama günlüğü anahtarı) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanır. Pesapal ödeme denemeleri her zaman saklanır. Mevcut siparişler Pesapal ödeme notlarını ve izleme kimliklerini korur.

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

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