VibeFox Przelewy24 for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Para birimi: sipariş PLN, EUR, GBP veya CZK cinsinden olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. Sipariş kendi para biriminde tahsil edilir; eklenti para birimi dönüştürmez.

Przelewy24 hesabı: bir Przelewy24 satıcı hesabına ve API bilgilerine ihtiyacınız var: Merchant ID, API anahtarı (Przelewy24 panelinde report key olarak adlandırılır), CRC anahtarı ve mağazanızın kendi kimliği varsa POS ID (Shop ID). Bunları panel.przelewy24.pl üzerindeki 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 ayar yapmanız gerekmez: eklenti, her ödemeyle birlikte kendi bildirim URL'sini gönderir. Przelewy24 ödeme bildirimlerini bu adrese gönderdiği için sitenizin 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

1. WordPress'te Plugins > Add New > Upload Plugin sayfasına gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Alternatif olarak wcp_przelewy24_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

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

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

5. Sandbox anahtarlarını girin (Merchant ID, API key, CRC key; POS ID yalnızca Merchant ID'den farklıysa), Enable/Disable seçeneğini açın, kaydedin ve sandbox modunda bir test ödemesi yapın.

6. Canlı anahtarları girin, Test Mode onay kutusunun işaretini kaldırın ve gerçek ödemeleri kabul etmek için kaydedin.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Przelewy24. 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. (veya canlı anahtarlar için aynı uyarı). Przelewy24 mağaza para birimini kabul etmediğinde 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ı kaydederken temizlenir.

Ödeme sayfası

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ı. Varsayılan: Przelewy24.

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: Enable sandbox (test) mode. Açıkken yeni ödemeler sandbox anahtarlarıyla Przelewy24 sandbox'ına (sandbox.przelewy24.pl) gider ve gerçek para tahsil edilmez. Gerçek ödemeleri canlı anahtarlarla secure.przelewy24.pl üzerinden kabul etmek için işaretini kaldırın. Varsayılan: açık.

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ı. POS ID ile birlikte 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 anahtarı; istekleri imzalamak ve sandbox bildirimlerini doğrulamak için kullanılır.

Canlı ve sandbox anahtarları farklıdır. Merchant ID ve POS ID yalnızca rakam içermelidir; geçerli modun Merchant ID, API key ve CRC key bilgileri girilene kadar ödeme yöntemi ödeme sayfasında gösterilmez. Bir modda başlatılan ödeme, mod değiştirilse bile her zaman o modun anahtarlarıyla doğrulanır ve iade edilir; bu nedenle eski modun ödemeleri hâlâ açıksa veya iade edilebilirse o modun anahtarlarını saklayın.

Ödeme bildirimleri

Bu bölüm mağazanızın bildirim URL'sini gösterir. Şuna benzer: https://your-site/wc-api/wc_p24_payment/. Eklenti bu URL'yi her ödemeyle birlikte Przelewy24'e gönderir; bu nedenle Przelewy24 panelinde bir şey yapılandırmanız gerekmez. Aynı URL, iade sonuçlarını da alır. URL internetten erişilebilir olmalıdır: önünde güvenlik duvarı, bakım modu veya HTTP kimlik doğrulaması olmamalıdır. Bildirim olmasa bile müşteri sipariş alındı sayfasına döndüğünde ödeme onaylanır (bkz. Ödeme sayfası); müşteri geri dönmezse sipariş «Ödeme bekleniyor» durumunda kalır.

Gelişmiş

Debug Log: Enable logging, teknik olayları (sipariş numaraları, P24 işlem kimlikleri, hatalar) WooCommerce > Status > Logs altına, kaynak wcp_przelewy24_payment olarak yazar. Hatalar ve uyarılar her zaman kaydedilir. Anahtarlar, istek gövdeleri ve kişisel veriler hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Siparişler ve ödeme verileri hiçbir zaman silinmez. Eklentiyi devre dışı bırakmak her şeyi korur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Przelewy24, Checkout bloğunda P24 logosuyla) ve siparişi verir. Sandbox modunda Checkout bloğu Sandbox mode — no real money is charged ifadesini gösterir. Eklenti, sipariş toplamı için sipariş para biriminde bir Przelewy24 işlemi kaydeder; müşterinin e-posta adresi, adı ve fatura ülkesiyle birlikte, ve siparişe oturum kimliği ile modu (sandbox veya canlı) içeren bir sipariş notu 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 sitenin dilinde, desteklemiyorsa İngilizce gösterilir.

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

Ödemeden sonra müşteri sipariş alındı sayfasına döner. Bildirim henüz gelmediyse eklenti, Przelewy24'e kimliği doğrulanmış sunucudan sunucuya bir istekle işlem durumunu sorar (sipariş başına en fazla 10 saniyede bir) ve aynı kontrolleri uygular. Dönüş sayfası tek başına bir siparişi asla ödenmiş olarak işaretlemez. Ödeme onaylanmadığı sürece sayfa, 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ı ve Pay for order sayfasını açan bir Pay again düğmesini gösterir. Sipariş Beklemede durumundaysa sayfa Your payment is being verified. We will send you an e-mail as soon as it is confirmed. mesajını gösterir. Aynı siparişin daha eski bir Przelewy24 sayfasından daha sonra yapılan bir ödeme yine de kabul edilir.

Ödeme başlatılamazsa müşteri 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 belirten bir mesaj veya The order total must be greater than zero. Zaten ödenmiş veya beklemede olan bir sipariş Przelewy24'e yeniden gönderilmez (This order does not need a payment any more.).

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

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

Siparişler ve iadeler

Sipariş durumları

Pending payment: Müşteri Przelewy24'e yönlendirildi ve henüz ödeme yapmadı ya da ödeme henüz onaylanmadı.

Processing or Completed: Ödeme doğrulandı. WooCommerce, yalnızca indirilebilir sanal ürün içeren siparişler için «İşleniyor» veya «Tamamlandı» durumunu ayarlar. Sipariş notunda P24 sipariş kimliği, tutar ve mod gösterilir. Siparişin işlem kimliği P24 sipariş kimliğidir. Her ödeme bir kez uygulanır.

On hold: Przelewy24'ün bildirdiği tutar veya para birimi siparişten farklı (örneğin ödeme başlatıldıktan sonra sipariş toplamı değiştirildi); ödeme onaylanmadı ve not bunu belirtir. Ya da ödeme geldi 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.

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

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Przelewy24 düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modda (sandbox veya canlı) gönderilir; bu nedenle o modun anahtarları ayarlanmış olmalıdır. Przelewy24 iadeleri eş zamansız işler: sipariş notu önce iadenin talep edildiğini gösterir; sonuç daha sonra bildirim URL'sine gelir ve not olarak eklenir: Przelewy24: refund of … completed. ya da iadenin reddedildiğini ve paranın geri ödenmediğini belirten bir not. İade reddedilirse Przelewy24 panelinde kontrol edin; siparişte zaten kayıtlı olan WooCommerce iadesi otomatik olarak silinmez.

Przelewy24 iade talebini kabul etmezse WooCommerce, nedeniyle birlikte Przelewy24 refund failed: mesajını gösterir ve hiçbir iade kaydedilmez. Doğrudan Przelewy24 panelinde yapılan iadeler siparişe eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Przelewy24 sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar aktif olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar yalnızca bir alan adında çalışır. Anahtarın bir siteden kaldırılması, o sitenin 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. Oturum açmış mağaza yöneticileri ödeme yöntemini, (unlicensed — visible to admins only) işaretiyle yine görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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 key ve CRC key bilgilerinin girildiğini (Test Mode açıkken sandbox anahtarları, aksi halde canlı 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. Geliştiriciler para birimi listesini wc_p24_supported_currencies filtresiyle değiştirebilir (yalnızca Przelewy24 hesabınızda etkin olan, iki ondalık basamağa sahip para birimleri).

Ödeme tamamlandı ama sipariş Pending payment durumunda kaldı: Przelewy24'ün bildirimi mağazanıza ulaşmadı ve müşteri sipariş alındı sayfasına geri dönmedi. Payment notifications altında gösterilen URL'nin internetten erişilebilir olduğunu (/wc-api/wc_p24_payment/ önünde bakım modu, güvenlik duvarı veya HTTP kimlik doğrulaması olmadığını) ve ödemenin modundaki Merchant ID, POS ID ve CRC key bilgilerinin doğru olduğunu kontrol edin. Reddedilen bildirimler, Debug Log kapalı olsa bile WooCommerce > Status > Logs altında, kaynak wcp_przelewy24_payment olarak kaydedilir.

Mağazanın bildirimlere yanıtı: işlenen, 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 ya da ödemeden farklı modun anahtarlarıyla imzalanmış bir bildirim), 405 (POST isteği değil), 500 Verification failed (Przelewy24 ile doğrulama başarısız oldu; siparişe bir kez not eklenir) ve 503 Busy, retry later (sipariş aynı anda başka bir istek tarafından güncelleniyordu).

Müşteri Payment error: Przelewy24 could not start the payment: mesajını görür: 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 hata mesajı günlükte yer alır.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu 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. mesajı, 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. (veya canlı için aynı mesaj), ödemenin modunun anahtarlarının kaldırıldığı anlamına gelir; anahtarları yeniden girin.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu ile dönüş sayfasının kısa ömürlü işaretleri her zaman kaldırılır. Eklentinin ayarları ve günlükleri (döndürülmüş olanlar dahil günlük dosyaları ve wcp_przelewy24_payment kaynağının veritabanı günlük kayıtları) yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, işlem kimliklerini ve Przelewy24 ödeme verilerini korur.

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