VibeFox Redsys for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Redsys satıcı hesabı: bankanız (Redsys sanal POS'unu size veren acquirer), satıcı kodunu (FUC), terminal numarasını ve her ortamın SHA-256 gizli anahtarının gösterildiği Redsys yönetim paneline erişimi verir. Test ortamının anahtarı gerçek ortamın anahtarından farklıdır. Çevrim içi bildirim (HTTP) terminaliniz için etkin olmalıdır. Emin değilseniz bankanıza sorun.

Mağaza para birimi: modülün desteklediği para birimlerinden biri (bkz. Configuration) olmalı ve Redsys terminaliniz bu para birimi için bankanız tarafından etkinleştirilmiş olmalıdır. Çoğu terminal yalnızca EUR kabul eder.

Erişilebilir mağaza: Redsys, ödeme bildirimlerini iletebilmek için mağazanıza internetten, oturum açma gerektirmeden ve güvenlik duvarı engeli olmadan ulaşabilmelidir.

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

Kurulum

1. Yönetim panelinde Modules > Module Manager sayfasına gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme bittiğinde Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox Redsys Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Satıcı kodunuzu, terminali ve her ortamın gizli anahtarını girin (bkz. Configuration).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test Mode açıkken bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Test Mode seçeneğini kapatın.

Kurulumda modül Redsys payment on hold sipariş durumunu oluşturur. PrestaShop, o anda etkin olan ülkeler ile tüm para birimleri ve müşteri grupları için modüle yeni bir ödeme modülü önerir. Bunu Payment > Preferences bölümünden değiştirebilirsiniz; daha sonra etkinleştireceğiniz ülkeler de orada modül için işaretlenmelidir.

Configuration

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Redsys Gateway > 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; satıcı kodu eksikse veya yalnızca rakamlardan oluşmuyorsa, bir gizli anahtar geçerli bir Redsys SHA-256 anahtarı değilse, mevcut modun anahtarı boşsa (bu durumda ödeme yöntemi ödeme adımında gizlenir) ve mağaza para birimi desteklenmiyorsa sizi uyarır. Test modu açıkken sayfa Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. mesajını gösterir. Title boşsa sayfa Enter a title for the payment method. mesajını gösterir ve hiçbir şey kaydedilmez.

Redsys

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

Title: müşterilerin ödeme adımında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit/Debit Card (Redsys). Zorunlu.

Description: ödeme adımında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit or debit card via Redsys.

Redsys hesabı

Bankanız satıcı kodunu, terminali ve her ortamın SHA-256 gizli anahtarının gösterildiği Redsys yönetim paneline erişimi verir. Bu bölüm Redsys yönetim paneline bir bağlantı içerir.

Merchant Code (FUC): Redsys satıcı kodunuz, en fazla 9 rakam. Rakam olmayan her karakter kaydedilirken silinir.

Terminal Number: bankanız tarafından atanan terminal numarası, en fazla 3 rakam. Varsayılan: 1. Boş bırakılan alan 1 olarak kaydedilir.

Secret Key (SHA-256) — live: gerçek (üretim) ortamın Base64 SHA-256 anahtarı, genellikle 32 karakter. Test modu kapalıyken kullanılır.

Test modu (SIS-T)

Redsys test ortamının kendi gizli anahtarı vardır. Bu bölüm Redsys'in herkese açık test verilerini gösterir: satıcı kodu 999008881, terminal 1, anahtar sq7HjrUOBfKmC576ILgskD5srU870gJ7, kart 4548 8100 0000 0003, son kullanma 12/49, CVV 123. Test modunda gerçek para çekilmez.

Test Mode: ödemeler ve iadeler Redsys test ortamına (SIS-T) gider ve test anahtarıyla imzalanır. Varsayılan: açık. Gerçek ödemeleri kabul etmek için kapatın. Açıkken ödeme adımı ödeme yönteminin altında TEST MODE: Redsys test environment, no real money is charged. mesajını gösterir.

Secret Key (SHA-256) — test: test ortamının Base64 SHA-256 anahtarı. Kendi test anahtarınızı veya yukarıdaki herkese açık test anahtarını kullanın.

Kaydedilmiş 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: bir anahtarı işaretleyin ve silmek için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Ödeme sayfası ve siparişler

Commerce Name: Redsys ödeme sayfasında gösterilen mağaza adı, en fazla 25 karakter. Varsayılan: mağazanızın adı, 25 karaktere kısaltılmış.

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu.

Tutar veya para birimi uyuşmazlıkları, mağaza gerçek modda çalışırken yapılan test ödemeleri ve iptal edilen denemelerin ödemeleri her zaman Redsys payment on hold durumuna gider.

Ödeme bildirimleri

Notification URL: Redsys her ödemeyi mağazanızın bu adresine bildirir. Bu bölümde gösterilir ve dostça URL'lerle https://your-shop/module/wcp_redsys_gateway/notify gibi görünür. Modül bunu her ödemeyle birlikte Redsys'e gönderir, bu yüzden Redsys paneline kopyalanacak bir şey yoktur. Terminaliniz için çevrim içi bildirim (HTTP) etkin olmalıdır. Başarılı bir ödemeden sonra sipariş oluşmazsa bankanıza sorun. Geçerli imzası olmayan bildirimler reddedilir. Bildirim olmadan sipariş oluşturulmaz.

Gelişmiş

Debug log: ödeme, bildirim ve iade ayrıntılarını modül klasöründeki logs/rdsg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Anahtarlar, imzalar ve kart verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

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

Delete Data: açıkken modülü kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin Redsys ödeme kayıtları (iadeler için gerekli) ve Redsys payment on hold sipariş durumu her zaman korunur. Varsayılan: kapalı.

Desteklenen para birimleri

EUR, USD, GBP, JPY, CHF, CAD, AUD, NZD, NOK, SEK, DKK, PLN, CZK, HUF, BGN, RON, ILS, INR, MYR, SGD, THB, SAR, ZAR, RUB, BRL, MXN, ARS, CLP, COP, PEN, CNY, TWD. Diğer para birimlerindeki sepetler için ödeme yöntemi gizlenir.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Redsys)) ve siparişi onaylar. Müşteri Redirecting to Redsys for payment. Please wait... mesajını görür ve bankanızın Redsys ödeme sayfasına geçer. Tarayıcı kendi kendine devam etmezse müşteri Pay via Redsys düğmesine veya geri dönmek için Choose another payment method düğmesine tıklar. Bu noktada henüz bir sipariş yoktur.

Redsys sayfasında müşteri 3-D Secure ile kartla, ya da Bizum veya bankanızın terminal için etkinleştirdiği başka bir yöntemle öder. Sayfa sepetin dilini kullanır (İspanyolca, İngilizce, Katalanca, Fransızca, Almanca, İtalyanca, Portekizce ve diğerleri); diğer diller için İngilizce kullanılır. Tutar, sepet para biriminin en küçük biriminde sepet toplamıdır; örneğin EUR 43,45 4345 olarak gönderilir, JPY ve CLP ise ondalık kullanmaz. Ödeme, sepet numarası ve mağaza adınızla birlikte Cart olarak tanımlanır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, ancak Redsys imzalı bildirimle onayladıktan sonra ödenmiş olarak işaretlenir: siparişi bildirim oluşturur ve müşteri Your payment with Redsys has been received. ile standart sipariş onay sayfasını görür. Sipariş Redsys payment on hold durumuna geçtiyse sayfa Your payment with Redsys has been received and is being reviewed by the store. mesajını gösterir. Bildirim henüz gelmediyse Payment confirmation sayfası Redsys is confirming your payment. If you completed the payment, your order will be created in a few moments — please do not pay again. mesajını ve Check again ile Back to checkout düğmelerini gösterir.

Müşteri iptal ederse veya ödeme reddedilirse Redsys müşteriyi The Redsys payment was not completed. You can try again or choose another payment method. mesajıyla ödeme adımına geri gönderir. Sepet korunur ve müşteri yeniden ödeme yapabilir. Her yeni deneme yeni bir Redsys sipariş numarası alır; bunlardan herhangi birinden, örneğin ikinci bir tarayıcı sekmesinden yapılan ödeme yine de tanınır.

Ödeme Redsys'e gönderilemezse müşteri kısa bir mesajla ödeme adımında kalır: Redsys payments are not configured correctly. Please choose another payment method or contact us., para biriminin kabul edilmediğini belirten bir mesaj veya The order total must be greater than zero.

Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasıyla engellenmez.

Modül, Redsys sayfasında hemen yetkilendirilen ve tahsil edilen tek seferlik ödemeleri kabul eder. Kendi sitenizde kart formu (InSite veya iframe) yoktur; kayıtlı kart, tek tıkla ödeme veya tokenizasyon, abonelik veya tekrarlayan ödeme, sonradan tahsilatlı ön yetkilendirme ve yönetim panelinde oluşturulan siparişler için ödeme bağlantısı da yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Redsys'e yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya iptal edildi ya da Redsys bildirimi henüz gelmedi. Yalnızca sepet vardır.

Payment accepted, Delivered or Redsys payment on hold: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Ödeme, Redsys sipariş numarası (Ds_Order) işlem kimliği olarak kaydedilir ve bir not Redsys sipariş numarasını, yetkilendirme kodunu ve yanıt kodunu gösterir; test ödemeleri için [TEST] işaretiyle.

Redsys payment on hold after payment: Redsys, sepet toplamından farklı bir tutar veya para birimi bildirdi (örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi), mağaza gerçek modda çalışırken bir test ödemesi geldi (gerçek para çekilmedi ve ödeme kaydedilmedi) ya da müşteri, Redsys sayfasında bu ödemeyi iptal ettikten sonra ödeme yaptı. Not durumu açıklar. Ödemeyi Redsys yönetim panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Refunded: ödeme modül aracılığıyla tamamen iade edildi.

Reddedilen bir ödeme, mevcut bir siparişi asla değiştirmez. Sık görülen yanıt kodları için günlük ve notlar Insufficient funds, Card expired veya Cancelled by the customer gibi kısa bir neden verir. Zaten siparişi olan bir sepet için ikinci, farklı bir ödeme gelirse sipariş değiştirilmez. Bir not, mükerrer ödemeyi Redsys yönetim panelinde iade etmenizi ister. Redsys bir ödemenin hâlâ devam ettiğini bildirirse bir not eklenir ve sipariş nihai sonucu bekler.

Redsys ödeme bloğu

Sipariş sayfasında Redsys sipariş numarası (Ds_Order), yetkilendirme kodu ve yanıtı, ortam (gerçek veya test), ödenen ve iade edilen tutar, test ödemeleri için Test mode rozeti, beklemedeki siparişler için inceleme ipucu, iade geçmişi, siparişin Redsys notes bölümü ve sepet için verilmiş tüm Redsys sipariş numaralarıyla birlikte bir Redsys payment bloğu görünür.

İadeler

Redsys payment bloğuna tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via Redsys düğmesine tıklayın. Refund this amount through Redsys? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Siparişleri düzenleme hakkına sahip olmanız gerekir; modül sayfalarına erişim gerekmez. İadeler, Redsys'in tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, Redsys REST API üzerinden ödemenin yapıldığı ortama (test veya gerçek) gönderilir, o ortamın anahtarıyla imzalanır ve yanıt imzası kontrol edilir. Redsys iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara Redsys sipariş numarası ve nedeniyle birlikte eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Redsys üzerinden para geri göndermez.

Redsys yönetim panelinde yapılan iadeler, modülün iadeleri olarak kaydedilmez. Redsys bunlar için bir bildirim gönderdiğinde siparişe bir not eklenir. Sipariş durumu otomatik olarak değişmez.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Redsys Gateway lisans bloğu, Modules > Module Manager > VibeFox Redsys Gateway > 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ı maskeli olarak, durumunu (örneğin lisansın hangi tarihe kadar geçerli olduğu 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: presta-payment-redsys satırı ile Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modülün Configure iznine sahip çalışanlar değiştirebilir. Bloktaki metinler yönetim paneli 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 bir tarihle birlikte License expired on. Mağaza adresi değiştikten sonra ya da hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çok mağazalı kurulumda da. 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 Redsys ödeme adımı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 vitrini yönetim paneline giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışmaya devam eder.

Lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Durum, yönetim panelinde çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Redsys ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, satıcı kodu ve terminalin doldurulduğunu ve mevcut modun geçerli bir anahtarı olduğunu kontrol edin: test modunda Secret Key (SHA-256) — test, gerçek modda Secret Key (SHA-256) — live. Sepet para biriminin desteklenen para birimleri listesinde olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşmadı: Redsys bildirimi mağazanıza ulaşmadı. Bankanızdan terminaliniz için çevrim içi bildirimin (HTTP) etkin olduğunu kontrol etmesini isteyin. Notification URL alanında görünen adresin oturum açma veya güvenlik duvarı engeli olmadan internetten erişilebilir olduğunu kontrol edin. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Bildirim Forbidden yanıtı veriyor: imza, ödemenin başlatıldığı ortamın gizli anahtarıyla eşleşmiyor veya bildirimdeki satıcı kodu size ait değil. Ayarlardaki gizli anahtarların ve satıcı kodunun terminalinizin değerleri olduğunu kontrol edin.

Bildirim Order not found yanıtı veriyor: bildirim doğru imzalanmış, ancak bu mağazadaki hiçbir sepet bu Redsys sipariş numarasını kullanmıyor.

Bildirim Busy yanıtı veriyor: sepet aynı anda başka bir bildirim tarafından işleniyordu veya sipariş oluşturulamadı (örneğin modül devre dışı). Redsys bildirimi yeniden dener. Günlük nedeni gösterir.

Bildirim Bad request yanıtı veriyor: istekte Redsys parametreleri yoktu veya bozuktu. Beklenen biçimde Redsys'ten gelmedi.

Sipariş ödemeden sonra Redsys payment on hold durumunda: Redsys payment bloğundaki notları okuyun (bkz. Sipariş durumları), ardından siparişi işleyin veya ödemeyi iade edin.

Test ödemeleri gerçek modda siparişleri onaylamıyor: Test Mode kapalıyken bir test ödemesi hiçbir siparişi ödemez. Bunun yerine sipariş bir notla beklemeye alınır. Test ödemeleri için test anahtarıyla test modunu kullanın.

İade başarısız oluyor: hatayı okuyun. Redsys refund: the merchant code or the TEST secret key is not configured. (veya LIVE) ödemenin ortamının anahtarının eksik olduğu anlamına gelir. Redsys hata kodları mesajda açıklanır; örneğin SIS0057 (tutar ödemenin kalanını aşıyor), SIS0056 (orijinal ödeme bulunamadı; başka ortam veya terminal), SIS0042 (imza hatası, bu ortamın anahtarını kontrol edin), SIS0026 (bilinmeyen satıcı kodu veya terminal) ve SIS0027 (para birimi terminal için yapılandırılmamış). Redsys'e ulaşılamıyorsa iade yapılmaz. Daha sonra tekrar deneyin.

Terminaliniz listede olmayan bir para birimini kabul ediyor: geliştiriciler para birimi listesini actionRdsgCurrencyCodes kancasıyla değiştirebilir. Bir para birimini yalnızca bankanız terminal için etkinleştirmişse ekleyin.

Kaldırma

Modules > Module Manager sayfasına gidin, VibeFox Redsys Gateway 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 ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için korunur. Redsys ödeme kayıtları ve iadeler ile Redsys payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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