VibeFox PayU LATAM for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

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

Para birimi: sepet ARS, BRL, CLP, COP, MXN, PEN veya USD cinsinden 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 gösterilmez.

PayU Latam hesabı: PayU satıcı hesabınızdan üç değere ihtiyacınız vardır: satıcı kimliği (merchant ID), satış yaptığınız ülkenin hesap kimliği (account ID) ve API anahtarı. Bunlar PayU modülünde (PayU satıcı paneli) Settings > Technical configuration (merchant ID, API key) ve Accounts (account ID) altında yer alır. Test için PayU, geliştirici dokümantasyonundaki "Test your solution" sayfasında herkese açık test ortamı kimlik bilgilerini ve test kartlarını yayımlar. Ödeme PayU'nun barındırdığı sayfada yapıldığı ve modül PayU API'sini hiçbir zaman çağırmadığı için API Login ve diğer API kimlik bilgileri gerekli değildir.

Mağazanızın internet erişimi: PayU ödeme sonucunu sunucularından mağazanıza gönderir; bu nedenle mağaza internetten erişilebilir olmalıdır (yerel bir site veya parola korumalı bir site olmamalıdır).

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

Kurulum

1. Yönetim panelinde 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 tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox PayU LATAM Payment öğesini bulup Configure düğmesine tıklayın.

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

4. Test ortamı kimlik bilgilerini ve canlı kimlik bilgilerinizi girin (bkz. Yapılandırma). PayU'da herhangi bir onay URL'si ayarlanmasına gerek yoktur.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Bir test ödemesi yapana kadar Sandbox seçeneğini açık tutun; ardından canlı kimlik bilgileriyle gerçek ödemeleri kabul etmek için kapatın.

Kurulum sırasında modül iki sipariş durumu oluşturur: Awaiting PayU LATAM payment ve PayU LATAM payment on hold. PrestaShop yeni ödeme yöntemini tüm para birimleri, ülkeler ve müşteri grupları için sunar. Bunu Payment > Preferences bölümünden sınırlayabilirsiniz. Daha sonra etkinleştirilen bir ülke de modül için orada işaretlenmelidir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox PayU LATAM 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 açıkken Sandbox mode. Payments go to the PayU sandbox and no real money is charged. mesajını, geçerli ortamın satıcı kimliği, hesap kimliği veya API anahtarı eksikken bir hata mesajını ve PayU LATAM mağazanın varsayılan para birimini işlemiyorsa bir uyarıyı gösterir. Kimlik bilgileri eksik olduğu sürece PayU LATAM ödeme sayfasında gösterilmez. Bir kimlik bilgisinin başındaki ya da sonundaki boşluklar yok sayılır. Sayfa boş bir Title alanını kaydetmez ve Enter a title for the payment method. mesajını gösterir.

PayU LATAM

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

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

Description: ödeme sayfası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: ödemeler aşağıdaki test ortamı kimlik bilgileriyle PayU test ortamına gider ve gerçek para tahsil edilmez. Kapalıyken canlı kimlik bilgileri ve PayU'nun canlı ödeme sayfası kullanılır. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında Sandbox mode: no real money is charged. mesajını görür.

Canlı kimlik bilgileri

Bunları PayU modülünde bulabilirsiniz: Settings > Technical configuration (merchant ID, API key) ve Accounts (satış yaptığınız ülkenin account ID değeri). Bölüm PayU satıcı paneline bağlantı verir.

Merchant ID: PayU satıcı hesabınızın sayısal kimliği.

Account ID: PayU hesabının kimliği. Ülke başına 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üm PayU dokümantasyonundaki "Test your solution" sayfasına bağlantı verir.

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

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

Sandbox API key: PayU test ortamı için API anahtarı.

Kayıtlı API anahtarları bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: API Key veya Sandbox API key kutusunu işaretleyin ve kayıtlı anahtarı silmek için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Her ödeme denemesi kendi ortamını hatırlar. Test ortamı ödemesinin onayı test ortamının API anahtarı ve satıcı kimliğiyle, canlı ödemenin onayı ise canlı değerlerle doğrulanır; bu sayede geçişten sonra bekleyen ödemeler çalışmaya devam eder. Geçişten sonra onaylanan bir test ortamı ödemesi sipariş notlarında [sandbox] ile işaretlenir.

Onay URL'si

Bu bölüm, PayU'nun her ödeme sonucunu bildirdiği URL'yi gösterir. Kullanıcı dostu URL'ler etkinken şuna benzer: https://your-shop/module/wcp_payu_latam_payment/confirmation; başında /en/ gibi bir dil kodu da olabilir. Modül bunu her ödemeyle birlikte PayU'ya gönderir, bu yüzden PayU'da yapılandırılacak bir şey yoktur. URL internetten erişilebilir olmalıdır. Mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez. Onay, PayU tarafından API anahtarınızla imzalanır. Geçerli imzası olmayan, başka bir satıcı kimliği taşıyan veya bu mağazanın vermediği bir ödeme referansı içeren onaylar reddedilir. Modül PayU'nun şu işlem durumlarını işler:

4 (approved): ödeme yapıldı. Tutar ve para birimi sepetle eşleşiyorsa sipariş ödenmiş olarak oluşturulur.

6 (declined), 5 (expired), 104 (error): ödeme başarısız oldu. Sipariş oluşturulmaz ve sepet korunur.

7, 10, 12, 14, 15, 18 (pending): ödeme beklemededir; örneğin müşterinin henüz tamamlamadığı bir nakit veya banka ödemesi. Sipariş Awaiting PayU LATAM payment durumunda oluşturulur.

Diğer durumlar yalnızca not olarak eklenir. Onay olmadan sipariş oluşturulmaz.

Gelişmiş

Debug log: ödeme isteklerini ve PayU bildirimlerini modül klasöründeki logs/payu_lp_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Anahtarlar ve kişisel veriler kaydedilmez. Hatalar ve reddedilen bildirimler, bu anahtar kapalı olsa bile her zaman kaydedilir. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Temizlemek için Clear log düğmesine tıklayın.

Delete data: modül kaldırıldığında ayarları ve günlükleri siler. Siparişlerin PayU verileri (ödeme denemeleri) ve sipariş durumları korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini (varsayılan olarak PayU LATAM) seçer ve onaylar. Mağazanızın bir sayfası You are being redirected to PayU LATAM to complete the payment... mesajını gösterir ve imzalı bir formu PayU WebCheckout sayfasına otomatik olarak gönderir. Bu olmazsa müşteri Pay with PayU LATAM düğmesine ya da geri dönmek için Back to checkout düğmesine tıklar. Bu aşamada henüz bir sipariş yoktur.

Form; sepetin toplam tutarını ve para birimini, sepetin vergisini ve vergi matrahını (vergisiz sepetlerde ikisi de 0'dır; böylece PayU varsayılan KDV eklemez), sepet numarası ve mağaza adıyla birlikte Cart # açıklamasını, müşterinin e-posta adresini, adını, telefonunu ve fatura adresini içerir. PayU sayfası sepetin diline göre İspanyolca, Portekizce veya İngilizce açılır. PayU sayfasında müşteri, PayU hesabınızda etkin olan herhangi bir yöntemle ödeme yapar.

Ödeme sayfasının her ziyareti kendi referansıyla (PS, sepet numarası ve bir zaman damgası) yeni bir ödeme denemesi başlatır. Eski denemeler hatırlanır: müşteri daha önce açılmış bir PayU sekmesinde ödeme yaparsa ödeme yine kabul edilir.

Sipariş, PayU imzalı onayı gönderdikten sonra ödenmiş olarak işaretlenir. PayU'dan dönen müşteri hiçbir zaman bir siparişi ödenmiş olarak işaretlemez. Müşteri geri döndüğünde:

İmzalı bir red, süre dolumu veya hatadan sonra: müşteri ödeme sayfasına Your PayU LATAM payment was not approved mesajı, varsa PayU nedeni ve You can try again or choose another payment method. mesajıyla döner. Sepet korunur.

PayU işlemi olmadan (müşteri PayU sayfasından ayrıldı): müşteri ödeme sayfasına Your PayU LATAM payment was not completed. You can try again or choose another payment method. mesajıyla döner.

Sipariş zaten var: müşteri standart sipariş onay sayfasını görür. Awaiting PayU LATAM payment durumundaki bir 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. Beklemeye alınmış bir sipariş için We have received your PayU LATAM payment and are reviewing it. We will contact you if anything is needed. yazar. Payment error durumundaki bir sipariş için Your PayU LATAM payment was not approved. Please contact us. yazar.

PayU henüz onaylamadı: bir sayfa We are waiting for PayU LATAM to confirm your payment. You will receive an e-mail as soon as it is confirmed. (ya da nakit veya banka ödemesi için yukarıdaki bekleme metni) mesajını ve Check again düğmesini gösterir. Onay ulaşır ulaşmaz sipariş oluşturulur.

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 bir sepet para birimi için mesaj PayU LATAM does not accept payments in ve ardından para birimidir. Zaten siparişi olan bir sepet yeniden ödenmez: müşteri sipariş onay sayfasına yönlendirilir.

Modülde mağaza içi ödeme formu, PrestaShop üzerinden iade, kayıtlı kart, abonelik veya taksit ayarı yoktur (PayU taksitleri kendi sayfasında gösterir). Ödeme durumunu sorgulamak için PayU API'sine bağlanmaz: siparişi yalnızca imzalı onay günceller.

Siparişler

Sipariş durumları

Henüz sipariş yok: müşteri PayU'ya yönlendirildi ve ödeme yapmadı, ödeme reddedildi ya da PayU henüz onayı göndermedi. Yalnızca sepet vardır.

Payment accepted: PayU ödemeyi onayladı ve tutar ile para birimi eşleşiyor. Ödeme PayU işlem kimliğiyle kaydedilir; bir not işlemi, tutarı, ödeme yöntemini ve test ödemeleri için [sandbox] ifadesini gösterir.

Awaiting PayU LATAM payment: PayU ödemeyi beklemede olarak bildirir (nakit veya banka ödemesi). PayU ödemeyi onayladığında sipariş Payment accepted durumuna geçer.

PayU LATAM payment on hold: ödenen tutar veya para birimi sepet toplamıyla eşleşmiyor ya da iptal edilmiş bir sipariş için ödeme onaylandı. Ödeme sipariş para birimindeyse kaydedilir. Not hangi durumun geçerli olduğunu belirtir: PayU modülünde ödemeyi kontrol edin, ardından siparişi işleyin, geri yükleyin veya ödemeyi iade edin.

Payment error: son denemenin beklemedeki bir ödemesi daha sonra reddedildi, süresi doldu veya bir hatayla sonuçlandı. Not PayU mesajını gösterir. Bu sepet yeniden ödenemez: müşteri yeni bir sipariş verir. Daha eski bir denemenin reddi ya da zaten onaylanmış bir ödemesi olan siparişin reddi yalnızca not olarak eklenir.

Her bildirim sepet başına kilit altında bir kez işlenir: tekrarlanan PayU bildirimleri ikinci bir sipariş oluşturmaz ve notları iki kez eklemez. Ödenmiş bir sipariş asla yeniden açılmaz ya da düşürülmez. Zaten ödenmiş bir siparişe başka bir onaylı ödeme gelirse bir not bunu belirtir: müşteri iki kez ödediyse, yinelenen ödemeyi PayU modülünde iade edin.

PayU LATAM ödeme bloğu

Sipariş sayfasında referans, işlem kimliği, PayU referansı, durum ve PayU durumu, istenen tutar, PayU'nun bildirdiği tutar, ödeme yöntemi, PayU mesajı, test ödemeleri için bir SANDBOX rozeti, sepetin tüm ödeme denemelerinin listesi ve siparişin PayU LATAM notes bölümü ile birlikte bir PayU LATAM payment bloğu gösterilir.

İadeler

İadeler PrestaShop üzerinden yapılmaz. İşlemi PayU modülünde iade edin, ardından iadeyi PrestaShop'ta elle kaydedin.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox PayU LATAM Payment, Modules > Module Manager > VibeFox PayU LATAM Payment > Configure sayfasında ayarların üstündeki 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 tarih ve alan adınız) gösterir; ayrıca 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 düğmeleri bulunur. Bunların altında Product: presta-payment-payu-latam satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloktaki metinler 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 veya hesabınızda bir alan adı yuvası boşalttı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ı boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan PayU LATAM ö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 mağaza sayfası, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine PayU onayı ve müşterinin dönüşüyle onaylanır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir, sonrasında haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

PayU LATAM ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli ortamın satıcı kimliği, hesap kimliği ve API anahtarının doldurulduğunu kontrol edin: Sandbox açıksa test ortamı kimlik bilgilerini, kapalıysa canlı kimlik bilgilerini. Sepet para biriminin ARS, BRL, CLP, COP, MXN, PEN veya USD 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.

Ödeme geçti ama sipariş oluşmadı: PayU onayı mağazanıza ulaşmadı ya da reddedildi. Ayarlarda gösterilen onay URL'sinin internetten erişilebilir olduğunu kontrol edin (yerel site, güvenlik duvarı veya parola koruması olmamalı). Reddedilen onaylar için modül sayfasındaki Log alanına bakın. PayU, herhangi bir hata yanıtından sonra onayı yeniden gönderir.

Onay Invalid signature yanıtı veriyor: onay, ödemenin ortamının API anahtarıyla imzalanmamış. Canlı ödemeler için API Key, test ödemeleri için Sandbox API key değerini kontrol edin.

Onay Merchant mismatch yanıtı veriyor: onaydaki satıcı kimliği, ödemenin ortamındaki Merchant ID veya Sandbox merchant ID ile farklı. Ödemeleri işleyen PayU hesabının satıcı kimliğini girin.

Onay Gateway not configured yanıtı veriyor: ödemenin ortamının API anahtarı ya da satıcı kimliği eksik; örneğin bekleyen bir test ödemesi varken test kimlik bilgileri silinmiş olabilir. Bunları yeniden girin; PayU onayı yeniden deneyecektir.

Onay Retry yanıtı veriyor: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Hiçbir şey değişmedi ve PayU onayı yeniden gönderecek. Nedeni için Log alanına bakın.

Onay Unknown reference yanıtı veriyor: ödeme referansı bu mağaza tarafından verilmedi.

Onay URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca PayU'dan gelen istekleri kabul eder.

Müşteri This payment method is not available mesajını görüyor: modül, Payment > Preferences bölümünde müşterinin ülkesi, para birimi veya grubu için izinli değil ya da Enable/Disable kapalı.

Sipariş PayU LATAM payment on hold durumunda: PayU LATAM payment bloğundaki notları okuyun. Ödenen tutar veya para birimi sepetten farklıydı ya da ödeme siparişin iptalinden sonra geldi. PayU modülünde işlemi kontrol edin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox PayU LATAM 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. Delete data açıksa ayarlar ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Ödeme denemeleri ile Awaiting PayU LATAM payment ve PayU LATAM payment on hold sipariş durumları her zaman korunur; böylece eski bir denemeye ait geç gelen PayU onayı yeniden kurulumdan sonra da tanınır. Mevcut siparişler ödeme notlarını, PayU referansları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.