VibeFox Datatrans for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin.

PHP: 8.0 veya üzeri.

HTTPS: Datatrans'ın webhook'ları iletebilmesi için siteniz internetten HTTPS ile erişilebilir olmalıdır.

Datatrans hesabı: Merchant ID'ye, sunucudan sunucuya API parolasına ve webhook'lar için önerilen HMAC-SHA256 imza anahtarına ihtiyacınız vardır. Sandbox kimlik bilgileri Datatrans sandbox Web Admin'den (admin.sandbox.datatrans.com), canlı kimlik bilgileri canlı Web Admin'den (admin.datatrans.com) alınır. Sandbox ve canlı ortam, farklı Merchant ID'lere ve anahtarlara sahip ayrı Datatrans hesaplarıdır.

Para birimi: mağaza para birimi (veya çoklu para birimi eklentinizin sipariş para birimi) Datatrans satıcı hesabınız için etkinleştirilmiş olmalıdır.

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

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin bölümüne gidin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_datatrans_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın. WooCommerce etkin olmalıdır.

3. Ayarları açın: WooCommerce > Settings > Payments > Datatrans > Manage veya Eklentiler sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Sandbox kimlik bilgilerini ve gerçek ödemeler için canlı kimlik bilgilerini girin (bkz. Yapılandırma).

6. Enable/Disable seçeneğini açın. Test ederken Sandbox mode açık kalsın, ardından gerçek ödeme almak için işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Datatrans. Ağ geçidi etkin olduğu halde geçerli ortamın Merchant ID'si veya API parolası eksikse, sayfa eksik alanların listesiyle birlikte Datatrans is hidden at checkout until these settings are filled in: mesajını gösterir. Sandbox modu açıkken Sandbox mode is on: payments go to the Datatrans sandbox, no real money is charged. mesajını gösterir.

Webhook

Webhook URL ayarların üstünde gösterilir. Şuna benzer: https://your-site/wc-api/datatrans_payment_callback/. Eklenti bu adresi her işlemle birlikte Datatrans'a gönderir, bu yüzden onu hiçbir yere girmeniz gerekmez. Datatrans Web Admin'deki webhook ayarlarına da girerek orada yapılan tahsilat ve iptallerin güncellemelerini alabilirsiniz.

Webhook, işlemin durumunu bildirir. Eklenti şu durumlara göre hareket eder:

Bir HMAC imza anahtarıyla her webhook, Datatrans-Signature başlığıyla kontrol edilir. Geçerli imzası olmayan webhook'lar reddedilir. İmza anahtarı olmadan eklenti webhook içeriğine güvenmez ve her webhook'u Datatrans durum API'siyle kontrol eder. Webhook olmadan bir sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Genel

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öntemi adı. Varsayılan: Datatrans.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely via Datatrans.

Sandbox mode: Use the Datatrans sandbox (test payments, no real money). Hem API ve ödeme sayfası sunucularını hem de aşağıdaki kimlik bilgilerini değiştirir. İadeler ve tahsilatlar her zaman ödemenin yapıldığı ortamı kullanır. Varsayılan: açık. Gerçek ödeme almak için işaretini kaldırın.

Sandbox kimlik bilgileri

Bunları Datatrans sandbox Web Admin'den (admin.sandbox.datatrans.com) kopyalayın. İmza anahtarı orada güvenlik ayarlarındadır.

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

Sandbox API password: sandbox hesabınızı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 anahtar olmadan her webhook, Datatrans durum API'siyle yeniden kontrol edilir.

Canlı kimlik bilgileri

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

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

Production API password: canlı hesabınızı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 anahtar olmadan her webhook, Datatrans durum API'siyle yeniden kontrol edilir.

İmza anahtarı, Datatrans tarafından verildiği şekliyle onaltılık bir dize olmalıdır. Başka herhangi bir değer kaydedilmez: sayfa bir hata gösterir ve önceki değeri korur. Sürüm 1.0'dan güncelliyorsanız, o sürümdeki tek kimlik bilgisi seti, sandbox modu açıksa sandbox alanlarına taşınır; aksi halde canlı alanlarda kalır.

Ödeme işleme

Auto settle: Capture (settle) payments immediately. Varsayılan: açık. Kapatırsanız ödemeler yalnızca yetkilendirilir: sipariş beklemeye alınır ve siparişi daha sonra Capture Datatrans payment sipariş eylemiyle tahsil edersiniz ya da Cancel Datatrans authorization ile serbest bırakırsınız.

Order status after payment: ödeme tahsil edildiğinde (settle) ayarlanan sipariş durumu. Durum, ikinci bir durum değişikliği olmadan hemen ayarlanır.

Gelişmiş

Logging: Log payment events and API calls ayrıntıları WooCommerce > Status > Logs bölümüne yazar, kaynak wcp_datatrans_gateway. Hatalar her zaman günlüğe kaydedilir. Hiçbir anahtar, kart verisi veya müşteri verisi yazılmaz. Varsayılan: kapalı.

Delete data on uninstall: Remove the plugin settings when the plugin is deleted. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Datatrans) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde, sipariş ID'sini referans alan bir Datatrans işlemi oluşturur ve müşteriyi Datatrans ödeme sayfasına yönlendirir. Orada müşteri, Datatrans hesabınızda etkin olan herhangi bir yöntemle öder; örneğin kart, TWINT veya PostFinance. Siteniz bu dillerden birini kullanıyorsa ödeme sayfası Almanca, İngilizce, Fransızca veya İtalyanca açılır; aksi halde dili Datatrans seçer.

Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş yalnızca Datatrans onayladıktan sonra ödenmiş olarak işaretlenir: webhook ile ya da müşteri döndüğünde Datatrans durum API'sine yapılan sunucu tarafı bir istekle. Dönüş adresi sipariş anahtarını taşır ve dönüşün kendisi bir siparişi asla ödenmiş olarak işaretlemez.

Müşteri ödeme sayfasında iptal ederse, The payment was canceled. You can try again or choose another payment method. mesajıyla Pay for order sayfasına gider. Başarısız bir ödemeden sonra mesaj The payment was not completed. Please try again or choose another payment method. şeklindedir. Sipariş ödenebilir durumda kalır ve müşteri yeniden deneyebilir.

Datatrans ödemeyi başlatamazsa müşteri The payment could not be started. Please try again or choose another payment method. mesajını görür. 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.

Eklenti yalnızca Datatrans ödeme sayfasında tek seferlik ödemeleri kabul eder. Kayıtlı kart veya takma ad, abonelik, Lightbox veya Secure Fields entegrasyonu, ayarlarda ödeme yöntemi seçimi ve bir yetkilendirmenin kısmi tahsili desteği yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Datatrans'a yönlendirildi ve henüz ödemedi, ödeme sayfasında iptal etti veya Datatrans ödemeyi henüz onaylamadı. Her yeni işlem, ID'si ve ortamıyla birlikte siparişe not edilir.

Processing, Completed or On Hold: ödeme tahsil edildi. Durum Order status after payment ayarını izler. Sipariş notu tutarı, ödeme yöntemini, Datatrans işlem ID'sini ve ortamı (sandbox veya canlı) gösterir. İşlem ID'si siparişe kaydedilir.

On hold, authorized: Auto settle kapalıyken ödeme yetkilendirildi ancak tahsil edilmedi. Siparişi açın ve sipariş eylemlerinde Capture Datatrans payment veya Cancel Datatrans authorization seçeneğini seçin. Tahsilat, yetkilendirilen tutardan yüksek olmaması gereken güncel sipariş toplamını kullanır. Yüksekse ya da Datatrans tahsilatı veya iptali reddederse neden sipariş notlarına eklenir.

On hold after payment: Datatrans sipariş toplamından farklı bir tutar veya para birimi bildirdi (örneğin sipariş, ödeme başladıktan sonra düzenlendi) ya da ödeme, sipariş iptal edildikten sonra geldi. Sipariş notu bunu açıklar. İşlemi Datatrans Web Admin'de kontrol edin ve siparişi işleme alın ya da ödemeyi iade edin.

Failed: ödeme başarısız oldu veya reddedildi. Müşteri yeniden deneyebilir.

Cancelled: yetkilendirme, sipariş eylemiyle veya Datatrans Web Admin'de serbest bırakıldı.

Geç gelen bir başarısızlık veya iptal bildirimi ödenmiş bir siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, olası çift tahsilat konusunda uyarır ve gerekirse Datatrans'ta iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Datatrans düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortamda gönderilir; bu nedenle o ortamın kimlik bilgileri ayarlı olmalıdır. Yeniden denenen bir iade iki kez alacaklandırılmaz. Datatrans iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, tutar ve Datatrans iade işlem ID'siyle birlikte sipariş notlarına eklenir.

Yalnızca yetkilendirilmiş bir ödemede, tam tutarın iadesi yetkilendirmeyi iptal eder. Ödeme tahsil edilene kadar kısmi iade mümkün değildir.

Datatrans Web Admin'de yapılan iadeler WooCommerce'e kaydedilmez. Gerekirse WooCommerce'te Refund via Datatrans kullanmadan manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Datatrans sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Blok, örneğin lisansın hangi tarihe kadar etkin olduğu ve alan adınız gibi durumu gösterir. 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda 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. Giriş yapmış 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: başlamış ödemeler yine onaylanır, iadeler ve tahsilatlar çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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'si ile API parolasının ayarlı olduğunu kontrol edin: sandbox modunda sandbox alanları, aksi halde canlı alanlar. Ayarlar sayfası eksik alanları listeler.

Ödeme geçti ama sipariş Ödeme bekleniyor durumunda kalıyor: Datatrans webhook URL'sine ulaşamadı ve müşteri mağazaya dönmedi. Sitenin internetten HTTPS ile erişilebilir olduğunu ve hiçbir güvenlik eklentisinin ya da güvenlik duvarının /wc-api/datatrans_payment_callback/ adresine yapılan istekleri engellemediğini kontrol edin. Ayarlardaki imza anahtarının ödemenin ortamına ait olduğunu kontrol edin. Logging seçeneğini açın ve WooCommerce > Status > Logs bölümüne bakın, kaynak wcp_datatrans_gateway.

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

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

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

Müşteri The payment could not be started mesajını görüyor: Merchant ID veya API parolası yanlış, diğer ortama ait ya da para birimi Datatrans hesabınız için etkin değil. Nedeni görmek için Logging seçeneğini açın.

Sipariş ödemeden sonra Beklemede: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı, ödeme sipariş iptal edildikten sonra geldi ya da ödeme yalnızca yetkilendirilmiş olup tahsilatı bekliyor.

Tahsilat mümkün değil: sipariş toplamı yetkilendirilen tutardan yüksek. Tahsilat güncel sipariş toplamını kullanır; bu nedenle onu yetkilendirilen tutara veya daha aşağıya düşürün.

İade, kimlik bilgileriyle ilgili bir mesajla başarısız oluyor: ödeme diğer ortamda yapıldı ve o ortamın kimlik bilgileri ayarlı değil. Bunları girin ve yeniden deneyin. Yetkilendirilmiş bir ödemede tam tutarı iade edin veya önce tahsil 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 anahtarı yeni alan adı için etkinleştirmek üzere Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Geliştiriciler için readme, örneğin Datatrans sayfasında gösterilen ödeme yöntemlerini sınırlamak üzere wcp_datatrans_gateway_init_request filtresinden söz eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için Eklentiler (Plugins) sayfasında devre dışı bırakın ve silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde daha sonraki bir yeniden kurulum için kalır. Mevcut siparişler ödeme notlarını ve işlem ID'lerini korur.

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