VibeFox PayU for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 - 9.x.

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

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

Mağazanıza internet erişimi: PayU, ödeme bildirimlerini mağazanıza gönderir; bu nedenle mağazanız internetten erişilebilir olmalıdır (HTTP kimlik doğrulaması veya güvenlik duvarı arkasında olmamalıdır). Bildirimler olmasa bile müşteri PayU'dan döndüğünde ödemeler 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 yolunda bulabilirsiniz. Sandbox anahtarları ayrı bir PayU sandbox hesabından gelir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. Back office'te 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 daha sonra modül listesinde VibeFox PayU Payment modülünü bulup Configure düğmesine tıklayın.

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

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

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test ödemesi yapana kadar Test Mode açık kalsın; ardından gerçek ödemeleri Live anahtarlarıyla kabul etmek için kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Awaiting PayU payment confirmation ve PayU payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için kullanıma sunar. Bunları Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox PayU 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 sayfa; sandbox modu açıkken (Sandbox (test) modu açık: ödemeler PayU sandbox'a gider ve gerçek para tahsil edilmez. Test modunda ödenmiş siparişleri göndermeyin.), geçerli moddaki dört anahtardan biri eksikken ve PayU mağazanın varsayılan para birimini kabul etmediğinde sizi uyarır. Son iki durumda PayU ödeme sayfasında gösterilmez.

Kaydettiğinizde tüm anahtarlardaki boşluklar ve satır sonları kaldırılır; çünkü PayU panelinden kopyalama sırasında bunlar sık sık eklenir. Boş bir Title kaydedilmez: sayfa Ödeme yöntemi için bir başlık girin. mesajını gösterir.

PayU

Enable/Disable: Enable PayU payment gateway ödeme seçeneğini açar veya kapatır. Varsayılan: kapalı.

Title: müşteriye gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: PayU. Zorunlu.

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

API kimlik bilgileri

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

Test Mode: PayU sandbox'ı ve aşağıdaki Sandbox anahtarlarını kullanır. Gerçek para tahsil edilmez. Açıkken müşteriler ödeme seçeneğinin altında Sandbox modu: gerçek bir ödeme alınmaz. ifadesini görür. Gerçek ödemeleri Live anahtarlarıyla kabul etmek için kapatın. Varsayılan: açık.

Live POS ID: üretim satış noktanızın POS ID'si (merchantPosId).

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'si.

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.

Kaydedilmiş Second Key'ler ve client secret'lar bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. yazar. Yalnızca değiştirmek istediğinizde yeni bir değer girin. POS ID'ler ve client ID'ler kayıtlı olduğu gibi gösterilir.

Clear saved secrets: bir gizli anahtarı işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan kayıtlı değeri korur.

Her ödeme kendi ortamını hatırlar. Bir ödemenin bildirimleri, durum kontrolleri ve iadeleri her zaman o ortamın anahtarlarını kullanır; bu nedenle mod değiştirdikten sonra da eski ödemeler çalışmaya devam eder. Sandbox anahtarıyla imzalanmış bir bildirim, canlı bir ödeme için asla kabul edilmez; tersi de geçerlidir.

Ödeme bildirimleri

Notification URL: PayU'nun bildirim gönderdiği adresi gösterir. Dostça URL'lerle şu biçimde görünür: https://your-shop/module/wcp_payu_payment/webhook, başında bir dil kodu olabilir. Modül bu adresi her ödemeyle birlikte PayU'ya gönderir; bu nedenle PayU panelinde bir şey yapılandırmanız gerekmez. Adresin internetten erişilebilir olduğundan emin olun (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemeli). Bildirimler mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Gelişmiş

Receive payments automatically: onay bekleyen ödemeleri otomatik olarak tahsil eder. Bu yalnızca PayU panelinde satış noktanız için otomatik tahsilat kapalıysa önemlidir: ödemeler o zaman onay bekler (WAITING_FOR_CONFIRMATION). Bu seçenek açıkken modül bu tür ödemeleri hemen tahsil eder ve PayU ödemeyi tamamlandı olarak bildirdiğinde sipariş oluşturulur. Kapalıysa veya tahsilat başarısız olursa sipariş Awaiting PayU payment confirmation durumunda oluşturulur ve ödemeyi siparişin PayU bloğundaki düğmelerle tahsil eder veya iptal edersiniz. Varsayılan: açık.

Logging: teknik olayları (sepet ve sipariş numaraları, PayU sipariş kimlikleri, durumlar, hatalar; anahtar veya kişisel veri yok) modül klasöründeki logs/wc_pu_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir; diğer olaylar yalnızca bu seçenek açıkken kaydedilir. 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: modül kaldırıldığında modül ayarlarını ve günlükleri siler. Siparişler ve ödeme verileri (PayU işlemleri, iadeler, sipariş durumları) asla silinmez. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme seçeneğini seçer (varsayılan olarak PayU) ve açıklamayı ile Ödemeyi tamamlamak için PayU'ya yönlendirileceksiniz (BLIK, banka havalesi, kart ve diğer yöntemler). notunu görür. Onaylandıktan sonra modül, sepet tutarı için sepet para biriminde bir PayU siparişi oluşturur; açıklama Cart #, sepet numarası ve mağaza adınızdan oluşur. PayU sayfasında gösterilmek üzere ürünler, kargo ve hediye paketi de iletilir. Müşterinin e-posta adresi, adı ve telefonu PayU'ya iletilir. PayU sayfasının dili, PayU destekliyorsa mağaza dilini izler; aksi halde İngilizce kullanılır. Müşteri PayU sayfasına yönlendirilir, orada bir yöntem seçip öder. Bu aşamada henüz bir sipariş yoktur.

Her ödeme denemesi kendi PayU siparişini alır. Müşteri yeniden denediğinde, sepetin önceki tamamlanmamış PayU ödemesi PayU'da iptal edilir; böylece eski bir ödeme bağlantısı iki kez ödenemez. Önceki ödeme zaten ödenmiş çıkarsa, yeni bir ödeme yerine sipariş oluşturulur.

Yalnızca mağazanıza geri dönmek hiçbir siparişi ödenmiş yapmaz. Sipariş, PayU onaylayana kadar ödenmiş olarak işaretlenmez: ödemenin ortamının Second Key değeriyle imzalanmış bir bildirim ile ya da müşteri geri döndüğünde PayU siparişinin sunucu tarafında durum kontrolüyle (sepet başına en fazla 10 saniyede bir). PayU siparişi bu sepet için oluşturulmuş olmalı, tutar ve para birimi eşleşmelidir. Modül şu PayU durumlarını işler:

Onaylanmış bir ödemeden sonra müşteri standart sipariş onay sayfasını görür. Onay bekleyen veya beklemede olan bir sipariş için sayfa şu notu ekler: Ödemeniz doğrulanıyor. Onaylandığında size e-posta göndereceğiz. Böyle bir siparişin ödemesi daha sonra iptal edilirse sayfa şunu gösterir: PayU ödemeniz tamamlanmadı. Bu sipariş hakkında bizimle iletişime geçin.

Müşteri döndüğünde PayU ödemeyi henüz onaylamamışsa, Payment confirmation sayfası şunu gösterir: PayU'dan ödeme onayını henüz almadık. Ödeme kesintiye uğradıysa tekrar deneyebilirsiniz: (veya PayU bir hata bildirdiyse, Ödeme tamamlanmadı. Tekrar deneyebilirsiniz:) ve Pay again ile Check again düğmeleriyle. Bildirim ulaştığı anda sipariş oluşturulur. Ödeme iptal edildiyse müşteri Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. mesajıyla ödeme sayfasına döner. Sepet korunur.

PayU ödemeyi başlatamazsa müşteri ödeme sayfasında kalır ve Ödeme hatası. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajını görür. Teknik neden günlüğe yazılır. Geçerli moddaki anahtarlar eksikse mesaj Ödeme ağ geçidi düzgün yapılandırılmamış. Lütfen yöneticiyle iletişime geçin. olur.

Ödeme ile onayı arasında sepetteki bir kupon geçerliliğini yitirirse siparişten kaldırılır. Sipariş bu durumda, müşteri indirimli fiyatı ödediği için kuponu belirten bir notla PayU payment on hold durumuna geçer.

Müşteri ödeme yöntemini ödeme sayfanızda değil, PayU sayfasında seçer. Modülün mağazanızda kart formu, kayıtlı kart veya tek tıkla ödeme, abonelik ve PayU taksit ya da kredi bileşeni yoktur. Ortam başına tek bir satış noktası kullanır.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: müşteri PayU'ya yönlendirildi ve ödeme yapmadı ya da PayU henüz ödemeyi onaylamadı. Yalnızca sepet mevcut.

Payment accepted: ödeme onaylandı. Ödeme, PayU sipariş kimliği işlem kimliği olarak kaydedilir ve bir notta PayU sipariş kimliği, tutar ve ortam (sandbox veya live) gösterilir.

Awaiting PayU payment confirmation: ödeme yetkilendirildi ve sizin işleminizi bekliyor (otomatik tahsilat kapalı veya tahsilat başarısız). Henüz hiçbir ödeme kaydedilmedi.

PayU payment on hold: ödenen tutar veya para birimi sepetle eşleşmedi (sipariş ödenmiş olarak işaretlenmez), bir kupon kaldırıldı, onay bekleyen bir ödemenin tutarı farklıydı ya da iptal edilmiş bir sipariş için ödeme tamamlandı (ödeme kaydedilir). Not hangisinin geçerli olduğunu belirtir. Siparişi kontrol edip işleme alın ya da ödemeyi iade edin.

Payment error: onay bekleyen bir siparişin ödemesi iptal edildi veya reddedildi.

Refunded: ödeme modül aracılığıyla tamamen iade edildi.

Her bildirim bir kez işlenir: tekrarlanan bildirimler not eklemez ve siparişi yeniden değiştirmez. Zaten ödenmiş veya iade edilmiş bir sipariş için başka bir ödeme tamamlanırsa, bir not sizden bunu PayU panelinde iade etmenizi ister. Zaten ödenmiş veya kapatılmış bir siparişte onay bekleyen bir ödeme otomatik olarak iptal edilir; böylece para iki kez alınmaz.

PayU ödeme bloğu

Sipariş sayfasında PayU sipariş kimliği, extOrderId, PayU durumu, ödenen ve iade edilen tutar, sandbox ödemeleri için bir Sandbox rozeti, iade geçmişi ve siparişin PayU notes bölümü bulunan bir PayU payment bloğu gösterilir. Bloğun işlemleri sipariş düzenleme yetkisi gerektirir; Modüller sayfalarına erişim gerekmez.

Onay bekleyen ödemeler

Onay bekleyen bir ödemesi olan siparişte blok Receive PayU payment (waiting for confirmation) ve Cancel PayU payment (release the funds) gösterir. Soruyu onayladıktan sonra işlem, ödemenin ortamının anahtarlarıyla PayU'ya gönderilir, adınızla birlikte notlara eklenir ve yeni PayU durumu hemen uygulanır: tahsil edilen bir ödeme siparişi Payment accepted, iptal edilen bir ödeme ise Payment error durumuna alır.

İadeler

PayU payment bloğunda tutarı girin (henüz iade edilmemiş tutar doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via PayU düğmesine tıklayın. Bu tutar PayU üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İade, gerçekten ödenmiş olan PayU siparişi için ve ödemenin ortamının anahtarlarıyla gönderilir; bu nedenle bu anahtarların ayarlanmış olması gerekir. İadeler PayU'nun tahsil ettiği tutar ve para biriminde yapılır; dolayısıyla tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. Neden, iade açıklaması olarak gönderilir. PayU iadeyi reddederse blok PayU'nun hatasını gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna alır. Kısmi iade durumu değiştirmez.

PayU'da iadeler eşzamansızdır. Modül hemen PayU iade kimliği ve durumu ile bir not ekler; nihai durum daha sonra bir PayU bildirimi olarak gelir ve notlara ile iade geçmişine eklenir. PayU bir iadeyi iptal ederse not, paranın müşteriye geri iade edilmediğini belirtir ve tutar yeniden iade edilebilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri PayU üzerinden para göndermez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox PayU Payment, Modules > Module Manager > VibeFox PayU Payment > Configure sayfasında ayarların üstünde yer alan 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 tarihi 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-payu 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 back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. 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ızdan serbest bırakın.

Etkin bir anahtar olmadan PayU, ö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 back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler bildirimlerle onaylanmaya devam eder ve iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün bir kez, sonra 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

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 da doldurulduğunu kontrol edin: sandbox modunda Sandbox anahtarları, live modunda Live anahtarları. Sepet para biriminin desteklenen para birimlerinden biri olduğunu kontrol edin. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin. Ayarlar sayfası, anahtarlar eksik olduğunda veya mağaza para birimi desteklenmediğinde uyarı gösterir.

Ödeme gerçekleşti ama sipariş oluşturulmadı: PayU henüz bildirimi iletmedi ve dönüş sayfasındaki durum kontrolü tamamlanmış bir ödeme görmedi. Ayarlarda gösterilen Notification URL'nin internetten erişilebilir olduğunu kontrol edin. Neyin geldiğini görmek için Logging seçeneğini açın. Müşteri ayrıca Payment confirmation sayfasında Check again düğmesine tıklayabilir.

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

Bildirim Ignored: unknown PayU order yanıtı veriyor: PayU siparişi bu mağaza tarafından oluşturulmamış; örneğin aynı POS üzerindeki başka bir mağaza. PayU yeniden denemeyi durdurur.

Bildirim Busy, retry later yanıtı veriyor: sepet o sırada başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). PayU bildirimi tekrarlar. Nedenini görmek için Logging seçeneğini açın.

Notification URL tarayıcıda POST expected gösteriyor: bu normaldir. URL yalnızca PayU'dan gelen bildirimleri kabul eder.

Müşteri PayU'yu seçerken Payment error görüyor: Logging seçeneğini açın ve modül sayfasındaki Log alanına bakın. Günlük HTTP kodunu ve PayU durumunu gösterir. PayU ile kimlik doğrulaması yapılamadı (OAuth client ID / secret değerlerini kontrol edin). mesajı, geçerli moddaki OAuth anahtarlarının yanlış olduğu anlamına gelir.

Sipariş PayU payment on hold durumunda: PayU payment bloğundaki notları okuyun (bkz. Sipariş durumları), ardından siparişi işleme alın veya ödemeyi iade edin.

Sipariş Awaiting PayU payment confirmation durumunda: satış noktanız için otomatik tahsilat kapalı ve ödeme sizi bekliyor. PayU bloğundaki Receive PayU payment veya Cancel PayU payment düğmesini kullanın.

İade başarısız: Bu siparişin tamamlanmış bir PayU ödemesi yok. İade işlenemiyor. PayU'nun siparişle ilgili henüz bir ödemeyi tamamlamadığı anlamına gelir. Sandbox veya Live anahtarlarının eksik olduğu yönünde bir mesaj, ödemenin o ortamda yapıldığını ve anahtarlarının ayarlanmadığını gösterir. Anahtarları girin ve tekrar deneyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PayU 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 kaldırılır. Önbelleğe alınmış PayU erişim belirteçleri her zaman kaldırılır. 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. PayU işlemleri ve iadeleri ile Awaiting PayU payment confirmation ve PayU payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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