VibeFox Transbank for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Şili pesosu (CLP). Webpay Plus yalnızca tam peso tahsil eder; bu nedenle WooCommerce > Settings > General bölümünde Number of decimals değerini 0 olarak ayarlayın. Başka para birimi kullanan mağazalarda ödeme yöntemi gösterilmez.

Transbank hesabı: gerçek ödemeler için, canlı Commerce Code ve API Key Secret bilgileriyle birlikte standart bir Webpay Plus ticari hesabı (anında tahsilat) gerekir. Transbank, affiliation'ınız 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. WordPress'te Plugins > Add New > Upload Plugin yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_transbank_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Mağaza para birimini Şili pesosu, Number of decimals değerini 0 olarak WooCommerce > Settings > General bölümünde ayarlayın.

4. Ayarları açın: WooCommerce > Settings > Payments > Transbank Webpay Plus > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

5. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

6. Enable / Disable seçeneğini açın ve Integration (test) mode açıkken, Transbank geliştirici dokümantasyonundaki test kartlarını kullanarak bir ödeme deneyin.

7. Canlıya geçmek için Production Commerce Code ve Production API Key Secret bilgilerinizi girin, Integration (test) mode seçeneğinin işaretini kaldırın ve kaydedin.

Transbank'ta dönüş URL'si veya webhook ayarlamanız gerekmez. Eklenti her işlemle birlikte kendi dönüş URL'sini gönderir.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Transbank Webpay Plus. Alanların üstünde sayfa; canlı mod seçili olduğu halde Production Commerce Code veya API Key eksik ya da geçersizse (bu durumda Webpay ödeme sayfasında gizlenir), mağaza para birimi CLP değilse (ödeme yöntemi gizlenir) ve CLP fiyatlarında ondalık varsa (toplamlar tam pesoya yuvarlanır) sizi uyarır. Entegrasyon modu açıkken sayfa Integration (test) environment ibaresini gösterir: gerçek para tahsil edilmez. Kaydettikten sonra uyarılar yeni ayarlara göre güncellenir. Ödeme yöntemleri listesinde, canlı mod seçili ama geçerli kimlik bilgileri yoksa ağ geçidi kurulum gerektiriyor olarak işaretlenir.

Genel

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ı. Varsayılan: Webpay Plus.

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 canlı kimlik bilgilerinin ne zaman verildiğini açıklar.

Integration (test) mode: Use the Transbank integration environment. Ödemeler, Transbank entegrasyon ortamına, otomatik doldurulan herkese açık test ticari kodu (597055555532) ile gönderilir. Aşağıdaki canlı kimlik bilgileri kullanılmaz ve gerçek para tahsil edilmez. Varsayılan: açık. Canlıya geçmek için işareti kaldırın.

Production Commerce Code: canlı ticari kodunuz (Tbk-Api-Key-Id): 12 haneli, 5970 ile başlar. Kodunuz 8 haneliyse olduğu gibi girin; eklenti kaydederken 5970 önekini ekler. Boşluklar ve diğer karakterler silinir. Transbank'ın herkese açık test ticari kodları canlı ortamda kabul edilmez.

Production API Key Secret: canlı ticari hesabınızın Tbk-Api-Key-Secret değeri. Gizli tutun. Kaydederken boşluklar silinir.

Gelişmiş

Debug log: Log API requests and returns (errors are always logged). Ayrıntılar WooCommerce > Status > Logs bölümüne, kaynak wcp_transbank_gateway olarak yazılır; alanda bir view logs bağlantısı vardır. Bu seçenek kapalı olsa bile hatalar ve uyarılar kaydedilir. Kart verisi, API anahtarları veya tam jetonlar günlüğe yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (order data is kept). 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 daha sonra değiştirseniz bile her zaman ödemenin oluşturulduğu ortama (entegrasyon veya canlı) ve o ortamın kimlik bilgileriyle gider.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Webpay Plus) ve siparişi verir. Entegrasyon modunda ödeme sayfası TEST MODE: Integration environment gösterir. Gerçek tahsilat yapılmaz. Eklenti, sipariş tutarı için tam peso olarak bir Transbank işlemi oluşturur (ondalıklı toplam 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 kapalıysa müşteri Proceed to Webpay düğmesine tıklar. Webpay'de müşteri kredi kartı, banka kartı veya ön ödemeli kartla öder.

Müşteri geri döndüğünde eklenti, işlemi Transbank ile sunucudan sunucuya onaylar (commit). Sipariş, yalnızca Transbank onayladıktan sonra ödenmiş olarak işaretlenir: yanıt onaylanmış olmalı, tutar, buy order ve oturum da mağazanın bu deneme için gönderdiğiyle eşleşmelidir. Ardından müşteri sipariş alındı sayfasını görür. Onay isteği, örneğin zaman aşımı nedeniyle başarısız olursa eklenti Transbank'tan işlem durumunu sorar. Durum hâlâ bilinemiyorsa sipariş değiştirilmez 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.

Müşteri Webpay'de iptal ederse, Webpay formu süresi dolarsa veya hata verirse hiçbir tutar tahsil edilmez. Sipariş ödeme bekleyen durumda kalır ve müşteri, bir mesajla birlikte Pay for order sayfasına döner; örneğin You cancelled the Webpay payment. Nothing was charged — you can try again or choose another payment method. Reddedilen bir kart Your Webpay payment was rejected and nothing was charged. Please try again or choose another payment method. mesajını gösterir. Müşteri aynı sayfadan yeniden ödeme yapabilir. Her yeni deneme yeni bir Webpay işlemidir.

Her Webpay denemesi en fazla bir kez onaylanır. Dönüş sayfasını yeniden yüklemek, tarayıcının geri düğmesi veya aynı anda ikinci bir dönüş hiçbir zaman iki kez onaylamaz ve siparişi değiştirmez. Bir siparişin artık ödemeye ihtiyacı yoksa (başka bir denemeyle ödenmiş, iptal edilmiş veya iade edilmişse), geç gelen bir dönüş onaylanmaz; dolayısıyla Transbank bu tutarı tahsil etmez. Müşteri 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 kısa bir mesaj görür; örneğin Could not connect to Webpay. Please try again in a moment. veya Webpay payments are not available at the moment. Please choose another payment method. Teknik neden günlüğe yazılır.

Ö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.

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ş beklemede kalır; Transbank'a göre onaylanmamış işlemler mutabakata alınmaz. Eklenti Webpay Plus Mall, Oneclick kayıtlı kartları, abonelikler, ertelenmiş tahsilat veya para birimi dönüşümünü desteklemez.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Webpay'e gönderildi ancak henüz ödeme yapmadı, iptal etti, formun süresinin dolmasına izin verdi veya ödeme henüz onaylanamadı. Her kapanan deneme, buy order ile birlikte bir notta kaydedilir.

Processing or Completed: Transbank ödemeyi onayladı. Durum WooCommerce tarafından ayarlanır: İşleniyor veya yalnızca sanal indirilebilir ürün içeren siparişler için Tamamlandı. Sipariş notunda yetkilendirme kodu, kartın son dört hanesi, buy order, tutar, ödeme türü ve taksit sayısı gösterilir. İşlem kimliği Webpay jetonudur.

On hold: Transbank, siparişle eşleşmeyen bir ödemeyi yetkilendirdi (tutar, buy order veya oturum kimliği); örneğin ödeme başladıktan sonra sipariş düzenlendiği için. Not farkları listeler. Transbank portalını kontrol edin ve siparişi iade edin veya tamamlayın.

Failed: ödeme reddedildi. Hiçbir tutar tahsil edilmedi. Not yanıt kodunu ve durumunu gösterir.

Webpay, zaten ödenmiş, iptal edilmiş veya iade edilmiş bir sipariş için ödeme döndürürse ödeme onaylanmaz ve müşteri bir tahsilat bildirirse bir not Transbank portalını kontrol etmenizi ister. Mevcut siparişler sonraki denemelerden etkilenmez.

İadeler

İade düğmesi yalnızca Webpay ile ödenmiş siparişlerde sunulur. Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Webpay Plus düğmesine tıklayın (düğme ödeme yönteminin başlığını kullanır). Tam ve kısmi iadeler tam peso olarak desteklenir. 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 son kalanı, tahsilat gibi yuvarlanır. İade, ödemenin yapıldığı ortama gider; bu nedenle canlı ortamda canlı kimlik bilgilerinin kaydedilmiş olması gerekir.

Transbank bir geri alma (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 sipariş notlarına eklenir. Transbank iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Transbank portalında yapılan iadeler WooCommerce'e aktarılmaz.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu, WooCommerce > Settings > Payments > Transbank Webpay Plus sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok durumu gösterir; örneğin lisansın hangi tarihe kadar aktif olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, 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 tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Alan adı hakkını vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Webpay Plus, ödeme sayfası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. 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 görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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, mağaza para biriminin CLP olduğunu (Pay for order sayfasında sipariş para birimi) ve entegrasyon modu kapalıyken geçerli bir Production Commerce Code (12 haneli, 5970 ile başlayan) ile Production API Key Secret kaydedildiğini kontrol edin. Ayarlar sayfası, eksik her koşul için bir uyarı gösterir.

Ödeme geçti ama sipariş Pending payment durumunda kaldı: Transbank'ın webhook'u yok, bu yüzden sipariş yalnızca müşteri Webpay'den döndüğünde onaylanır. Müşteri Webpay'de tarayıcıyı kapattıysa işlem onaylanmamıştır ve Transbank'a göre mutabakata alınmaz. Sipariş notlarını, günlüğü ve Transbank portalındaki işlemi 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ş değiştirilmedi ve bir not eklendi. Müşteri birazdan yeniden deneyebilir. Transbank portalı işlemi onaylanmış olarak gösteriyorsa, kargolamadan önce orada onaylayın.

Müşteri sipariş verirken bir hata görüyor: Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, kaynak wcp_transbank_gateway olacak şekilde bakın. Webpay payments are not available at the moment mesajı genellikle hatalı canlı kimlik bilgileri anlamına gelir. Could not connect to Webpay ise Transbank'a ulaşılamadığı anlamına gelir. CLP dışında bir para biriminde verilen sipariş Webpay ile ödenemez.

Toplamlar ve iadeler birkaç peso farklı: CLP fiyatlarında ondalık bulunur. Webpay tam peso tahsil eder; bu nedenle toplamlar yuvarlanır. Number of decimals değerini 0 olarak ayarlayın.

İade The production Commerce Code / API Key are missing hatasıyla başarısız oluyor: ödeme canlı ortamda yapıldı ve canlı kimlik bilgileri kaydedilmemiş. Bilgileri girin ve yeniden deneyin.

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

Lisans bloğu bir hata gösteriyor: bloktaki 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şılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi 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ı, diğer seçenekler, eklentinin geçici verileri ve günlükleri (döndürülmüş olanlar dahil log dosyaları ve veritabanı günlük kayıtları) yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için saklanırlar. Siparişlerde saklanan Transbank verileri muhasebe ve iadeler için gerekli olduğundan her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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.