VibeFox Przelewy24 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 PLN, EUR, GBP veya CZK cinsinden olması gerekir. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gösterilmez. Sipariş kendi para biriminde tahsil edilir; eklenti para birimlerini dönüştürmez.

Przelewy24 hesabı: bir Przelewy24 satıcı hesabına ve bu hesabın API verilerine ihtiyacınız vardır: Merchant ID, API anahtarı (Przelewy24 panelinde report key olarak adlandırılır), CRC key ve mağazanızın kendi kimliği varsa POS ID (Shop ID). Bunları panel.przelewy24.pl adresindeki Przelewy24 satıcı panelinde, My data > API data and configuration altında bulabilirsiniz. Sandbox anahtarları, sandbox.przelewy24.pl/panel adresindeki ayrı bir sandbox hesabından alınır. Przelewy24 panelinde başka bir şey ayarlamanız gerekmez: eklenti her ödemeyle birlikte kendi bildirim URL'sini gönderir. Przelewy24 ö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

İ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_przelewy24_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_przelewy24_payment.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_przelewy24_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine, arşivdeki 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 olarak Payments seçin. VibeFox Przelewy24 Payment eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme iznine sahip olması gerekir.

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

4. Sandbox anahtarlarını girin (Merchant ID, API anahtarı, CRC key; POS ID yalnızca Merchant ID'den farklıysa), Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve sandbox modunda bir test ödemesi yapın.

5. Canlı anahtarları girin, Test 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_przelewy24_payment.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 Przelewy24 Payment öğ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 Przelewy24 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 bildirim URL'si farklıdır (bkz. Ödeme bildirimleri).

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

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Przelewy24 Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde, eksik bir şey olduğunda sayfa uyarılar gösterir. Sandbox açıkken: Sandbox (test) mode is on: payments go to the Przelewy24 sandbox and no real money is charged. Do not ship orders paid in test mode. Geçerli modun anahtarları eksikse: Enter the Sandbox Merchant ID, API key and CRC key - until then Przelewy24 is not shown at checkout. (ya da canlı anahtarlar için aynısı). Przelewy24, mağazanızın varsayılan para birimini kabul etmiyorsa uyarı para birimini ve desteklenen para birimlerini belirtir. Kaydettikten sonra uyarılar yeni mod ve anahtarları hemen takip eder. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken bir alan hatalıysa hiçbir şey kaydedilmez: Title boş olamaz (Enter a title for the payment method (at most 128 characters).), 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. Eksik anahtarlar kaydetmeyi engellemez. Przelewy24 panelinden anahtarlarla birlikte kopyalanan boşluklar ve satır sonları kaydederken temizlenir.

Przelewy24

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

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

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay with BLIK, online bank transfer or card via Przelewy24.

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

Geo Zone: Przelewy24'ü 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: Przelewy24'ün sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde sepet toplamı. Herhangi bir tutar için Przelewy24'ü sunmak üzere boş bırakın.

API kimlik bilgileri

Bu bölüm anahtarların nerede bulunacağını açıklar (Przelewy24 satıcı panelinde My data > API data and configuration) ve Przelewy24 paneline ve sandbox paneline bağlantılar içerir.

Test Mode: Przelewy24 sandbox'ını ve Sandbox anahtarlarını kullanır. Gerçek para tahsil edilmez. Canlı anahtarlarla gerçek ödemeleri kabul etmek için kapatın. Varsayılan: on. Açıkken müşteriler Confirm Order adımında Sandbox mode - no real money is charged ifadesini görür.

Canlı anahtarlar

Live Merchant ID: Przelewy24 satıcı kimliğiniz, yalnızca rakamlar.

Live POS ID (optional): Shop ID (posId). Merchant ID ile aynıysa boş bırakın.

Live API key (report key): Przelewy24 panelindeki API anahtarı. API kimlik doğrulaması için kullanılır.

Live CRC key: Przelewy24'e gönderilen istekleri imzalamak ve Przelewy24 bildirimlerinin imzasını doğrulamak için kullanılır.

Sandbox anahtarları

Sandbox Merchant ID: Przelewy24 sandbox hesabınızın Merchant ID'si.

Sandbox POS ID (optional): sandbox hesabının Shop ID'si (posId). Merchant ID ile aynıysa boş bırakın.

Sandbox API key (report key): sandbox hesabının API anahtarı.

Sandbox CRC key: sandbox hesabının CRC key'i; istekleri imzalamak ve sandbox bildirimlerini doğrulamak için kullanılır.

Kaydedilmiş API anahtarları ve CRC key'ler bir daha asla 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. Kaydedilmiş bir anahtarı kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Canlı ve sandbox anahtarları farklıdır. Merchant ID ve POS ID yalnızca rakam içermelidir; geçerli modun Merchant ID, API anahtarı ve CRC key'i girilene kadar ödeme yöntemi ödeme sayfasında gösterilmez. Bir modda başlatılan bir ödeme, modlar değiştirilse bile her zaman o modun anahtarlarıyla doğrulanır ve iade edilir; bu nedenle eski modun ödemeleri açık olduğu veya iade edilebileceği sürece eski modun anahtarlarını saklayın.

Ödeme bildirimleri

Notification URL: Przelewy24'ten ödeme bildirimlerini alan adres. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_przelewy24_payment/notify, OpenCart 4'te https://your-store/index.php?route=extension/wcp_przelewy24_payment/payment/wcp_przelewy_24payment.notify gibi görünür ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Eklenti her ödemede ve her iadede bu URL'yi Przelewy24'e gönderir, bu nedenle Przelewy24 panelinde bir şey yapılandırmanız gerekmez. URL internetten erişilebilir olmalıdır: önünde güvenlik duvarı veya HTTP kimlik doğrulaması olmamalıdır. Mağaza bakım modundayken de çalışmaya devam eder: OpenCart 3 ödeme eklentisi isteklerini geçirir, OpenCart 4'te ise eklenti bildirim URL'si ve müşterinin dönüşü için kendi başlangıç eylemini ekler. Bildirim olmasa bile müşteri mağazaya döndüğünde ödeme yine onaylanır (bkz. Ödeme sayfası); müşteri geri dönmezse sipariş durumsuz kalır.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, Przelewy24 ödemeyi onayladıktan ve eklenti bunu doğruladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Paid Order Status: doğrulanmış bir ödemeden sonraki durum. Varsayılan: Processing.

On Hold (Review) Status: tutarı veya para birimi siparişle eşleşmeyen (doğrulanmamış) ödemeler ya da sipariş iptal edildikten sonra gelen ödemeler bu durumu ve nedenini açıklayan bir not alır. 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: eklenti bunu asla ayarlamaz. Bu durumdaki bir sipariş için doğrulanmış bir ödeme, siparişi sessizce yeniden açmak yerine siparişi beklemeye alır. Varsayılan: Canceled.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug Log: teknik olayları (sipariş numaraları, P24 işlem kimlikleri, hatalar) OpenCart günlükler klasöründeki (storage/logs) wc_p24_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında wc_p24_debug.old.log.php dosyasına taşınır. Reddedilen bildirimler ya da başarısız bir doğrulama veya iade gibi hatalar ve uyarılar her zaman kaydedilir; her adımı da kaydetmek için anahtarı açın. Anahtarlar ve kişisel veriler asla kaydedilmez. Varsayılan: off.

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

Delete data on uninstall: açıkken eklentiyi kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Siparişler ve Przelewy24 ödeme verileri asla silinmez. Varsayılan: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API anahtarları ve CRC key'ler 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. Kaydedilmiş API anahtarları ve CRC key'ler korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Przelewy24). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the secure Przelewy24 page to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde sipariş toplamı için Przelewy24'te bir işlem kaydeder; müşterinin e-posta adresi, adı ve fatura ülkesi ile birlikte, Order # açıklamasına sipariş numarası ve mağazanızın adı eklenerek kaydedilir. Her ödeme denemesi kendi oturum kimliğini alır. Müşteri Przelewy24 ödeme sayfasına yönlendirilir ve Przelewy24 hesabınızda etkin olan BLIK, online banka havalesi, kart veya başka bir yöntemle öder. Ödeme sayfası Przelewy24 destekliyorsa sipariş dilinde, desteklemiyorsa İngilizce gösterilir. 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.

Sipariş, yalnızca Przelewy24 ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir. Przelewy24 mağazanıza imzalı bir bildirim gönderir. Eklenti imzayı CRC key, Merchant ID ve POS ID ile doğrular; oturumun bu sipariş için ve aynı modda kaydedildiğini; tutarın ve para biriminin ödeme denemesi ve sipariş toplamıyla eşleştiğini kontrol eder. Ancak bundan sonra işlemi Przelewy24 ile doğrular (Przelewy24 yalnızca doğrulanmış ödemeleri hesaba geçirir) ve Paid Order Status durumunu OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle ayarlar. Geçerli imzası olmayan webhook'lar reddedilir.

Ödemeden sonra müşteri mağazanıza geri döner. Bildirim henüz gelmediyse eklenti, Przelewy24'ten kimliği doğrulanmış bir sunucudan sunucuya istekle işlem durumunu ister (deneme başına en fazla 10 saniyede bir) ve aynı kontrolleri uygular. Yalnızca dönüş sayfası bir siparişi asla ödenmiş olarak işaretlemez. Ödeme onaylandığında müşteri OpenCart sipariş başarı sayfasını görür. Onaylanmadığı sürece Payment confirmation sayfası We have not received the payment confirmation from Przelewy24 yet. If you have paid, it will be confirmed in a few minutes. If the payment was interrupted, you can try again: mesajını, ödeme sayfasını açan bir Check again ve bir Pay again düğmesiyle gösterir. Sepet korunur ve daha eski bir Przelewy24 sayfasından sonra yapılan ödeme de kabul edilir. Sipariş beklemedeyse başarı sayfası Your payment is being verified. We will send you an e-mail as soon as it is confirmed. gösterir. Sonraki bir ödeme siparişi bekleme durumundan Paid Order Status durumuna taşıdığında müşteriye e-postayla bildirim gönderilir. Siparişi ödeme yapılmadan önce iptal ettiyseniz ve Przelewy24'te bu sipariş için bir ödeme yoksa geri dönen müşteri Order #… was cancelled by the store before the payment was completed. No Przelewy24 payment was received for it. Please place a new order or contact us. mesajını görür.

Ödeme başlatılamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde kısa bir mesaj görür: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (nedeni günlüğe yazılır), Payment gateway is not configured properly. Please contact the administrator. (geçerli modun anahtarları eksik), Przelewy24'ün sipariş para biriminde ödeme kabul edemediğini bildiren bir mesaj ya da The order total must be greater than zero. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; zaten ödenmiş bir sipariş veya sepet tekrar Przelewy24'e gönderilmez ve müşteri başarı sayfasına gider.

OpenCart 4, ödeme sayfası için tek bir siparişi saklar ve Confirm Order adımı her gösterildiğinde onu günceller; bu nedenle Pay again, aynı sipariş için yeni bir Przelewy24 işlemi başlatır. Bu sipariş bu arada mağaza tarafından kapatılmışsa (örneğin iptal edilmiş veya iade edilmişse), müşteri Your previous order was closed by the store. Please confirm the order again to place and pay a new order. mesajıyla ödeme sayfasına geri gönderilir (ödeme yapılmadan önce iptal edilmiş bir sipariş için, yukarıdaki iptal edilmiş sipariş mesajıyla birlikte) ve bir sonraki Confirm Order yeni bir siparişi öder. Ödeme sayfasının siparişi zaten ödenmiş ama sepet o zamandan beri değişmişse (yeni miktar dahil), müşteri Your previous order #… has already been placed. Your cart has changed: please confirm the new order to pay for it. mesajını görür ve yeni sepet yeni bir siparişle ödenir. OpenCart 4'te bu mesajlar ile We could not match this payment to an order. If you were charged, please contact us. mesajı ödeme sayfasının üstünde gösterilir.

Eklentinin kayıtlı kart veya tek tıkla ödeme, abonelik veya yinelenen ödeme, ödeme sayfanızda P24 ödeme yöntemi seçimi (örneğin bir BLIK kodu alanı), taksit bileşenleri yoktur ve sepet içeriğini Przelewy24'e göndermez.

Siparişler ve iadeler

Sipariş durumları

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

Paid Order Status (varsayılan Processing): ödeme doğrulandı. Bir not P24 sipariş kimliğini, tutarı ve modu gösterir. Her ödeme bir kez uygulanır.

On Hold (Review) Status (varsayılan Pending): Przelewy24'ün bildirdiği tutar veya para birimi siparişten farklıdır; ödeme onaylanmadı ve not bunu belirtir. Ya da ödeme geldi ve iptal durumundaki bir sipariş için doğrulandı; sipariş sessizce yeniden açılmaz, not sizden siparişi göndermenizi veya ödemeyi iade etmenizi ister. Ödemeyi Przelewy24 panelinde kontrol edin. Bir uyuşmazlıktan sonra bekleme durumundaki bir sipariş için başka bir denemeden doğru bir ödeme daha sonra gelirse sipariş Paid Order Status durumuna geçer.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş veya iade edilmiş bir sipariş ya da sepet için ikinci bir ödeme gelirse (eski bir ödeme bağlantısı, iki tarayıcı sekmesi, aynı sepetin başka bir siparişi), bu ödeme onaylanmaz ve Przelewy24 onu hesaba geçirmez. Ödenmiş siparişteki bir not, ödemeyi Przelewy24 panelinde kontrol etmenizi ve gerekirse alıcıya iade etmenizi ister.

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

VibeFox Przelewy24 Payment sekmesi

Sales > Orders bölümünde Przelewy24 ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Przelewy24 Payment sekmesi P24 sipariş kimliğini, Session bilgisini, Environment (Sandbox veya Live) bilgisini, ödemenin Status bilgisini ve nasıl doğrulandığını (bildirim veya dönüş), Paid / refunded tutarlarını, iade formunu, iade geçmişini ve siparişin Payment notes notlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Przelewy24 Payment sekmesinde Amount bilgisini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Przelewy24 düğmesine tıklayın. Refund this amount through Przelewy24? This cannot be undone. sorusunu onaylayın. Henüz iade edilmemiş tutara kadar tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme izniniz olmalıdır (System > Users > User Groups bölümünde ayarlanır). İade, ödemenin yapıldığı modda (sandbox veya canlı) gönderilir; bu nedenle o modun anahtarları girilmiş olmalıdır. İadeler, Przelewy24 ödemeyi doğruladıktan sonra kullanılabilir.

Przelewy24 iadeleri eşzamansız işler. Sekme Refund of … requested at Przelewy24. The result will be added as an order note. mesajını gösterir, iade geçmişinde requested durumu görünür ve bir not eklenir. Sonuç daha sonra bildirim URL'sine gelir: durum completed olur ve Przelewy24: refund of … completed. notu eklenir ya da durum rejected olur ve paranın alıcıya iade edilmediğini belirten bir not eklenir. Tam iade, istek anında siparişi müşteriye bildirim göndermeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi iade durumu değiştirmez. Bir iade reddedilirse Przelewy24 panelinde kontrol edin; sipariş durumu otomatik olarak geri alınmaz.

Przelewy24 iade isteğini kabul etmezse sekme nedeniyle birlikte Przelewy24 refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Sales > Returns bölümündeki ürün iadeleri Przelewy24 üzerinden para geri göndermez; Przelewy24 panelinden doğrudan yapılan iadeler siparişe eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Przelewy24 Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Przelewy24 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ı maskelenmiş 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-przelewy24 satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici panelinin diline uyar (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedeni belirtir; ö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 eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar 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 Przelewy24 ö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 hâlâ görür ve (unlicensed — visible to admins only) ibaresiyle işaretlenmiş olarak görür; böylece anahtarı satın almadan önce eklentiyi kurup 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önetici Dashboard ekranında bir hatırlatıcı görünür. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: başlatılmış ödemeler doğrulanmaya ve onaylanmaya devam eder ve iadeler çalışır.

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

Sorun giderme

Przelewy24 ö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, API anahtarı ve CRC key'inin girildiğini (Test Mode açıkken Sandbox anahtarları, aksi halde Live anahtarları; Merchant ID ve POS ID yalnızca rakam) ve sipariş para biriminin PLN, EUR, GBP veya CZK 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 değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kalıyor: Przelewy24 bildirimi mağazanıza ulaşmadı ve müşteri mağazaya geri dönmedi. Notification URL adresinin internetten erişilebilir olduğunu (önünde güvenlik duvarı veya HTTP kimlik doğrulaması olmadan) ve ödemenin modunun Merchant ID, POS ID ve CRC key'inin doğru olduğunu kontrol edin. Reddedilen bildirimler Debug Log kapalıyken bile günlüğe yazılır; eklenti sayfasındaki Log alanına bakın.

Mağaza bildirimleri nasıl yanıtlar: işlenmiş, tekrarlanan veya bilinmeyen bir bildirim HTTP 200 ile yanıtlanır. Aksi halde Przelewy24 bunu daha sonra yeniden gönderir: 400 (eksik veya bozuk veriler), 401 Invalid signature (yanlış CRC key, farklı Merchant ID veya POS ID), 401 Invalid signature for this payment (ödemenin modundan farklı bir modun anahtarlarıyla imzalanmış bildirim), 405 (POST olmayan istek), 500 Verification failed (Przelewy24 ile doğrulama başarısız oldu; siparişe bir kez not eklenir), 500 Order could not be updated (sipariş durumu ayarlanamadı; sonraki bildirim yeni bir doğrulama olmadan ayarlar) ve 503 Busy, retry later (sipariş aynı anda başka bir istek tarafından onaylanıyordu).

Müşteri Payment error: Przelewy24 could not start the payment mesajını görüyor: Przelewy24 işlemi reddetti, genellikle geçerli modun yanlış anahtarları nedeniyle (sandbox anahtarları yalnızca sandbox modunda, canlı anahtarlar yalnızca canlı modda çalışır). Przelewy24'ten gelen hata günlüktedir.

Müşteri We could not match this payment to an order mesajını görüyor: Przelewy24'ten gelen dönüş bağlantısı mağazanın hiçbir siparişiyle eşleşmedi. Müşteriden ücret alındıysa ödemeyi Przelewy24 panelinde bulun.

Ödemeden sonra sipariş inceleme durumunda: VibeFox Przelewy24 Payment sekmesindeki notları okuyun. Tutar veya para birimi siparişten farklıydı ya da ödeme iptal edilmiş bir sipariş için geldi. Ödemeyi Przelewy24 panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

İade başarısız oluyor: This order has no verified Przelewy24 payment. Cannot process refund. siparişin doğrulanmış bir Przelewy24 ödemesiyle ödenmediği anlamına gelir. The payment was made in the Przelewy24 sandbox, but the Sandbox keys are missing. (ya da canlı için aynısı) ödemenin modunun anahtarlarının kaldırıldığı anlamına gelir; bunları yeniden girin. Invalid refund amount tutarın boş olduğu, bir sayı olmadığı veya henüz iade edilmemiş tutardan fazla olduğu anlamına gelir.

Geliştiriciler için: para birimi listesi OpenCart olayı wc_p24_supported_currencies ile değiştirilebilir (yalnızca iki ondalık basamağı olan para birimleri).

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Przelewy24 Payment yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin 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. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te 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 on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Siparişlerin Przelewy24 ödeme verileri (oturumlar, P24 sipariş kimlikleri, iadeler) her zaman korunur; böylece önceden ö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, kurulu uzantılar listesinde VibeFox Przelewy24 Payment 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.

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