VibeFox PayU India for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 6.0 veya üzeri, kurulu ve etkin olmalı. Eklenti WooCommerce olmadan etkinleşmeyi reddeder; WooCommerce daha sonra 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.

Store currency: Hindistan Rupisi (INR). PayU India yalnızca rupi cinsinden tahsilat yapar. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Phone number: PayU her ödeme için bir telefon numarası gerektirir. Ödeme sayfanızda telefon alanını zorunlu veya en azından görünür yapın.

PayU India account: PayU Dashboard > Payment Gateway > Key Salt Details bölümündeki Merchant Key ve Merchant Salt (v1) bilgilerine ihtiyacınız vardır. Test çiftini görmek için kontrol panelini Test Mode konumuna getirin. Salt v2 değil, Salt v1 kullanın.

Internet access to your site: isteğe bağlı webhook için gereklidir. Bu olmadan, siparişler müşteri PayU'dan geri döndüğünde onaylanır.

VibeFox license key: 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 yolunu izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_payu_india_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 India > Manage yoluna gidin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Test Merchant Key ve Salt ile Canlı Merchant Key ve Salt bilgilerini girin (bkz. Yapılandırma).

6. Önerilen: 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.

7. Mode seçeneğini belirleyin ve Enable/Disable ayarını açın. Test modunda bir ödeme deneyin, ardından Live moduna geçin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > PayU India. Sayfa; geçerli modun anahtarı veya salt değeri eksik olduğunda alanların üzerinde sizi uyarır, Test modunda Test mode is active: payments go to test.payu.in and no real money is charged. mesajını görüntüler ve mağaza para birimi INR olmadığında uyarı verir (bu durumda ödeme yöntemi ödeme sayfasında gizlenir).

Kaydetme sırasında anahtar ve salt değerlerindeki boşluklar ve satır sonları kaldırılır; çünkü yanlışlıkla yapıştırılan bir boşluk her PayU yanıtının doğrulamadan geçememesine neden olur.

Genel

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ığı. Varsayılan: PayU India.

Description: müşterinin ödeme sırasında gördüğü ödeme yöntemi açıklaması. Varsayılan: Pay securely via Credit/Debit Card, NetBanking, UPI, or Wallets through PayU.

API kimlik bilgileri

Merchant Key ve Merchant Salt (v1) bilgilerini PayU Dashboard > Payment Gateway > Key Salt Details bölümünden kopyalayın. Test çifti için paneli Test Mode konumuna getirin.

Mode: yeni ödemelerin hangi PayU ortamını kullanacağını belirler.

İadeler her zaman ödemenin yapıldığı moda gider.

Live Merchant Key: canlı PayU Merchant Key bilginiz.

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

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

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

Return ve webhook URL'leri

Return URL: https://your-site/wc-api/payu_p_callback/ benzeri bir yapıdadır. Her ödemeyle birlikte PayU'ya otomatik olarak gönderilir; herhangi bir yapılandırma gerekmez.

Webhook URL: https://your-site/wc-api/payu_p_webhook/ benzeri bir yapıdadır. İsteğe bağlıdır ancak önerilir: müşteri geri dönmeden önce tarayıcıyı kapatsa bile ödemeleri onaylar. Başarılı ve başarısız ödemeler için bunu PayU Dashboard > Webhooks bölümüne ekleyin. URL'yi ayarlar sayfasında gösterildiği şekilde tam olarak kopyalayın.

Gelişmiş

Verify Payment: Double-check every successful payment with the PayU verify_payment API. Önerilir. Doğrulama tamamlanamazsa, sipariş ödendi olarak işaretlenmek yerine beklemede durumuna alınır. Varsayılan: açık.

Enable Logging: Log gateway events for troubleshooting. WooCommerce > Status > Logs bölümüne, wcp_payu_india_payment kaynağıyla kaydedilir. Hatalar ve uyarılar her zaman günlüğe kaydedilir; bu seçenek diğer olayları ekler. Anahtarlar, salt değerleri ve müşterilerin kişisel verileri hiçbir zaman günlüğe kaydedilmez. Varsayılan: kapalı.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted (orders are never deleted). Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak PayU India) ve siparişi verir. Siparişte fatura telefon numarası (veya teslimat telefon numarası) yoksa, müşteri PayU India requires a phone number. Please enter your phone number and try again. mesajını görür. Aksi takdirde müşteri, PayU'nun barındırılan ödeme sayfasına imzalı bir ödeme isteği gönderen kısa bir sayfaya (Thank you for your order. You will be redirected to PayU to complete your payment.) yönlendirilir. Müşteri orada kart, NetBanking, UPI veya cüzdan ile ödeme yapar.

Her ödeme sayfası, tutarı ve moduyla birlikte siparişte saklanan kendi PayU işlem kimliğini alır. Aynı siparişin daha önce açılmış eski bir ödeme sayfasında yapılan bir ödeme yine de kabul edilir. Ödenmiş, beklemede veya iptal edilmiş bir siparişe asla yeni bir ödeme formu verilmez; böylece tarayıcının Geri düğmesi ikinci bir ödeme başlatamaz.

PayU, sonucu müşteriyle birlikte ve yapılandırılmışsa webhook aracılığıyla geri gönderir. Bir sonuç, yalnızca ödemenin başlatıldığı modun anahtarı ve salt değeriyle oluşturulmuş geçerli bir PayU hash değeriyle ve yalnızca o sipariş için oluşturulan bir işlem kimliği için kabul edilir. Verify Payment açık olduğunda, başarılı bir sonuç PayU verify_payment API'si ile de kontrol edilir. Ödenen tutar, INR cinsinden paisa kuruşuna kadar sipariş toplamına eşit olmalıdır. Sipariş ancak PayU bu şekilde onayladıktan sonra ödendi olarak işaretlenir. Eklenti şu PayU sonuçlarını işler:

Başarılı veya beklemedeki bir ödemeden sonra müşteri sipariş alındı sayfasını görür. Başarısız bir ödemeden sonra müşteri şu mesajlardan biriyle ödeme sayfasına geri döner: Payment was not completed. Please try again or choose a different payment method., Payment was cancelled. You may try again. veya sonuç kontrol edilemediğinde We could not confirm the payment result. If your account was charged, please contact us before paying again. Bu mesajlar hem klasik ödeme sayfasında hem de Ödeme bloğunda çalışır.

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

Eklenti yalnızca INR cinsinden tahsilat yapar ve çoklu para birimi işleme (MCP) özelliğine sahip değildir. Kayıtlı kartlar veya tokenizasyon, WooCommerce Subscriptions, sitede yerleşik (seamless) kart formu, taksit (EMI) veya teklif yönetimi ve PayU tek tıkla ödeme özellikleri bulunmaz.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri PayU'ya yönlendirildi ve henüz ödeme yapmadı.

Processing: ödeme onaylandı. Sipariş notunda PayU işlem kimliği (mihpayid), ödeme modu ve banka kodu gösterilir. Siparişin işlem kimliği PayU mihpayid bilgisidir. Yalnızca sanal ve indirilebilir ürünler içeren siparişler, WooCommerce'in varsayılan olarak yaptığı gibi Tamamlandı durumuna geçer.

On hold: ödeme PayU tarafında hâlâ beklemede (UPI veya NetBanking), ödenen tutar veya para birimi siparişten farklı, verify_payment API'sine ulaşılamadı veya ödeme henüz onaylanmadı ya da iptal edilmiş bir sipariş için bir ödeme ulaştı. Sipariş notu nedeni belirtir. İşlemi PayU Dashboard üzerinden kontrol edin ve tamamlayın ya da iade edin. Doğrulama başarısız olduğunda, sipariş sonucun bir sonraki iletiminde otomatik olarak onaylanır.

Failed: ödeme reddedildi veya iptal edildi. Müşteri tekrar ödeme yapabilir.

PayU zaten ödenmiş bir sipariş için başka bir başarılı ödeme bildirirse, bir not PayU Dashboard üzerinden mükerrer ödemeyi iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via PayU India düğmesine tıklayın (düğme sizin Title başlığınızı gösterir). Tam ve kısmi iadeler desteklenir; tutar sıfırdan büyük olmalıdır. İade, ödemenin yapıldığı modun anahtarı ve salt değeriyle PayU iade API'si üzerinden gönderilir; bu nedenle bu kimlik bilgilerinin ayarlanmış olması gerekir. PayU iadeyi reddederse WooCommerce PayU'nun mesajını gösterir ve hiçbir iade kaydedilmez.

PayU iadeleri sıraya alır ve eşzamansız olarak tamamlar; müşteri genellikle parayı 5–7 iş günü içinde alır. Sipariş notunda tutar, PayU istek kimliği ve neden gösterilir. Eklenti daha sonra iade durumunu tekrar kontrol etmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > PayU India 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 durumu gösterir; örneğin lisansın hangi tarihe kadar etkin 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 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 India ö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. Oturum açmış mağaza yöneticileri ödeme yöntemini yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir, böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Lisans 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 India does not appear at checkout: lisansın etkin olduğunu, Enable/Disable ayarının açık olduğunu ve seçilen Mode için anahtar ile salt bilgilerinin doldurulduğunu kontrol edin. Mağaza para biriminin (veya «Pay for order» sayfasındaki sipariş para biriminin) INR olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

The payment went through, but the order stays Pending payment: müşteri mağazaya geri dönmedi ve hiçbir webhook ulaşmadı. Başarılı ve başarısız ödemeler için ayarlardaki webhook URL'sini PayU Dashboard > Webhooks bölümüne ekleyin ve internetten erişilebilir olduğundan emin olun.

Webhook answers invalid_signature: PayU hash değeri eşleşmedi. Ödeme modunun anahtar ve salt bilgilerinin doğru olduğunu ve Salt v2 değil, Salt v1 kullanıldığını kontrol edin. Sipariş değiştirilmez.

Webhook answers not_configured: ödemenin başlatıldığı modun anahtarı veya salt değeri eksik. Bunları girin; PayU webhook bildirimini yeniden dener.

Webhook answers verify_unavailable: verify_payment API'si ödemeyi henüz doğrulayamadı. Sipariş beklemededir ve bir sonraki iletimde tekrar doğrulanır.

The customer sees PayU India requires a phone number: ödeme sayfasında telefon alanını zorunlu veya görünür yapın. Fatura telefonu kullanılır veya yalnızca o doldurulmuşsa teslimat telefonu kullanılır.

The order is On hold: sipariş notunu okuyun. Neden; bekleyen bir UPI veya NetBanking ödemesi, tutar veya para birimi uyuşmazlığı, başarısız veya bekleyen bir doğrulama ya da iptal edilmiş bir sipariş için yapılan ödemedir.

Refund fails: PayU transaction ID not found for this order. mesajı, siparişte PayU ödemesi bulunmadığı anlamına gelir. Ödeme modunun Merchant Key/Salt bilgilerinin ayarlanmadığını belirten bir mesaj, önce o modun kimlik bilgilerini girmeniz gerektiği anlamına gelir.

Too little in the log: hatalar ve uyarılar her zaman yazılır; her PayU isteğini ve sonucunu da görmek için Enable Logging ayarını açın.

Developer hooks: payu_p_request_fields filtresi imzalanmadan önce ödeme isteği alanlarını değiştirir; payu_p_icon filtresi ödeme simgesini değiştirir.

The license block shows an error: bölümdeki mesajı takip edin. Örneğin, anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir alan adı hakkını 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 verileri korur. Eklentiyi tamamen kaldırmak için Plugins sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve bu eklentinin günlükleri (günlük dosyaları ve WooCommerce veritabanı günlüğünün satırları) yalnızca Delete data on uninstall açık olduğunda silinir. Aksi takdirde daha sonra yeniden kurulum için saklanırlar. Mevcut siparişler ödeme notlarını, PayU işlem kimliklerini ve iade istek 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.