VibeFox PayU 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, cURL uzantısı ile birlikte.

Para birimi: müşterinin ödeme para birimi şunlardan biri olmalıdır: PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. Para birimi ayrıca PayU'daki satış noktanız için etkinleştirilmiş olmalıdır. Diğer para birimleri için ödeme yöntemi ödeme sayfasında gösterilmez.

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 yine de 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 bulunur. Sandbox anahtarları ayrı bir PayU sandbox hesabından gelir.

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

Kurulum

İndirme, 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_payu_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_payu_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_payu_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, bu paketin 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 PayU Payment öğesini 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 bulunan License key alanına yapıştırın 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 bir 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 seçeneğini açık bırakın; ardından gerçek ödemeleri Live anahtarlarıyla kabul etmek için kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_payu_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir paket çalışmaz.

2. Paket, aynı sayfadaki yüklü eklentiler 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 türü Payments olarak seçin. VibeFox PayU Payment eklentisini bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve PayU 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 PayU Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, sandbox modu açıkken sizi uyarır (Sandbox (test) modu açık: ödemeler PayU sandbox'ına gider ve gerçek para tahsil edilmez. Test modunda ödenen siparişleri göndermeyin.); geçerli modun dört anahtarından biri eksikse (bu durumda PayU ödeme sayfasında gösterilmez) ve PayU mağazanın varsayılan para birimini kabul etmiyorsa (bu durumda PayU o para birimindeki siparişler için gizlenir) da uyarır. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydettiğinizde, PayU panelinden kopyalama sırasında sıklıkla eklenen boşluklar ve satır sonları tüm anahtarlardan silinir. Title boş olamaz ve 128 karakterden uzun olamaz (sayfa Enter a title for the payment method (at most 128 characters). uyarısını gösterir), Sort Order tam sayı olmalıdır (negatif sayılar kabul edilir), Total 0 veya daha büyük bir sayı olmalıdır ve bölge (geo zone) ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez. Ayarları kaydetmek, önbelleğe alınmış PayU erişim jetonlarını da temizler.

PayU

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

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

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: Pay securely via PayU.

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

Geo Zone: PayU'yu yalnızca seçilen bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: PayU'nun sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. PayU'yu her tutarda sunmak için boş bırakın.

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 gelir. Bir modun dört anahtarının tamamı doldurulmalıdır. Bölüm, PayU geliştirici belgelerine bağlantılar içerir.

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

Live POS ID: üretim 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.

Kaydedilmiş Second Key'ler ve client secret'lar 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. POS ID'ler ve client ID'ler kaydedildikleri şekilde gösterilir.

Clear saved secrets: bir gizli bilgiyi 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. Bildirimler, durum sorgulamaları, bir ödemenin alınması veya iptal edilmesi ve iadeler 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, gerçek bir ödeme için asla kabul edilmez; bunun tersi de geçerlidir.

Sipariş durumları

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, PayU ödemeyi imzalı bir bildirimle veya müşteri döndüğünde yapılan durum sorgulamasıyla onayladıktan sonra bir durum alır. OpenCart'ta On hold durumu yoktur: bekleme durumları varsayılan olarak Pending olur ve siparişin PayU sekmesi ile notları nedenini açıklar. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler; System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilirsiniz.

Order Status After Payment: PayU ödemeyi onayladığında (COMPLETED) ve tutar ile para birimi eşleştiğinde ayarlanır. Varsayılan: Processing.

Awaiting PayU Payment Confirmation: ödeme yetkilendirilmiştir ve tahsil edilmeyi bekler (otomatik tahsilat kapalı veya başarısız). Siparişin PayU sekmesindeki Receive PayU payment veya Cancel PayU payment düğmelerini kullanın. Varsayılan: Pending.

PayU Payment On Hold: ödenen tutar veya para birimi siparişle eşleşmiyor ya da iptal edilmiş bir sipariş için ödeme tamamlandı. Sipariş ödenmiş olarak işaretlenmez; not nedenini açıklar. Varsayılan: Pending.

Payment Error Status: onay bekleyen bir siparişin ödemesi iptal edildi veya reddedildi. Varsayılan: Failed.

Cancelled Order Status: bu durumdaki bir sipariş için tamamlanan bir PayU ödemesi, siparişi sessizce yeniden açmak yerine bekleme durumuna alır. Eklenti bu durumu asla ayarlamaz. Varsayılan: Canceled.

Refunded Status: ödeme, siparişin PayU sekmesinden tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Ödeme bildirimleri

Notification URL: PayU'nun bildirimleri gönderdiği adresi gösterir. OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_payu_payment/notify, OpenCart 4'te https://your-store/index.php?route=extension/wcp_payu_payment/payment/wcp_payu_payment.notify biçimindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Eklenti bunu her ödemede PayU'ya gönderir; bu yüzden PayU panelinde bir şey yapılandırmanız gerekmez. İnternetten erişilebilir olduğundan emin olun (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemeli). Mağaza bakım modundayken de bildirimler çalışır (OpenCart 4'te bunun için eklentinin başlangıç eylemi kullanılır; bu eylem müşterinin PayU'dan dönüşüne de izin verir). Geçerli imzası olmayan bildirimler reddedilir.

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 onay bekler (WAITING_FOR_CONFIRMATION). Bu seçenek açıkken eklenti bu ödemeleri hemen tahsil eder ve PayU ödemenin tamamlandığını bildirdiğinde sipariş ödenmiş durumunu alır. Kapalıysa veya tahsilat başarısız olursa sipariş Awaiting PayU Payment Confirmation durumunu alır ve ödemeyi siparişin PayU sekmesindeki düğmelerle tahsil edersiniz veya iptal edersiniz. Varsayılan: açık.

Logging: teknik olayları (sipariş numaraları, PayU sipariş kimlikleri, durumlar, hatalar; anahtar veya kişisel veri yok) OpenCart günlük klasöründeki (storage/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 en son girişlerini gösterir. Temizlemek 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 ödeme verileri (PayU işlemleri ve iadeler) asla silinmez. Önbelleğe alınmış PayU erişim jetonları her zaman kaldırılır. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Gizli bilgiler 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. Kayıtlı gizli bilgiler korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayU). Confirm Order adımında müşteri açıklamanızı ve Ödemeyi tamamlamak için PayU'ya yönlendirileceksiniz (BLIK, banka havalesi, kart ve diğer yöntemler). notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemini ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde sipariş toplamı için bir PayU siparişi oluşturur; açıklama olarak Order #, sipariş numarası ve mağaza adınız kullanılır; PayU sayfasında gösterilmek üzere ürünler, kargo yöntemi ve siparişin diğer toplam satırları da eklenir. Müşterinin e-posta adresi, adı ve telefonu PayU'ya iletilir; PayU sayfasının dili mağaza dilini izler. Müşteri PayU sayfasına yönlendirilir, orada bir yöntem seçer ve öder.

Her deneme kendi PayU siparişini alır. Müşteri yeniden denediğinde (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur, OpenCart 4 ise ödeme sayfasındaki siparişi günceller), aynı siparişe ve aynı sepete ait önceki denemelerin tamamlanmamış PayU ödemeleri PayU'da iptal edilir; böylece eski bir ödeme bağlantısı iki kez ödenemez. Önceki bir ödemenin zaten ödendiği anlaşılırsa o ödeme yerine geçerli sayılır; zaten ödenmiş, PayU'da bekleyen veya onay bekleyen bir sipariş ya da sepet, ikinci bir ödeme olmadan doğrudan başarı sayfasına gider. Sepette yapılan her değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

Müşterinin mağazanıza geri dönmesi tek başına bir siparişi asla ödemez. Sipariş, PayU onaylayana kadar ödenmiş olarak işaretlenmez: ödemenin ortamının Second Key'i ile imzalanmış bir bildirimle veya müşteri döndüğünde sunucuda yapılan PayU sipariş durumu sorgulamasıyla (ödeme başına en fazla 10 saniyede bir). Tutar ve para birimi eşleşmelidir. Sipariş bundan sonra OpenCart'ın standart yoluyla durum alır; olağan sipariş e-postaları gönderilir ve stok güncellenir. Eklenti şu PayU durumlarını işler:

Onaylanan bir ödemeden sonra müşteri OpenCart sipariş başarı sayfasını görür. Onay bekleyen veya bekleme durumundaki bir sipariş için sayfa Ödemeniz doğrulanıyor. Onaylandığında size bir e-posta göndereceğiz. mesajını ekler. Böyle bir sipariş daha sonra ödenirse veya ödemesi başarısız olursa OpenCart müşteriye yeni durumu bildirir. Siparişin ödemesi başarısız olduysa sayfa PayU ödemeniz tamamlanmadı. Bu sipariş hakkında lütfen bizimle iletişime geçin. mesajını gösterir.

Müşteri döndüğünde PayU ödemeyi henüz onaylamadıysa Payment confirmation sayfası PayU'dan henüz ödeme onayı alınmadı. Ödeme kesintiye uğradıysa tekrar deneyebilirsiniz: mesajını (veya PayU bir hata bildirdiyse Ödeme tamamlanmadı. Tekrar deneyebilirsiniz: mesajını) Pay again (ödeme sayfasına dön) ve Check again düğmeleriyle gösterir. Bildirim geldiği anda sipariş durumunu ayarlar. Ö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. OpenCart 4'te bu mesaj ödeme sayfasının üstünde gösterilir.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar. Bu sipariş bu arada ödeme yapılmadan kapatılmışsa (örneğin onay bekleyen ödemesi iptal edildiyse ya da siz iptal edip iade ettiyseniz), müşteri Önceki siparişiniz kapatıldı (ödenmedi, iptal edildi veya iade edildi). Yeni bir siparişle ödeme yapmak için lütfen siparişi yeniden onaylayın. mesajıyla ödeme adımına geri döner. Müşteri PayU'dan, ödeme yapılmadan kapatılmış bir siparişe döndüğünde mesaj: Ödeme tamamlanmadı. Tekrar deneyebilir veya başka bir ödeme yöntemi seçebilirsiniz. Bu sipariş daha önceki bir sepet için zaten ödenmişse ve sepet o zamandan beri değiştiyse, müşteri ödeme adımına geri yönlendirilir. Her durumda bir sonraki Confirm Order mevcut sepetin yeni siparişi için ödeme yapar. Kapatılmış bir sipariş asla ödenmiş gibi gösterilmez.

PayU ödemeyi başlatamazsa müşteri Confirm Order adımı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 modun anahtarları eksikse mesaj Ödeme ağ geçidi düzgün yapılandırılmamış. Lütfen yöneticiyle iletişime geçin. olur.

Müşteri ödeme yöntemini sizin ödeme sayfanızda değil, PayU sayfasında seçer. Eklentinin sitenizde kart formu, kayıtlı kart veya tek tıkla ödeme, abonelik ve PayU taksit ya da kredi bileşenleri yoktur. Her ortam için bir satış noktası kullanır.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri PayU'ya yönlendirildi ve ödeme yapmadı, ödeme iptal edildi veya PayU ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): ödeme onaylandı. Bir not PayU sipariş kimliğini, tutarı ve ortamı (sandbox veya live) gösterir.

Awaiting PayU Payment Confirmation (varsayılan Pending): ödeme yetkilendirildi ve sizin işleminizi bekliyor (otomatik tahsilat kapalı veya tahsilat başarısız).

PayU Payment On Hold (varsayılan Pending): ödenen tutar veya para birimi siparişle eşleşmedi, onay bekleyen bir ödemenin tutarı farklıydı ya da iptal edilmiş bir sipariş için ödeme tamamlandı. Not hangisinin geçerli olduğunu belirtir. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Payment Error Status (varsayılan Failed): onay bekleyen bir siparişin ödemesi iptal edildi veya reddedildi.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden 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 ya da zaten ödenmiş bir sepetin başka bir siparişi için başka bir ödeme tamamlanırsa, ödenmiş siparişteki bir not sizden PayU panelinde iade etmenizi ister. Zaten ödenmiş veya kapatılmış bir sipariş için onay bekleyen bir ödeme otomatik olarak iptal edilir; böylece para iki kez tahsil edilmez.

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

VibeFox PayU Payment sekmesi

Sales > Orders bölümünde PayU ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox PayU Payment sekmesi, sandbox ödemeleri için Sandbox etiketiyle birlikte PayU order ID'yi, extOrderId'yi, PayU status'u, Payment amount'u, Paid / refunded tutarlarını, iade formunu, Refunds geçmişini, siparişin PayU payment attempts kayıtlarını ve PayU notes alanını gösterir. Sekme eklentiye erişimi olan kullanıcılara gösterilir; sekmedeki işlemler eklentiyi değiştirme iznini gerektirir (System > Users > User Groups bölümünde ayarlanır).

Onay bekleyen ödemeler

Onay bekleyen bir ödemesi olan siparişte sekme Receive PayU payment ve Cancel PayU payment düğmelerini gösterir. Soruyu onayladıktan sonra işlem, ödemenin ortamının anahtarlarıyla PayU'ya gönderilir, kullanıcı adınızla birlikte notlara eklenir ve yeni PayU durumu hemen uygulanır: alınan bir ödeme Order Status After Payment'ı, iptal edilen bir ödeme ise Payment Error Status'u ayarlar.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz Reason (optional) alanını doldurun ve Refund via PayU düğmesine tıklayın. Refund this amount through PayU? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. İadeler, PayU ödemeyi tamamladıktan sonra kullanılabilir. İade, gerçekten ödenmiş PayU siparişi için ö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; bu nedenle 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 sekme PayU'nun hatasını gösterir ve hiçbir iade kaydedilmez. Tam iade, siparişi Refunded Status durumuna getirir; müşteriye bildirilmez ve ürünler stoğa geri eklenmez. Kısmi iade durumu değiştirmez.

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

Sales > Returns bölümündeki ürün iadeleri PayU üzerinden para göndermez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayU Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox PayU Payment > Edit sayfasında, ayarların üstünde ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskeli 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: opencart-payment-payu satırı ve hesabınızda, 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önetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten 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 eklenti bilinen son 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 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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine bildirimlerle onaylanır ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, yönetici Dashboard veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman 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 doldurulduğunu kontrol edin: sandbox modunda Sandbox anahtarları, live modunda Live anahtarları. Müşterinin para biriminin desteklenenlerden biri olduğunu, ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin. Ayarlar sayfası, anahtarlar eksikse veya mağaza para birimi desteklenmiyorsa uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş durumsuz kaldı: PayU henüz bildirimi iletmedi ve dönüş sayfasındaki durum sorgusu tamamlanmış bir ödeme görmedi. Ayarlarda gösterilen bildirim URL'sinin internetten erişilebilir olduğunu kontrol edin. Ne 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 ortamın da Second Key'i ile imzalanmamış. Live Second Key (MD5) ve Sandbox Second Key (MD5) alanlarını 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ı satış noktasındaki başka bir mağaza. PayU yeniden denemeyi durdurur.

Bildirim Busy, retry later yanıtı veriyor: sepet aynı anda başka bir istek tarafından onaylanıyordu. PayU bildirimi tekrarlar. Nedenini görmek için Logging seçeneğini açın.

Bildirim URL'si tarayıcıda POST expected gösteriyor: bu normaldir. URL yalnızca PayU bildirimlerini kabul eder.

Müşteri Confirm Order sonrasında Payment error görüyor: Logging seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Günlük HTTP kodunu ve PayU durumunu gösterir. Could not authenticate with PayU (check the OAuth client ID / secret). geçerli modun OAuth anahtarlarının yanlış olduğu anlamına gelir. This payment method is not available. ise ödeme oturumunun artık siparişle eşleşmediği veya ödeme yönteminin bu arada kapatıldığı anlamına gelir: müşterinin ödeme sayfasını yeniden yüklemesi gerekir.

Sipariş PayU Payment On Hold durumunda: VibeFox PayU Payment sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

Sipariş Awaiting PayU Payment Confirmation durumunda: satış noktanız için otomatik tahsilat kapalıdır ve ödeme sizin işleminizi bekler. Sekmedeki Receive PayU payment veya Cancel PayU payment düğmelerini kullanın.

İade başarısız oluyor veya iade formu yok: sekme nedenini gösterir. Refunds are available once PayU has completed the payment. PayU'nun siparişin ödemesini henüz tamamlamadığı anlamına gelir. Sandbox veya Live anahtarlarının eksik olduğuna dair bir mesaj, ödemenin o ortamda yapıldığını ve anahtarlarının ayarlanmadığını gösterir. Anahtarları girin ve yeniden deneyin. Eklentiyi değiştirme izniniz yoksa sekme You do not have permission to refund (modify this extension). mesajını gösterir.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox PayU 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 Order statuses bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayı ve önbelleğe alınmış PayU erişim jetonları da kaldırılır (OpenCart 4'te olayları ve bakım modunda bildirim ile müşteri dönüşüne 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, otomatik tahsilat, günlük kaydı) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. PayU işlemleri ve iadeleri her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklentinin dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, yüklü eklentiler listesinde VibeFox PayU Payment yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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