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

Datatrans hesabı: merchant ID, sunucudan sunucuya API parolası ve webhook'lar için önerilen HMAC-SHA256 imza anahtarına ihtiyacınız vardır. Sandbox kimlik bilgileri Datatrans sandbox Web Admin (admin.sandbox.datatrans.com) üzerinden, canlı kimlik bilgileri ise canlı Web Admin (admin.datatrans.com) üzerinden alınır. Sandbox ve canlı ortam, farklı merchant ID'leri ve anahtarları olan ayrı Datatrans hesaplarıdır.

Erişilebilir mağaza: Datatrans webhook'ları kendi sunucularından gönderir; bu nedenle mağazanızın internetten erişilebilir olması gerekir.

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_datatrans_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_datatrans_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her iki sürüm için aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_datatrans_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ü Payments olarak seçin. VibeFox Datatrans 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. VibeFox lisans anahtarınızı, sayfanın üst kısmındaki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Datatrans sandbox Web Admin'deki sandbox kimlik bilgilerini girin (bkz. Yapılandırma).

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir test ödemesi yapın. Her şey çalıştığında canlı kimlik bilgilerini girin ve Sandbox 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_datatrans_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış bir 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ü Payments olarak seçin. VibeFox Datatrans Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve Datatrans kimlik bilgilerini girin ve OpenCart 3 için 3 ila 5. adımlardaki gibi bir test ödemesi yapın. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Yapılandırma).

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar. Webhook URL'si her işlemle birlikte Datatrans'a gönderilir; bu nedenle bunu ayrıca ayarlamanız gerekmez.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Datatrans Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ödeme yöntemi etkin olduğunda ancak geçerli ortamın merchant ID'si veya API parolası yoksa, sayfa eksik alanlarla birlikte Datatrans is hidden at checkout until these settings are filled in: mesajını gösterir. Sandbox modu açıkken sayfa Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. mesajını gösterir. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydettiğinizde Title boş olamaz veya 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır, Total 0 veya daha büyük bir sayı olmalıdır ve bölge ile sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa hatayı gösterir. Onaltılık bir dize olmayan bir imza anahtarı kaydedilmez: önceki değer korunur, diğer ayarlar kaydedilir ve sayfa alanın adını belirten bir uyarı gösterir.

Datatrans

Enable/Disable: Enable Datatrans Payment ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Datatrans. 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 Datatrans.

Sandbox mode: Datatrans sandbox'ını kullanır: test ödemeleri, gerçek para yok. Hem Datatrans sunucularını hem de yeni ödemeler için kullanılan kimlik bilgilerini değiştirir. Varsayılan: açık. Gerçek ödemeler almak için kapatın. Açıkken müşteriler Confirm Order adımında Sandbox mode: no real payment is taken. mesajını görür. İadeler ve tahsilatlar, bu anahtar ne olursa olsun her zaman ödemenin yapıldığı ortamı kullanır.

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

Geo Zone: Datatrans'ı yalnızca seçilen 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: Datatrans sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir tutar için Datatrans sunmak üzere boş bırakın.

Sandbox kimlik bilgileri

Bunları Datatrans sandbox Web Admin'den kopyalayın (admin.sandbox.datatrans.com; sayfa bağlantıyı içerir). İmza anahtarı, oradaki güvenlik ayarlarında bulunur.

Sandbox merchant ID: sandbox hesabınızın merchant ID'si.

Sandbox API password: sandbox hesabının sunucudan sunucuya API parolası.

Sandbox HMAC sign key: webhook'ların Datatrans-Signature başlığını doğrulamak için kullanılan onaltılık anahtar. Bu olmadan her webhook, Datatrans durum API'si üzerinden yeniden kontrol edilir.

Canlı kimlik bilgileri

Bunları Datatrans canlı Web Admin'den kopyalayın (admin.datatrans.com).

Production merchant ID: canlı hesabınızın merchant ID'si.

Production API password: canlı hesabın sunucudan sunucuya API parolası.

Production HMAC sign key: canlı webhook'ların Datatrans-Signature başlığını doğrulamak için kullanılan onaltılık anahtar. Bu olmadan her webhook, Datatrans durum API'si üzerinden yeniden kontrol edilir.

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

Webhook URL'si

Bu bölüm, mağazanızın webhook URL'sini gösterir. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_datatrans_gateway/webhook, OpenCart 4'te ise şuna benzer: https://your-store/index.php?route=extension/wcp_datatrans_gateway/payment/wcp_datatrans_gateway.webhook. Bu adres OpenCart kurulumunuzun vitrin adresinden oluşturulur. Eklenti bu URL'yi her işlemle birlikte Datatrans'a gönderir; bu nedenle bunu bir yere girmeniz gerekmez. Datatrans Web Admin'in webhook ayarlarına da girebilirsiniz; böylece orada yapılan tahsilat ve iptallere ilişkin güncellemeleri alırsınız. Ayarların gösterdiği şekliyle birebir kopyalayın. Datatrans Web Admin'de yapılan iadeler siparişe yansıtılmaz.

Webhook, işlemin durumunu bildirir. Eklenti bu durumlara göre işlem yapar:

HMAC imza anahtarıyla, her webhook, ödemenin yapıldığı ortamın imza anahtarı kullanılarak Datatrans-Signature başlığıyla doğrulanır. Geçerli imzası olmayan webhook'lar reddedilir. İmza anahtarı yoksa eklenti webhook içeriğine güvenmez ve her webhook'u Datatrans durum API'si üzerinden kontrol eder. Webhook olmadan bir sipariş, yalnızca müşteri ödeme yaptıktan sonra mağazaya geri döndüğünde durum alır.

Ödeme işleme

Auto settle: ödemeleri hemen tahsil eder (settle eder). Kapalıysa ödemeler yalnızca yetkilendirilir: sipariş beklemeye alınır ve daha sonra sipariş sekmesindeki Capture Datatrans payment ile tahsil edersiniz ya da Cancel Datatrans authorization ile serbest bırakırsınız. Varsayılan: açık.

OpenCart siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, yalnızca Datatrans ödemeyi onayladıktan sonra bir durum alır. Başarısız veya iptal edilmiş bir ödeme siparişi durumsuz bırakır ve sepet korunur. Aşağıdaki her alan, OpenCart sipariş durumlarınızı listeler.

Order status after payment: ödeme tahsil edildiğinde ve tutarı ile para birimi eşleştiğinde siparişin durumu. Varsayılan: Processing.

Datatrans payment on hold: yalnızca yetkilendirilmiş ödemeler (Auto settle kapalı), tutar veya para birimi uyuşmazlıkları ve sipariş iptal edildikten sonra gelen ödemeler. Bir not nedeni 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.

Authorization canceled: yetkilendirme Cancel Datatrans authorization ile veya Datatrans Web Admin'de serbest bırakıldığında ayarlanır. Varsayılan: Canceled.

Refunded: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Logging: ödeme olaylarını ve API çağrılarını OpenCart günlük klasöründeki (storage/logs) datatrans_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında datatrans_p_debug.old.log.php dosyasına taşınır. Hatalar, bu anahtar kapalı olsa bile her zaman kaydedilir. Hiçbir anahtar, kart verisi veya müşteri verisi yazılmaz. 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çıkken eklentiyi kaldırmak modül ayarlarını ve günlüğü siler. Siparişlerin Datatrans ödeme kayıtları (işlemler, iadeler) korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Parolalar ve imza 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ı parolalar ve imza anahtarları korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Datatrans). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the Datatrans payment page to complete the payment securely. notunu görür. OpenCart siparişi bu adımda, hâlâ durum olmadan oluşturur. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde sipariş toplamı için bir Datatrans işlemi oluşturur; referans olarak OpenCart sipariş numarasını kullanır ve müşteriyi Datatrans ödeme sayfasına yönlendirir. Mağaza dili Almanca, İngilizce, Fransızca veya İtalyanca ise sayfa bu dillerden biriyle açılır. Müşteri orada Datatrans hesabınızda etkin olan herhangi bir yöntemle ö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.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Datatrans onayladıktan sonra ödenmiş olarak işaretlenir: webhook ile veya müşteri geri döndüğünde Datatrans durum API'sine sunucu tarafında yapılan bir istekle. Dönüş adresi, ödeme denemesine ait rastgele bir jeton taşır ve adresin kendisi hiçbir zaman güvenilir kabul edilmez. Ardından sipariş, OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını Your payment with Datatrans has been received. mesajıyla görür. Yalnızca yetkilendirilmiş bir ödemede sayfa Your payment with Datatrans has been authorized. The amount will be charged when your order is processed. mesajını gösterir. Datatrans ödemeyi henüz onaylamadıysa, Payment confirmation sayfası Your payment is being confirmed by Datatrans. You will receive an e-mail as soon as it is confirmed. Please do not pay again. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir; webhook geldiği anda sipariş durumunu ayarlar. OpenCart 4'te Datatrans müşteriyi geri gönderdiğinde tarayıcı mağazanın oturumunu iletmez; bu nedenle eklenti önce kısa bir sayfa gösterir ve aynı dönüş adresini mağazanızdan yeniden açar. Müşteri sepetini ve oturumunu korur.

Müşteri Datatrans sayfasında iptal ederse ödeme sayfasına The payment was canceled. You can try again or choose another payment method. mesajıyla döner. Ödeme başarısız olduysa mesaj The payment was not completed. Please try again or choose another payment method. olur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Sepet korunur. OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ödeme sayfası için tek bir sipariş tutar ve onu günceller, yeni deneme ise aynı siparişin yeni bir Datatrans işlemidir. Yeni bir ödeme başlamadan önce, aynı sepetin önceki siparişlerine ait açık Datatrans işlemleri kontrol edilir: ödenmiş veya yetkilendirilmiş olan, yeni bir ödeme başlatmak yerine onaylanır; açık olan ise Datatrans'ta iptal edilir. Bir sepet yalnızca bir kez ödenir: aynı sepetin başka bir siparişi zaten ödenmiş veya yetkilendirilmişse yeni ödeme başlatılmaz ve müşteri başarı sayfasına gider. Zaten ödenmiş bir sepetin başka bir siparişi için ödeme yine gelirse, o sipariş durumsuz kalır ve ödenmiş sipariş, kopyayı Datatrans'ta kontrol edip iade etmenizi isteyen bir not alır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada ödenmeden kapatılmışsa (örneğin iptal edildi, bir yetkilendirmeyi de iptal ettiyseniz veya iade edildiyse), Confirm Order veya Datatrans'tan dönüş müşteriyi Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderir ve sonraki Confirm Order sepet için yeni bir sipariş öder. Sipariş zaten ödenmişse ve sepet o zamandan beri değiştiyse (başka ürünler veya adetler), müşteri ödeme sayfasına geri gönderilir ve değişen sepet yeni bir sipariş ile kendi ödemesini alır; aynı sepet ise yeni bir ödeme olmadan başarı sayfasına gider.

Datatrans ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve The payment could not be started. Please try again or choose another payment method. mesajını görür. Teknik neden günlüğe yazılır.

Webhook, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentilerinin isteklerine izin verir, OpenCart 4'te ise eklenti webhook ve müşteri dönüşü için bir başlangıç eylemi ekler.

Eklenti, Datatrans ödeme sayfasında tek seferlik ödemeleri kabul eder. Kayıtlı kartlar veya takma adlar, abonelikler, sitenizde Lightbox veya Secure Fields, ayarlarda ödeme yöntemi seçimi ya da bir yetkilendirmenin kısmi tahsilatı desteklenmez.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): müşteri Datatrans'a yönlendirildi ve ödeme yapmadı, ödeme başarısız oldu veya iptal edildi ya da Datatrans henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order status after payment (default Processing): ödeme tahsil edildi. Bir not tutarı, ödeme yöntemini, Datatrans işlem kimliğini, ortamı ve onayın nasıl alındığını (webhook veya dönüş) gösterir.

Datatrans payment on hold after an authorization (default Pending): Auto settle kapalıdır ve ödeme yalnızca yetkilendirilmiştir. Sipariş sekmesinde tahsil edin veya iptal edin.

Datatrans payment on hold after payment: Datatrans, sipariş toplamından farklı bir tutar veya para birimi bildirdi ya da ödeme, sipariş iptal edildikten sonra geldi. Not nedeni açıklar. İşlemi Datatrans Web Admin'de kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Authorization canceled (default Canceled): yetkilendirme, sipariş sekmesinde veya Datatrans Web Admin'de serbest bırakıldı.

Refunded (default Refunded): ödeme eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş veya yetkilendirilmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez. Bir not, kopyayı kontrol edip Datatrans'ta iade etmenizi ister. Başarısız veya iptal edilmiş bir işlem, ödenmiş bir siparişi hiçbir zaman düşürmez. Zaten iade edilmiş bir sipariş için gelen ödeme yalnızca bir not ekler.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Datatrans Gateway sekmesi

Sales > Orders bölümünde Datatrans ile ödenmiş bir sipariş açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Datatrans Gateway sekmesi; sandbox ödemeleri için Sandbox etiketiyle birlikte Transaction ID'yi, Datatrans Status değerini, Payment method'u, Amount tutarını, Paid / refunded tutarlarını, tahsilat ve iptal düğmelerini veya iade formunu, iade geçmişini ve siparişin Datatrans notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir. İşlemleri, eklentiyi değiştirme yetkisi gerektirir (System > Users > User Groups bölümünde ayarlanır).

Tahsilat ve iptal

Yalnızca yetkilendirilmiş bir ödeme için sekme Capture Datatrans payment ve Cancel Datatrans authorization seçeneklerini gösterir. Tahsilat, yetkilendirilen tutarı aşamayan mevcut sipariş toplamı için ödemeyi settle eder; ardından sipariş Order status after payment durumuna geçer. İptal, yetkilendirmeyi serbest bırakır ve siparişi Authorization canceled durumuna ayarlar. Her ikisi de ödemenin ortamına gider. Datatrans reddederse sekme hatayı gösterir ve bir not eklenir.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) girin ve Refund via Datatrans düğmesine tıklayın. Refund this amount through Datatrans? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir; Datatrans'ın gerçekten tahsil ettiği tutarın, önceki iadeler düşüldükten sonraki miktarına kadar. İade, ödemenin ortamına gönderilir; bu nedenle o ortamın merchant ID'si ve API parolası ayarlanmış olmalıdır. Yeniden denenen bir iade iki kez yansıtılmaz. Datatrans iadeyi kabul etmezse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Datatrans iade işlem kimliğiyle birlikte iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriyi bilgilendirmeden ve ürünleri stoğa geri eklemeden Refunded durumuna getirir; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez.

İadeler, Datatrans ödemeyi tahsil ettikten sonra kullanılabilir. Yalnızca yetkilendirilmiş bir ödeme bunun yerine tahsil edilir veya iptal edilir; tutarı uyuşmayan bir yetkilendirme ise tahsil edilene kadar iade edilemez.

Sales > Returns bölümündeki ürün iadeleri Datatrans üzerinden para geri göndermez. Datatrans Web Admin'de yapılan iadeler OpenCart'ta kaydedilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Datatrans Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Datatrans 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ı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: opencart-payment-datatrans 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 bir 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 yalnızca 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ızdan serbest bırakın.

Etkin bir anahtar olmadan Datatrans, ö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. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle hâlâ görür; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim Dashboard ekranında bir hatırlatma görünür. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: daha önce 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, yönetim Dashboard 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, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Datatrans ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve geçerli ortamın merchant ID'sine ve API parolasına sahip olduğunu kontrol edin: sandbox modunda sandbox alanları, aksi halde canlı alanlar. Ayarlar sayfası eksik alanları listeler. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: Datatrans webhook URL'sine ulaşamadı ve müşteri mağazaya geri dönmedi. Mağazanın internetten erişilebilir olduğunu ve bir güvenlik duvarının webhook URL'sine yapılan istekleri engellemediğini kontrol edin. Ayarlardaki imza anahtarının ödemenin ortamına ait olduğunu kontrol edin. Eklenti sayfasındaki Log alanına bakın.

Webhook, Invalid signature yanıtı veriyor: ayarlardaki HMAC imza anahtarı, Datatrans Web Admin'deki anahtarla eşleşmiyor ya da diğer ortama ait. Anahtarı yeniden kopyalayın.

Webhook, Not configured veya Verification failed yanıtı veriyor: webhook'un Datatrans durum API'si ile kontrol edilmesi gerekiyordu, ancak o ortamın kimlik bilgileri eksik ya da Datatrans yanıt vermedi. Datatrans webhook'u yeniden dener.

Webhook, Busy, retry yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş durumu ayarlanamadı. Datatrans webhook'u yeniden dener. Günlükte nedeni görünür.

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

HMAC imza anahtarı kaydedilmiyor: anahtar onaltılık bir dize olmalıdır. Datatrans Web Admin'den yeniden kopyalayın.

Müşteri Datatrans payments are not configured yet mesajını görüyor: geçerli ortamın merchant ID'si veya API parolası eksik.

Müşteri The payment could not be started mesajını görüyor: Log alanına bakın. Yanlış bir merchant ID veya API parolası ya da yanlış ortamın kimlik bilgileri, yaygın nedenlerdir.

Müşteri We could not verify the payment mesajını görüyor: dönüş adresi, siparişin hiçbir ödeme denemesiyle eşleşmedi. Para tahsil edildiyse webhook yine de sipariş durumunu ayarlar.

Sipariş ödemeden sonra ödeme beklemesi durumunda: sipariş sekmesindeki Datatrans notes kayıtlarını okuyun (bkz. Sipariş durumları), ardından siparişi tamamlayın veya ödemeyi iade edin.

Tahsilat reddediliyor: sipariş toplamı yetkilendirilen tutardan yüksek. Datatrans, yetkilendirilenden fazlasını settle edemez.

Sekmede tahsilat düğmeleri veya iade formu yok: sekme nedenini belirtir: ödeme henüz settle edilmedi, tamamen iade edildi, kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok veya ödeme ortamının kimlik bilgileri eksik.

İade veya tahsilat, eksik kimlik bilgileriyle ilgili bir mesajla başarısız oluyor: ödeme diğer ortamda yapıldı ve o ortamın merchant ID'si veya API parolası ayarlanmamış. Bunları girin ve tekrar deneyin.

Geliştiriciler için: Datatrans işlemi oluşturulmadan önce eklenti, istek gövdesi ve sipariş ile birlikte datatrans_p_init_request OpenCart olayını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Datatrans 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 processing bölümündeki dört sipariş durumu; yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve Datatrans'ın bakım modundan geçmesini sağlayan başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa, diğer modül ayarları (başlık, açıklama, sandbox modu, kimlik bilgileri, auto settle, günlük kaydı) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanır. Datatrans işlemleri ve iadeleri her zaman korunur; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir veya tahsil edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te yüklenen dosyaları da kaldırmak için, kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu eklentiler listesinde VibeFox Datatrans Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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