VibeFox Redsys 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.

Redsys satıcı hesabı: bankanız (size Redsys sanal POS'unu sağlayan 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 anahtardan farklıdır. Çevrimiçi bildirim (HTTP) terminaliniz için etkin olmalıdır. Emin değilseniz bankanıza danışın.

Para birimi: eklentinin desteklediği para birimlerinden biri (bkz. Yapılandırma) 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 internet üzerinden giriş yapmadan ve güvenlik duvarı engeli olmadan erişebilmelidir.

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

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_redsys_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_redsys_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_redsys_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications sayfasını yenilemeniz gerekmez. Yükleyici yerine, bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions sayfasına gidin ve tür olarak Payments seçin. VibeFox Redsys Gateway eklentisini 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 simgeli düğme) tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Satıcı kodunuzu, terminalinizi ve her ortamın gizli anahtarını girin (bkz. Yapılandırma).

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

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_redsys_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Redsys Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve Redsys bilgilerini OpenCart 3 için 3-5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Ödeme bildirimleri).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Redsys Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Ayarların üzerinde sayfa; satıcı kodu eksik veya yalnızca rakamlardan oluşmuyorsa, bir gizli anahtar geçerli bir Redsys SHA-256 anahtarı değilse, geçerli modun anahtarı boşsa (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Test modu açıkken Test mode is active: payments go to the Redsys test environment (SIS-T), no real money is charged. ifadesini gösterir.

Kaydederken Title alanı 1 ila 128 karakter uzunluğunda olmalıdır (Enter a title for the payment method (1 to 128 characters).), Sort Order tam sayı olmalıdır (negatif sayılara izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve bölge ile her sipariş durumu mevcut olmalıdır. Aksi takdirde 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 sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit/Debit Card (Redsys). Zorunludur, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında, onay düğmesinin üzerinde gördüğü metin. Varsayılan: Pay securely with your credit or debit card via Redsys.

Sort Order: Redsys'in ödeme sayfasındaki ödeme yöntemleri arasındaki sırası. Boş bırakın veya bir tam sayı girin.

Geo Zone: Redsys'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones altında ayarlanır.

Total: Redsys'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme tutarı: 0 veya daha büyük bir sayı. Her tutar için Redsys sunmak üzere boş bırakın.

Redsys hesabı

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

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

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

Secret Key (SHA-256) — live: gerçek (üretim) ortamını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. 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 tahsil edilmez.

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 müşteriler Confirm Order adımında TEST MODE: Redsys test environment, no real money is charged. ifadesini görür.

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

Kayıtlı anahtarlar bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı kaldırmak için alanın altındaki Clear saved secret on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Ö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: ödenmiş bir siparişin alacağı durum.

Tutar veya para birimi uyuşmazlıkları, geçit canlı moddayken yapılan test ödemeleri ve iptal edilen denemelerin ödemeleri her zaman On hold (review) status alır.

OpenCart, siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Yalnızca imzalı Redsys bildiriminden sonra bir durum alır. Reddedilen veya iptal edilen bir ödeme siparişi durumsuz bırakır; müşteri sepeti korunmuş olarak ödeme sayfasına döner. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Processing status: Order Status After Payment Processing olduğunda kullanılır. Varsayılan: İşleniyor.

Completed status: Order Status After Payment Completed olduğunda kullanılır. Varsayılan: Tamamlandı.

On hold (review) status: incelemenizi gerektiren ödemeler için (yukarıya bakın) veya Order Status After Payment On hold (review) olduğunda ödenmiş her sipariş için. Varsayılan: Beklemede; çünkü OpenCart'ta On hold durumu yoktur; siparişteki bir not nedenini açıklar. System > Localisation > Order Statuses altında kendi durumunuzu oluşturup buradan seçebilirsiniz.

Refunded status: Redsys ödemesi sipariş sayfasından tamamen iade edildiğinde ayarlanır. Varsayılan: İade edildi.

Ödeme bildirimleri

Notification URL: Redsys her ödemeyi mağazanızın bu adresine bildirir. Bu bölümde gösterilir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_redsys_gateway/notify, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_redsys_gateway/payment/wcp_redsys_gateway.notify gibi görünür. URL, OpenCart kurulumunuzun mağaza adresinden oluşturulur. Eklenti bunu her ödemede Redsys'e gönderir; bu nedenle Redsys paneline kopyalanacak bir şey yoktur. Çevrimiçi bildirim (HTTP) terminaliniz için etkin olmalıdır. Başarılı bir ödemeden sonra hiçbir sipariş onaylanmıyorsa bankanıza danışın. Geçerli imzası olmayan bildirimler reddedilir. Bildirim olmadan sipariş hiçbir zaman bir durum almaz.

Gelişmiş

Debug log: ödeme, bildirim ve iade ayrıntılarını OpenCart günlükler klasöründeki (storage/logs) rdsg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında eski bir kopyaya taşınır. Hatalar, bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Anahtarlar, imzalar ve kart verileri asla günlüğe yazılmaz. Varsayılan: kapalı.

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

Delete Data: açık olduğunda eklentiyi kaldırmak, geçit ayarlarını ve günlüğü siler. Siparişlerin Redsys ödeme kayıtları (iadeler için gerekli) her zaman korunur. Varsayılan: kapalı.

İçe Aktar / Dışa Aktar

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar 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ı gizli anahtarlar korunur.

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. Müşterinin para birimi bu listede yoksa ödeme yöntemi gizlenir.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Redsys)). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, yine durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti imzalı bir ödeme formu hazırlar, müşteri Redirecting to Redsys for payment. Please wait... ifadesini görür ve bankanızın Redsys ödeme sayfasına geçer. Tarayıcı kendiliğinden devam etmezse müşteri Pay via Redsys düğmesine tıklar. 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.

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

Ödemeden sonra müşteri mağazanıza geri döner. Geri dönüş tek başına hiçbir şeyi ödenmiş olarak işaretlemez. Sipariş, yalnızca Redsys imzalı bildirimle onaylarsa ödenmiş olarak işaretlenir. Ardından sipariş, OpenCart'ın olağan yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri Your payment with Redsys has been received. mesajıyla OpenCart sipariş başarı sayfasını görür. Sipariş On hold (review) status aldıysa sayfa Your payment with Redsys has been received and is being reviewed by the store. gösterir. Bildirim henüz gelmediyse Payment confirmation sayfası Redsys is confirming your payment. If you completed the payment, your order will be confirmed in a few moments — please do not pay again. metni ile Check again ve 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 sayfasına geri gönderir. Sepet korunur ve müşteri yeniden ödeme yapabilir. Her yeni deneme yeni bir Redsys sipariş numarası alır; bunlardan herhangi biriyle, örneğin ikinci bir tarayıcı sekmesinden yapılan ödeme yine de tanınır. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; aynı sepetin başka bir siparişi zaten ödenmişse müşteri doğrudan başarı sayfasına gider ve diğer siparişin geç gelen ödemesi uygulanmaz.

OpenCart 4'te tamamlanmayan ödemeye ilişkin mesaj, ödeme sayfasının üstünde gösterilir. OpenCart 4, ödeme sayfası için tek bir siparişi tutar ve onu günceller; bu nedenle iptalden veya reddedilen bir ödemeden sonra müşteri aynı siparişi yeni bir Redsys sipariş numarasıyla öder. Bu arada sipariş kapatılmışsa müşteri, Your previous order was closed without a payment. Please confirm the order again to pay with a new order. ya da siparişte bir Redsys ödemesi varsa Your order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir. Bir sonraki Confirm Order yeni bir siparişi öder. Ödeme sayfasındaki sipariş zaten ödenmişse ama sepet o zamandan beri değişmişse (yeni adet dahil), müşteri ödeme sayfasına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

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

Bildirim ve müşterinin dönüşü de mağaza bakım modundayken çalışır: OpenCart 3, ödeme eklentisi isteklerine izin verir; OpenCart 4'te ise eklenti bunlar için bir başlangıç eylemi ekler.

Eklenti yalnızca tek seferlik ödemeleri kabul eder; bunlar Redsys sayfasında hemen yetkilendirilir ve tahsil edilir. Kendi sitenizde kart formu (InSite veya iframe), kayıtlı kart, tek tıkla ödeme veya tokenizasyon, abonelik veya tekrarlayan ödeme, sonradan tahsilatlı ön yetkilendirme ve yönetici panelinde oluşturulan siparişler için ödeme bağlantısı yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Redsys'e yönlendirildi ve ödeme yapmadı, ödeme reddedildi veya iptal edildi ya da Redsys bildirimi henüz gelmedi. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Processing, Completed veya On hold (review): ödeme onaylandı. Durum, Order Status After Payment ayarını izler. Bir notta Redsys sipariş numarası (Ds_Order), onay kodu ve yanıt kodu gösterilir; test ödemeleri [TEST] ile işaretlenir.

Ödemeden sonra On hold (review) durumu: Redsys, sipariş toplamından farklı bir tutar veya para birimi bildirdi; geçit canlı moddayken bir test ödemesi geldi (gerçek para tahsil edilmedi) ya da müşteri, Redsys sayfasında o ödemeyi iptal ettikten sonra ödeme yaptı. Not bunu açıklar. Ödemeyi Redsys yönetim panelinde kontrol edin, ardından siparişi işleyin veya ödemeyi iade edin.

Refunded status: ödeme eklenti üzerinden tamamen iade edildi.

Reddedilen bir ödeme, zaten durumu olan 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 ödenmiş bir sipariş veya sepet için ikinci, farklı bir ödeme gelirse sipariş değişmez. Bir not, yinelenen ödemeyi Redsys yönetim panelinden iade etmenizi ister. Redsys bir ödemenin hâlâ işlemde olduğunu bildirirse bir not eklenir ve sipariş nihai sonucu bekler.

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

VibeFox Redsys Gateway sekmesi

Sales > Orders sayfasında Redsys ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Redsys Gateway sekmesinde Redsys order number (Ds_Order), Authorisation code / response, Environment (canlı veya test) ve Test mode etiketi, ödemenin Status bilgisi, Paid / refunded, bekleyen siparişler için inceleme ipucu, iade formu, iade geçmişi, siparişin Redsys notes bölümü ve Redsys order numbers issued for this cart gösterilir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) 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 değiştirme izniniz olmalıdır (Sales > Orders, System > Users > User Groups altında ayarlanır). İadeler, Redsys'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortamın (test veya canlı) Redsys REST API'sine, o ortamın anahtarıyla imzalanarak gönderilir ve yanıt imzası kontrol edilir. Redsys iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Redsys sipariş numarası ve nedenle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan, elle yapılan bir durum değişikliği gibi Refunded status durumuna alır. Kısmi iade durumu değiştirmez.

Sales > Returns altındaki ürün iadeleri Redsys üzerinden para göndermez.

Redsys yönetim panelinde yapılan iadeler, eklentinin 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ı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Redsys Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Redsys Gateway > Edit sayfasında ayarların üstündeki 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-redsys satırı ve 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önetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini açıklar, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte 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 son bilinen 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 Redsys, müşterilere ödeme sayfasında 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. Aynı tarayıcıda yönetici paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada hâlâ (unlicensed — visible to admins only) işaretiyle 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 panelinde oturum açıldığını görmez; bu yüzden etkin bir anahtar yoksa ö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. Bunu × ile kapatırsanız 7 gün boyunca gizlenir. 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. Yönetici Dashboard veya Edit sayfasını açtığınızda durum 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. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Redsys ödeme sayfası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 geçerli modda geçerli bir anahtar bulunduğunu kontrol edin: test modunda Secret Key (SHA-256) — test, canlı modda Secret Key (SHA-256) — live. Müşterinin para biriminin desteklenen para birimleri listesinde olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş durumsuz kaldı: Redsys bildirimi mağazanıza ulaşmadı. Bankanızdan, terminaliniz için çevrimiçi bildirimin (HTTP) etkin olduğunu kontrol etmesini isteyin. Notification URL altında gösterilen adresin, giriş yapmadan ve güvenlik duvarı engeli olmadan internetten erişilebilir olduğunu kontrol edin. Debug log seçeneğini açın ve eklenti 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 sipariş 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ş durumu ayarlanamadı. Redsys bildirimi yeniden dener. Nedeni günlükte görünür.

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

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

Test ödemeleri canlı modda siparişleri onaylamıyor: Test Mode kapalıyken bir test ödemesi hiçbir zaman bir siparişi ödemez. Bunun yerine sipariş bir notla beklemeye alınır. Test ödemeleri için test modunu ve test anahtarını 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 kısmını aşıyor), SIS0056 (özgün ö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şılamazsa iade yapılmaz. Daha sonra tekrar deneyin.

Sekmede iade formu yok: sekme nedenini belirtir: örneğin siparişin onaylanmış bir Redsys ödemesi olmaması, tamamen iade edilmiş olması veya kullanıcı grubunuzun siparişleri değiştirme izninin olmaması.

Geliştiriciler için: eklenti OpenCart olaylarını tetikler: wcp_redsys_gateway/merchant_parameters (ödeme parametreleri ve sipariş) ve wcp_redsys_gateway/currency_codes (desteklenen para birimlerinin listesi). Bankanız bir para birimini terminal için etkinleştirmediyse eklemeyin.

Kaldırma

Extensions > Extensions sayfasına gidin, tür olarak Payments seçin ve VibeFox Redsys 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 dört sipariş durumu; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda bildirimin ve müşterinin dönüşünün geçmesine izin veren başlangıç eylemi de kaldırılır). Delete Data açıksa diğer geçit ayarları (başlık, açıklama, satıcı kodu, terminal, anahtarlar, test modu, mağaza adı, ödeme sonrası sipariş durumu, günlükleme) ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanır. Redsys ödeme kayıtları ve iadeleri her zaman korunur; bu nedenle önceden ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Redsys Gateway yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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