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

Worldline hesabı: bir Worldline Direct (eski adıyla Ingenico Direct) satıcı hesabı. Test ve canlı hesaplar ayrıdır ve farklı kimlik bilgilerine sahiptir. Her hesap için Merchant ID (PSPID'niz), bir API Key ID ve bunun Secret API Key'i ile bir webhook anahtarı ve bunun gizli anahtarı gerekir. Hepsi Worldline Merchant Portal'da oluşturulur (bkz. Yapılandırma).

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. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_worldline_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_worldline_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini 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üğmesine tıklayın ve wcp_worldline_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişiklikleri yoktur, bu nedenle Extensions > Modifications yenilenmesi 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 Worldline Gateway eklentisini bulun ve Install düğmesine tıklayın (yeşil + düğmesi). 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 simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test kimlik bilgilerini girin, Save düğmesine ve ardından Test credentials düğmesine tıklayın.

5. Test hesabının Merchant Portal'ına webhook URL'sini ekleyin ve webhook anahtarını ve gizli anahtarını girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın, kaydedin ve bir test ödemesi yapın. Ardından canlı kimlik bilgilerini girin, canlı hesabınızda webhook kurulumunu tekrarlayın, Live credentials düğmesine tıklayın ve Test Mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_worldline_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin 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 Worldline Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, kimlik bilgilerini ve webhook'u OpenCart 3 için 3 ila 6. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook'lar).

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 Worldline Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, geçerli modun kimlik bilgileri (Merchant ID, API Key ID, Secret API Key) eksik olduğunda uyarır, çünkü ödeme yöntemi bu durumda ödeme sayfasında gizlenir. Test modu açıkken Test mode is on (pre-production environment): no real money is charged. gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydettiğinizde Title boş olamaz (en fazla 128 karakter), 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 sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Eksik kimlik bilgileri kaydetmeyi engellemez.

Worldline (Ingenico)

Enable/Disable: Enable Worldline 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: Worldline. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely via Worldline.

Sort Order: ödeme sayfasındaki ödeme yöntemleri arasında Worldline'ın konumu. Boş bırakın veya tam sayı girin.

Geo Zone: Worldline'ı yalnızca seçilen bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones bölümünde tanımlanır.

Total: Worldline sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme sayfası toplamı. Herhangi bir toplam için sunmak üzere boş bırakın.

Worldline Direct API

Kimlik bilgilerini test hesabının ve canlı hesabın Worldline Merchant Portal'ından alın. PSPID'niz Merchant ID'dir. Developer > Payment API API Key ID'yi ve Secret API Key'i oluşturur; Developer > Webhooks webhook anahtarını ve gizli anahtarını oluşturur. Bu bölümde her iki portala ve Worldline belgelerine bağlantılar bulunur.

Test Mode: hem API uç noktasını hem de kimlik bilgilerini değiştirir. Test modu test ortamını ve test kimlik bilgilerini, canlı mod ise canlı ortamı ve canlı kimlik bilgilerini kullanır. Varsayılan: açık. Gerçek ödemeleri tahsil etmek için kapatın. Test modu açıkken müşteriler Confirm Order adımında Test mode — no real money is charged. mesajını görür.

Test hesabı (ön üretim)

Test Merchant ID (PSPID): test hesabınızın PSPID'si.

Test API Key ID: test hesabının Developer > Payment API bölümünde oluşturulan API Key ID.

Test Secret API Key: bu API Key ID'ye ait Secret API Key.

Test Webhook Key ID: isteğe bağlı. Ayarlanırsa yalnızca bu anahtarla gönderilen webhook'lar kabul edilir.

Test Webhook Secret: test hesabının webhook gizli anahtarı. Her webhook'un imzasını doğrulamak için kullanılır.

Canlı hesap (üretim)

Live Merchant ID (PSPID): canlı hesabınızın PSPID'si.

Live API Key ID: canlı hesabın Developer > Payment API bölümünde oluşturulan API Key ID.

Live Secret API Key: bu API Key ID'ye ait Secret API Key.

Live Webhook Key ID: isteğe bağlı. Ayarlanırsa yalnızca bu anahtarla gönderilen webhook'lar kabul edilir.

Live Webhook Secret: canlı hesabın webhook gizli anahtarı.

Kaydedilmiş gizli anahtarlar ve webhook gizli 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 değeri kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Kimlik bilgilerini kontrol et: Test credentials ve Live credentials düğmeleri, her hesabın kayıtlı kimlik bilgilerini Worldline'a yapılan bir test çağrısıyla kontrol eder. Önce değişikliklerinizi kaydedin. Yanıt düğmelerin altında görünür, örneğin Test credentials: connection successful., API credentials are not configured. veya Worldline'ın döndürdüğü hata.

Webhook'lar

Webhook, müşteri mağazaya geri dönmese bile ödemelerle ilgili olarak mağazanıza bilgi verir; örneğin tarayıcıyı kapattıktan sonra veya bir ödeme daha sonra onaylandığında. Merchant Portal'da test hesabının Developer > Webhooks bölümünü açın ve bu bölümde Endpoint URL altında gösterilen URL'yi ekleyin. URL, OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_worldline_gateway/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_worldline_gateway/payment/wcp_worldline_gateway.webhook. OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL'yi ayarların gösterdiği gibi tam olarak kopyalayın: yönlendirme olmadan yanıt vermeli ve internetten erişilebilir olmalıdır. Ardından webhook anahtar kimliğini ve gizli anahtarını Test Webhook Key ID ve Test Webhook Secret alanlarına girin. Canlı hesapta da canlı alanlarla aynısını yapın.

Eklenti, Worldline'ın uç nokta doğrulama isteğini otomatik olarak yanıtlar. Ödeme olaylarını (ödeme durumu değişikliklerini) ve iade olaylarını (iade durumu değişikliklerini) işler. Diğer olaylar kabul edilir ve yok sayılır. Geçerli imzası olmayan webhook'lar reddedilir. Bir olay, ödemenin yapıldığı hesabın gizli anahtarıyla imzalanmış olmalıdır; bu nedenle test webhook'u hiçbir zaman canlı bir ödemeyi onaylamaz. Bir webhook, kendisini imzalayan hesabın Merchant ID'sinden farklı bir Merchant ID'den geliyorsa da yok sayılır. Webhook olmadan bir sipariş, müşteri ödemeden sonra mağazaya döndüğünde onaylanır.

Ödeme sayfası ve siparişler

Payment page template: Merchant Portal'a yüklenmiş barındırılan bir ödeme sayfası şablonunun (varyant) isteğe bağlı adı, örneğin SimplifiedCustomPaymentPage. Varsayılan Worldline sayfası için boş bırakın.

Order Status After Payment: tahsil edilmiş bir ödemenin hangi durumu ayarlayacağı. Ödemeler her zaman doğrudan satış (yetkilendirme ve tahsilat) olarak istenir.

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik bir sipariş). Sipariş, yalnızca Worldline ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Paid Order Status: Payment accepted (processing) ile tahsil edilmiş bir ödemeden sonraki durum. Varsayılan: Processing.

Complete Order Status: Delivered (completed) ile tahsil edilmiş bir ödemeden sonraki durum. Varsayılan: Complete.

Awaiting Capture Status: ödeme yetkilendirilmiş veya tahsilat talep edilmiştir; tahsilat webhook'u siparişi ödenmiş olarak işaretler. Varsayılan: Pending.

On Hold (Review) Status: ödenen tutar veya para birimi siparişle eşleşmiyor. Bir not nedenini açıklar. Varsayılan: Pending, çünkü OpenCart'ın On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumlarınızı oluşturabilir ve burada seçebilirsiniz.

Payment Error Status: Worldline, tahsilat bekleyen bir siparişin ödemesini reddetti veya iptal etti. Varsayılan: Failed.

Refunded Status: ödeme, sipariş sayfasından tamamen iade edildi. Varsayılan: Refunded.

Gelişmiş

Logging: tüm API isteklerini ve webhook'ları OpenCart günlükler klasöründeki (storage/logs) wlg_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında wlg_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Anahtarlar, kart bilgileri ve kişisel veriler maskelenir. Varsayılan: kapalı.

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

Delete Data: açıkken eklentiyi kaldırmak, ağ geçidi ayarlarını ve günlüğü siler. Worldline işlemleri ve iadeleri her zaman korunur, çünkü mevcut siparişler iadeler için bunlara ihtiyaç duyar. Varsayılan: kapalı.

Import / Export

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

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Worldline). Confirm Order adımında müşteri açıklamanızı 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ş para biriminde sipariş toplamı için bir Worldline barındırılan ödeme sayfası oluşturur ve müşteriyi Worldline ödeme sayfasına gönderir. Orada müşteri, Worldline hesabınızda etkin olan bir kartla, dijital cüzdanla veya başka bir ödeme yöntemiyle öder. Fatura adı, adres, e-posta ve telefon Worldline'a aktarılır; ödeme sayfası, Worldline destekliyorsa müşterinin dilinde açılır. Her ödeme denemesi, sipariş numarasından ve rastgele bir bölümden oluşan kendi referansını alır. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve sayfanın altındaki Confirm Order düğmesine tıklar.

Ödemeden sonra müşteri mağazanıza döner. Eklenti dönüşü kaydedilmiş denemeyle karşılaştırır ve ödeme durumunu sunucu tarafında Worldline'dan okur. Sipariş, yalnızca Worldline bu durum kontrolü veya imzalı bir webhook ile onayladıktan sonra ödenmiş olarak işaretlenir. Sipariş daha sonra OpenCart'ın standart yöntemiyle durum alır; olağan sipariş e-postaları ve stok güncellemesiyle birlikte, müşteri Your payment with Worldline has been received. mesajıyla OpenCart sipariş başarı sayfasını görür. Ödeme yetkilendirilmiş ancak henüz tahsil edilmemişse sayfa Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. gösterir. Bu tür bir siparişin ödemesi başarısız olursa sayfa Your Worldline payment was not completed. Please contact us about this order. gösterir.

Ödeme tamamlanmadıysa sipariş hiçbir durum almaz, sepet korunur ve müşteri bir mesajla ödeme sayfasına döner:

Durum henüz kontrol edilemediyse bir Payment confirmation sayfası We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir. Webhook, ulaştığı anda sipariş durumunu ayarlar.

OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

Confirm Order adımı her gösterildiğinde OpenCart 3 yeni bir sipariş oluşturur; OpenCart 4 ise siparişi ödeme için günceller ve bu nedenle iptal veya reddetmeden sonra müşteri aynı siparişi yeni bir Worldline ödeme sayfasında öder. Yeni bir ödemeden önce eklenti sepeti kontrol eder: aynı sepetin başka bir siparişi zaten ödenmişse veya önceki deneme bu arada ödenmişse, müşteri doğrudan başarı sayfasına gider ve iki kez tahsilat yapılmaz. Aynı siparişin önceki ödeme sayfası aynı tutar ve modla hâlâ açıksa ve 30 dakikadan kısa süre önce oluşturulduysa, müşteri oraya geri gönderilir.

OpenCart 4'te, sipariş için ödeme reddedildikten veya yetkilendirmeden sonra iptal edildikten sonra bir sonraki Confirm Order, müşteriyi başarı sayfası yerine reddedilen ödeme mesajıyla ödeme adımına geri gönderir. Mağaza siparişi kapattıysa (örneğin iptal etti veya iade etti), mesaj Your previous order was closed by the shop (cancelled / refunded). Please confirm the order again to pay with a new order. olur. Her iki durumda da bir sonraki Confirm Order yeni bir siparişi öder. Sipariş ödenmiş ama sepet o zamandan beri değiştiyse (yeni adet dahil), müşteri ödeme adımına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

Worldline ödemeyi başlatamazsa müşteri, düğmenin üstünde Payment error: Could not create checkout session. Please try again. mesajıyla Confirm Order adımında kalır. Neden günlüğe yazılır. Geçerli modun kimlik bilgileri eksikse müşteri This payment method is not available at the moment. Please choose another payment method. mesajını görür.

Webhook 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, tek seferlik ödemeleri Worldline sayfasında doğrudan satış olarak kabul eder. Kayıtlı kart veya tokenleştirme, abonelik, gömülü kart formu, OpenCart üzerinden yakalama veya iptal içeren yalnızca yetkilendirme modu, ek ücret (surcharge) ve otomatik webhook kaydı desteklenmez.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Worldline'a gönderildi ve ödeme yapmadı ya da Worldline ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Paid Order Status veya Complete Order Status (varsayılan Processing veya Complete): ödeme tahsil edildi. Durum, Order Status After Payment ayarını izler. Bir not tutarı, Worldline ödeme kimliğini ve onayın nasıl yapıldığını (imzalı webhook veya durum kontrolü) gösterir.

Awaiting Capture Status (varsayılan Pending): Worldline ödemeyi yetkilendirilmiş ya da tahsilatı talep edilmiş olarak bildirir, ama henüz tahsil edilmemiştir. Webhook tahsilatı onayladığında sipariş ödenmiş duruma geçer. Not ödemenin tahsil edilmediğini söylüyorsa, Worldline Merchant Portal'da tahsil edin.

On Hold (Review) Status (varsayılan Pending): ödeme siparişle eşleşmiyor; örneğin tutar veya para birimi farklı ya da ödeme başka bir denemeye ait. Not, ödenen tutarı, sipariş toplamını ve referansı gösterir. Siparişi kontrol edin ve tamamlayın ya da ödemeyi iade edin.

Payment Error Status (varsayılan Failed): Worldline, tahsilat bekleyen bir siparişin ödemesini reddetti veya iptal etti.

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

İptal edilmiş veya iade edilmiş bir siparişe ödeme gelirse sipariş yeniden açılmaz. Bir not, ödemeyi Worldline Merchant Portal'da iptal etmenizi veya iade etmenizi ya da siparişi elle geri yüklemenizi ister. Geri dönen müşteri Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. mesajını görür. Zaten ödenmiş bir sipariş için veya zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme gelirse sipariş değişmez. Ödenmiş siparişteki bir not, ikinci ödemeyi Worldline Merchant Portal'da iade etmenizi ister.

Notlar, müşterinin görmediği siparişin History bölümündeki kayıtlardır. Kelime Worldline ile başlarlar.

VibeFox Worldline Gateway sekmesi

Sales > Orders bölümünde Worldline ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Worldline Gateway sekmesi Worldline payment bloğunu gösterir: Payment ID, Merchant reference, Hosted checkout, denemenin Status değeri, Amount charged / refunded, test ödemeleri için bir Test environment etiketi, iade formu, iade geçmişi ve siparişin Payment notes notları. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Worldline Gateway sekmesinde tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Worldline düğmesine tıklayın. Refund this amount through Worldline? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Ödemenin tahsil edilmiş olması gerekir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İadeler, Worldline'ın 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 her zaman orijinal ödemenin ortamına (test veya canlı) o hesabın kimlik bilgileriyle gönderilir; bu nedenle bu bilgilerin ayarlanmış olması gerekir. Zaman aşımından sonra yeniden denenen bir iade iki kez çalıştırılmaz ve bir siparişte aynı anda yalnızca bir iade çalışır. Worldline iadeyi reddederse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Kabul edilen bir iade, Worldline iade kimliği ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tam iade, müşteriye bildirim yapmadan ve ürünleri stoka geri koymadan, manuel bir durum değişikliği gibi siparişi Refunded Status durumuna getirir. Kısmi iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri Worldline üzerinden para geri göndermez.

Worldline'dan gelen iade durumu değişiklikleri webhook ile gelir, iade geçmişini günceller ve notlara eklenir. Merchant Portal'da yapılan iadeler sipariş durumunu değiştirmez; gerekirse durumu elle güncelleyin.

Lisans anahtarı

Eklenti, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox Worldline Gateway, Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit 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 hangi tarihe kadar geçerli olduğunu ve alan adınızı) ve Check now düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girer) ve Remove key düğmesini (anahtarı bu mağazadan kaldırır) gösterir. Bunların altında Product: opencart-payment-worldline satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify yetkisine sahip yönetici kullanıcılar 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 tarihiyle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

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ızda serbest bırakın.

Etkin bir anahtar olmadan Worldline, ödeme sayfasında müşterilere gösterilmez. Bir ödeme yine de 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 yine de mağazada (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 ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve 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 sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonra haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Worldline ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli modun bir Merchant ID, bir API Key ID ve bir Secret API Key'e sahip olduğunu kontrol edin: test modunda test alanları, canlı modda canlı alanlar. Ayarlar sayfası eksik olduklarında uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlanan Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti, ancak sipariş durumsuz kalıyor: webhook çalışmıyor. Kullandığınız hesabın (test veya canlı) Merchant Portal'ında uç noktanın var olduğunu ve URL'nin Endpoint URL altında gösterilenle tam olarak aynı olduğunu, yönlendirme içermediğini kontrol edin. O hesabın webhook gizli anahtarının ilgili alanda (Test Webhook Secret veya Live Webhook Secret) olduğunu ve webhook anahtar kimliği alanının boş olduğunu veya anahtarla eşleştiğini kontrol edin. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de durum alır.

Webhook answers Webhook secret not configured: webhook gizli anahtarlarının hiçbiri ayarlanmamış. Ayarlara webhook gizli anahtarını girin. Worldline webhook'u yeniden dener.

Webhook answers Invalid signature: webhook gizli anahtarı başka bir hesaba veya başka bir anahtara ait ya da webhook anahtar kimliği, webhook'u gönderen anahtarla eşleşmiyor. Test ve canlı gizli anahtarların yer değiştirmediğini kontrol edin.

Webhook answers Missing signature, Empty body veya Invalid JSON: istek Worldline'dan beklenen biçimde gelmedi ya da bir proxy veya yönlendirme onu değiştirdi. URL'nin yönlendirme olmadan yanıt verdiğini kontrol edin.

Webhook answers Ignored: webhook, o modun ayarlarındakinden farklı bir Merchant ID'den geldi. Test Merchant ID (PSPID) veya Live Merchant ID (PSPID) alanını kontrol edin.

Webhook answers Retry later: sipariş aynı anda başka bir istek tarafından onaylanıyordu veya sipariş durumu ayarlanamadı. Worldline webhook'u yeniden dener. Nedeni görmek için Log alanına bakın.

Webhook URL'si tarayıcıda Method not allowed gösteriyor: bu normaldir. URL yalnızca Worldline'dan gelen istekleri kabul eder.

Test credentials veya Live credentials bir hata gösteriyor: önce ayarları kaydedin, ardından Merchant ID, API Key ID ve Secret API Key'in aynı hesaptan geldiğini ve test değerlerinin test alanlarında, canlı değerlerin canlı alanlarında olduğunu kontrol edin.

Müşteri Confirm Order sonrası bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Hatalar, Logging kapalı olsa bile günlüğe yazılır. İsteklerin tüm ayrıntılarını görmek için Logging seçeneğini açın ve yeniden deneyin.

Test ödemeleri canlı bir ödemeyi onaylamıyor: test ve canlı ayrı tutulur. Test Mode seçeneğini kullanmak istediğiniz moda ayarlayın ve o hesabın kimlik bilgilerini ve webhook'unu kullanın.

Sipariş ödemeden sonra inceleme veya tahsilat bekleme durumunda: VibeFox Worldline Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları). Ya Worldline tahsilatı henüz onaylamamıştır (webhook siparişi tamamlar) ya da ödenen tutar veya para birimi siparişle uyuşmuyordu.

Sekmede iade formu yok: sekme nedenini gösterir: tahsil edilmiş bir Worldline ödemesi yok, ödeme tamamen iade edilmiş, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok ya da ödemenin ortamının kimlik bilgileri ayarlanmamış.

İade, ortamla ilgili bir mesajla başarısız oluyor: ödeme test veya canlı ortamda yapıldı ve o ortamın kimlik bilgileri ayarlanmamış. Bunları girin ve yeniden deneyin.

Geliştiriciler için: barındırılan ödeme sayfası oluşturulmadan önce eklenti, istek verileri ve siparişle birlikte OpenCart olayı wlg_hosted_checkout_data'yı tetikler; örneğin gösterilen ödeme yöntemlerini sınırlamak için.

Kaldırma

Extensions > Extensions bölümüne gidin, tür olarak Payments seçin ve VibeFox Worldline 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 Payment page and 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 webhook ile müşterinin dönüşünü geçiren başlangıç eylemi de kaldırılır). Delete Data açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, kimlik bilgileri, webhook gizli anahtarları, sayfa şablonu, günlükleme) ve günlük kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Worldline işlemleri 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 dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Worldline 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.

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