VibeFox Tpay for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 sürümünde test edilmiştir) veya 4.0.2 ve üzeri (4.1.0.3 sürümünde test edilmiştir).

PHP: 8.0 veya üzeri. Bildirimlerin JWS imza kontrolü için OpenSSL eklentisi ve secure.tpay.com adresine giden HTTPS bağlantısı gereklidir.

Para birimi: yalnızca Polonya zlotisi (PLN). Tpay PLN cinsinden ödeme yapar ve Open API'sinde para birimi alanı yoktur. Mağazanızda yoksa System > Localisation > Currencies bölümünden PLN ekleyin: Tpay yalnızca müşteri PLN ile ödeme yaptığında gösterilir.

Mağazanıza internet erişimi: Tpay ödeme bildirimlerini mağazanıza gönderir; bu nedenle bildirim adresinin internetten erişilebilir olması gerekir (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemeli).

Tpay hesabı: Tpay satıcı panelinden şu bilgilere ihtiyacınız vardır: Merchant ID (Tpay hesap kimliğiniz), Open API anahtarları Client ID ve Client secret (Integration, API) ve güvenlik kodu (Settings, Notifications). Sandbox anahtarları ayrı bir Tpay sandbox hesabından alınır.

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

Kurulum

İndirilen dosya, iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Arşivi bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_tpay_payment-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_tpay_payment.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi 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_tpay_payment-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği bulunmadığından 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 olarak Payments seçin. VibeFox Tpay Payment eklentisini bulup Install (yeşil + düğmesi) düğmesine 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 (kalem düğmesi) düğmesine tıklayın. Sayfanın üstündeki lisans bloğunda bulunan License key alanına VibeFox lisans anahtarınızı yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox anahtarlarını ve üretim anahtarlarını girin (bkz. Yapılandırma). Her işlemle birlikte bildirim adresi gönderildiği için Tpay panelinde güvenlik kodu dışında bir şey ayarlamanız gerekmez.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox 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_tpay_payment.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır, adı değiştirilmiş paket ise çalışmaz.

2. Paket, aynı sayfadaki kurulu eklentiler listesinde görünür. Yanındaki Install düğmesine (yeşil +) tıklayın.

3. Extensions > Extensions sayfasına gidin ve türü Payments olarak seçin. VibeFox Tpay Payment eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını, Tpay anahtarlarını ve bildirim ayarlarını OpenCart 3 için 3-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. Ödeme bildirimleri).

Yeni bir kurulum, ödeme yöntemi kapalı ve sandbox modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Tpay Payment > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa, sandbox modu açıkken Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. mesajını gösterir. Geçerli modun anahtarları eksik olduğunda (bu durumda Tpay ödeme sayfasında gösterilmez), mağazanın varsayılan para birimi PLN değilse (Tpay yalnızca müşteri PLN ile ödediğinde gösterilir) ve JWS kontrolü açıkken OpenSSL PHP eklentisi eksikse (bu durumda ödemeler onaylanmaz) uyarır. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken Title boş olamaz ve 128 karakterden uzun olamaz, Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Eksik anahtarlar kaydetmeyi engellemez. Merchant ID veya Client ID ile birlikte yapıştırılan boşluklar silinir, gizli değerlerin başındaki ve sonundaki boşluklar kırpılır.

Tpay

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Tpay. Zorunlu, en fazla 128 karakter.

Description: müşterinin Confirm Order adımında, onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: Tpay sandbox'ını (test ödemeleri, gerçek para yok) sandbox anahtarları ve openapi.sandbox.tpay.com ile kullanır. Gerçek ödemeleri üretim anahtarlarıyla kabul etmek için kapatın. İadeler her zaman siparişin ödendiği ortama yapılır. Varsayılan: açık.

Sort Order: Tpay'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin (negatif değerlere izin verilir).

Geo Zone: Tpay'i yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones sayfasında ayarlanır.

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

Üretim anahtarları

Nerede bulunur: Tpay satıcı panelinde (bölüm oraya bağlantı verir), Integration, API altında (Open API anahtarları: Client ID ve Secret); Merchant ID, Tpay hesap kimliğinizdir; güvenlik kodu Settings, Notifications altındadır.

Merchant ID: Tpay hesap kimliğiniz (rakamlar). Tpay bunu her bildirimde gönderir.

Client ID: Open API Client ID.

Client secret: Open API Client secret.

Security code: Tpay bildirimlerinin MD5 sağlama toplamını doğrulamak için kullanılır.

Sandbox anahtarları

Sandbox, kendi anahtarlarına sahip ayrı bir Tpay test hesabıdır (bölüm Tpay API belgelerine bağlantı verir). Yalnızca Sandbox mode açıkken kullanılır.

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

Sandbox Client ID: sandbox hesabının Open API Client ID'si.

Sandbox Client secret: sandbox hesabının Open API Client secret'ı.

Sandbox Security code: sandbox hesabının bildirim güvenlik kodu.

Kayıtlı gizli değerler (her iki ortamın Client secret ve Security code değerleri) bir daha gösterilmez. Alan boş kalır ve Saved - leave empty to keep it. gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir gizli değeri silmek için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Ödeme bildirimleri

Notification URL: Tpay ödemeleri burada gösterilen adrese onaylar. OpenCart 3'te adres https://your-store/index.php?route=extension/payment/wcp_tpay_payment/notify biçimindedir, OpenCart 4'te https://your-store/index.php?route=extension/wcp_tpay_payment/payment/wcp_tpay_payment.notify biçimindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. Adres her işlemle otomatik olarak gönderilir; Tpay panelinde güvenlik kodu dışında bir şey ayarlamanız gerekmez. Bir sipariş, yalnızca geçerli sağlama toplamı ve imzası olan ve tutarı eşleşen bir bildirimden sonra (ya da müşteri döndüğünde eşleşen bir durum sorgulamasından sonra) durum alır. Tpay, mağazanız kabul edene kadar bir bildirimi yineler. Bakım modu bu adresi engellemez (OpenCart 4'te eklenti, bildirimler ve müşterinin geri dönüşü için bir başlangıç eylemi ekler).

JWS signature: bildirimlerin X-JWS-Signature değerini Tpay sertifikasıyla da doğrular (önerilir). PHP OpenSSL eklentisini ve secure.tpay.com adresine giden HTTPS bağlantısını gerektirir. Sertifikalar bir gün önbelleğe alınır. MD5 sağlama toplamı her zaman doğrulanır. Varsayılan: açık.

Siparişler

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

Paid Order Status: onaylanmış bir ödemeden sonraki durum. Varsayılan: İşleniyor.

On Hold (Review) Status: ödeme sizin incelemenizi gerektirir (bkz. Sipariş durumları). Varsayılan: Beklemede; çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Cancelled Order Status: eklenti bu durumu hiçbir zaman ayarlamaz. Bu durumdaki bir sipariş için yapılan ödeme, siparişi sessizce yeniden açmak yerine incelemeye alır. Varsayılan: İptal edildi.

Refunded Status: ödeme sipariş sayfasından tam olarak iade edildikten sonra ayarlanır. Varsayılan: İade edildi.

Gelişmiş

Debug log: ödeme olaylarını kaydeder: yalnızca teknik olaylar (anahtar yok, müşteri verisi yok), OpenCart günlük klasöründe (storage/logs) wc_tp_debug.log.php dosyasında. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında eski bir kopyaya taşınır. Varsayılan: kapalı. Kapalıyken hatalar dahil hiçbir şey yazılmaz; bu nedenle bir sorunun nedenini aramadan önce açın.

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 on uninstall: açıksa eklentinin kaldırılması ağ geçidi ayarlarını ve günlüğü siler. Siparişler ve Tpay ödeme verileri her zaman korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Client secret'lar ve Security code'lar 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ı Client secret'lar ve Security code'lar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Tpay). Confirm Order adımında müşteri açıklamanızı ve You will be redirected to the secure Tpay page to complete the payment. notunu görür. Sandbox modunda Sandbox mode - no real money is charged. da gösterilir. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. 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.

Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için PLN cinsinden bir Tpay işlemi oluşturur; açıklama olarak Order # ve sipariş numarasını kullanır, müşterinin adını, e-posta adresini, ödeme adresini ve telefon numarasını iletir ve müşteriyi Tpay ödeme sayfasına yönlendirir. Sayfa, siparişin diline göre Lehçe, İngilizce veya Ukraynaca gösterilir (diğer diller İngilizce alır). Orada müşteri BLIK, banka havalesi, kart veya Tpay hesabınızda etkin olan başka bir yöntemi seçer ve öder.

Sipariş, yalnızca Tpay ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir. Tpay mağazanıza bir bildirim gönderir; eklenti MD5 sağlama toplamını güvenlik kodu ve Merchant ID ile (açıksa JWS imzasıyla birlikte) doğrular; bunu ödemenin başlatıldığı ortamın anahtarlarıyla yapar ve ardından tutarı kontrol eder: bu ödeme denemesi için istenen tutara ve sipariş toplamına eşit olmalıdır, ödenen tutar da daha düşük olamaz. Geçerli sağlama toplamı veya imzası olmayan bildirimler reddedilir. Sipariş, ardından olağan OpenCart yöntemiyle, standart sipariş e-postaları ve stok güncellemesiyle durum alır.

Ödemeden sonra müşteri mağazanıza döner. Yalnızca dönmek hiçbir şeyi ödenmiş olarak işaretlemez. Bildirim henüz gelmediyse eklenti Tpay API'sinden işlemin durumunu sorar (en fazla 10 saniyede bir) ve aynı kontrolleri uygular. Ödeme onaylandığında müşteri OpenCart sipariş başarılı sayfasını görür. Onaylanana kadar bir Payment confirmation sayfası Tpay has not confirmed your payment yet. If you have paid, refresh this page in a moment. If the payment did not go through, you can try again: mesajını, bir Refresh düğmesini ve ödeme sayfasına geri götüren bir Pay again düğmesini gösterir. Bildirim ulaşır ulaşmaz sipariş durumunu ayarlar. Sipariş incelemeye alındıysa başarı sayfası ayrıca Your payment is being verified. We will contact you as soon as it is confirmed. mesajını gösterir.

Tpay ödemenin başarısız olduğunu bildirirse müşteri Tpay reports that the payment did not go through. Please try again or choose another payment method. mesajıyla ödeme sayfasına döner. Ödeme Tpay sayfasında başarısız olursa Tpay müşteriyi ödeme sayfasına geri gönderir. Her iki durumda da sepet korunur.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur. OpenCart 4 ise oluşturduğu tek siparişi ödeme sürecinde tutar ve günceller; bu nedenle Pay again aynı siparişin yeni bir denemesini başlatır. Her ödeme denemesinin kendi referansı vardır. Müşteri yeniden ödeme yaptığında, siparişin ve aynı sepetteki diğer siparişlerin önceki ödenmemiş Tpay işlemleri Tpay'de iptal edilir; daha önceki bir bağlantıyla zaten tamamlanmış bir ödeme yine de kabul edilir. Aynı sepetin başka bir siparişi zaten ödenmişse müşteri yeni bir ödeme yerine başarı sayfasına gider.

OpenCart 4'te, siparişin mağaza tarafından bu arada kapatılması veya siparişin zaten ödenmiş olup sepetin, yeni adet dahil, o zamandan beri değişmesi durumunda müşteri Your previous order is already closed or paid. Please confirm the order again: the cart will be paid with a new order. mesajıyla ödeme sayfasına geri gönderilir. Mağazanın herhangi bir ödeme yapılmadan önce iptal ettiği bir sipariş için mesaj Order #… was cancelled by the store before the payment was completed. No Tpay payment was received for it. Please place a new order or contact us. şeklindedir. Bir sonraki Confirm Order yeni bir sipariş için ödeme yapar. OpenCart 4'te bu mesajlar, başarısız ödeme mesajı ve We could not match this payment to an order. If you were charged, please contact us. ile birlikte ödeme sayfasının üstünde gösterilir.

Tpay ödemeyi başlatamazsa müşteri Confirm Order adımında kalır ve The Tpay payment could not be started. Please try again or choose another payment method. mesajını görür; neden (Debug log açıksa) günlüğe yazılır. Diğer mesajlar: Tpay accepts payments in Polish złoty (PLN) only. Please choose another payment method. ve The order total must be greater than zero.

Eklenti yalnızca PLN ile çalışır. Mağazada banka veya BLIK kodu seçimi yoktur (müşteri bunu Tpay sayfasında seçer), kayıtlı kart yoktur, abonelik yoktur, mağazada Apple Pay veya Google Pay düğmesi yoktur ve taksit hesaplayıcıları yoktur.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Tpay'e yönlendirildi ve ödeme yapmadı ya da Tpay henüz ödemeyi onaylamadı. Başarısız bir ödeme de siparişi durumsuz bırakır. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Paid Order Status (default Processing): Tpay ödemeyi onayladı. Bir not, Tpay işlem başlığını (TR-...), ödenen tutarı, onayın bildirimle mi yoksa durum sorgusuyla mı geldiğini, ortamı ve varsa fazla ödemeyi gösterir.

On Hold (Review) Status (default Pending): bir ödeme geldi, ancak sipariş para birimi PLN değil, tutarı istenen tutarla veya sipariş toplamıyla eşleşmiyor (örneğin ödeme başladıktan sonra sipariş değiştirildi), yalnızca bir kısmı ödendi ya da ödeme Cancelled Order Status durumundaki bir sipariş için geldi. Not bunu açıklar. Ödemeyi Tpay panelinde kontrol edin ve siparişi tamamlayın ya da iade edin. Müşteri daha sonra doğru tutarı başka bir denemeyle öderse sipariş Paid Order Status durumuna geçer.

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

Tpay, zaten ödenmiş veya iade edilmiş bir sipariş için başka bir ödeme bildirirse sipariş değiştirilmez; bir not, gerekirse fazla ödemeyi Tpay panelinde iade etmenizi ister. Zaten ödenmiş bir sepetin başka bir siparişi için yapılan ödeme, o siparişi durumsuz bırakır ve ödenmiş siparişe not düşülür. Zaten bir durumu olan bir sipariş için başarısız bir ödeme, bir chargeback ve bilinmeyen bir Tpay durumu yalnızca not ekler.

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

VibeFox Tpay Payment sekmesi

Sales > Orders sayfasında Tpay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Tpay Payment sekmesi Tpay transaction başlığını ve Transaction ID bilgisini, ödeme referansını (CRC), Environment bilgisini (sandbox ödemeleri için Sandbox etiketi), ödemenin Status bilgisini ve nasıl onaylandığını, ödenen tutarı, Order total / refunded bilgisini, sipariş toplamından farklıysa Refundable (paid through Tpay) bilgisini, iade formunu, iade geçmişini, siparişin Payment attempts kayıtlarını (iptal edilen bağlantılar için link cancelled ile) ve Payment notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional, kept in the note) yazın ve Refund via Tpay düğmesine tıklayın. Refund this amount through Tpay? This cannot be undone. sorusunu onaylayın. Tpay üzerinden alınmış bir ödemesi olan siparişler için tam ve kısmi iadeler desteklenir; inceleme altındaki siparişler dahildir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). Ödemeyi yapan Tpay işleminin tahsil ettiği tutara kadar iade yapabilirsiniz; ancak sipariş toplamını aşamaz. İade, siparişin ödendiği ortama (sandbox veya üretim) gönderilir; bu nedenle o ortamın anahtarları ayarlanmış olmalıdır. İade yalnızca Tpay onayladığında tamamlanmış sayılır; Tpay'in reddettiği veya onaylamadığı bir iade hata olarak gösterilir ve kaydedilmez. Başarılı bir iade, girdiğiniz nedenle birlikte iade geçmişine ve notlara eklenir (neden Tpay'e gönderilmez). İade edilebilir tutarın tamamının iadesi, müşteriye bildirilmeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi siparişi Refunded Status durumuna getirir. Kısmi bir iade durumu değiştirmez.

Sales > Returns sayfasındaki ürün iadeleri Tpay üzerinden para geri göndermez. Tpay satıcı panelinde yapılan iadeler OpenCart'a otomatik olarak eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Tpay Payment lisans bloğu, Extensions > Extensions > Payments > VibeFox Tpay Payment > 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 hangi tarihe kadar geçerli olduğunu 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-tpay 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. Bloktaki metinler yönetim panelinin 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 ya da hesabınızda bir alan adı yuvası 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 tek bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarın mağazadan kaldırılması alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Tpay müşterilere ödeme sayfasında 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 yine 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 oturumunu görmez, bu yüzden etkin anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim 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 yine onaylanır ve iadeler çalışmaya devam eder.

Lisans sona erdiğinde eklenti çalışmaya devam eder; ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde Dashboard veya Edit sayfasını açtığınızda durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Tpay ö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 dört anahtarının da (Merchant ID, Client ID, Client secret, Security code) girildiğini kontrol edin. Müşterinin PLN ile ödeme yaptığını, ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlarda belirlenen Total değerine ulaştığını kontrol edin. Ayarlar sayfası eksik anahtarlar ve PLN dışı mağaza para birimi için uyarı gösterir.

Ödeme geçti ama sipariş durumsuz kaldı: Tpay bildirimi teslim edemedi veya bildirim reddedildi. Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın. Yaygın nedenler; ödemenin ortamı için yanlış bir güvenlik kodu veya Merchant ID, engellenmiş bir bildirim adresi (güvenlik duvarı, HTTP kimlik doğrulaması) ya da JWS kontrolü için OpenSSL'i veya giden HTTPS bağlantısı olmayan bir sunucudur. Müşteri ödemeden sonra mağazaya döndüğünde sipariş de durum alır.

Notification answered FALSE - invalid checksum: ayarlardaki Merchant ID veya güvenlik kodu, ödemenin Tpay hesabıyla (sandbox veya üretim) eşleşmiyor.

Notification answered FALSE - invalid JWS signature: imza doğrulanamadı; örneğin OpenSSL eksik olduğu veya Tpay sertifikası indirilemediği için. Sunucuyu düzeltin veya gerekirse JWS signature seçeneğini kapatın; MD5 sağlama toplamı yine de kontrol edilir.

Notification answered FALSE - busy, retry later veya FALSE - order could not be updated: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş durumu ayarlanamadı. Tpay bildirimi otomatik olarak yeniden gönderir. Nedeni görmek için Debug log seçeneğini açın.

Bildirim URL'si FALSE - POST only in the browser gösteriyor: bu normaldir. URL yalnızca Tpay'den gelen bildirimleri kabul eder.

Sipariş inceleme durumunda: VibeFox Tpay Payment sekmesindeki notları okuyun (bkz. Sipariş durumları), ödemeyi Tpay panelinde kontrol edin, ardından siparişi tamamlayın veya ödemeyi iade edin.

Müşteri The Tpay payment could not be started mesajını gördü: geçerli modun anahtarları hatalı veya Tpay isteği reddetti. Debug log seçeneğini açın; günlükte Tpay hatası görünür.

Müşteri This payment method is not available mesajını gördü: ödeme oturumu artık siparişle eşleşmiyor ya da ödeme yöntemi bu arada kapatıldı veya anahtarlarını kaybetti. Müşteri ödeme sayfasını yeniden yükler.

Müşteri We could not match this payment to an order mesajını gördü: dönüş bağlantısı siparişe ait değildi. Müşteriden ücret alındıysa bildirim yine de sipariş durumunu ayarlar; Tpay panelini kontrol edin.

İade başarısız oluyor: mesaj anahtarların eksik olduğunu söylüyorsa siparişin ödendiği ortamın anahtarlarını girin. Tutarın çok yüksek olduğunu söylüyorsa en fazla gösterilen tutar iade edilebilir. Tpay iadeyi onaylamadıysa yeniden denemeden önce işlemi Tpay satıcı panelinde kontrol edin. Sekme Tpay transaction ID not found. diyorsa siparişte iade edilecek onaylanmış bir Tpay ödemesi yoktur.

Geliştiriciler için: Tpay işlemi oluşturulmadan önce eklenti, işlem verileri, sipariş ve ortamla birlikte wc_tp_transaction_data OpenCart olayını tetikler.

Kaldırma

Extensions > Extensions sayfasına gidin, tür olarak Payments seçin ve VibeFox Tpay Payment 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 Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı (OpenCart 4'te ayrıca olayları ve başlangıç eylemi) ile Tpay erişim jetonları ve önbelleğe alınmış sertifikalar da her zaman kaldırılır. Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, sandbox modu, anahtarlar, JWS imzası, hata ayıklama günlüğü anahtarı) ve günlük de silinir. Kapalıysa daha sonraki bir yeniden kurulum için saklanırlar. Tpay 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 eklenti dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Tpay Payment yanındaki Uninstall düğmesine (turuncu −) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu) tıklayın.

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