VibeFox TrustPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

finby (TrustPay) hesabı: finby Merchant Portal'da Project ID ve Secret key bilgileriyle bir projeniz olmalıdır. Test ödemeleri için kendi Project ID ve Secret key bilgilerine sahip ayrı bir test (playground) projesi gerekir. Başka anahtar gerekmez: Secret key, hem API erişimi almak hem de ödeme bildirimlerinin imzasını doğrulamak için kullanılır.

Erişilebilir bildirim URL'si: finby, sitenize internet üzerinden ulaşabilmelidir. Güvenlik duvarı, bakım modu veya sitenin parola koruması ödeme bildirimlerini engeller.

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 yolunu izleyin, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_trustpay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > TrustPay / finby, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Canlı projenizin Project ID ve Secret key bilgilerini, test için de test projenizinkileri girin (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. Test mode açıkken bir test ödemesi yapın, ardından gerçek ödeme almak için Test mode seçimini kaldırın.

1.0 sürümünden güncelleme yaptığınızda Project ID ve Secret key bilgileriniz canlı kimlik bilgileri olarak korunur ve test modu kapatılır. Güncellemeden sonra ayarları kontrol edin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > TrustPay / finby. Alanların üstünde sayfa, geçit etkinken mevcut modun Project ID veya Secret key bilgisi boşsa ve mağaza para birimi desteklenmiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme sayfasında gizlenir. Ödeme yöntemleri listesinde geçit, mevcut modda Project ID ve Secret key girilene kadar kurulum gerektiren olarak işaretlenir.

General

Enable / Disable: Enable TrustPay / finby card 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: Card payment (TrustPay).

Description: ödeme sayfasında ödeme yönteminin altında görünen metin. Varsayılan: Pay securely by card on the TrustPay / finby payment page.

API credentials

Projenizin Project ID ve Secret key bilgilerini finby (TrustPay) Merchant Portal'dan kopyalayın. Bölümde Merchant Portal'a bir bağlantı bulunur. Test ödemeleri, kendi Project ID ve Secret key bilgilerine sahip ayrı bir test (playground) projesi kullanır. Orada gerçek para tahsil edilmez.

Test mode: Use the test project (no real payments). Yeni ödemeler ve iadeler test kimlik bilgilerini kullanır. Bir siparişin iadeleri her zaman siparişin ödendiği projeye yapılır. Varsayılan: açık.

Live Project ID: canlı projenizin sayısal Project ID değeri.

Live Secret key: canlı projenin Secret key değeri. API erişim jetonlarını almak ve ödeme bildirimlerini doğrulamak için kullanılır.

Test Project ID: test (playground) projenizin sayısal Project ID değeri.

Test Secret key: test projesinin Secret key değeri.

Project ID yalnızca rakamlardan oluşmalıdır. Başka bir değer kaydederseniz sayfa bir hata gösterir ve önceki değer korunur. Secret key değerleri girdiğiniz gibi kaydedilir; yalnızca baştaki ve sondaki boşluklar silinir.

Payment notifications

Sipariş, finby ödemeyi imzalı bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Eklenti, bildirim URL'sini her ödemeyle otomatik olarak gönderir, bu yüzden bunu ayrıca kurmanız gerekmez. Bölümde URL görünür, örneğin https://your-site/wc-api/trustpay_payment_callback/. Bunu Merchant Portal'daki projelerinizin bildirim URL'si olarak da girebilirsiniz. Geçerli imzası olmayan bildirimler reddedilir.

Eklenti, ödeme durumunu finby'den kendiliğinden sorgulamaz. Bir bildirim sitenize ulaşamazsa, finby bildirimi iletene kadar sipariş Pending payment durumunda kalır.

Advanced

Order status after payment: başarılı bir ödemeden sonra ayarlanan sipariş durumu. Durum tek adımda ayarlanır, böylece müşteri tek bir e-posta alır.

Debug logging: Log API requests and notifications günlüğe ayrıntı ekler. Hatalar, bu seçenek kapalı olsa bile her zaman günlüğe yazılır. Günlükler WooCommerce > Status > Logs altında, kaynağı wcp_trustpay_gateway olarak bulunur ve anahtar, jeton, kart veya müşteri bilgisi içermez. Varsayılan: kapalı.

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted (order data is kept). Varsayılan: kapalı.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Card payment (TrustPay)) ve siparişi verir. Test modunda ödeme sayfası, açıklamanın altında Test mode: no real payment will be taken. mesajını gösterir.

Kart ödemeleri fatura adresi gerektirir. Cadde, şehir, posta kodu veya ülke eksikse müşteri Please enter your billing address (street, city, postcode and country) — it is required for card payments. mesajını görür.

Eklenti, sipariş tutarı için sipariş para biriminde finby'de bir kart ödeme talebi oluşturur. Müşterinin adı, adresi ve e-posta adresi 3-D Secure için gönderilir, sipariş kimliği referans olarak gönderilir. Müşteri finby ödeme sayfasına yönlendirilir ve kartla orada öder. Sayfa, finby destekliyorsa mağazanızın dilinde, desteklemiyorsa İngilizce açılır. Siparişteki bir not, ödeme talebini, tutarı ve projeyi (test veya canlı) gösterir.

Ödemeden sonra müşteri mağazanızın sipariş alındı sayfasına döner ve sepet boşaltılır. Sipariş, finby imzalı bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Dönüş işlemi tek başına ödeme durumunu hiçbir zaman değiştirmez.

Müşteri ödeme sayfasında iptal ederse veya ödeme sayfası hata döndürürse, müşteri Pay for order sayfasına şu mesajla döner: The card payment was cancelled. You can try again or choose another payment method. ya da The card payment was not completed. Please try again or choose another payment method. Siparişe bir not eklenir. Müşteri bu sayfadan yeniden ödeme yapabilir.

finby ödemeyi başlatamazsa müşteri We could not start the card payment. Please try again in a moment or choose another payment method. mesajını görür. Teknik neden günlüğe yazılır.

Para birimleri: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF ve USD. HUF tutarları ondalıksız gönderilir. Pay for order sayfasında sipariş para birimi kontrol edilir.

Ö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 İngilizce, Slovakça ve Çekçe çevirilerle birlikte gelir.

Eklenti yalnızca kart ödemelerini kabul eder; finby sayfasında tek adımlık bir satın alma olarak. Banka havalesi veya finby'nin diğer ödeme yöntemleri, Apple Pay veya Google Pay düğmeleri, kayıtlı kartlar, abonelikler veya yinelenen ödemeler, ayrı yetkilendirme ve tahsilat, ayrıca durum sorgulama yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: Müşteri finby'ye yönlendirildi ve henüz ödeme yapmadı ya da bildirim henüz gelmedi.

Processing or Completed: finby ödemeyi onayladı; tutar ve para birimi ödeme talebi ile sipariş toplamıyla eşleşiyor. Durum, Order status after payment ayarını izler. Sipariş notu tutarı, ödeme talebini ve projeyi gösterir. İşlem kimliği, finby ödeme talebi kimliğidir.

On hold: üç durumda ayarlanır. Ödeme finby'de hâlâ beklemededir ve sipariş son sonucu bekler. Ödeme yalnızca yetkilendirilmiş, tahsil edilmemiştir: finby Merchant Portal'da tahsil edin veya iptal edin, ardından siparişi güncelleyin. Ya da ödenen tutar veya para birimi ödeme talebinden ya da sipariş toplamından farklıdır; örneğin müşteri ödeme sayfasına gönderildikten sonra sipariş düzenlendiği için. Gönderimden önce ödemeyi kontrol edin. Sipariş notu durumu açıklar.

Failed: finby, siparişin son ödemesini reddetti. finby nedeni gönderdiğinde not bunu gösterir. Müşteri Pay for order sayfasından yeniden ödeme yapabilir.

İptal edilen veya iade edilen siparişler, geciken bir ödemeyle asla yeniden açılmaz. Bir not, siparişi geri getirmenizi veya ödemeyi Merchant Portal'da iade etmenizi ister. Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş değişmez ve bir not, yinelenen ödemeyi Merchant Portal'da iade etmenizi ister. finby tarafından bildirilen itirazlar ve anlaşmazlıklar not olarak eklenir.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Card payment (TrustPay) düğmesine tıklayın (düğmede Title ayarınız görünür). Tam ve kısmi iadeler desteklenir. İade, siz o zamandan beri modu değiştirmiş olsanız bile siparişin ödendiği projeye (test veya canlı) gönderilir; bu nedenle o modun Project ID ve Secret key bilgileri girilmiş olmalıdır. HUF iadeleri tam tutar olmalıdır.

Bir iade, yalnızca finby kabul ettiğinde kaydedilir. Aksi halde WooCommerce, nedeniyle birlikte TrustPay refused the refund: mesajını gösterir ve iade oluşturulmaz. Başarılı bir iade sipariş notlarına eklenir.

finby Merchant Portal'da yapılan iadeler WooCommerce iadesi olarak kaydedilmez. Bunlarla ilgili finby bir bildirim gönderirse, sipariş notu olarak eklenir ve sipariş durumu değişmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > TrustPay / finby sayfasının üst kısmındadır. 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 etkin olduğunu ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve 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, 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 ödeme yöntemi, ö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 yine onaylanır ve iadeler çalışır.

Bir 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

Card payment (TrustPay) ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve mevcut modda Project ID ile Secret key bulunduğunu kontrol edin: test modunda Test Project ID ve Test Secret key, canlı modda Live Project ID ve Live Secret key. Mağaza para birimi veya Pay for order sayfasındaki sipariş para birimi desteklenen para birimlerinden biri olmalıdır. Ayarlar sayfası her iki durumda da bir uyarı gösterir. Geliştiriciler, trustpay_p_supported_currencies filtresiyle para birimi listesini değiştirebilir.

Ödeme gerçekleşti, ancak sipariş Pending payment durumunda kalıyor: bildirim mağazanıza ulaşmadı. https://your-site/wc-api/trustpay_payment_callback/ adresinin internetten erişilebilir olduğunu kontrol edin (güvenlik duvarı, bakım modu veya parola koruması olmamalı). finby bildirimi yeniden dener. WooCommerce > Status > Logs sayfasına, kaynak wcp_trustpay_gateway olacak şekilde bakın.

Günlükte Notification rejected: invalid signature or unknown project görünüyor: bildirim, Project ID'si ayarlarda olmayan bir projeden geldi veya o projenin Secret key bilgisi yanlış. Mağaza Invalid signature yanıtı verir ve sipariş değişmez. Ödemenin yapıldığı modun Project ID ve Secret key bilgilerini kontrol edin.

Günlükte Notification ignored görünüyor: bildirim, bu mağazanın o sipariş için oluşturmadığı bir ödeme talebine veya ödemenin başlatıldığı projeden farklı bir projeye ait. Sipariş değişmez.

Bildirim Busy, retry later yanıtını alıyor: sipariş aynı anda başka bir bildirim tarafından güncelleniyordu. finby yeniden dener.

Müşteri We could not start the card payment mesajını görüyor: günlüğü açın. Yanlış Project ID veya Secret key, finby'nin proje kimlik bilgilerini reddettiği mesajını verir. Test bilgilerinin test alanlarında, canlı bilgilerin canlı alanlarında olduğunu kontrol edin.

Kart ödemesi geçici olarak kullanılamıyor: müşteri bu mesajı, mevcut modda Project ID veya Secret key yoksa görür. Bilgileri girin ve kaydedin.

Sipariş, tutar/para birimi uyuşmazlığı notuyla On hold durumunda: bildirim gerçekti, ancak ödenen tutar veya para birimi ödeme talebinden ya da sipariş toplamından farklı. Gönderimden önce Merchant Portal'da ödemeyi kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

İade, proje ile ilgili bir mesajla başarısız oluyor: sipariş test veya canlı projeyle ödendi ve o modun Project ID veya Secret key bilgisi girilmemiş ya da şimdi farklı bir Project ID kayıtlı. Bu projenin bilgilerini girin veya ödemeyi finby Merchant Portal'da iade 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şılamıyorsa eklenti son bilinen durumla çalışmaya devam eder.

Kaldırma

Eklentiyi devre dışı bırakmak tüm verileri korur. Kaldırmak için eklentiyi devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu ile önbelleğe alınmış API erişim jetonları her zaman kaldırılır. Geçit ayarları ve eklenti günlükleri (eski döndürülmüş dosyalar dahil günlük dosyaları ve veritabanındaki günlük kayıtları), yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Sipariş verileri korunur: mevcut siparişler ödeme notlarını, ödeme talebi kimliklerini ve işlem kimliklerini saklamaya devam eder.

TrustPay ve finby, ilgili sahiplerinin ticari markalarıdır. Bu eklenti TrustPay veya finby ile bağlantılı değildir ve onlar tarafından desteklenmez.