VibeFox Transbank for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edildi) veya 4.0.2 ve sonrası (4.1.0.3 sürümünde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: Şili pesosu (CLP). Mağazanızda yoksa System > Localisation > Currencies bölümünden 0 ondalık basamakla ekleyin: Webpay Plus yalnızca tam peso tahsil eder. Başka bir para biriminde yapılan siparişlerde ödeme yöntemi gösterilmez.

Transbank hesabı: canlı ödemeler için, üretim Commerce Code ve API Key Secret bilgilerine sahip standart bir Webpay Plus işyeri (anında tahsilat) gerekir. Transbank, üye olma başvurunuz onaylandığında Commerce Code'u, entegrasyon doğrulama sürecinden sonra ise API Key Secret'ı verir (Transbank geliştirici dokümantasyonuna bakın). Testler için kimlik bilgisi gerekmez. Webpay Plus Mall, Oneclick ve ertelenmiş tahsilat işyeri kodları desteklenmez.

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

Kurulum

İndirme, her 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_transbank_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_transbank_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 bölümüne gidin, Upload düğmesini tıklayın ve wcp_transbank_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümü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 bölümüne gidin ve tür olarak Payments seçin. VibeFox Transbank 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 yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın 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 CLP cinsinden bir ödeme deneyin.

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

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_transbank_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 + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve tür olarak Payments seçin. VibeFox Transbank Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) tıklayın, ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve ayarları 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 dönüş URL'si farklıdır (bkz. Dönüş URL'si).

Transbank tarafında bir dönüş URL'si veya webhook ayarlamanız gerekmez. Eklenti, her işlemle birlikte kendi dönüş URL'sini gönderir. Yeni bir kurulum, ödeme yöntemi kapalı ve entegrasyon modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Transbank Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa; üretim modu seçili olduğunda ancak ü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 ondalık basamak içeriyorsa (toplamlar tam pesoya yuvarlanır) sizi uyarır. Entegrasyon modu açıkken sayfa, ödemelerin herkese açık test işyeri koduyla Transbank entegrasyon ortamına gittiğini ve gerçek para tahsil edilmediğini gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez ve sayfa hatayı gösterir.

Transbank Webpay Plus

Enable / Disable: Enable Transbank Webpay Plus payments ödeme yöntemini açar veya kapatır. Varsayılan: off.

Title: müşterinin ödeme sırasında gördüğü ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak saklanır. Varsayılan: Webpay Plus. Zorunludur, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay with credit, debit or prepaid card via Webpay.

Sort Order: ödeme sırasında Webpay'in ödeme yöntemleri arasındaki konumu. Boş bırakın veya tam sayı girin (negatif değerlere izin verilir).

Geo Zone: Webpay'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 bölümünde ayarlanır.

Total: Webpay'in sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme tutarı. Herhangi bir tutar için Webpay sunmak üzere boş bırakın.

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, herkese açık test işyeri kodu (597055555532) ile Transbank entegrasyon ortamına gider ve bu kod otomatik olarak kullanılır. Aşağıdaki üretim kimlik bilgileri kullanılmaz ve gerçek para tahsil edilmez. Varsayılan: on. Canlıya geçmek için kapatın. Açıkken müşteriler Confirm Order adımında TEST MODE — Entegrasyon ortamı. Gerçek tahsilat yok. ifadesini görür.

Production Commerce Code: üretim işyeri kodunuz (Tbk-Api-Key-Id): 5970 ile başlayan 12 haneli kod. Kodunuz 8 haneliyse olduğu gibi girin; 5970 öneki kaydederken eklenir. Boşluklar ve diğer karakterler silinir. Transbank'ın herkese açık test işyeri kodları üretimde çalışmaz: bunlardan biriyle Webpay ödeme sayfasında gizli kalır.

Production API Key Secret: üretim işyerinizin Tbk-Api-Key-Secret değeri. Gizli tutun. Kaydederken boşluklar silinir. Kaydedilmiş 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. Kayıtlı anahtarı silmek için Clear saved API key kutusunu işaretleyin ve Save düğmesine tıklayın.

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 yapılır.

Dönüş URL'si

Return from Webpay: Transbank'ın müşteriyi geri gönderdiği adres, bilgi amacıyla gösterilir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_transbank_gateway/back, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_transbank_gateway/payment/wcp_transbank_gateway.back. Transbank tarafında hiçbir şey ayarlanmaz: eklenti bu URL'yi her işlemle gönderir (Transbank'ta webhook yoktur: ödeme, müşteri geri döndüğünde onaylanır). İnternetten erişilebilir olmalıdır; bakım modu buna engel olmaz (OpenCart 4'te eklenti bunun için bir başlangıç eylemi ekler).

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, müşteri Webpay'den döndüğünde mağaza işlemi Transbank ile doğruladıktan (commit) sonra bir durum alır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: onaylanmış ve doğrulanmış bir Webpay ödemesinden sonra ayarlanan durum. Varsayılan: Processing.

Transbank Payment On Hold Status: Transbank, siparişle eşleşmeyen bir ödemeyi (tutar, buy order, session id) yetkilendirdi: sipariş manuel inceleme için beklemeye alınır ve bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildiğinde ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: API isteklerini ve yanıtlarını OpenCart günlükler klasöründeki (storage/logs) wc_tbk_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Kart verileri, API anahtarları ve tam jetonlar kaydedilmez. Varsayılan: off.

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

Delete data on uninstall: açıksa, eklentiyi kaldırmak ağ geçidi ayarlarını ve günlüğü siler. Sipariş ve ödeme verileri her zaman korunur. Varsayılan: off.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. API Key Secret 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ı API anahtarı korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Webpay Plus). Confirm Order adımında müşteri sizin açıklamanızı ve You will be redirected to Webpay (Transbank) to complete the payment. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için tam peso cinsinden bir Transbank işlemi oluşturur (ondalıklı toplamlar en yakın pesoya yuvarlanır) ve müşteri doğrudan Webpay formuna geçer; burada kredi, banka kartı veya ön ödemeli kartla öder. 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.

Müşteri geri döndüğünde eklenti, işlemi sunucudan sunucuya Transbank ile onaylar (commit). Sipariş, yalnızca Transbank onayladıktan sonra ödenmiş olarak işaretlenir: yanıt onaylanmış olmalı ve tutar, buy order ile oturum, mağazanın bu deneme için gönderdiği bilgilerle eşleşmelidir. Ardından sipariş, standart OpenCart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle birlikte durum alır ve müşteri Your Webpay payment has been received. mesajını içeren OpenCart sipariş başarı sayfasını görür. İncelemedeki bir sipariş için sayfa Your Webpay payment was received and is being reviewed by the store. gösterir.

Onay çağrısı başarısız olursa, örneğin zaman aşımı nedeniyle, eklenti Transbank'a işlemin durumunu sorar. Durum hâlâ bilinemiyorsa sipariş durumsuz kalır 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ıyla ödeme sayfasına döner. Bu sırada aynı sepeti onaylayan başka bir istek varsa veya Transbank ödemeyi onayladı ama sipariş durumu henüz ayarlanamadıysa, müşteri Payment confirmation sayfasını görür; sayfada Your Webpay payment is being confirmed. Please do not pay again — check again in a moment. yazar ve Check again ve Back to checkout düğmeleri bulunur. Durum daha sonra kaydedilmiş yanıttan, ikinci bir onay olmadan ayarlanır.

Müşteri Webpay'de iptal ederse veya Webpay formu zaman aşımına uğrar ya da 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. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur. OpenCart 4 ise ödeme için tek bir sipariş tutar ve onu günceller; bu nedenle iptal edilen veya reddedilen bir ödemeden sonra müşteri aynı siparişi yeni bir Webpay işlemiyle öder. Ödeme başladıktan sonra sipariş değiştiyse (para birimi veya toplamı işlemle artık eşleşmiyorsa), işlem onaylanmaz; bu nedenle Transbank tahsil etmez ve müşteri Your order 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. Siparişin zaten bir durumu varsa veya aynı sepetin başka bir siparişi zaten ödenmişse, geç gelen bir dönüş de onaylanmaz: müşteri ödenmiş siparişin başarı sayfasına gider veya 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.

OpenCart 4'te, ödeme sayfasındaki sipariş Webpay ödemesi olmadan bir duruma kavuştuysa veya bu arada mağaza tarafından kapatıldıysa, bir sonraki Confirm Order müşteriyi aynı mesajla ödeme sayfasına geri gönderir ve sepet yeni bir siparişle ödenir. Sipariş zaten ödenmişse ama o zamandan beri sepet değiştiyse (yeni bir adet dahil), müşteri ödeme sayfasına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

Webpay ödemeyi başlatamazsa, müşteri Confirm Order adımında kısa bir mesajla kalır, örneğin Could not connect to Webpay. Please try again in a moment. veya Webpay could not start the payment. Please try again or choose another payment method. Teknik neden günlüğe yazılır.

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

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Webpay'e yönlendirildi ve ödeme yapmadı, iptal etti, formun süresinin dolmasına izin verdi, kart reddedildi veya ödeme henüz onaylanamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür.

Order Status After Payment (varsayılan Processing): Transbank ödemeyi onayladı. Bir not; yetkilendirme 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 Status (varsayılan Pending): Transbank, siparişle eşleşmeyen bir ödemeyi yetkilendirdi (tutar, buy order veya oturum). Not farkları listeler. Transbank portalını kontrol edin ve siparişi tamamlayın veya ödemeyi iade edin.

Refunded Status (varsayılan Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Webpay, zaten bir durumu olan bir sipariş için veya başka bir sipariş tarafından zaten ödenmiş bir sepet için ödeme döndürürse, ödeme onaylanmaz ve müşteri bir tahsilattan bahsederse bir not Transbank portalını kontrol etmenizi ister. İptaller, süresi dolan formlar, form hataları ve reddedilen kartlar da not edilir. Notlar, müşterinin görmediği siparişin History kayıtlarıdır.

VibeFox Transbank Gateway sekmesi

Sales > Orders bölümünde Webpay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Transbank Gateway sekmesi Buy order ve ortamını (test ödemeleri için bir Integration etiketi), ödemenin Status değerini, Authorization code, taksit sayısıyla birlikte Card / payment type, Charged / refunded, iade formu, iade geçmişi, Webpay attempts of the order ve Transbank notes bilgilerini gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanına CLP cinsinden tutar girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) 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 cinsinden desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Ondalıklı kısmi bir tutar Webpay refunds are in whole Chilean pesos. Please enter an amount without decimals. mesajıyla reddedilir. Ondalıklı bir sipariş toplamının son kalanı, tahsilat gibi yuvarlanır. İadeler, Transbank'ın tahsil ettiği tutara kadar yapılabilir. İade, ödemenin yapıldığı ortama gider; bu nedenle üretim ödemesi için üretim kimlik bilgilerinin ayarlanmış olması gerekir.

Transbank bir ters işlem (REVERSED) veya iptal (NULLIFIED) ile yanıt verir. Başarılı bir iade, tutar, tür, yetkilendirme kodu ve Transbank'ta kalan bakiye ile birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirim göndermeden ve manuel bir durum değişikliği gibi ürünleri stoka geri koymadan Refunded Status değerini ayarlar. Kısmi iade durumu değiştirmez. Transbank iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez.

Sales > Returns bölümündeki ürün iadeleri Transbank üzerinden para geri göndermez. Transbank portalında yapılan iadeler OpenCart'a aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Transbank Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Transbank 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ı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınızı) ve 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üğmelerini gösterir. Bunların altında Product: opencart-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 eklenti için Modify yetkisine sahip 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 belirtir, ö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 sonra 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 adresinde. 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. Yönetim paneline aynı tarayıcıda 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 oturumunu görmez, bu nedenle etkin bir anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler, müşteri Webpay'den döndüğünde yine onaylanır ve sipariş sayfasından yapılan iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu 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, müşterinin CLP ile ödeme yaptığını 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. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin. Ayarlar sayfası, eksik kimlik bilgileri ve CLP dışı mağaza para birimi için uyarı gösterir.

Ödeme geçti ama sipariş durumsuz kalıyor: Transbank'ta webhook olmadığı için sipariş, ancak müşteri Webpay'den döndüğünde durum alır. Müşteri Webpay'de tarayıcıyı kapattıysa işlem onaylanmamıştır ve Transbank'a göre mutabakata alınmaz. Debug log seçeneğini açın, Log alanına bakın ve işlemi Transbank portalında kontrol edin.

Müşteri şu mesajı görüyor: We could not confirm your Webpay payment with Transbank: onay çağrısı başarısız oldu ve durum kontrol edilemedi. Sipariş değiştirilmedi ve nedeni günlüktedir. Müşteri birkaç dakika sonra yeniden deneyebilir. Transbank portalı işlemi yetkilendirilmiş olarak gösteriyorsa, müşteri tekrar ödemeden önce onunla iletişime geçin.

Müşteri şu mesajı görüyor: Your order changed after the Webpay payment was started: sipariş toplamı veya para birimi işlemle farklıydı. Hiçbir şey tahsil edilmedi; müşteri yeniden öder.

Müşteri Confirm Order sonrası bir hata görüyor: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Webpay payments are not available at the moment genellikle yanlış ü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), siparişin başka bir para biriminde olduğu anlamına gelir. This payment method is not available. Please reload the checkout page. ise ödeme oturumunun artık siparişle eşleşmediği anlamına gelir: müşteri ödeme sayfasını yeniden yükler.

Toplamlar ve iadeler birkaç peso farklı: CLP para biriminin ondalık basamakları vardır. Webpay tam peso tahsil eder, bu nedenle toplamlar yuvarlanır. System > Localisation > Currencies bölümünde CLP için ondalık basamak sayısını 0 yapın.

Sipariş ödemeden sonra inceleme durumunda: VibeFox Transbank Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ö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 kaydedilmemiş. Bunları girin ve yeniden deneyin.

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

İade şu hatayla başarısız oluyor: Another request is processing this order: sipariş tam o sırada iade ediliyor veya onaylanıyordu. Birkaç dakika sonra yeniden deneyin.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Transbank 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 Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda Webpay'den dönüşe izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, entegrasyon modu, kimlik bilgileri, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Webpay denemeleri ve iadeleri her zaman korunur; bu nedenle daha önce ö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 Transbank Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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