VibeFox Przelewy24 for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, eski PHP sürümlerine kurulmayı reddeder.

Para birimi: sepet PLN, EUR, GBP veya CZK cinsinden olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Sepet kendi para biriminde tahsil edilir; modül para birimi dönüşümü yapmaz.

Przelewy24 hesabı: bir Przelewy24 satıcı hesabına ve API bilgilerine ihtiyacınız vardır: Merchant ID, API anahtarı (Przelewy24 panelinde report key olarak geçer), CRC anahtarı 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 gelir. Przelewy24 panelinde başka bir şey ayarlamanız gerekmez: modül, 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 tek 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 bittiğinde Configure düğmesine tıklayın veya VibeFox Przelewy24 Payment modülünü daha sonra modül listesinde bulup Configure düğmesine tıklayın.

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

4. Sandbox anahtarlarını (Merchant ID, API anahtarı, CRC anahtarı; POS ID yalnızca Merchant ID'den farklıysa) girin, Enable/Disable seçeneğini açın, Save düğmesine tıklayın ve sandbox modunda bir deneme ö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.

Kurulumda modül Przelewy24 payment on hold sipariş durumunu oluşturur. Ardından PrestaShop, tüm para birimleri, ülkeler ve müşteri grupları için yeni bir ödeme modülü sunar. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Przelewy24 Payment > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde, 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 etmezse, uyarı bu para birimini ve desteklenen para birimlerini belirtir. Kaydettikten sonra uyarılar hemen yeni modu ve yeni anahtarları izler. Przelewy24 panelinden anahtarlarla birlikte kopyalanan boşluklar ve satır sonları kaydetme sırasında kaldırılır.

Przelewy24

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Przelewy24. Zorunlu: başlık boşken kaydederseniz Enter a title for the payment method. görüntülenir.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with BLIK, online bank transfer or card via Przelewy24.

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 panel.przelewy24.pl ile sandbox.przelewy24.pl/panel adreslerine bağlantılar verir.

Test Mode: Przelewy24 sandbox'ını (sandbox.przelewy24.pl) ve Sandbox anahtarlarını kullanır. Gerçek para tahsil edilmez. Canlı anahtarlarla secure.przelewy24.pl üzerinde gerçek ödemeleri kabul etmek için kapatın. Varsayılan: açık. Açık olduğu sürece müşteriler ödeme yönteminin altı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ı kontrol etmek 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 anahtarı; istekleri imzalamak ve sandbox bildirimlerini kontrol etmek için kullanılır.

Kaydedilmiş API anahtarları ve CRC anahtarları 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.

Clear saved secrets: bir anahtarı işaretleyip kaldırmak için Save düğmesine tıklayın. Boş bir alan, kaydedilmiş değeri korur.

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 anahtarı girilene kadar ödeme yöntemi ödeme sayfasında görünmez. Bir modda başlatılan ödeme, moddan sonra 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. Okunabilir URL'lerle şöyle görünür: https://your-shop/module/wcp_przelewy24_payment/notify; /en/ gibi bir dil koduyla birlikte olabilir. Modül bu URL'yi her ödeme ve her iadeyle birlikte Przelewy24'e gönderir, bu nedenle Przelewy24 panelinde hiçbir şey ayarlanmaz. 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 ve mağazanızın ülke kısıtlamasıyla engellenmez. Bildirim olmasa bile ödeme, müşteri mağazaya döndüğünde onaylanır (bkz. Ödeme); müşteri geri dönmezse sipariş oluşturulmaz.

Gelişmiş

Debug Log: teknik olayları (sepet numaraları, P24 işlem kimlikleri, hatalar) modül klasöründeki logs/wc_p24_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Reddedilen bildirimler veya başarısız doğrulama ya da iade gibi hatalar ve uyarılar her zaman kaydedilir; her adımı da kaydetmek için anahtarı açın. Anahtarlar, istek gövdeleri ve kişisel veriler hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete data on uninstall: açıksa modül kaldırıldığında modül ayarları ve günlük silinir. Siparişler ve Przelewy24 ödeme verileri hiçbir zaman silinmez. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak P24 logolu Przelewy24) ve siparişi onaylar. Modül, sepet toplamı için sepetin para biriminde bir Przelewy24 işlemi kaydeder; müşterinin e-postası, adı ve fatura ülkesi ile sepet numarası ve mağaza adınızdan oluşan Cart # açıklamasını ekler. Her ödeme girişimi kendi oturum kimliğini alır. Müşteri Przelewy24 ödeme sayfasına yönlendirilir ve BLIK, çevrimiçi banka havalesi, kart veya Przelewy24 hesabınız için etkinleştirilmiş başka bir yöntemle öder. Ödeme sayfası, Przelewy24 destekliyorsa müşterinin sepetinin dilinde, desteklemiyorsa İngilizce gösterilir. Bu aşamada henüz bir sipariş yoktur.

Sipariş yalnızca Przelewy24 onayladıktan sonra ödenmiş olarak işaretlenir. Przelewy24, mağazanıza imzalı bir bildirim gönderir. Modül; imzayı CRC anahtarı, Merchant ID ve POS ID ile kontrol eder; oturumun bu sepet için ve aynı modda kaydedildiğini kontrol eder; tutar ve para biriminin ödeme girişimi ve geçerli sepet toplamıyla eşleştiğini doğrular. Ancak bundan sonra işlemi Przelewy24 ile doğrular (Przelewy24 yalnızca doğrulanmış ödemeleri hesaba geçirir) ve siparişi Payment accepted durumunda oluşturur. Geçerli imzası olmayan webhook'lar reddedilir.

Ödeme yapıldıktan sonra müşteri mağazanıza döner. Bildirim henüz ulaşmadıysa modül, kimliği doğrulanmış bir sunucudan sunucuya istekle Przelewy24'ten işlem durumunu ister (sepet başına en fazla 10 saniyede bir) ve aynı kontrolleri uygular. Yalnızca dönüş sayfası hiçbir zaman bir siparişi ödenmiş olarak işaretlemez. Ödeme onaylandığında müşteri standart sipariş onay 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ı gösterir; bunun altında ödemeyi yeniden kontrol etmek için Check again ve ödeme sayfasını açan Pay again düğmeleri bulunur. Sepet korunur ve aynı sepetin daha eski bir Przelewy24 sayfasında sonradan yapılan ödeme yine de kabul edilir. Sipariş beklemedeyse onay sayfası Your payment is being verified. We will send you an e-mail as soon as it is confirmed. ifadesini gösterir.

Ödeme başlatılamazsa müşteri ödeme sayfasında kısa bir mesajla kalır: Payment error: Przelewy24 could not start the payment. Please try again or choose another payment method. (neden günlüğe yazılır), Payment gateway is not configured properly. Please contact the administrator. (geçerli modun anahtarları eksik), Przelewy24'ün sepet para biriminde ödeme kabul edemediğine dair bir mesaj veya The order total must be greater than zero. Zaten siparişi olan bir sepet Przelewy24'e yeniden gönderilmez; müşteri sipariş onayına yönlendirilir.

Modül; kayıtlı kart veya tek tıkla ödeme, abonelik veya yinelenen ödemeleri desteklemez, ödeme sayfanızda P24 ödeme yönteminin seçilmesine (örneğin bir BLIK kodu alanı) izin vermez, taksit widget'ları içermez ve sepet içeriğini Przelewy24'e göndermez.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Przelewy24'e yönlendirildi ve ödeme yapmadı ya da ödeme henüz onaylanmadı. Yalnızca sepet vardır.

Payment accepted: ödeme doğrulandı. Ödeme, P24 sipariş kimliği işlem kimliği olarak kaydedilir; bir not P24 sipariş kimliğini, tutarı ve modu gösterir. Her ödeme yalnızca bir kez uygulanır.

Przelewy24 payment on hold: Przelewy24'ün bildirdiği tutar veya para birimi sepetten farklıdır (örneğin ödeme başlatıldıktan sonra sepet değiştirilmiştir); ödeme onaylanmadı ve not bunu belirtir. Ya da ödeme ulaştı ve iptal edilmiş 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 beklemedeki bir sipariş için başka bir girişimin doğru ödemesi daha sonra gelirse, sipariş Payment accepted durumuna geçer.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Siparişi zaten ödenmiş veya iade edilmiş bir sepet için ikinci bir ödeme gelirse (eski bir ödeme bağlantısı, iki tarayıcı sekmesi), bu ödeme onaylanmaz ve Przelewy24 hesaba geçirmez. Siparişteki bir not, bunu Przelewy24 panelinde kontrol etmenizi ve gerekirse alıcıya iade etmenizi ister.

Przelewy24 ödeme bloğu

Sipariş sayfasında P24 sipariş kimliği, oturum, ortam (sandbox ödemeleri için Sandbox rozeti), ödeme durumu ve doğrulama yöntemi (bildirim veya dönüş), ödenen ve iade edilen tutarlar, iade formu, iade geçmişi ve siparişin Payment notes bölümünü içeren bir Przelewy24 payment bloğu gösterilir.

İadeler

Przelewy24 payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın 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. Siparişleri düzenleme yetkisine sahip olmanız gerekir; modül sayfalarına erişim gerekli değildir. İade, ödemenin yapıldığı modda (sandbox veya canlı) gönderilir; bu nedenle o modun anahtarları ayarlanmış olmalıdır. İadeler, Przelewy24 ödemeyi doğruladıktan sonra kullanılabilir.

Przelewy24 iadeleri eşzamansız işler. Blok 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 ulaşır: 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, talep edildiğinde siparişi Refunded durumuna getirir; kısmi iade durumu değiştirmez. Bir iade reddedilirse Przelewy24 panelinde kontrol edin; sipariş durumu otomatik olarak geri alınmaz.

Przelewy24 iade talebini kabul etmezse blok nedeniyle birlikte Przelewy24 refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Przelewy24 üzerinden para geri göndermez ve Przelewy24 panelinde doğrudan yapılan iadeler siparişe eklenmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Przelewy24 Payment lisans bloğu, Modules > Module Manager > VibeFox Przelewy24 Payment > Configure sayfasında ayarların üstünde bulunan 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 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: presta-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 modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 veya tarihle birlikte License expired on. Mağaza adresi değiştikten sonra 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek 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ızda 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. 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 sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine doğrulanır ve onaylanır, iadeler çalışır.

Bir lisansın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından 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

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 anahtarının girildiğini (Test Mode açıkken Sandbox anahtarları, aksi halde Live anahtarları; Merchant ID ve POS ID yalnızca rakam) ve sepet para biriminin PLN, EUR, GBP veya CZK 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üşterinin grubu için izinli olduğunu kontrol edin. Geliştiriciler para birimi listesini actionWcpPrzelewy24SupportedCurrencies kancasıyla değiştirebilir (yalnızca Przelewy24 hesabınız için iki ondalık basamağı etkin olan para birimleri).

Ödeme yapıldı ama sipariş oluşturulmadı: Przelewy24'ün 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ı olmadığını) ve ödemenin modundaki Merchant ID, POS ID ve CRC anahtarının doğru olduğunu kontrol edin. Reddedilen bildirimler, Debug Log kapalıyken bile günlüğe yazılır; modül sayfasındaki Log alanına bakın.

Mağaza bildirimlere nasıl yanıt verir: işlenmiş, tekrarlanan veya bilinmeyen bir bildirim HTTP 200 ile yanıtlanır. Aksi halde Przelewy24 bildirimi daha sonra yeniden gönderir: 400 (eksik veya hatalı veri), 401 Invalid signature (yanlış CRC anahtarı, farklı Merchant ID veya POS ID), 401 Invalid signature for this payment (bildirim, ödemeden farklı modun anahtarlarıyla imzalanmış), 405 (POST isteği değil), 500 Verification failed (Przelewy24 ile doğrulama başarısız oldu; sipariş varsa siparişe bir kez not eklenir), 500 Order could not be created (örneğin modül devre dışıdır; bir sonraki bildirim yeni bir doğrulama olmadan siparişi oluşturur) ve 503 Busy, retry later (sepet tam o 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'ün hatası günlükte yer alır.

Sipariş ödeme sonrası Przelewy24 payment on hold durumunda: Przelewy24 payment bloğundaki notları okuyun. Tutar veya para birimi sepetten 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.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Przelewy24 Payment 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. Delete data on uninstall açıksa modül ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerin Przelewy24 ödeme verileri (oturumlar, P24 sipariş kimlikleri, iadeler) ve Przelewy24 payment on hold sipariş durumu her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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