VibeFox PayU India 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.

Para birimi: Hint Rupisi (INR). PayU India yalnızca rupi cinsinden tahsilat yapar. Mağazanızın INR para birimine ihtiyacı vardır (System > Localisation > Currencies). Diğer para birimlerindeki siparişler için ödeme yöntemi ödeme sayfasında gizlenir.

Telefon numarası: PayU her ödeme için bir telefon numarası ister. Siparişin bir telefon numarası olması için ödeme sayfanızda Telephone alanını tutun. OpenCart 4'ün ödeme sayfası varsayılan olarak telefon istemez: siparişte telefon numarası yoksa eklenti onay adımında kendi Phone alanını gösterir (bkz. Ödeme).

PayU India hesabı: PayU Dashboard > Payment Gateway > Key Salt Details bölümündeki Merchant Key ve Merchant Salt (v1) değerlerine ihtiyacınız vardır. Test çiftini görmek için paneli Test Mode'a alın. Salt v2 değil, Salt v1 kullanın.

Mağazanıza internet erişimi: isteğe bağlı webhook için gereklidir. Olmadan siparişler, müşteri PayU'dan döndüğünde onaylanır.

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_india_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_payu_india_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_india_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 India Payment Gateway öğ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. Test Merchant Key ve Salt ile Live Merchant Key ve Salt değerlerini girin (bkz. Yapılandırma).

5. Önerilir: PayU Dashboard > Webhooks bölümünde, başarılı ve başarısız ödemeler için ayarlar sayfasında gösterilen webhook URL'sini ekleyin.

6. Mode seçeneğini belirleyin, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test modunda bir ödeme deneyin, ardından Live moduna geçin.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_payu_india_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 India Payment Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi), ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını, PayU bilgilerini ve webhook'u OpenCart 3 için 3 ila 6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca dönüş ve webhook URL'leri farklıdır (bkz. Dönüş ve webhook URL'leri).

Yeni bir kurulum, ödeme yöntemi kapalı ve Test modu seçili olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, geçerli modun anahtarı veya salt'ı eksikse sizi uyarır; Test modundayken Test modu etkin: ödemeler test.payu.in adresine gider ve gerçek para tahsil edilmez. mesajını gösterir ve mağazanın varsayılan para birimi INR değilse bir hata gösterir: bu durumda ağ geçidi, ödeme sayfasında yalnızca müşteri INR ile ödeme yaptığında gösterilir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydettiğinizde Title boş olamaz ve 128 karakterden uzun olamaz, 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. Anahtarlardan ve salt'lardan boşluklar ve satır sonları silinir; çünkü yapıştırılmış bir boşluk içeren salt, her PayU yanıtının doğrulamada başarısız olmasına neden olur. Geçerli modun anahtarı ve salt'ı olmadan ödeme yöntemi etkinleştirilirse sayfa kaydettikten sonra sizi uyarır.

PayU India

Bölüm kısa bir notla başlar: kartlar, NetBanking, UPI ve cüzdanlar PayU'nun barındırdığı ödeme sayfasında; sonuçlar yalnızca geçerli bir PayU imzasıyla kabul edilir; yalnızca rupi.

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

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: PayU India. 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 Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

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

Geo Zone: PayU India'yı 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 India'nın sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. PayU India'yı her tutarda sunmak için boş bırakın.

API kimlik bilgileri

Merchant Key ve Merchant Salt (v1) değerlerini PayU Dashboard > Payment Gateway > Key Salt Details bölümünden kopyalayın. Test çifti için paneli Test Mode'a alın. Bölümde Open the PayU Dashboard bağlantısı vardır.

Mode: yeni ödemelerin kullandığı PayU ortamı.

Zaten başlatılmış ödemeler, başlatıldıkları modu korur: sonuçları bu modun anahtarı ve salt'ı ile kontrol edilir, iadeleri de bu anahtar ve salt ile gönderilir; modu değiştirseniz bile.

Live Merchant Key: canlı PayU Merchant Key'iniz.

Live Merchant Salt (v1): canlı PayU Merchant Salt (v1) değeriniz. İstekleri imzalar ve PayU yanıtlarını doğrular. Gizli tutun.

Test Merchant Key: yalnızca Test modunda kullanılan PayU test Merchant Key'iniz.

Test Merchant Salt (v1): yalnızca Test modunda kullanılan PayU test Merchant Salt (v1) değeriniz.

Kaydedilmiş salt'lar bir daha asla gösterilmez. Alan boş kalır ve Kaydedildi — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir salt'ı kaldırmak için alanın altındaki Clear the saved salt on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Dönüş ve webhook URL'leri

Return URL: OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/back, OpenCart 4'te https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.back biçimindedir. Her ödemede otomatik olarak PayU'ya gönderilir; herhangi bir yapılandırma gerekmez.

Webhook URL: OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_payu_india_payment/webhook, OpenCart 4'te https://your-store/index.php?route=extension/wcp_payu_india_payment/payment/wcp_payu_india_payment.webhook biçimindedir. İsteğe bağlıdır ama önerilir: müşteri geri dönmeden tarayıcıyı kapatsa bile ödemeleri onaylar. Başarılı ve başarısız ödemeler için PayU Dashboard > Webhooks bölümüne ekleyin. URL'yi ayarlar sayfasında gösterildiği gibi aynen kopyalayın. İnternetten erişilebilir olmalıdır (temel kimlik doğrulaması veya güvenlik duvarı engeli olmamalıdır). Mağazanın bakım modu bunu engellemez.

Webhook, müşterinin dönüşüyle aynı imzalı sonucu taşır. Geçerli bir PayU hash'i olmayan webhook'lar reddedilir.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, PayU doğru şekilde imzalanmış bir sonuç gönderene kadar bir durum almaz. Başarısız veya iptal edilmiş bir ödeme, siparişi durumsuz bırakır ve müşteri sepeti korunmuş olarak ödeme sayfasına döner. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Verify Payment açıkken verify_payment tarafından onaylanan, INR cinsinden beklenen tutarla yapılmış başarılı bir ödeme. Varsayılan: Processing.

Awaiting PayU Payment Status: PayU ödemeyi beklemede olarak bildirir (UPI collect, NetBanking sürüyor). PayU onayladığında sipariş ödeme sonrası durumunu alır. Varsayılan: Pending.

On Hold (Review) Status: PayU, manuel inceleme gerektiren başarılı bir ödeme bildirdi (bkz. Sipariş durumları). Varsayılan: Pending; çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Payment Error Status: PayU'nun daha sonra başarısız olarak bildirdiği bekleyen bir ödeme. Varsayılan: Failed.

Refunded Status: ödenen tutarın tamamı sipariş sayfasından iade edildiğinde ayarlanır. Varsayılan: Refunded.

Cancelled Order Status: mağazanızın iptal edilmiş siparişler için kullandığı durum. Böyle bir sipariş için alınan bir ödeme, siparişi ödenmiş olarak işaretlemek yerine inceleme durumuna alır. Eklenti bu durumu asla ayarlamaz. Varsayılan: Canceled.

Gelişmiş

Verify Payment: her başarılı ödemeyi PayU verify_payment API'si ile yeniden kontrol eder. Önerilir. Kontrol tamamlanamazsa sipariş ödenmiş olarak işaretlenmek yerine inceleme durumuna alınır. Varsayılan: açık.

Enable Logging: sorun gidermek için ağ geçidi olaylarını OpenCart günlük klasöründeki (storage/logs) payu_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir; bu seçenek her ödeme formu ve her PayU sonucu gibi diğer olayları da ekler. Anahtarlar, salt'lar ve müşteri kişisel verileri asla kaydedilmez. 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: eklenti kaldırıldığında ağ geçidi ayarlarını ve günlüğü siler. Siparişler ve PayU işlem kayıtları asla silinmez. Varsayılan: kapalı.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Salt'lar 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ı salt'lar korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak PayU India). Confirm Order adımında müşteri açıklamanızı 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. Siparişte telefon numarası yoksa, OpenCart 4'ün onay bloğu Phone alanını ve PayU India, ödeyenin telefon numarasını gerektirir. ipucunu gösterir. Oraya girilen numara PayU'ya gönderilir ve bir sonraki deneme için saklanır; siparişin telefon numarası önceliklidir. Müşteri Confirm Order düğmesine tıkladığında eklenti para birimini, geçerli modun kimlik bilgilerini ve siparişin telefon numarasını kontrol eder. Telefon numarası yoksa müşteri adımda kalır ve PayU India için telefon numarası gereklidir. Lütfen telefon numaranızı girip tekrar deneyin. mesajını görür. Aksi halde eklenti, sipariş toplamı için INR cinsinden imzalı bir ödeme isteği oluşturur ve tarayıcı bunu hemen PayU'nun barındırdığı ödeme sayfasına gönderir. Sayfa Ödemenizi tamamlamak için PayU'ya yönlendiriliyorsunuz. mesajını ve tarayıcı kendiliğinden devam etmezse Pay with PayU düğmesini gösterir. PayU sayfasında müşteri kartla, NetBanking, UPI veya cüzdanla öder.

Confirm Order her tıklamada, sipariş numarasıyla başlayan ve tutarı ile modu ile birlikte kaydedilen kendi PayU işlem kimliğiyle (txnid) yeni bir deneme başlatır. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi günceller ve yeni deneme aynı siparişi öder. Aynı siparişin, hâlâ açık olan eski bir ödeme sayfasında yapılan ödeme kabul edilmeye devam eder. Aynı sepetteki başka bir sipariş zaten ödenmişse, PayU'da bekliyorsa veya incelemedeyse, müşteri doğrudan başarı sayfasına gider ve yeni bir ödeme formu oluşturulmaz. Sepette yapılan her değişiklik, yeni adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

PayU sonucu müşteriyle birlikte geri gönderir ve yapılandırılmışsa webhook ile de bildirir. Sonuç, yalnızca ödemenin başlatıldığı modun anahtarı ve salt'ı ile üretilmiş geçerli bir PayU hash'i varsa ve yalnızca o sipariş için verilmiş bir işlem kimliği içinse kabul edilir. Verify Payment açıkken başarılı sonuç ayrıca PayU verify_payment API'si ile kontrol edilir. Ödenen tutar, denemenin tutarına ve sipariş toplamına, INR cinsinden kuruşuna kadar eşit olmalıdır. Sipariş yalnızca PayU bu şekilde onayladıktan sonra ödenmiş olarak işaretlenir ve bundan sonra OpenCart'ın standart yoluyla durum alır; olağan sipariş e-postaları gönderilir ve stok güncellenir. Eklenti şu PayU sonuçlarını işler:

Başarılı veya beklemedeki bir ödemeden sonra müşteri OpenCart sipariş başarı sayfasını görür. Beklemedeki bir ödeme PayU ödemeniz beklemede. PayU sonucu onaylar onaylamaz sipariş güncellenecek — tekrar ödeme yapmanıza gerek yok. mesajını ekler; incelemedeki bir sipariş Ödemeniz inceleniyor. Başka bir şeye ihtiyaç duyarsak sizinle iletişime geçeceğiz. mesajını ekler; ödeme hatası veya iptal durumundaki ödenmemiş bir sipariş ise PayU ödemeniz tamamlanmadı. Bu sipariş hakkında lütfen bizimle iletişime geçin. mesajını gösterir.

Başarısız bir ödemeden sonra müşteri şu mesajlarla ödeme sayfasına döner: Ödeme tamamlanmadı. Lütfen tekrar deneyin veya farklı bir ödeme yöntemi seçin., Ödeme iptal edildi. Tekrar deneyebilirsiniz. veya sonuç doğrulanamadıysa Ödeme sonucunu doğrulayamadık. Hesabınızdan ücret alındıysa, tekrar ödeme yapmadan önce lütfen bizimle iletişime geçin. Müşteri döndüğünde sonuç hâlâ işleniyorsa bir sayfa PayU ödemenizi doğruluyoruz. Ödemeyi tamamladıysanız siparişiniz kısa süre içinde güncellenecek — lütfen tekrar ödeme yapmayın. mesajını ve Check again ile Back to checkout düğmelerini gösterir. OpenCart 4'te bu mesajlar ö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ş ödeme yapılmadan kapatılmışsa (örneğin bekleyen ödemesi başarısız olduysa ya da siz iptal ettiyseniz), müşteri Önceki siparişiniz iptal edildi veya ödemesi başarısız oldu. Lütfen siparişi yeniden onaylayın. mesajıyla ödeme adımına geri döner. Siparişin ödemesi tamamlanıp sonra iptal edildiyse ya da mağaza tarafından iade edildiyse mesaj: Önceki siparişiniz iptal edildi veya mağaza tarafından iade edildi. Yeni bir siparişle ödeme yapmak için lütfen siparişi yeniden onaylayın. Sipariş daha önceki bir sepet için ödenmişse ve sepet değiştiyse mesaj: Önceki siparişiniz zaten ödendi. Sepetiniz değişti — geçerli sepet için ödeme yapmak üzere lütfen siparişi yeniden onaylayın. Bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. Kapatılmış bir sipariş asla ödenmiş gibi gösterilmez.

Webhook, mağaza bakım modundayken de çalışır; çünkü OpenCart ödeme eklentisi isteklerini geçirir (OpenCart 4'te eklenti bunun için kendi başlangıç eylemini ekler; bu eylem müşterinin PayU'dan dönüşüne de izin verir).

Eklenti yalnızca INR cinsinden tahsilat yapar ve çoklu para birimi işlemi (MCP) desteklemez. Kayıtlı kart veya tokenizasyon, abonelik, sitede gömülü (seamless) kart formu, EMI veya teklif yönetimi ve PayU tek tıkla ödeme özelliği yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri PayU'ya yönlendirildi ve ödeme yapmadı ya da ödeme başarısız oldu veya iptal edildi. 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 payment successful. Transaction ID: …, Mode: …, Bank: … mesajını gösterir.

Awaiting PayU Payment Status (varsayılan Pending): bir UPI veya NetBanking ödemesi PayU'da hâlâ beklemede. PayU onayladığında sipariş ödenmiş durumunu alır.

On Hold (Review) Status (varsayılan Pending): ödenen tutar veya para birimi siparişten farklı, verify_payment API'sine ulaşılamadı ya da ödemeyi henüz onaylamadı, ya da Cancelled Order Status durumundaki bir sipariş için ödeme geldi. Not nedenini belirtir. İşlemi PayU Dashboard'da kontrol edin, ardından ödenmiş durumunu ayarlayın veya siparişi iptal edip ödemeyi iade edin. Yalnızca doğrulama başarısız olduysa, sonuç bir sonraki teslimde sipariş otomatik olarak ödenmiş olur.

Payment Error Status (varsayılan Failed): beklemedeki bir ödeme daha sonra reddedildi veya iptal edildi. Daha sonraki başarılı bir sonuç siparişi yine de öder.

Refunded Status (varsayılan Refunded): ödenen tutarın tamamı eklenti üzerinden iade edildi.

PayU, zaten ödenmiş bir sipariş için başka bir başarılı ödeme bildirirse sipariş değişmez ve bir not sizden kopyayı PayU Dashboard'da iade etmenizi ister. Zaten ödenmiş bir sepetin başka bir siparişi için yapılan ödeme, o siparişi ödenmiş siparişteki bir notla birlikte durumsuz bırakır. Başka bir ödeme yöntemine geçirilmiş bir sipariş için yapılan PayU ödemesi yalnızca bir not alır.

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

VibeFox PayU India Payment Gateway sekmesi

Sales > Orders bölümünde PayU India ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox PayU India Payment Gateway sekmesi PayU transaction ID (mihpayid)'yi, Store transaction ID (txnid)'yi, test ödemeleri için Test mode rozetiyle birlikte Environment'ı, PayU Status'unu, ödemenin Mode / bank bilgisini, Paid / refund requested (INR) tutarlarını, iade formunu, iade geçmişini ve siparişin PayU notes alanını gösterir. İncelemedeki bir sipariş için, ödemeyi kontrol etmeniz için bir hatırlatma gösterir. Sekme eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Ödemenin VibeFox PayU India Payment Gateway sekmesinde 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; tutar sıfırdan büyük olmalı ve PayU'nun tahsil ettiği tutarın kalanını aşmamalıdır. Eklentiyi değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İade, ödemenin yapıldığı modun anahtarı ve salt'ı ile PayU iade API'si üzerinden gönderilir; bu nedenle bu kimlik bilgileri ayarlanmış olmalıdır. Bir siparişte aynı anda yalnızca bir PayU isteği çalışır. PayU iadeyi reddederse sekme PayU refund failed: ve PayU'nun mesajını gösterir; hiçbir iade kaydedilmez.

PayU iadeleri kuyruğa alır ve eşzamansız olarak tamamlar; müşteri genellikle parayı 5–7 iş günü içinde alır. İade geçmişi ve notlar tutarı, PayU istek kimliğini ve nedeni gösterir. Tam iade, siparişi müşteriye bildirilmeden ve ürünler stoğa geri eklenmeden, manuel bir durum değişikliği gibi Refunded Status durumuna getirir. Kısmi iade durumu değiştirmez. İadeler, PayU ödemenin işlem kimliğini bildirdikten sonra kullanılabilir. Eklenti iade durumunu daha sonra kontrol etmez.

Sales > Returns bölümündeki ürün iadeleri PayU üzerinden para göndermez. PayU Dashboard'da yapılan iadeler OpenCart'a geri senkronize edilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox PayU India Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox PayU India Payment Gateway > 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-india 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 India, ö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 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 India ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve seçili Mode'un anahtarının ve salt'ının doldurulduğunu kontrol edin. Müşterinin INR ile ödeme yaptığını, ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin. Ayarlar sayfası, kimlik bilgileri eksikse veya mağaza para birimi INR değilse uyarı gösterir.

Ödeme gerçekleşti, ancak sipariş durumsuz kaldı: müşteri mağazaya geri dönmedi ve hiçbir webhook gelmedi. Ayarlar sayfasındaki webhook URL'sini başarılı ve başarısız ödemeler için PayU Dashboard > Webhooks bölümüne ekleyin ve URL'nin internetten erişilebilir olduğundan emin olun.

Webhook invalid_signature yanıtı veriyor: PayU hash'i eşleşmedi. Ödemenin modunun anahtarının ve salt'ının doğru olduğunu ve Salt v2 değil Salt v1 kullanıldığını kontrol edin. Gerçek bir ödemenin test salt'ı ile imzalanmış sonucu veya bunun tersi de reddedilir. Hiçbir şey değiştirilmez.

Webhook not_configured yanıtı veriyor: ödemenin başlatıldığı modun anahtarı veya salt'ı eksik. Bunları girin; PayU webhook'u yeniden deneyecek.

Webhook verify_unavailable yanıtı veriyor: verify_payment API'si ödemeyi henüz onaylayamadı. Sipariş inceleme durumunda kalır ve bir sonraki teslimde yeniden doğrulanır.

Webhook busy veya retry yanıtı veriyor: aynı sepetle müşterinin dönüşü aynı anda işleniyordu veya sipariş durumu ayarlanamadı. PayU webhook'u yeniden deneyecek. Neden günlüğe yazılır.

Webhook ignored_unknown_txnid yanıtı veriyor: işlem bu mağaza tarafından başlatılmadı; örneğin aynı PayU hesabını kullanan başka bir mağaza. Hiçbir şey değiştirilmez.

Müşteri PayU India için telefon numarası gerektiğini görüyor: siparişin telefon numarası yok. Ödeme sayfanızda Telephone alanını tutun. OpenCart 4'te müşteri numarayı onay bloğundaki Phone alanına girebilir.

Müşteri This payment method is not available. Please reload the checkout page. mesajını görüyor: ödeme yöntemi bu arada kapatıldı, kimlik bilgileri eksik veya ödeme sayfası artık siparişle eşleşmiyor. Müşteri ödeme sayfasını yeniden yüklemelidir.

Sipariş inceleme durumunda: VibeFox PayU India Payment Gateway sekmesindeki notları okuyun. Neden bir tutar veya para birimi uyuşmazlığı, başarısız veya bekleyen bir doğrulama ya da iptal edilmiş bir sipariş için ödemedir.

İade başarısız oluyor: PayU transaction ID not found for this order. siparişin henüz bir PayU ödemesi olmadığı anlamına gelir. This payment was made in Test mode, but the Merchant Key/Salt of that mode are not set. (veya Live mode) ödemenin o modda yapıldığını ve önce o modun kimlik bilgilerini girmeniz gerektiğini gösterir. Invalid refund amount: at most … INR can be refunded. tutarın ödemenin kalanından fazla olduğu anlamına gelir.

Günlükte çok az bilgi var: hatalar ve uyarılar her zaman yazılır; her ödeme formunu ve her PayU sonucunu da görmek için Enable Logging seçeneğini açın.

Geliştiriciler için: ödeme isteği imzalanmadan önce eklenti, istek alanları ve sipariş ile birlikte OpenCart olayı payu_p_request_fields'ı tetikler. Anahtar, işlem kimliği, tutar ve dönüş URL'leri bu olay tarafından değiştirilemez.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox PayU India Payment Gateway 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 Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda webhook 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, mod, anahtarlar, salt'lar, ödeme doğrulama, günlük kaydı) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. PayU işlem kayıtları ve iade talepleri 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 India Payment Gateway 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.