VibeFox PayU LATAM for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, yüklü ve etkin. Eklenti onsuz etkinleşmez; WooCommerce sonradan kapatılırsa eklenti hiçbir işlem yapmaz ve yönetim alanında bir bildirim gösterir.

PHP: 8.0 veya üzeri.

Currency: sipariş ARS, BRL, CLP, COP, MXN, PEN veya USD ile olmalıdır; bunlar PayU Latam'ın Arjantin, Brezilya, Şili, Kolombiya, Meksika, Panama ve Peru'da işlediği para birimleridir. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

PayU Latam account: PayU işletmenize ait üç değer gerekir: satıcı kimliği, satış yaptığınız ülkenin hesap kimliği ve API anahtarı. Bunlar PayU modülünde (PayU satıcı paneli), Settings > Technical configuration (satıcı kimliği, API anahtarı) ve Accounts (hesap kimliği) altındadır. PayU, test için geliştirici belgelerinin "Test your solution" sayfasında herkese açık test ortamı kimlik bilgileri ve test kartları yayımlar. Ödeme PayU'nun barındırdığı sayfada yapıldığından API Login ve diğer API kimlik bilgileri gerekmez.

Internet access to your site: PayU ödeme sonucunu kendi sunucularından mağazanıza gönderir; bu nedenle siteye internetten erişilebilmelidir (yerel site olmamalı, parola koruması veya bakım sayfası arkasında bulunmamalıdı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 yoluna gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_payu_latam_payment klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > PayU LATAM > Manage veya Eklentiler 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ündeki lisans bloğuna girin ve Activate düğmesine tıklayın.

5. Test ortamı ve canlı kimlik bilgilerinizi girin (bkz. Yapılandırma). PayU'da onay URL'si yapılandırmak gerekmez.

6. Enable/Disable seçeneğini açıp kaydedin. Bir test ödemesi yapana kadar Sandbox açık kalsın; ardından canlı kimlik bilgileriyle gerçek ödeme kabul etmek için işareti kaldırın.

Yapılandırma

Tüm ayarlar tek sayfadadır: WooCommerce > Settings > Payments > PayU LATAM. Sayfa, alanların üstünde test modu açıkken (Sandbox mode. Ödemeler PayU test ortamına gider ve gerçek para tahsil edilmez.), geçerli ortamın satıcı kimliği, hesap kimliği veya API anahtarı eksikken ve PayU LATAM mağaza para birimini işlemediğinde uyarı gösterir. Son iki durumda PayU LATAM ödeme sayfasında gösterilmez. Ödeme yöntemleri listesinde PayU LATAM, geçerli ortamın üç kimlik bilgisi doldurulana kadar kurulum gerekiyor olarak işaretlenir. Kimlik bilgilerinin başındaki veya sonundaki boşluklar yok sayılır.

Genel

Enable/Disable: Enable PayU LATAM, ödeme yöntemini açar veya kapatır. Varsayılan: off.

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

Description: ödeme sırasında müşteriye gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay with a card, cash or bank transfer on the secure PayU page. You will be redirected to PayU to complete your payment.

Ortam

Sandbox: Enable the PayU sandbox (test mode). Ödemeler aşağıdaki test kimlik bilgileriyle PayU test ortamına gider ve gerçek para tahsil edilmez. Kapatıldığında canlı kimlik bilgileri ve PayU canlı ödeme sayfası kullanılır. Varsayılan: on.

Canlı kimlik bilgileri

PayU modülünde bulun: Settings > Technical configuration (satıcı kimliği, API anahtarı) ve Accounts (satış yaptığınız ülkenin hesap kimliği). Bölümde PayU satıcı paneline bağlantı vardır.

Merchant ID: PayU işletmenizin sayısal tanımlayıcısı.

Account ID: PayU hesabının tanımlayıcısı. Her ülke için bir hesap vardır.

API Key: ödemeleri imzalamak ve PayU bildirimlerini doğrulamak için kullanılan gizli anahtar.

Test ortamı kimlik bilgileri

PayU, test ortamı için herkese açık test kimlik bilgileri ve test kartları yayımlar. Bölümde PayU belgelerinin "Test your solution" sayfasına bağlantı vardır.

Sandbox merchant ID: PayU test ortamının satıcı kimliği.

Sandbox account ID: PayU test ortamının hesap kimliği.

Sandbox API key: PayU test ortamının API anahtarı.

Her ödeme denemesi ortamını hatırlar. Test ödemesi onayı test API anahtarı ve satıcı kimliğiyle, canlı ödeme onayı ise canlı değerlerle doğrulanır; böylece geçişten sonra bekleyen ödemeler çalışmaya devam eder. Tek kimlik bilgisi kümesi kullanan 1.0 sürümünden güncellediğinizde, test ortamı açıksa eski değerler test alanlarına kopyalanır. Güncellemeden sonra ayarları kontrol edin.

Onay URL'si

Bu bölüm PayU'nun her ödeme sonucunu bildirdiği URL'yi gösterir. Şuna benzer: https://your-site/wc-api/payu_lp/. Eklenti bunu her ödemeyle PayU'ya gönderir; PayU'da yapılandırılacak bir şey yoktur. Sayfaya internetten erişilebilmelidir. PayU onayı API anahtarınızla imzalar. Geçerli imzası olmayan, farklı satıcı kimliği içeren veya bu mağazanın sipariş için oluşturmadığı bir ödeme referansına sahip onaylar reddedilir. Eklenti şu PayU işlem durumlarını işler:

4 (approved): ödeme yapılmıştır. Tutar ve para birimi eşleştiğinde sipariş ödenmiş olarak işaretlenir.

6 (declined), 5 (expired), 104 (error): ödeme başarısızdır. Son denemeye ait ödenmemiş sipariş Başarısız olarak işaretlenir.

7 and other pending states: ödeme beklemektedir; örneğin müşterinin henüz tamamlamadığı bir nakit veya banka ödemesi. Sipariş beklemeye alınır.

Diğer durumlar yalnızca sipariş notu olarak eklenir. Onay olmadan sipariş hiçbir zaman ödenmiş sayılmaz: Ödeme bekleniyor durumunda kalır.

Gelişmiş

Debug log: Log payment requests and PayU notifications, ayrıntıları WooCommerce > Status > Logs altında wcp_payu_latam_payment kaynağına anahtar veya kişisel veri olmadan yazar. Hatalar ve reddedilen bildirimler her zaman kaydedilir. Varsayılan: off.

Delete data: Delete the settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişlere kaydedilen PayU verileri korunur. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan PayU LATAM) ve siparişi verir. Test modunda Ödeme bloğunda Sandbox mode: no real payment is made. ifadesini görür. Sipariş Ödeme bekleniyor durumunda kalır ve müşteri mağazanızdaki, Thank you for your order. You are being redirected to PayU LATAM to complete the payment… metnini içeren ödeme sayfasına gider. Sayfa PayU WebCheckout sayfasına otomatik olarak imzalı form gönderir. Bu gerçekleşmezse müşteri Pay with PayU LATAM düğmesine veya siparişi iptal etmek için Cancel order düğmesine tıklar.

Form; sipariş toplamını ve para birimini, sipariş vergisini ve vergi matrahını (PayU varsayılan KDV eklemesin diye vergisiz siparişlerde ikisi de 0), sipariş numarası ve mağaza adınızla birlikte Order # açıklamasını, müşterinin e-postasını, adını, telefonunu ve fatura adresini içerir. PayU sayfası mağaza diline göre İspanyolca, Portekizce veya İngilizce açılır. Müşteri PayU sayfasında hesabınızda etkin olan herhangi bir yöntemle ödeme yapar.

Ödeme sayfasının her ziyareti kendi referansına (sipariş numarası ve zaman damgası) sahip yeni bir ödeme denemesi başlatır. Siparişin son 30 denemesi hatırlanır: müşteri eski bir PayU sekmesinde ödeme yaparsa ödeme yine kabul edilir.

Sipariş ancak PayU imzalı onayla doğruladıktan sonra ödenmiş olarak işaretlenir. Müşterinin PayU'dan dönmesi siparişi hiçbir zaman ödenmiş olarak işaretlemez. Müşteri döndüğünde:

İmzalı ret, süre dolumu veya hatadan sonra: sipariş hemen Başarısız olarak işaretlenir ve WooCommerce yeniden ödeme seçeneğiyle standart başarısız ödeme sayfasını gösterir.

PayU işlemi yoksa (müşteri PayU sayfasından ayrılmışsa): müşteri Your PayU LATAM payment was not completed. You can try again or choose another payment method. mesajıyla Pay for order sayfasına gider.

Diğer durumlarda: müşteri sipariş alındı sayfasını görür. Sipariş Ödeme bekleniyor durumundayken We are waiting for PayU LATAM to confirm your payment. You will receive an e-mail as soon as it is confirmed. yazar. Beklemedeki sipariş için Your PayU LATAM payment is pending (for example, a cash or bank payment that has not been completed yet). We will process the order as soon as PayU confirms the payment. yazar.

Geçerli ortamın kimlik bilgileri eksikse müşteri PayU LATAM is not available right now. Please choose another payment method. mesajını görür. Desteklenmeyen sipariş para birimi için mesaj PayU LATAM does not accept payments in şeklindedir ve ardından para birimi gelir. Zaten ödenmiş sipariş tekrar ödenmez: ödeme sayfası This order has already been paid. mesajını gösterir.

Ö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.

Eklentide mağaza içi ödeme formu, WooCommerce üzerinden iade, kayıtlı kartlar, abonelikler veya taksit ayarları yoktur (PayU taksitleri kendi sayfasında gösterir). Ödeme durumunu öğrenmek için PayU API'sini sorgulamaz: yalnızca imzalı onay siparişi günceller.

Siparişler

Sipariş durumları

Pending payment: müşteri PayU'ya gönderilmiş ve henüz ödeme yapmamıştır veya PayU henüz onay göndermemiştir.

Processing: PayU ödemeyi onaylamıştır, tutar ve para birimi eşleşir. Sipariş notu PayU işlemini, tutarı, ödeme yöntemini ve test ödemelerinde [sandbox] işaretini gösterir. Siparişin işlem kimliği PayU işlem kimliğidir. Yalnızca sanal indirilebilir ürün içeren siparişler, WooCommerce'in varsayılan davranışıyla Tamamlandı durumuna geçer.

On hold: PayU ödemeyi beklemede bildirir (nakit veya banka ödemesi), ödenen tutar ya da para birimi sipariş toplamıyla eşleşmez veya iptal edilmiş bir sipariş için ödeme onaylanmıştır. Sipariş notu nedeni belirtir: ödemeyi PayU modülünde kontrol edip siparişi işleyin, geri yükleyin veya ödemeyi iade edin.

Failed: son ödeme denemesi reddedilmiş, süresi dolmuş veya hatayla bitmiştir. Not PayU mesajını gösterir. Müşteri yeniden ödeme yapabilir. Eski bir denemenin veya zaten onaylı ödemesi olan siparişin reddi yalnızca not olarak eklenir.

Her bildirim sipariş başına kilit altında bir kez işlenir: tekrarlanan PayU bildirimleri notları, stok azaltmalarını veya e-postaları çoğaltmaz. Başka bir istek siparişi çok uzun süre güncelliyorsa onaya hata yanıtı verilir ve PayU daha sonra tekrar gönderir. Ödenmiş, tamamlanmış veya iade edilmiş sipariş hiçbir zaman yeniden açılmaz. Zaten ödenmiş sipariş için başka bir onaylı ödeme gelirse bir not bunu belirtir: müşteri iki kez ödediyse yinelenen ödemeyi PayU modülünde iade edin.

İadeler

İadeler WooCommerce üzerinden yapılmaz. İşlemi PayU modülünde iade edin ve gerekirse iadeyi WooCommerce'e elle kaydedin.

Lisans anahtarı

Eklenti vibefox.net üzerinden alınan VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > PayU LATAM sayfasının üstündedir. Anahtarı License key alanına yapıştırıp Activate düğmesine tıklayın. Blok, lisansın etkin olduğu son tarih ve alan adınız gibi durum bilgilerini gösterir. Durumu yeniden kontrol etmek için Check now, başka anahtar girmek için Change key, 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ı siteden kaldırmak alan adı kotasındaki yeri boşaltmaz. Yeri vibefox.net hesabınızdan boşaltın.

Etkin anahtar olmadan PayU LATAM müşterilere ödeme sayfasında gösterilmez. Buna rağmen ödeme 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 (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında hatırlatma gösterilir. Mevcut siparişler etkilenmez: başlamış ödemeler onaylanmaya devam eder.

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 LATAM ödeme sayfasında görünmüyor: lisansın etkin, Enable/Disable açık ve geçerli ortamın satıcı kimliği, hesap kimliği ve API anahtarının doldurulmuş olduğunu kontrol edin: Sandbox açıkken test kimlik bilgileri, kapalıyken canlı bilgiler. Mağaza para biriminin (veya sipariş ödeme sayfasındaki sipariş para biriminin) ARS, BRL, CLP, COP, MXN, PEN veya USD olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için uyarı gösterir.

Ödeme gerçekleşti ama sipariş Pending payment durumunda: PayU onayı mağazanıza ulaşmamış veya reddedilmiştir. Ayarlardaki onay URL'sine internetten erişilebildiğini kontrol edin (yerel site, bakım modu, güvenlik duvarı veya parola koruması olmamalıdır). Reddedilen onaylar için WooCommerce > Status > Logs altında wcp_payu_latam_payment kaynağına bakın. PayU her hata yanıtından sonra onayı yeniden gönderir.

Onay Invalid signature yanıtı alıyor: onay ödeme ortamının API anahtarıyla imzalanmamıştır. Canlı ödemeler için API Key, test ödemeleri için Sandbox API key alanını kontrol edin.

Onay Merchant mismatch yanıtı alıyor: onaydaki satıcı kimliği, ödeme ortamının Merchant ID veya Sandbox merchant ID değerinden farklıdır. Ödemeleri işleyen PayU hesabının satıcı kimliğini girin.

Onay Gateway not configured yanıtı alıyor: ödeme ortamının API anahtarı veya satıcı kimliği eksiktir; örneğin test ödemesi beklerken test kimlik bilgileri kaldırılmıştır. Bilgileri yeniden girin; PayU onayı tekrar dener.

Onay Busy, retry later yanıtı alıyor: aynı anda başka bir istek siparişi güncelliyordur. Hiçbir şey değiştirilmez ve PayU onayı yeniden gönderir.

Onay Unknown reference yanıtı alıyor: ödeme referansı bu mağazanın PayU LATAM siparişine ait değildir; örneğin sipariş başka ödeme yöntemine geçirilmiş veya silinmiştir.

Sipariş On hold durumunda: sipariş notunu okuyun. Ödeme PayU'da hâlâ beklemektedir (nakit veya banka ödemesi), ödenen tutar ya da para birimi siparişten farklıdır veya ödeme sipariş iptal edildikten sonra gelmiştir. İşlemi PayU modülünde kontrol edin.

Diğer para birimleri veya form alanları: geliştiriciler para birimi listesini payu_lp_supported_currencies filtresiyle, ödeme simgesini payu_lp_icon filtresiyle ve WebCheckout form alanlarını payu_lp_payment_fields filtresiyle değiştirebilir.

Lisans bloğu hata gösteriyor: bloktaki mesajı izleyin. Örneğin anahtar başka alan adında kullanılıyorsa vibefox.net hesabınızda bir yer boşaltıp 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 son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlükleri yalnızca Delete data açık idiyse kaldırılır. Aksi takdirde daha sonra yeniden yüklemek için saklanır. Mevcut siparişler ödeme notlarını, PayU referanslarını 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.