VibeFox TrustPay for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 ile test edildi) veya 4.0.2 ve üzeri (4.1.0.3 ile test edildi).

PHP: 8.0 veya üzeri.

finby (TrustPay) hesabı: finby Merchant Portal'ında Project ID ve Secret key içeren bir projeniz olmalıdır. Test ödemeleri için kendi Project ID ve Secret key değerlerine 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 mağazanıza internetten ulaşabilmelidir. Mağazanın önündeki bir güvenlik duvarı, bakım girişi veya HTTP kimlik doğrulaması ödeme bildirimlerini engeller.

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

Kurulum

İndirme, OpenCart'ın iki 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_trustpay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_trustpay_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 sayfasına gidin, Upload düğmesine tıklayın ve wcp_trustpay_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications sayfası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 sayfasına gidin ve türü Payments olarak seçin. VibeFox TrustPay 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 iznine sahip olması gerekir.

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 License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Test projenizin ve gerçek ödemeler için canlı projenizin Project ID ve Secret key değerlerini girin (bkz. Yapılandırma). Bildirim URL'si her ödemeyle birlikte gönderildiği için Merchant Portal'da herhangi bir ayar yapmanız gerekmez.

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir test ödemesi yapın, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_trustpay_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ı sayfada yüklü eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions sayfasına gidin, türü Payments olarak seçin, VibeFox TrustPay 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 finby projelerini OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Yapılandırma).

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 TrustPay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, ödeme yöntemi açık olmasına rağmen geçerli modun Project ID veya Secret key değeri boşsa ve mağazanın varsayılan para birimi desteklenmiyorsa sizi uyarır. Her iki durumda da ödeme yöntemi ödeme adımında gizlenir. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort order tam sayı olmalıdır (negatif değerlere izin verilir), Minimum total 0 veya daha büyük bir sayı olmalıdır ve seçilen coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi halde hiçbir şey kaydedilmez ve sayfa mesajı gösterir. Project ID yalnızca rakamlardan oluşmalıdır: başka bir değer kaydederseniz sayfa must contain digits only — the previous value was kept. mesajını gösterir ve diğer alanlar kaydedilir.

TrustPay / finby

Enable / Disable: Enable TrustPay / finby card payments. ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterinin ödeme adımında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Card payment (TrustPay). 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 by card on the TrustPay / finby payment page.

Sort order: ödeme yönteminin ödeme adımındaki konumu. Boş bırakın veya bir tam sayı girin (negatif değerlere izin verilir).

Geo zone: ödeme yöntemini yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones altında ayarlanır.

Minimum total: ödeme yönteminin sunulabilmesi için bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme adımı toplamı. Minimum olmaması için boş bırakın.

API kimlik bilgileri

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

Test mode: test projesini kullanır (gerçek ödeme alınmaz). 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. Açık olduğu sürece müşteriler Confirm Order adımında Test mode: no real payment will be taken. mesajını görür.

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

Live Secret key: canlı projenin Secret key değeri. API erişim token'ları 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.

Secret key değerleri girildiği gibi kaydedilir; yalnızca baştaki ve sondaki boşluklar silinir. Kaydedilmiş Secret key değerleri bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. mesajını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Ayarları kaydetmek, önbellekteki API erişim token'larını da temizler; böylece yeni kimlik bilgileri hemen kullanılır.

Clear saved secrets: bir Secret key'i işaretleyip Save düğmesine tıklayarak kaldırın. Boş bir alan kayıtlı değeri korur.

Sipariş durumları

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, finby imzalı bir bildirimle onaylayana kadar bir duruma sahip olmaz. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler. OpenCart'ta beklemedeki veya beklemede tutulan bir TrustPay ödemesi için kendi durumu yoktur; bu nedenle ikisi de varsayılan olarak Pending (Beklemede) kullanır; sipariş notları ve sipariş sekmesi bunları ayırt eder. Kendi durumlarınızı System > Localisation > Order Statuses altında oluşturabilir ve burada seçebilirsiniz.

Order status after payment: ödenmiş bir siparişin durumu. Varsayılan: İşleniyor. Ödenmiş siparişlerin hemen tamamlanmasını istiyorsanız Tamamlandı seçin. Durum tek adımda ayarlanır, böylece müşteri tek bir e-posta alır.

Awaiting TrustPay payment: finby son ödemeyi beklemede olarak bildirdi; finby onayladığında sipariş ödenmiş durumuna geçer. Varsayılan: Beklemede.

TrustPay payment on hold: ödeme yalnızca yetkilendirildi (Merchant Portal'dan tahsil edilmesi gerekiyor) veya ödenen tutar ya da para birimi ödeme talebinden ya da sipariş toplamından farklı. Varsayılan: Beklemede.

Payment error: finby, beklemedeki bir siparişin son ödemesini reddetti. Daha sonra onaylanan bir ödeme siparişi yine ödenmiş durumuna taşır. Varsayılan: Başarısız.

Cancelled order status: eklenti bunu ayarlamaz. Bu durumdaki bir sipariş geç gelen bir ödemeyle asla yeniden açılmaz; bir not eklenir. Varsayılan: İptal edildi.

Refunded order status: sipariş sayfasından tam iade yapıldıktan sonra ayarlanır. Varsayılan: İade edildi.

Ödeme bildirimleri

Sipariş, finby onu imzalı bir bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Eklenti, bildirim URL'sini her ödemeyle otomatik olarak gönderir; bu nedenle bunu kurmanız gerekmez. Bölüm, Notification URL altında URL'yi gösterir. OpenCart 3'te URL şu biçimdedir: https://your-store/index.php?route=extension/payment/wcp_trustpay_gateway/callback, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_trustpay_gateway/payment/wcp_trustpay_gateway.callback ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Ayrıca Merchant Portal'da projelerinizin bildirim URL'si olarak da girebilirsiniz. Geçerli imzası olmayan bildirimler reddedilir. URL, mağaza bakım modundayken de çalışır (OpenCart 4'te eklentinin bir başlangıç eylemi bildirimin ve müşterinin geri dönüşünün geçmesine izin verir).

Eklenti finby'den ödeme durumunu kendiliğinden sormaz. Bir bildirim mağazanıza ulaşamazsa, finby iletene kadar sipariş durumsuz kalır. finby bildirimleri yeniden dener.

Gelişmiş

Debug logging: API isteklerini ve bildirimleri OpenCart günlük klasöründeki (storage/logs; OpenCart 4'te system/storage/logs) trustpay_p_debug.log.php dosyasına ekler. Dosya web üzerinden açılamaz. Hatalar, bu seçenek kapalı olsa bile her zaman kaydedilir. Günlükte anahtar, token, kart verisi veya müşteri bilgisi bulunmaz. Varsayılan: kapalı.

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

Delete data on uninstall: açıkken eklentiyi kaldırmak, eklenti ayarlarını ve günlüğü siler. Sipariş verileri korunur: siparişler, TrustPay ödeme kayıtları ve iadeler. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Secret key değerleri 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ı Secret key değerleri korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Card payment (TrustPay)). Yalnızca müşterinin para birimi desteklenen para birimlerinden biriyse sunulur: EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF ve USD. Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the secure TrustPay / finby payment page to pay by card. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri ödeme yöntemini, Payment method options penceresindeki ödeme yöntemi bloğunun Choose düğmesiyle seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Müşteri Confirm Order düğmesine tıkladığında eklenti, finby'de sipariş tutarı ve sipariş para birimi için bir kart ödeme talebi oluşturur. HUF tutarları ondalık olmadan gönderilir. Müşterinin adı, adresi ve e-posta adresi 3-D Secure için gönderilir; OpenCart sipariş numarası referans olarak gönderilir. Kart ödemeleri bir adres gerektirir: sokak, ş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. OpenCart 4 varsayılan olarak fatura adresi istemediğinden, eksik alanlar teslimat adresinden alınır. Müşteri finby ödeme sayfasına yönlendirilir ve orada kartla öder. Sayfa, finby destekliyorsa mağazanın dilinde, desteklemiyorsa İngilizce açılır.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, finby imzalı bildirimle onaylayana kadar ödenmiş olarak işaretlenmez. Geri dönüşün kendisi ödeme durumunu hiçbir zaman değiştirmez. Bildirim zaten geldiyse müşteri OpenCart sipariş başarı sayfasını görür. Gelmediyse Payment confirmation sayfası şunu gösterir: TrustPay / finby is confirming your card payment. Your order is confirmed as soon as the payment is confirmed, and you will receive an e-mail — there is no need to pay again. Sayfada Check again ve Back to checkout düğmeleri bulunur. Sipariş beklemede veya beklemede tutulan durumdayken başarı sayfası Your card payment is being confirmed by TrustPay / finby. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. mesajını gösterir. Beklemedeki veya beklemede tutulan bir sipariş sonradan ödenirse ya da finby ödemeyi reddederse, müşteri yeni sipariş durumuyla ilgili e-postayı alır. finby ödemeyi reddettiyse veya ödenmemiş sipariş iptal edildiyse başarı sayfası Your card payment was not completed. Please contact us about this order. mesajını gösterir. OpenCart 4'te müşteri finby ödeme sayfasından döndüğünde, kısa bir ara sayfa mağazanızdaki dönüş adresini yeniden açar; böylece sepet ve müşteri girişi korunur.

Müşteri ödeme sayfasında iptal ederse, The card payment was cancelled. You can try again or choose another payment method. mesajıyla ödeme adımına döner. Ödeme sayfası bir hata döndürürse veya finby ödemeyi zaten reddettiyse mesaj şudur: The card payment was not completed. Please try again or choose another payment method. Sepet korunur ve müşteri yeniden ödeme yapabilir. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme siparişini günceller. Bir sepet yalnızca bir siparişle ödenir: sepetteki bir siparişin TrustPay durumu olduğunda, sepeti yeniden onaylamak ikinci bir ödeme yerine başarı sayfasına götürür. Miktar değişikliği dahil sepetteki her değişiklik, kendi ödemesi gereken yeni bir sepet sayılır.

OpenCart 4, siparişi başarı sayfası gösterilene kadar ödemede tutar. İptal edilen veya başarısız bir ödemeden sonra müşteri aynı siparişi yeni bir finby ödeme talebiyle öder. Bu sipariş bu arada kapatıldıysa müşteri ödemeye geri döner ve sonraki Confirm Order yeni bir sipariş öder: reddedilen bir ödemeden veya iptal edilen ödenmemiş bir siparişten sonra The card payment was not completed. Please try again or choose another payment method. ile; aksi halde (örneğin siparişi siz iptal ettiyseniz veya iade ettiyseniz) Your previous order was cancelled or refunded by the store. Please confirm the order again to pay with a new order. ile.

finby ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve düğmenin üstünde 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.

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

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri finby'ye yönlendirildi ve ödeme yapmadı ya da bildirim henüz gelmedi. Sales > Orders altında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında görünür. OpenCart 4.1'de böyle bir sipariş Voided durumuna da sahip olabilir; OpenCart onay adımı yeniden gösterildiğinde bu durumu ayarlar ve eklenti bunu durumsuz sipariş olarak sayar.

Ödemeden sonraki sipariş durumu (varsayılan İşleniyor): finby ödemeyi onayladı ve tutar ile para birimi ödeme talebi ve sipariş toplamıyla eşleşiyor. Bir not tutarı, ödeme talebini ve projeyi (test veya canlı) gösterir.

TrustPay ödemesi bekleniyor (varsayılan Beklemede): finby son ödemeyi beklemede olarak bildirdi. finby ödemeyi onayladığında sipariş ödenmiş durumuna geçer.

TrustPay ödemesi beklemede tutuluyor (varsayılan Beklemede): iki durumda ayarlanır. Ödeme yalnızca yetkilendirildi, tahsil edilmedi: finby Merchant Portal'dan 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ı: göndermeden önce ödemeyi kontrol edin. Not durumu açıklar. Para alındığı için iade yapılabilir.

Ödeme hatası (varsayılan Başarısız): finby, beklemedeki bir siparişin son ödemesini reddetti. finby bildirdiğinde not nedeni gösterir. Daha sonra onaylanan bir ödeme siparişi yine ödenmiş durumuna taşır.

İade edilmiş sipariş durumu (varsayılan İade edildi): ödeme eklenti üzerinden tamamen iade edildi.

İptal edilen veya iade edilen siparişler geç gelen bir ödemeyle asla yeniden açılmaz. Bir not, siparişi geri yüklemenizi veya ödemeyi Merchant Portal'dan iade etmenizi ister. Zaten ödenmiş bir sipariş için veya zaten ödenmiş siparişi olan bir sepetin başka bir siparişi için ikinci bir ödeme gelirse, sipariş değiştirilmez ve bir not, kopyayı Merchant Portal'dan iade etmenizi ister. finby tarafından bildirilen chargeback'ler ve itirazlar not olarak eklenir.

Notlar, müşterinin görmediği siparişin History kayıtlarıdır. Mağazanın varsayılan dilinde yazılırlar.

VibeFox TrustPay Gateway tab

Sales > Orders altında TrustPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox TrustPay Gateway sekmesi Payment request ID, Payment ID, test ödemeleri için Test project rozetiyle birlikte Project, Status, Requested / paid ve Paid / refunded tutarlarını, iade formunu, iade geçmişini, Payment requests of this order ve TrustPay notes bölümlerini gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox TrustPay Gateway sekmesinde Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via TrustPay düğmesine tıklayın. Refund this amount through TrustPay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme iznine sahip olmanız gerekir (System > Users > User Groups altında ayarlanır). İadeler, finby'nin ödeme için bildirdiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. HUF iadeleri tam tutar olmalıdır.

İade, mod değiştirmiş olsanız bile siparişin ödendiği projeye (test veya canlı) gider. O projenin Project ID ve Secret key değerleri ayarlanmış olmalı ve Project ID değişmemiş olmalıdır. İade yalnızca finby kabul ederse kaydedilir. Aksi halde sekme, nedeniyle birlikte TrustPay refused the refund: mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded order status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez.

Sales > Returns altındaki ürün iadeleri finby üzerinden para geri göndermez. finby Merchant Portal'da yapılan iadeler iade olarak kaydedilmez. finby bunlarla ilgili bir bildirim gönderirse, bildirim not olarak eklenir ve sipariş durumu değişmez.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu License — VibeFox TrustPay Gateway, Extensions > Extensions > Payments > VibeFox TrustPay Gateway > Edit sayfasında ayarların üstünde ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı maskelenmiş olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu mağazadan kaldırmak için Remove key düğmelerini gösterir. Bunların altında Product: opencart-payment-trustpay satırı ve Manage licenses and domains in your account bağlantısı bulunur; bu bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca eklenti için Modify iznine 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 tarihli License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttı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ızda serbest bırakın.

Etkin bir anahtar olmadan kart ödemesi ödeme adımı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 hâlâ (unlicensed — visible to admins only) işaretiyle 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 anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma belirir. 7 gün gizlemek için × ile kapatın. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler TrustPay bildirimiyle ve mağazaya dönüşle onaylanmaya devam eder, iadeler de çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim paneli Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir. Cron job gerekmez. Eklentiyi kaldırmak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

Card payment (TrustPay) ödeme adımında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modun Project ID ve Secret key değerlerine sahip olduğunu kontrol edin: test modunda Test Project ID ve Test Secret key, canlı modda Live Project ID ve Live Secret key. Müşterinin para birimi desteklenen para birimlerinden biri olmalıdır. Kimlik bilgileri eksikse veya varsayılan para birimi desteklenmiyorsa ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo zone içinde olduğunu ve siparişin Minimum total tutarına ulaştığını kontrol edin.

Ödeme gerçekleşti ama sipariş durumsuz kaldı: bildirim mağazanıza ulaşmadı. Notification URL altında gösterilen URL'nin internetten erişilebilir olduğunu kontrol edin (güvenlik duvarı, bakım girişi veya HTTP kimlik doğrulaması yok). finby bildirimi yeniden dener ve bildirim geldiğinde sipariş durumunu alır. Hatalar her zaman günlüğe yazılır; eklenti sayfasındaki Log alanına bakın.

Günlükte Notification rejected: invalid signature or unknown project görünüyor: bildirim, Project ID'si ayarlarda bulunmayan bir projeden geldi veya o projenin Secret key değeri yanlış. Mağaza Invalid signature yanıtı verir ve hiçbir şey değişmez. Ödemenin yapıldığı modun Project ID ve Secret key değerlerini 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/moddan farklı bir projeye ya da moda ait. Hiçbir şey değişmez.

Bildirim Busy, retry later veya Temporary error yanıtı alıyor: sepet aynı anda başka bir bildirim tarafından güncelleniyordu veya sipariş durumu ayarlanamadı. finby bunu yeniden dener. Günlük nedeni gösterir.

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

Card payment is temporarily unavailable: müşteri bunu, geçerli modda Project ID veya Secret key olmadığında görür. Bunları girin ve kaydedin.

Sipariş beklemede tutulan durumda: VibeFox TrustPay Gateway sekmesindeki notları okuyun (Sipariş durumları bölümüne bakın). Göndermeden önce Merchant Portal'da ödemeyi kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

İade, proje hakkında bir mesajla başarısız oluyor: sipariş test veya canlı projeyle ödendi ve o modun Project ID veya Secret key değeri ayarlanmamış ya da orada şimdi başka bir Project ID kayıtlı. Bu projenin kimlik bilgilerini girin veya ödemeyi finby Merchant Portal'dan iade edin.

Invalid refund amount: at most … can be refunded: tutar, ödenen tutardan eklenti üzerinden yapılmış iadeler çıkarıldıktan sonra kalan tutardan fazla.

Kaldırma

Extensions > Extensions sayfasına gidin, türü Payments olarak seçin ve VibeFox TrustPay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart her zaman eklentinin kendi ayarlarını kaldırır: Enable / Disable, Sort order, Geo zone, Minimum total ve yeniden kurulumda varsayılanlarına dönen sipariş durumları. Eklentinin OpenCart olayı ve önbellekteki API erişim token'ları da kaldırılır (OpenCart 4'te ayrıca olayları ve bakım modunda bildirimin ve müşterinin geri dönüşünün geçmesine izin veren başlangıç eylemi). Delete data on uninstall açıksa diğer ayarlar (başlık, açıklama, test modu, Project ID'ler, Secret key'ler, günlük kaydı) ve günlük kaldırılır. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. TrustPay ödeme kayıtları ve iadeler 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 eklentinin dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, yüklü eklentiler listesinde VibeFox TrustPay Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) ve ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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