VibeFox Redsys for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleşmez.

PHP: 8.0 veya üzeri.

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

Mağaza para birimi: eklentinin desteklediği para birimlerinden biri (bkz. Yapılandırma) ve bankanızın Redsys terminalini bu para birimi için etkinleştirmiş olması gerekir. Çoğu terminal yalnızca EUR kabul eder.

Erişilebilir site: Redsys, ödeme bildirimlerini iletebilmek için sitenize internet üzerinden, oturum açma veya güvenlik duvarı engeli olmadan ulaşabilmelidir.

VibeFox lisans anahtarı: 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 bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_redsys_gateway 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 > Redsys > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. Enable/Disable seçeneğini açın. Test Mode açıkken bir test ödemesi deneyin, ardından gerçek ödemeleri kabul etmek için Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Redsys. Alanların üstünde 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ğaza 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. gösterir. Kaydettikten sonra uyarılar yeni ayarları hemen izler. Ödeme yöntemleri listesinde, satıcı kodu, terminal ve geçerli modun anahtarı geçerli olana kadar Redsys kurulum gerektiriyor olarak işaretlenir.

Genel

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önteminin adı. Varsayılan: Credit/Debit Card (Redsys).

Description: ödeme sayfası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 size 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 bağlantı içerir.

Merchant Code (FUC): Redsys satıcı kodunuz, en fazla 9 rakam. Rakam olmayan karakterler kaydederken kaldırılır.

Terminal Number: bankanızın atadığı 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ı. 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 genel 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: Enable test mode ödemeleri ve iadeleri Redsys test ortamına (SIS-T) gönderir ve test anahtarıyla imzalar. Varsayılan: açık. Gerçek ödemeleri kabul etmek için işaretini kaldırın. Açıkken ödeme sayfası ödeme yönteminin altında TEST MODE: Redsys test environment, no real money is charged. gösterir.

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

Ödeme sayfası ve siparişler

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

Order Status After Payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum yalnızca bir kez ayarlanır; böylece müşteri tek bir e-posta alır.

Ödeme bildirimleri

Redsys her ödemeyi mağazanızın bildirim adresine iletir. Adres https://your-site/wc-api/rdsg_redsys/ biçimindedir ve bu bölümde gösterilir. Eklenti bunu her ödemeyle birlikte Redsys'e gönderir; bu yüzden Redsys paneline kopyalanacak bir şey yoktur. Çevrim içi bildirim (HTTP) terminalinizde etkin olmalıdır. Başarılı bir ödemeden sonra siparişler hâlâ Ödeme bekleniyor durumunda kalıyorsa bankanıza danışın. Geçerli imzası olmayan bildirimler reddedilir. Bildirim olmadan bir sipariş ödenmiş olarak işaretlenmez.

Gelişmiş

Debug log: Enable debug logging ödemelerin, bildirimlerin ve iadelerin ayrıntılarını WooCommerce > Status > Logs bölümüne, kaynak wcp_redsys_gateway olarak yazar. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Anahtarlar, imzalar ve kart verileri hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete Data: Delete the gateway settings when the plugin is deleted. Açıkken eklenti silindiğinde ağ geçidi ayarları ve eklenti günlükleri kaldırılır. 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 birimleri için ödeme yöntemi gizlenir. Pay for order sayfasında siparişin para birimi geçerlidir.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit/Debit Card (Redsys)) ve siparişi verir. Sipariş Ödeme bekleniyor durumuna geçer ve müşteri Redirecting to Redsys for payment. Please wait... mesajını görür, ardından bankanızın Redsys ödeme sayfasına geçer. Tarayıcı kendiliğinden devam etmezse müşteri Pay via Redsys düğmesine tıklar. 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 mağazanızın dilini kullanır (İspanyolca, İngilizce, Katalanca, Fransızca, Almanca, İtalyanca, Portekizce ve daha fazlası), diğer diller için İngilizce kullanır.

Tutar, sipariş para biriminin en küçük birimleriyle gönderilir; örneğin EUR 43,45 olarak 4345, JPY veya CLP ise ondalıksız. Ödeme, sipariş numarası ve site adınızla birlikte Order olarak tanımlanır. Stok, ödeme onaylanınca azaltılır, önce değil.

Ödemeyi yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, ancak Redsys imzalı bildirimle onayladıktan sonra ödenmiş olarak işaretlenir. Bildirim gelene kadar sayfa Redsys is confirming your payment. If you completed the payment, your order will be updated in a few moments — please do not pay again. mesajını gösterir.

Müşteri iptal ederse veya ödeme reddedilirse Redsys müşteriyi mağazanıza geri gönderir. Ödeme sayfasından verilen bir sipariş, WooCommerce'in standart yöntemiyle iptal edilir ve sepet korunur. Yönetici panelinden oluşturduğunuz bir sipariş (ödeme bağlantısı) için müşteri The Redsys payment was not completed. You can try again or choose another payment method. mesajıyla Pay for order sayfasına döner ve sipariş iptal edilmez. Mağazanızın yönlendirme sayfası ayrıca Cancel order & restore cart veya yönetici panelinden oluşturulan siparişler için Choose another payment method seçeneklerini sunar.

Müşteri, ödenmemiş bir siparişi Pay for order sayfasından yeniden ödeyebilir. Her deneme yeni bir Redsys sipariş numarası alır; bunlardan herhangi biriyle, örneğin ikinci bir tarayıcı sekmesinden yapılan ödeme yine tanınır.

Sipariş Redsys'e gönderilemezse müşteri kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir: Redsys payments are not configured correctly. Please choose another payment method or contact us., para biriminin kabul edilmediğini bildiren bir mesaj ya da The order total must be greater than zero.

Ö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, Redsys sayfasında hemen yetkilendirilen ve tahsil edilen tek seferlik ödemeleri kabul eder. 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 SOAP bildirimi yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Redsys'e yönlendirildi ve henüz ödeme yapmadı ya da Redsys bildirimi henüz gelmedi. Sipariş notu Awaiting Redsys payment. yazar.

Processing, Completed or On Hold: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Sipariş notu Redsys sipariş numarasını (Ds_Order), yetkilendirme kodunu ve yanıt kodunu gösterir; test ödemeleri [TEST] ile işaretlenir. Siparişin işlem kimliği Redsys sipariş numarasıdır.

On hold after payment: Redsys, sipariş toplamından farklı bir tutar veya para birimi bildirdi; mağaza canlıdayken bir test ödemesi geldi (gerçek para çekilmedi) ya da ödeme, sipariş iptal edildikten sonra geldi. Sipariş notu nedenini açıklar. Ödemeyi Redsys yönetim panelinde kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Failed: ödeme Redsys tarafında reddedildi veya iptal edildi. Sipariş notu yanıt kodunu ve sık görülen kodlar için Insufficient funds, Card expired veya Cancelled by the customer gibi kısa bir nedeni gösterir. Yalnızca hâlâ ödeme bekleyen bir sipariş Başarısız olur. Ödenmiş veya kapanmış bir sipariş, reddedilen bir denemeyle asla değişmez; deneme yalnızca not edilir.

Cancelled: müşteri ödemeyi iptal etti ya da sipariş sizin veya WooCommerce stok tutma zaman aşımı nedeniyle iptal edildi.

Zaten ödenmiş veya iade edilmiş bir siparişe ikinci, farklı bir ödeme gelirse sipariş değişmez. Bir not, yinelenen ö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.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Redsys ödeme yöntemi üzerinden iade düğmesine tıklayın (varsayılan olarak Refund via Credit/Debit Card (Redsys)). Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (test veya canlı) Redsys REST API üzerinden gönderilir, o ortamın anahtarıyla imzalanır ve yanıt imzası kontrol edilir. Redsys iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Redsys sipariş numarası ve nedeniyle birlikte sipariş notlarına eklenir.

Redsys yönetim panelinde yapılan iadeler WooCommerce iadesi olarak kaydedilmez. Redsys bunlar için bildirim gönderdiğinde siparişe bir not eklenir. Gerekirse Redsys iade düğmesini kullanmadan WooCommerce'te manuel iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Redsys sayfasının ü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 etkin olduğu tarihi ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı 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, o alan adı hakkını serbest bırakmaz. Hakkı 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma çıkar. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisansın 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

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 modun geçerli bir anahtarı olduğunu kontrol edin: test modunda Secret Key (SHA-256) — test, canlı modda Secret Key (SHA-256) — live. Mağaza para biriminin (Pay for order sayfasında siparişin para birimi) desteklenen para birimleri listesinde olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kaldı: Redsys bildirimi mağazanıza ulaşmadı. Bankanızdan, terminalinizde çevrim içi bildirimin (HTTP) etkin olduğunu kontrol etmesini isteyin. Ödeme bildirimleri bölümünde gösterilen adresin oturum açma, bakım sayfası veya güvenlik duvarı engeli olmadan internetten erişilebilir olduğunu kontrol edin. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, kaynak wcp_redsys_gateway olarak bakın.

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

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

Bildirim Busy yanıtı veriyor: sipariş aynı anda başka bir bildirim tarafından işleniyordu. Redsys bildirimi yeniden dener.

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

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı, mağaza canlıdayken bir test ödemesi geldi ya da ödeme sipariş iptal edildikten sonra geldi. Siparişi yerine getirin veya ödemeyi iade edin.

Test ödemeleri canlı modda siparişleri onaylamaz: Test Mode kapalıyken bir test ödemesi hiçbir zaman 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 tutarı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şılamıyorsa iade yapılmaz. Daha sonra tekrar deneyin.

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

1.0 sürümünden güncelledikten sonra: test modunda kullandığınız anahtar artık Secret Key (SHA-256) — test alanındadır. Test Mode seçeneğinin işaretini kaldırmadan önce canlı anahtarı girin. 1.0 sürümüyle oluşturulan siparişler bildirim ve iade almaya devam eder.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa vibefox.net hesabınızda bir hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı 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 eklenti günlükleri yalnızca Delete Data açıksa kaldırılır; aksi halde ileride yeniden kurulum için saklanır. Siparişlerde saklanan Redsys verileri her zaman korunur, çünkü ödemeleri belgeler ve iadeler için gereklidir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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