VibeFox PayU for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. Eklenti WooCommerce olmadan etkinleşmez; WooCommerce sonradan devre dışı bırakılırsa eklenti hiçbir işlem yapmaz ve yönetici alanında bir uyarı gösterir.

PHP: 8.0 veya üzeri.

Mağaza para birimi: PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH para birimlerinden biri. Para birimi ayrıca PayU'daki satış noktanız için etkinleştirilmiş olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Sitenize internet erişimi: PayU mağazanıza ödeme bildirimleri gönderir, bu nedenle sitenin internetten erişilebilir olması gerekir (HTTP kimlik doğrulaması veya bakım sayfası arkasında olmamalıdır). Bildirim olmasa bile müşteri PayU'dan döndüğünde siparişler kontrol edilir.

PayU hesabı: satış noktanızın (POS) dört anahtarına ihtiyacınız vardır: POS ID, Second key (MD5), OAuth client_id ve OAuth client_secret. Bunlar PayU satıcı panelinde Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys altında bulunur. Sandbox anahtarları ayrı bir PayU sandbox hesabından alınır.

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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_payu_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 > PayU > Manage yolunu izleyin veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üst kısmındaki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Dört Sandbox anahtarını ve dört Live anahtarını girin (bkz. Yapılandırma). PayU panelinde herhangi bir bildirim URL'si yapılandırmanız gerekmez.

6. Enable/Disable seçeneğini açın. Bir test ödemesi yapana kadar Test Mode seçeneğini açık bırakın, ardından Live anahtarlarıyla gerçek ödemeleri kabul etmek için bu seçeneğin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > PayU. Alanların üst kısmında sayfa; sandbox modu açıkken, geçerli modun dört anahtarından biri eksik olduğunda ve PayU mağaza para birimini kabul etmediğinde sizi uyarır. Son iki durumda PayU ödeme sayfasında gösterilmez.

PayU panelinden kopyalama sırasında sıkça boşluk ve satır sonu eklendiğinden, kaydetme sırasında tüm anahtarlardaki boşluklar ve satır sonları temizlenir.

Genel

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

Title: müşteriye gösterilen ödeme yöntemi başlığı. Varsayılan: PayU.

Description: müşteriye gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely via PayU.

API kimlik bilgileri

Anahtarları PayU satıcı panelinde bulun: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Sandbox anahtarları ayrı bir PayU sandbox hesabından alınır. Bir modun dört anahtarının tamamı doldurulmalıdır.

Test Mode: Enable sandbox (test) mode. PayU sandbox ortamını ve aşağıdaki Sandbox anahtarlarını kullanır. Gerçek para tahsil edilmez. Klasik ödeme sayfasında ve Ödeme bloğunda müşteri Sandbox mode — no real money is charged uyarısını görür. Live anahtarlarıyla gerçek ödemeleri kabul etmek için bu seçeneği kapatın. Varsayılan: açık.

Live POS ID: canlı satış noktanızın POS ID (merchantPosId) değeri.

Live Second Key (MD5): PayU bildirimlerinin imzasını doğrulamak için kullanılır.

Live OAuth Client ID: satış noktasının OAuth client_id değeri.

Live OAuth Client Secret: satış noktasının OAuth client_secret değeri.

Sandbox POS ID: PayU sandbox satış noktanızın POS ID değeri.

Sandbox Second Key (MD5): PayU sandbox bildirimlerinin imzasını doğrulamak için kullanılır.

Sandbox OAuth Client ID: sandbox satış noktasının OAuth client_id değeri.

Sandbox OAuth Client Secret: sandbox satış noktasının OAuth client_secret değeri.

Her ödeme kendi ortamını hatırlar. Bir ödemenin bildirimleri, durum kontrolleri ve iadeleri her zaman o ortamın anahtarlarını kullanır, böylece mod değiştirdikten sonra da eski ödemeler sorunsuz çalışmaya devam eder. Canlı bir ödeme için sandbox anahtarıyla imzalanmış bir bildirim asla kabul edilmez.

Ödeme bildirimleri

Bu bölüm, https://your-site/wc-api/wc_pu_payment/ biçimindeki bildirim URL'sini gösterir. Eklenti bunu her ödemeyle birlikte PayU'ya gönderir, bu nedenle PayU panelinde hiçbir yapılandırma gerekmez. İnternetten erişilebilir olduğundan (güvenlik duvarı, bakım modu veya HTTP kimlik doğrulaması tarafından engellenmediğinden) emin olun.

Gelişmiş

Receive payments automatically: Automatically receive payments waiting for confirmation. Bu ayar yalnızca PayU panelinde satış noktanız için otomatik tahsilat kapalıysa önem taşır: ödemeler onay bekler (WAITING_FOR_CONFIRMATION). Bu seçenek açıkken eklenti bu tür ödemeleri hemen tahsil eder. Kapalı olduğunda ilgili siparişler beklemeye alınır ve ödemeyi Receive PayU payment ile Cancel PayU payment sipariş işlemleriyle tahsil eder veya iptal edersiniz. Varsayılan: açık.

Logging: Enable logging teknik olayları (sipariş numaraları, PayU sipariş kimlikleri, durumlar, hatalar; anahtarlar veya kişisel veriler hariç) WooCommerce > Status > Logs bölümüne, kaynak wcp_payu_payment olarak yazar. 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 tüm verileri korur. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak PayU) ve siparişi verir. Eklenti, sipariş para biriminde sipariş toplamı için Order # açıklaması, sipariş numarası ve mağaza adınızla birlikte PayU sayfasında gösterilmek üzere sipariş kalemleri, kargo ve ücretleri içeren bir PayU siparişi oluşturur. PayU sayfasının dili, PayU destekliyorsa mağaza dilini, aksi takdirde İngilizceyi takip eder. Müşteri PayU ödeme sayfasına yönlendirilir, orada bir yöntem seçer ve ödemeyi yapar.

Her ödeme denemesi kendi PayU siparişini alır. Müşteri tekrar ödeme yaptığında (başarısız veya iptal edilen bir ödemeden sonra ya da Pay for order sayfasından), siparişin tamamlanmamış önceki PayU ödemesi PayU tarafında iptal edilir, böylece eski bir ödeme bağlantısı üzerinden iki kez ödeme yapılamaz.

Yalnızca mağazanıza geri dönülmesi siparişi hiçbir zaman ödenmiş saymaz. Sipariş ancak PayU onayladıktan sonra ödendi olarak işaretlenir: ödeme ortamının Second Key değeriyle imzalanmış bir bildirimle veya müşteri geri döndüğünde sunucuda yapılan PayU sipariş durumu kontrolüyle (bildirim geciktiğinde faydalıdır). PayU siparişi bu sipariş için oluşturulmuş olmalı, tutar ve para birimi eşleşmelidir. Eklenti şu PayU durumlarını işler:

Sipariş alındı sayfasında, sipariş hâlâ Ödeme bekleniyor durumundayken müşteri We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: mesajını ya da başarısız bir ödemenin ardından The payment was not completed. You can try again: mesajını görür; her ikisinde de Pay again düğmesi yer alır. Beklemeye alınan bir sipariş için mesaj şudur: Your payment is being verified. We will send you an e-mail as soon as it is confirmed.

PayU ödemeyi başlatamazsa müşteri Payment error. Please try again or choose another payment method. mesajını görür. Teknik neden (HTTP kodu ve PayU durumu) günlüğe ve PayU payment could not be started: sipariş notuna yazılır. Geçerli modun anahtarları eksikse mesaj Payment gateway is not configured properly. Please contact the administrator. şeklinde olur.

Ödeme yöntemi klasik ödeme sayfasında, Ödeme bloğunda ve Pay for order sayfasında çalışır. WooCommerce Yüksek Performanslı Sipariş Depolama (HPOS) ile uyumludur.

Müşteri ödeme yöntemini mağazanızın ödeme sayfasında değil, PayU sayfasında seçer. Eklenti mağazanızda kart formu, kayıtlı kartlar veya tek tıkla ödeme, abonelikler ve PayU taksit veya kredi bileşenleri içermez. Ortam başına bir satış noktası kullanır (para birimi başına satış noktası yoktur).

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri PayU'ya yönlendirildi ve henüz ödeme yapmadı. Sipariş notu PayU sipariş kimliğini ve ortamı (sandbox veya live) gösterir.

Processing: ödeme onaylandı. Sipariş notu PayU sipariş kimliğini, tutarı ve ortamı gösterir. İşlem kimliği, ödenen PayU sipariş kimliğidir. Yalnızca sanal ve indirilebilir ürünler içeren siparişler, WooCommerce'in varsayılan işleyişinde olduğu gibi Tamamlandı durumuna geçer.

On hold: ödenen tutar veya para birimi siparişle eşleşmedi, iptal edilmiş bir sipariş için ödeme tamamlandı veya bir ödeme onayınızı bekliyor (otomatik tahsilat kapalı ya da tahsilat başarısız oldu). Sipariş notu durumun ne olduğunu ve ne yapılması gerektiğini açıklar.

Failed: en son PayU ödemesi iptal edildi veya reddedildi. Müşteri tekrar ödeme yapmayı deneyebilir.

Her bildirim sipariş başına bir kilit altında bir kez işlenir: tekrarlanan bildirimler sipariş notu eklemez, stokları mükerrer düşürmez veya iki kez e-posta göndermez. Zaten ödenmiş veya iade edilmiş bir sipariş için başka bir ödeme tamamlanırsa bir not PayU panelinden iade etmenizi ister. Zaten ödenmiş veya kapatılmış bir siparişte onay bekleyen bir ödeme otomatik olarak iptal edilir, böylece para iki kez tahsil edilmez.

Onay bekleyen ödemeler

Onay bekleyen bir ödemesi bulunan ödenmemiş bir sipariş için sipariş ekranı iki sipariş işlemi sunar: Receive PayU payment (waiting for confirmation) ve Cancel PayU payment (release the funds). Birini seçin ve güncelle düğmesine tıklayın. İşlem, kullanıcı adınızla birlikte sipariş notlarına eklenir ve yeni PayU durumu hemen uygulanır.

İadeler

Siparişi açın, Refund seçeneğine tıklayın, tutarı girin ve Refund via PayU düğmesine tıklayın (düğmede Title bilginiz görünür). Tam ve kısmi iadeler desteklenir. İade, fiilen ödenen PayU siparişi için ödemenin yapıldığı ortamın anahtarlarıyla gönderilir, bu nedenle o anahtarların tanımlanmış olması gerekir. İade nedeni, iade açıklaması olarak iletilir. PayU iadeyi reddederse WooCommerce PayU'nun hatasını gösterir ve hiçbir iade kaydedilmez.

PayU'da iadeler eşzamansızdır (asenkron). Eklenti derhal PayU iade kimliğini ve durumunu içeren bir not ekler; nihai durum daha sonra bir PayU bildirimi olarak ulaşır ve not olarak kaydedilir. PayU bir iadeyi iptal ederse not, paranın müşteriye geri ödenmediğini belirtir.

Tutar veya para birimi uyuşmazlığı nedeniyle beklemeye alınan siparişler, PayU sipariş kimliğini işlem kimliği olarak korur, böylece ödeme hem WooCommerce üzerinden hem de PayU panelinden iade edilebilir.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > PayU sayfasının en üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm lisans durumunu; örneğin lisansın hangi tarihe kadar geçerli olduğunu ve alan adınızı gösterir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa PayU ödeme sayfasında müşterilere gösterilmez. Ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Giriş yapmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) ibaresiyle görmeye devam eder, böylece bir anahtar satın almadan önce eklentiyi yapılandırabilir ve test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatıcı görünür. Mevcut siparişler etkilenmez: önceden başlatılmış ödemeler 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 arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

PayU ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun dört anahtarının tamamının doldurulduğunu kontrol edin: sandbox modunda Sandbox anahtarları, canlı modda Live anahtarları. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) desteklenen para birimlerinden biri olduğunu doğrulayın. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Ödeme bekleniyor durumunda: PayU henüz bildirimi teslim etmemiştir ve geri dönüş sayfasındaki durum kontrolü tamamlanmış bir ödeme tespit etmemiştir. Ayarlarda gösterilen bildirim URL'sinin internetten erişilebilir olduğunu kontrol edin. Gelen verileri görmek için Logging seçeneğini açın.

Bildirim Invalid signature yanıtı veriyor: bildirim iki ortamın da Second Key değeriyle imzalanmamıştır. Live Second Key (MD5) ve Sandbox Second Key (MD5) değerlerini kontrol edin. Invalid signature for this payment yanıtı, bildirimin ödemenin yapıldığı ortamdan farklı bir ortamın anahtarıyla imzalandığı anlamına gelir.

Bildirim Ignored yanıtı veriyor: PayU siparişi, bu mağazanın PayU ile ödenmiş bir siparişine ait değildir (örneğin aynı satış noktasındaki başka bir mağazaya aittir). PayU yeniden denemeyi durdurur.

Ödeme oluşturulmuyor: Logging seçeneğini açın ve WooCommerce > Status > Logs altındaki wcp_payu_payment kaynağına bakın. Günlük HTTP kodunu ve PayU durumunu gösterir. Could not authenticate with PayU (check the OAuth client ID / secret). uyarısı, geçerli modun OAuth anahtarlarının yanlış olduğu anlamına gelir.

Sipariş Beklemede durumunda: sipariş notunu okuyun. Neden; tutar veya para birimi uyuşmazlığı, iptal sonrası bir ödeme ya da onay bekleyen bir ödemedir. Son durum için Receive PayU payment veya Cancel PayU payment sipariş işlemlerini kullanın.

İade başarısız oluyor: This order has no completed PayU payment. Cannot process refund. uyarısı, siparişte ödenmiş bir PayU siparişi bulunmadığı anlamına gelir. Sandbox veya Live anahtarlarının eksik olduğuna dair bir mesaj, ödemenin o ortamda yapıldığını ve ortam anahtarlarının tanımlanmadığını gösterir. Bunları girip tekrar deneyin.

Diğer para birimleri: geliştiriciler para birimi listesini wc_pu_supported_currencies filtresiyle, ödeme sayfası simgesini ise wc_pu_icon filtresiyle değiştirebilir.

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

Kaldırma

Eklentiyi devre dışı bırakmak tüm ayarları korur; yalnızca önbelleğe alınmış PayU erişim jetonları silinir. Eklentiyi kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu, önbelleğe alınan jetonlarla birlikte her zaman kaldırılır. Ağ geçidi ayarları ve bu eklentinin günlüğü yalnızca Delete data on uninstall seçeneği açıksa kaldırılır. Aksi takdirde daha sonra yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, PayU sipariş kimliklerini ve işlem kimliklerini korur.

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