VibeFox Transbank for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

Para birimi: Şili pesosu (CLP). Webpay Plus yalnızca tam peso tahsil eder; bu nedenle International > Localization > Currencies bölümünde CLP para biriminin hassasiyetini 0 olarak ayarlayın. Başka para birimindeki sepetler için ödeme yöntemi gösterilmez.

Transbank hesabı: gerçek ödemeler için canlı Commerce Code ve API Key Secret içeren standart bir Webpay Plus ticari hesabına (anında tahsilat) ihtiyacınız vardır. Transbank, üyeliğiniz onaylandığında Commerce Code'u, entegrasyon doğrulama sürecinden sonra da API Key Secret'ı verir (Transbank geliştirici dokümantasyonuna bakın). Testler için kimlik bilgisi gerekmez. Webpay Plus Mall, Oneclick ve ertelenmiş tahsilat ticari kodları desteklenmez.

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 ya da daha sonra modül listesinde VibeFox Transbank 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. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Integration (test) mode açıkken, Transbank geliştirici dokümantasyonundaki test kartlarını kullanarak bir ödeme deneyin.

5. Canlıya geçmek için Production Commerce Code ve Production API Key Secret değerlerinizi girin, Integration (test) mode seçeneğini kapatın ve Save düğmesine tıklayın.

Transbank tarafında dönüş URL'si veya webhook ayarlamanız gerekmez. Modül, her işlemle birlikte kendi dönüş URL'sini gönderir.

Kurulumda modül Transbank payment on hold sipariş durumunu oluşturur. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Bunları Payment > Preferences bölümünden sınırlayabilirsiniz; CLP para biriminin modül için izinli kalması gerekir.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Transbank 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; üretim seçili olmasına rağmen üretim Commerce Code veya API Key eksik ya da geçersizse (bu durumda Webpay ödeme sayfasında gizlenir), mağazanın varsayılan para birimi CLP değilse (ödeme yöntemi diğer para birimleri için gizlenir) ve CLP'nin ondalık basamağı varsa (tutarlar tam pesoya yuvarlanır) sizi uyarır. Entegrasyon modu açıkken sayfa, ödemelerin herkese açık test ticari koduyla Transbank entegrasyon ortamına gittiğini ve gerçek para tahsil edilmediğini gösterir.

Transbank Webpay Plus

Enable / Disable: Enable Transbank Webpay Plus payments ö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 de ödeme yönteminin adı olarak kaydedilir. Varsayılan: Webpay Plus. Zorunlu: başlık boşken kaydederseniz Enter a title for the payment method. görünür.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with credit, debit or prepaid card via Webpay.

Ortam ve kimlik bilgileri

Bölüm metni Transbank geliştirici dokümantasyonuna bağlantı verir ve Transbank'ın üretim kimlik bilgilerini ne zaman verdiğini açıklar.

Integration (test) mode: ödemeler, otomatik olarak doldurulan herkese açık test ticari kodu (597055555532) ile Transbank entegrasyon ortamına gider. Aşağıdaki üretim kimlik bilgileri kullanılmaz ve gerçek para tahsil edilmez. Varsayılan: açık. Canlıya geçmek için kapatın. Açıkken müşteriler, ödeme yöntemi açıklamasının üstünde TEST MODE: entegrasyon ortamı. Gerçek tahsilat yok. mesajını görür.

Production Commerce Code: üretim ticari kodunuz (Tbk-Api-Key-Id): 5970 ile başlayan 12 haneli. Kodunuz 8 haneliyse olduğu gibi girin; modül kaydederken 5970 önekini ekler. Boşluklar ve diğer karakterler kaldırılır. Transbank'ın herkese açık test ticari kodları üretimde kabul edilmez.

Production API Key Secret: üretim ticari kodunuzun Tbk-Api-Key-Secret değeri. Gizli tutun. Kaydederken boşluklar kaldırılır. Kayıtlı bir anahtar bir daha 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.

Clear saved API key: Production API Key Secret kutusunu işaretleyin ve kayıtlı anahtarı kaldırmak için Save düğmesine tıklayın. Boş alan kayıtlı değeri korur.

Dönüş URL'si

Return from Webpay: Transbank'ın müşteriyi geri yönlendirdiği adres, yalnızca bilgi amaçlı gösterilir. Transbank'ta bir şey ayarlamanız gerekmez: modül bu URL'yi her işlemle gönderir. Müşterilerin erişebilmesi gerekir; bakım modu bunu engellemez.

Gelişmiş

Debug log: API isteklerini ve dönüşleri modül klasöründeki logs/wc_tbk_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar ve uyarılar bu seçenek kapalıyken bile her zaman kaydedilir. Kart verisi, API anahtarları ya da tam token'lar 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 on uninstall: açıksa modül kaldırıldığında geçit ayarları ve günlük silinir. Sipariş verileri korunur. Varsayılan: kapalı.

Test ve canlı

Integration (test) mode yeni ödemelerin nereye gideceğini belirler. Her ödeme kendi ortamını hatırlar: bir ödemenin onayı ve iadeleri, modu sonradan değiştirseniz bile her zaman o ödemenin oluşturulduğu ortama (entegrasyon veya üretim) ve o kimlik bilgileriyle gider.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Webpay logolu Webpay Plus) ve onaylar. Modül, sepet tutarı için tam peso olarak bir Transbank işlemi oluşturur (ondalıklı tutar en yakın pesoya yuvarlanır) ve müşteriyi Webpay formuna yönlendiren kısa bir Redirecting to Webpay. Please wait... sayfasına gönderir. JavaScript olmadan müşteri Proceed to Webpay düğmesine tıklar. Webpay'de müşteri kredi kartı, banka kartı veya ön ödemeli kartla öder. Bu noktada henüz bir sipariş yoktur.

Müşteri geri döndüğünde modül işlemi sunucudan sunucuya Transbank ile onaylar (commit). Sipariş, ancak Transbank onayladıktan sonra ödenmiş olarak işaretlenir: yanıt onaylanmış olmalı ve tutar, buy order ile oturum bu deneme için mağazanın gönderdiğiyle eşleşmelidir. Sipariş ardından oluşturulur ve müşteri Your Webpay payment has been received. mesajıyla standart sipariş onay sayfasını görür. Beklemedeki bir sipariş için sayfa Your Webpay payment was received and is being reviewed by the shop. mesajını gösterir.

Onay isteği başarısız olursa, örneğin zaman aşımında, modül Transbank'tan işlemin durumunu sorar. Durum hâlâ bilinemiyorsa sipariş oluşturulmaz ve müşteri We could not confirm your Webpay payment with Transbank. Please try again in a moment; if your card was charged, contact us before paying again. mesajını görür. Aynı anda başka bir istek aynı sepeti onaylıyorsa ya da Transbank ödemeyi onaylamış ama sipariş henüz oluşturulamamışsa, müşteri Payment confirmation sayfasında Your Webpay payment is being confirmed. Please do not pay again — check again in a moment. mesajını ve Check again düğmesini görür. Sipariş bu durumda, ikinci bir onay olmadan kayıtlı yanıttan oluşturulur.

Müşteri Webpay'de iptal ederse ya da Webpay formu süresi dolar veya hata verirse hiçbir tutar tahsil edilmez. Müşteri, örneğin You cancelled the Webpay payment. Nothing was charged — you can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Reddedilen bir kart Your Webpay payment was rejected and nothing was charged. Please try again or choose another payment method. mesajını gösterir. Sepet korunur ve her yeni deneme yeni bir Webpay işlemidir.

Ödeme başladıktan sonra sepet değişirse (örneğin başka bir sekmede ya da sepetteki bir kupon geçerliliğini yitirip PrestaShop onu kaldırdıysa), işlem onaylanmaz ve Transbank onu tahsil etmez. Müşteri Your cart changed after the Webpay payment was started. The payment was not confirmed, so it was not charged — please pay again. mesajını görür. Sepetin zaten bir siparişi varsa (başka bir denemeyle ya da başka bir ödeme yöntemiyle ödenmiş), geç gelen bir dönüş de onaylanmaz ve müşteri, sipariş ödenmemişse This order can no longer be paid (it was cancelled or already paid). Your Webpay payment was not confirmed, so it was not charged. mesajını görür.

Webpay ödemeyi başlatamazsa müşteri ödeme sayfasında kalır ve örneğin Could not connect to Webpay. Please try again in a moment. ya da Webpay payments are not available at the moment. Please choose another payment method. gibi kısa bir mesaj görür. Teknik neden günlüğe yazılır.

Mağaza bakım modundayken Webpay'den dönüş çalışır ve mağazanızın ülke kısıtlaması tarafından engellenmez.

Transbank'ın ödeme webhook'u yoktur: sonuç, müşteri Webpay'den döndüğünde işlenir. Müşteri Webpay'de tarayıcıyı kapatır ve hiç dönmezse işlem onaylanmaz ve sipariş oluşturulmaz; Transbank'a göre onaylanmamış işlemler tahsil edilmez. Modül Webpay Plus Mall, Oneclick kayıtlı kartları, abonelikler, ertelenmiş tahsilat veya para birimi dönüşümünü desteklemez.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Webpay'e yönlendirildi ancak ödemedi, iptal etti, formun süresinin dolmasına izin verdi, kart reddedildi veya ödeme henüz onaylanamadı. Yalnızca sepet vardır.

Payment accepted: Transbank ödemeyi onayladı. Ödeme, Webpay token'ı işlem kimliği olarak kaydedilir; bir not onay kodunu, kartın son dört hanesini, buy order'ı, tutarı, ödeme türünü ve taksit sayısını gösterir.

Transbank payment on hold: Transbank, siparişle eşleşmeyen bir ödemeyi (tutar, buy order veya oturum) yetkilendirdi ya da Transbank ödemeyi onayladıktan sonra sepetteki bir kupon geçerliliğini yitirdi ve PrestaShop onu kaldırdı. Ödeme, Transbank'ın tahsil ettiği tutarla kaydedilir ve not farkları listeler. Transbank portalını kontrol edin ve siparişi tamamlayın ya da ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Webpay, zaten siparişi olan bir sepet için ödeme döndürürse ödeme onaylanmaz ve o siparişteki bir not, müşteri bir tahsilat bildirirse Transbank portalını kontrol etmenizi ister. Sonraki denemeler mevcut siparişleri etkilemez.

Transbank Webpay Plus bloğu

Sipariş sayfasında; buy order ve ortamı, ödeme durumu, onay kodu, kart ve ödeme türü ile taksit sayısı, tahsil edilen ve iade edilen tutar, test ödemeleri için Integration rozeti, iade geçmişi, Webpay attempts of the cart ve siparişin Transbank notes bölümü bulunan Transbank Webpay Plus bloğu gösterilir.

İadeler

Transbank Webpay Plus bloğunda tutarı CLP olarak girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via Transbank düğmesine tıklayın. Refund this amount via Transbank? sorusunu onaylayın. Tam ve kısmi iadeler tam peso olarak desteklenir. Siparişleri düzenleme yetkisine ihtiyacınız vardır; Modules sayfalarına erişim gerekmez. Ondalıklı kısmi tutar Webpay refunds are in whole Chilean pesos. Please enter an amount without decimals. mesajıyla reddedilir. Ondalıklı bir sipariş toplamının kalan kuruşu tahsilat gibi yuvarlanır. İadeler Transbank'ın tahsil ettiği tutara kadar yapılabilir; bu nedenle bir uyuşmazlıktan sonra müşterinin gerçekte ödediğini iade edebilirsiniz. İade, ödemenin yapıldığı ortama gider; bu nedenle canlı bir ödeme için üretim kimlik bilgileri kayıtlı olmalıdır.

Transbank bir iptal (REVERSED) veya geçersiz kılma (NULLIFIED) ile yanıt verir. Başarılı bir iade, iade geçmişine ve notlara tutar, tür, onay kodu ve Transbank'ta kalan bakiye ile eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez. Transbank iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Transbank üzerinden para iade etmez. Transbank portalında yapılan iadeler PrestaShop'a aktarılmaz.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Transbank Gateway lisans bloğu, Modules > Module Manager > VibeFox Transbank 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, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve Check now düğmesini, durumu yeniden kontrol etmek için, Change key düğmesini başka bir anahtar girmek için ve Remove key düğmesini anahtarı bu mağazadan kaldırmak için gösterir. Bunların altında Product: presta-payment-transbank satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri 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 License expired on ve bir tarih. Mağaza adresi değiştikten sonra veya hesabınızdaki 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 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ı serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Webpay Plus, ödeme sırası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, back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizden de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ama ödeme sırası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, müşteri Webpay'den döndüğünde yine onaylanır ve sipariş sayfasındaki iadeler çalışır.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, 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

Webpay Plus ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, sepet para biriminin CLP olduğunu ve entegrasyon modu kapalıyken geçerli bir Production Commerce Code (5970 ile başlayan 12 hane) ile bir Production API Key Secret kaydedildiğini kontrol edin. Ayarlar sayfası, eksik her koşul için uyarı gösterir. Payment > Preferences bölümünde modülün CLP, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme geçti ama sipariş oluşturulmadı: Transbank'ın webhook'u yoktur, bu nedenle sipariş yalnızca müşteri Webpay'den döndüğünde oluşturulur. Müşteri Webpay'de tarayıcıyı kapattıysa işlem onaylanmamıştır ve Transbank'a göre tahsil edilmez. Debug log seçeneğini açın, Log alanına bakın ve işlemi Transbank portalında kontrol edin.

Müşteri We could not confirm your Webpay payment with Transbank mesajını görüyor: onay isteği başarısız oldu ve durum kontrol edilemedi. Sipariş oluşturulmadı ve nedeni günlükte. Müşteri birazdan tekrar deneyebilir. Transbank portalı işlemi yetkilendirilmiş gösteriyorsa müşteri tekrar ödeme yapmadan önce onunla iletişime geçin.

Müşteri Your cart changed after the Webpay payment was started mesajını görüyor: sepet tutarı işlemden farklıydı; örneğin başka bir sekmedeki bir değişiklik ya da süresi dolmuş bir kupon nedeniyle. Hiçbir tutar tahsil edilmedi; müşteri yeni tutarı öder.

Müşteri Webpay Plus seçerken bir hata görüyor: Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın. Webpay payments are not available at the moment genellikle hatalı üretim kimlik bilgileri anlamına gelir. Could not connect to Webpay, Transbank'a ulaşılamadığı anlamına gelir. Transbank Webpay only supports payments in CLP (Chilean Peso) ise sepetin başka bir para biriminde olduğu anlamına gelir.

Tutarlar ve iadeler birkaç peso farklı: CLP para biriminin ondalık basamağı vardır. Webpay yalnızca tam peso tahsil eder, bu nedenle tutarlar yuvarlanır. International > Localization > Currencies bölümünde CLP hassasiyetini 0 olarak ayarlayın.

Ödemeden sonra sipariş Transbank payment on hold durumunda: Transbank Webpay Plus bloğundaki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın ya da ödemeyi iade edin.

İade şu hatayla başarısız oluyor: The production Commerce Code / API Key are missing: ödeme üretimde yapıldı ve üretim kimlik bilgileri kayıtlı değil. Bunları girin ve tekrar deneyin.

İade şu hatalarla başarısız oluyor: Transbank refused the refund ya da Transbank did not approve the refund: Transbank kabul etmedi; mesaj nedeni ya da Transbank'ın döndürdüğü türü ve yanıt kodunu gösterir. Hiçbir şey iade edilmedi. Transbank portalında işlemi kontrol edin.

İade şu hatayla başarısız oluyor: Another request is processing this order: sipariş tam o sırada iade ediliyor ya da onaylanıyordu. Birazdan tekrar deneyin.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Transbank 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 on uninstall açıksa geçit ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerin Webpay denemeleri ve iadeleri ile Transbank payment on hold sipariş durumu her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

Transbank ve Webpay, ilgili sahiplerinin ticari markalarıdır. Bu modül Transbank ile bağlantılı değildir ve Transbank tarafından onaylanmamıştır.