VibeFox Paystack 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.

Para birimi: siparişin, Paystack'in kabul ettiği bir para biriminde olması gerekir: NGN, USD, GHS, ZAR, KES, XOF, EGP veya RWF; hangilerinin Paystack hesabınızda etkin olduğuna bağlı olarak. Diğer para birimlerinde ödeme yöntemi gizlenir. XOF ve RWF'de Paystack yalnızca tam tutarları kabul eder.

Paystack hesabı: Paystack hesabınızın gizli anahtarlarına ihtiyacınız vardır: test gizli anahtarı (sk_test_...) ve/veya canlı gizli anahtar (sk_live_...). Ödeme Paystack'in barındırdığı sayfada yapıldığı için genel anahtarlar (pk_...) gerekli değildir. Paystack panelinde mağazanızın webhook URL'sini de ayarlarsınız (bkz. Yapılandırma). Webhook'ları alabilmek için mağazanızın internetten erişilebilir olması gerekir.

VibeFox lisans anahtarı: 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ü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_paystack_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_paystack_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun 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_paystack_payment-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ün yenilenmesi 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 türü Payments olarak seçin. VibeFox Paystack Payment uzantısını bulun ve Install düğmesine tıklayın (yeşil + düğmesi). 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 simgesi) 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ı).

4. Paystack panelinden gizli anahtarlarınızı yapıştırın ve webhook URL'sini Paystack panelinde ayarlayın (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Gerçek ödemeleri kabul etmeye başlamadan önce bir test ödemesi yapana kadar Test Mode seçeneğini açık bırakın, sonra kapatın.

OpenCart 4

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

2. Paket, aynı sayfadaki yüklü 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 türü Payments olarak seçin. VibeFox Paystack Payment uzantısını bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Paystack anahtarlarını ve webhook'u 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 webhook URL'si farklıdır (bkz. Webhook).

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

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Paystack Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstündeki bir durum kutusu modu gösterir: Test modu: gerçek para tahsil edilmez. veya Canlı mod: gerçek ödemeler kabul edilir. Ayrıca mevcut modun gizli anahtarı boşsa, bir gizli anahtar alanına genel anahtar (pk_...) girildiyse, canlı modda test anahtarı (sk_test_...) ya da test modunda canlı anahtar (sk_live_...) varsa ve Paystack mağazanızın varsayılan para birimini kabul etmiyorsa uyarır. Bir anahtar sorunu olduğu sürece ödeme yöntemi ödeme sayfasında gizlenir. Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve geo zone ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Anahtar sorunları kaydetmeyi engellemez: durum kutusu bunları belirtir.

Paystack

Bölüm kısa bir notla başlar: Paystack'in barındırdığı ödeme sayfasında kartlar, banka havalesi, USSD ve mobil para; her ödemenin Paystack API'si üzerinden sunucuda doğrulanması ve kabul edilen para birimleri.

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Paystack. Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında, onay düğmesinin üstünde müşteriye gösterilen metin. Varsayılan: Pay securely using your debit card, credit card, or bank account via Paystack.

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

Geo Zone: Paystack'i yalnızca seçilen geo zone içindeki ödeme adresleri için sunun. Varsayılan: All zones. Geo zone'lar System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Paystack sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Paystack'i her tutar için sunmak üzere boş bırakın.

API anahtarları

Gizli anahtarları Paystack panelinden, Settings > API Keys & Webhooks sayfasından kopyalayın. Bölüm bu sayfaya bağlantı içerir.

Test Mode: yeni ödemeler için test gizli anahtarını kullanır ve gerçek para tahsil edilmez. Gerçek ödemeleri canlı gizli anahtarla kabul etmek için kapatın. Diğer modda yapılan ödemeler, doğrulama ve iadeler için kendi modunun anahtarını kullanmaya devam eder. Varsayılan: açık. Açıkken müşteriler Confirm Order adımında TEST MODU ETKİN. Gerçek tahsilat yapılmayacaktır. mesajını görür.

Test Secret Key: Paystack test gizli anahtarınız. sk_test_ ile başlar.

Live Secret Key: Paystack canlı gizli anahtarınız. sk_live_ ile başlar.

Kaydedilmiş anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook

Webhook, müşteri mağazaya geri dönmese bile mağazanıza bir ödemenin yapıldığını bildirir. Paystack panelinde, Settings > API Keys & Webhooks sayfasında, bu bölümdeki Webhook URL alanında gösterilen URL'yi hem Test Webhook URL hem de Live Webhook URL olarak ayarlayın. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_paystack_payment/webhook, OpenCart 4'te https://your-store/index.php?route=extension/wcp_paystack_payment/payment/wcp_paystack_payment.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. URL'yi ayarların gösterdiği gibi birebir kopyalayın.

Paystack her webhook'u gizli anahtarınızla imzalar, bu yüzden başka bir şey yapılandırmanız gerekmez. Geçerli imzası olmayan webhook'lar reddedilir. Uzantı charge.success olayını kullanır:

Diğer olaylara OK yanıtı verilir ve yok sayılır. Webhook olmadan bir sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde onaylanır. Daha sonra tamamlanan banka havalesi ve USSD ödemeleri yalnızca webhook ile onaylanır.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş, missing order). Sipariş, Paystack ödemeyi API üzerinden onayladıktan sonra bir durum alır. Aşağıdaki her durum alanı OpenCart sipariş durumlarınızı listeler.

Autocomplete Order: açıkken ödenmiş siparişler, Paid Order Status yerine Complete Order Status alır. Varsayılan: kapalı.

Paid Order Status: onaylanmış bir ödemeden sonra ayarlanan durum. Varsayılan: Processing.

Complete Order Status: Autocomplete Order açıkken onaylanmış bir ödemeden sonra ayarlanan durum. Varsayılan: Complete.

Awaiting Payment Status: Paystack ödemeyi hâlâ işlerken müşteri geri döndü (banka havalesi, USSD, mobil para). Webhook ödemeyi onaylayana kadar sipariş bu durumu korur. Varsayılan: Pending.

On Hold (Review) Status: ödeme sizin incelemenizi gerektiriyor (bkz. Sipariş durumları). Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Failed Status: Paystack'in hâlâ işlemekte olduğu bir ödeme, bekleyen durumdaki bir sipariş için başarısız oldu. Varsayılan: Failed.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edildi. Varsayılan: Refunded.

Gelişmiş

Debug log: Paystack olaylarını ve API çağrılarını OpenCart günlükler klasöründeki (storage/logs) paystack_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında paystack_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman kaydedilir. Anahtarlar ve müşteri verileri asla kaydedilmez. 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 on uninstall: açıkken uzantıyı kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Siparişlerde kayıtlı ödeme verileri her zaman korunur. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli anahtarlar 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ı gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Paystack). Confirm Order adımında müşteri açıklamanızı ve Ödemeyi tamamlamak için güvenli Paystack sayfasına yönlendirileceksiniz. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemini ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında, uzantı sipariş tutarı için sipariş para biriminde bir Paystack işlemi başlatır, müşterinin e-posta adresini gönderir ve müşteriyi Paystack'in barındırdığı ödeme sayfasına yönlendirir. Orada müşteri, Paystack hesabınızda etkin olan kanallardan biriyle öder. Ödeme, sipariş numarasını ve müşteri adını içerir.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Paystack onayladıktan sonra ödenmiş olarak işaretlenir: müşteri geri döndüğünde ve webhook geldiğinde uzantı işlemi Paystack API'sinden okur ve referansı, durumu, tutarı ve para birimini kontrol eder. Sipariş, normal OpenCart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle durumunu alır ve müşteri OpenCart sipariş başarı sayfasını görür.

Ödeme hâlâ işleniyorsa, örneğin bir banka havalesi ise, müşteri geri döndüğünde sipariş Awaiting Payment Status alır ve başarı sayfası Teşekkürler. Ödemeniz Paystack tarafından onaylanıyor; onay e-postası alacaksınız. mesajını gösterir. Webhook siparişi daha sonra tamamlar ve sipariş ödendiğinde ya da ödeme başarısız olduğunda müşteri OpenCart sipariş durumu e-postasını alır. İncelemedeki bir sipariş için başarı sayfası Ödemeniz alındı ve siparişiniz incelenmektedir. Gerekirse sizinle iletişime geçeceğiz. gösterir. Müşteri geri döndüğünde Paystack'e ulaşılamazsa ya da ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası müşteriden tekrar ödeme yapmamasını ister ve Check again ile Back to checkout seçeneklerini sunar; webhook geldiği anda sipariş durumunu ayarlar.

Müşteri Paystack sayfasındaki Cancel payment düğmesine tıklarsa, ödemeden ayrılırsa ya da ödeme reddedilirse, sipariş durumsuz kalır ve sepet korunur. Müşteri şu mesajla ödeme sayfasına döner: Ödeme iptal edildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz., Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. ya da Ödemeniz reddedildi. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

Her yeni deneme (OpenCart 3, Confirm Order adımı gösterildiğinde her seferinde yeni bir sipariş oluşturur, OpenCart 4 ise ödeme sayfasındaki siparişi günceller) yeni bir Paystack işlemi başlatır. Eski bir ödeme sayfası geçerli kalır: daha sonra ödenirse ödeme yine kabul edilir. Yeni bir ödeme başlamadan önce, aynı sepetin son 24 saatteki açık denemeleri Paystack ile kontrol edilir. Sepet zaten ödenmişse, incelemedeyse ya da banka havalesi bekliyorsa, müşteri doğrudan başarı sayfasına gider ve ikinci bir ödeme başlatılmaz. Aynı sepetin başka bir siparişi yine de ödenirse, o sipariş durumsuz kalır ve ödenen sipariş, mükerrer ödemeyi iade etmek için bir not alır. Sepette yapılan her değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Bu sipariş ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz), müşteri Önceki siparişiniz ödeme yapılmadan iptal edildi. Yeni bir siparişle ödeme yapmak için lütfen siparişi yeniden onaylayın. mesajıyla ödeme adımına geri döner. Bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Bu sipariş daha önceki bir sepet için zaten ödenmişse ve sepet o zamandan beri değiştiyse, müşteri ödeme adımına geri yönlendirilir ve bir sonraki Confirm Order mevcut sepetin yeni siparişi için ödeme yapar. Kapatılmış bir sipariş asla ödenmiş gibi gösterilmez.

Dönüş bağlantısı yalnızca kendi rastgele jetonuyla çalışır. Bir siparişle eşleştirilemeyen bir dönüş, Bu ödeme bir siparişle eşleştirilemedi. Ücretlendirildiyseniz lütfen bizimle iletişime geçin. mesajıyla ödeme sayfasına yönlendirir.

Paystack ö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 Paystack ödemeyi başlatamadı: ardından Paystack'in verdiği neden, ya da Paystack geçici olarak kullanılamıyor. Lütfen birazdan tekrar deneyin veya başka bir ödeme yöntemi seçin. Sipariş tutarı sıfırdan büyük olmalı ve müşterinin geçerli bir e-posta adresi olmalıdır.

Webhook, OpenCart ödeme uzantısı isteklerine izin verdiği için mağaza bakım modundayken de çalışır (OpenCart 4'te uzantı bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin Paystack'ten dönüşüne de izin verir).

Uzantının satır içi veya açılır bir ödeme formu, kayıtlı kart, abonelik, bölünmüş ödeme ya da alt hesap yoktur ve OpenCart'ta ödeme kanalı seçimi yapılmaz.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Paystack'e yönlendirildi ve ödeme yapmadı, Paystack sayfasından ayrıldı ya da Paystack ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Awaiting Payment Status (varsayılan Pending): müşteri, Paystack bir banka havalesi ya da USSD gibi ödemeyi hâlâ işlerken geri döndü. Paystack ödemeyi onayladığında sipariş ödenmiş duruma geçer. Böyle bir ödeme hiç tamamlanmazsa, siz değiştirene kadar sipariş bu durumda kalır.

Paid Order Status (varsayılan Processing) veya Complete Order Status: ödeme onaylandı. Tamamlanmış durum, Autocomplete Order açıkken kullanılır. Bir not; tutarı, Paystack referansını, işlem numarasını, modu (test veya canlı), ödeme kanalını, kart ödemeleri için kart türünü ve son hanelerini, ayrıca müşterinin ödediği Paystack ücretlerini gösterir.

On Hold (Review) Status (varsayılan Pending): ödenen tutar ya da para birimi siparişten farklıdır (Paystack amount or currency mismatch notu) ya da ödeme, sipariş iptal edildikten veya ödeme olmadan başka bir duruma alındıktan sonra geldi. Not, neyin kontrol edilmesi gerektiğini açıklar. Siparişi tamamlayın ya da ödemeyi iade edin.

Failed Status (varsayılan Failed): Paystack, bekleyen durumdaki bir siparişin son ödeme denemesinin başarısız olduğunu ya da geri alındığını bildirir. Daha eski bir denemenin başarısızlığı siparişi değiştirmez.

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse, sipariş değiştirilmez. Bir not, mükerrer ödemeyi Paystack panelinde iade etmenizi ister. Shipped gibi başka bir işleme durumundaki bir sipariş için gelen ödeme yalnızca siparişe not olarak eklenir.

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

VibeFox Paystack Payment sekmesi

Sales > Orders bölümünde Paystack ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Paystack Payment sekmesi Transaction reference, test ödemeleri için Test etiketiyle birlikte Mode, ödemenin Status değerini, Transaction ID, Channel ve Card bilgilerini, ödeme tarihini, Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Paystack notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Paystack Payment sekmesinde Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz Reason (optional) alanını doldurun ve Refund via Paystack düğmesine tıklayın. Bu tutar Paystack üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Uzantıyı değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İade, siparişi ödeyen işleme, işlemin yapıldığı modun (test veya canlı) gizli anahtarıyla yapılır; bu nedenle o anahtarın ayarlı olması gerekir. İadeler, Paystack'in tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar ya da para birimi uyuşmazlığından sonra incelemede olan bir sipariş için, sipariş tutarına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. XOF ve RWF'de iadeler tam tutar olmalıdır.

Paystack iadeleri kuyruğa alır: not ve iade geçmişi, Paystack'in döndürdüğü durumu (örneğin pending) ve iade kimliğini gösterir. Paystack iadeyi kabul etmezse, sekme Paystack refund failed: ve nedenini gösterir; hiçbir iade kaydedilmez. Tam iade, siparişi müşteriye bildirilmeden ve ürünler stoğa geri eklenmeden Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez. İadeler, Paystack ödemeyi onayladıktan sonra kullanılabilir.

Sales > Returns bölümündeki ürün iadeleri Paystack üzerinden para geri göndermez. Paystack panelinde yapılan iadeler ve Paystack'in kuyruğa aldığı iadelerin nihai durumu OpenCart ile eşitlenmez. Gerekirse bunları elle kaydedin.

Lisans anahtarı

Uzantı, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Paystack Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Paystack Payment > 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: 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: opencart-payment-paystack satırı ve hesabınızda vibefox.net üzerinden açılan 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 belirtir, örneğin Key not found, This key belongs to another product, Domain limit reached ya da bir tarihle birlikte License expired on. Mağaza adresi değiştikten 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, uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresinde. 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 Paystack, ö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önetici 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 uzantıyı 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önetici paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici paneli Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Uzantı kaldırıldığında lisans anahtarı ve lisans durumu her zaman silinir.

Sorun giderme

Paystack ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, mevcut modun doğru gizli anahtara sahip olduğunu (test modunda sk_test_... ile Test Secret Key, canlı modda sk_live_... ile Live Secret Key) ve sipariş para biriminin Paystack'in kabul ettiği bir para birimi olduğunu kontrol edin. Ayarların üstündeki durum kutusu 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 yapıldı, ancak sipariş durumsuz kalıyor: webhook mağazanıza ulaşmadı ve müşteri geri dönmedi. Paystack panelinde Test Webhook URL ve Live Webhook URL'nin tam olarak Webhook URL alanında gösterilen URL olduğunu ve bunu bir güvenlik duvarının ya da parola korumasının engellemediğini kontrol edin. Debug log seçeneğini açın ve reddedilen webhook'lar için Log alanına bakın.

Webhook Invalid signature yanıtı veriyor: webhook, ayarlarda girilen test ya da canlı gizli anahtarla imzalanmadı; örneğin anahtarlar başka bir Paystack hesabına ait olduğu için. Webhook'u gönderen hesabın anahtarlarını girin.

Webhook Secret key not configured yanıtı veriyor: hiçbir gizli anahtar ayarlanmamış. Ayarlarda gizli anahtarları girin.

Webhook Verification failed, Busy, retry later veya Order could not be updated, retry later yanıtı veriyor: işlem o anda Paystack API'sinden okunamadı, sepet müşterinin dönüşü tarafından aynı anda işleniyordu ya da sipariş durumu ayarlanamadı. Paystack webhook'u yeniden gönderir. Günlük nedeni gösterir.

Webhook OK - unknown reference yanıtı veriyor: ödeme bu mağazadaki bir sipariş için yapılmadı; örneğin bir Paystack ödeme sayfası ya da aynı hesaptaki başka bir entegrasyon. Yok sayılır.

Webhook URL'si tarayıcıda Empty body gösteriyor: bu normaldir. URL yalnızca Paystack'ten gelen istekleri kabul eder.

Müşteri Payment gateway is not properly configured mesajını görüyor: mevcut modun gizli anahtarı eksik ya da hatalı. Ayarların üstündeki durum kutusunun belirttiği gibi düzeltin. Confirm Order sonrasında This payment method is not available. mesajı, ödeme yönteminin bu arada kapatıldığı ya da ödeme sayfasının artık siparişle eşleşmediği anlamına gelir: müşteri ödeme sayfasını yeniden yüklemelidir.

Sipariş ödemeden sonra inceleme durumunda: VibeFox Paystack Payment sekmesindeki notları okuyun (bkz. Sipariş durumları), sonra siparişi tamamlayın ya da ödemeyi iade edin.

Sipariş bekleme durumunda kalıyor: Paystack ödemeyi henüz onaylamadı. Paystack panelindeki işlemi ve webhook ayarlarını kontrol edin. Müşteri ödemeyi hiç tamamlamadıysa, durumu elle değiştirin.

Sekmede iade formu yok: sekme nedenini belirtir: ödeme henüz onaylanmadı, tamamen iade edildi, kullanıcı grubunuzun uzantıyı değiştirme izni yok ya da ödemenin modunun gizli anahtarı eksik.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test ya da canlı modda yapıldı ve o modun gizli anahtarı ayarlanmamış. Anahtarı girin ve tekrar deneyin.

Geliştiriciler için: uzantı OpenCart olaylarını tetikler: paystack_p_payment_request (işlem isteği), paystack_p_supported_currencies ve paystack_p_currency_decimals.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Paystack Payment 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 Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Uzantının OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda webhook ile müşteri dönüşüne izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, otomatik tamamlama, günlükleme) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için korunurlar. Siparişlerdeki Paystack ödeme verileri ve iadeler her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını 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, yüklü uzantılar listesinde VibeFox Paystack Payment yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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