VibeFox Tpay for WooCommerce — Yardım

Gereksinimler

WordPress: 5.8 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. WooCommerce olmadan eklenti etkinleştirilemez.

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

Mağaza para birimi: yalnızca Polonya złotisi (PLN). Tpay PLN cinsinden ödeme yapar ve Open API'sinde para birimi alanı yoktur; bu nedenle mağaza (veya ödenecek sipariş) başka bir para birimi kullanıyorsa ödeme yöntemi gizlenir.

Sitenize internet erişimi: Tpay ödeme bildirimlerini mağazanıza gönderir; bu nedenle bildirim adresine internetten erişilebilmelidir (bakım modu, güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemelidir).

Tpay hesabı: Tpay satıcı panelinden şu değerlere 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 gelir.

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. Ayrıca wcp_tpay_payment klasörünü FTP ile /wp-content/plugins/ dizinine yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > Tpay > Manage veya 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. Sandbox anahtarlarını ve Canlı anahtarları girin (bkz. Yapılandırma). Tpay panelinde güvenlik kodu dışında hiçbir şey ayarlamanız gerekmez: bildirim adresi her işlemle birlikte gönderilir.

6. Enable/Disable seçeneğini açın, sandbox modunda bir ödeme deneyin, ardından gerçek ödemeleri kabul etmek için Sandbox mode seçimini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Tpay. Alanların üstünde, sandbox modu açıkken sayfa Sandbox mode is on: payments go to the Tpay sandbox and no real money is charged. uyarısını gösterir. Geçerli modun anahtarları eksikse (bu durumda Tpay ödeme sayfasında görünmez), mağaza para birimi PLN değilse ve JWS kontrolü açıkken PHP OpenSSL eklentisi yoksa (ödemeler o zaman onaylanmaz) sayfa sizi uyarır. Ödeme yöntemleri listesinde, geçerli modun anahtarları girilene kadar Tpay kurulum gerektiriyor olarak işaretlenir. Merchant ID veya Client ID ile birlikte yapıştırılan boşluklar kaydetme sırasında silinir.

Genel

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

Title: ödeme sayfasında müşterilere gösterilen ödeme yöntemi başlığı. Varsayılan: Tpay.

Description: ödeme sayfasında müşterilere gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay with BLIK, online bank transfer or card on the secure Tpay page.

Sandbox mode: Use the Tpay sandbox (test payments, no real money). Sandbox modu, Sandbox anahtarlarını ve Tpay sandbox API'sini kullanır. Gerçek ödemeleri Canlı anahtarlarla kabul etmek için kapatın. İadeler her zaman siparişin ödendiği ortama gönderilir. Varsayılan: açık.

Canlı anahtarlar

Nerede bulunurlar: Tpay satıcı panelinde Integration, API bölümünde (Open API anahtarları: Client ID ve Secret); Merchant ID Tpay hesap kimliğinizdir; güvenlik kodu Settings, Notifications bölümündedir.

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 (bkz. Tpay API belgeleri). 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.

Ödeme bildirimleri

Tpay, ödemeleri bu bölümde gösterilen adrese bildirir. Adres şu biçimdedir: https://your-site/wc-api/wc_tp_payment/. Adres her işlemle birlikte otomatik olarak gönderilir; Tpay panelinde güvenlik kodu dışında hiç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 ödenmiş olur. Mağazanız kabul edene kadar Tpay bildirimi tekrar eder.

JWS imzası: Also verify the X-JWS-Signature of notifications with the Tpay certificate (recommended). PHP OpenSSL eklentisi ve secure.tpay.com adresine giden HTTPS bağlantısı gerektirir. MD5 sağlama toplamı her zaman doğrulanır. Varsayılan: açık.

Gelişmiş

Debug log: Log payment events. Yalnızca teknik olaylar (anahtar ve müşteri verisi olmadan) WooCommerce > Status > Logs altında, kaynak wcp_tpay_payment. Varsayılan: kapalı.

Delete data on uninstall: Remove the plugin settings and logs when the plugin is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Siparişler ve Tpay ödeme verileri her zaman korunur. Varsayılan: kapalı.

Sürüm 1.0 ayarları otomatik olarak aktarılır: test modu açıkken kullanılan anahtarlar Sandbox anahtarları olur.

Ödeme

Müşteri ödeme yöntemini (varsayılan olarak Tpay) seçer ve siparişi verir. Sandbox modunda ödeme sayfasında Sandbox mode — no real money is charged. gösterilir. Eklenti, sipariş tutarı 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, adresini ve telefonunu iletir ve müşteriyi Tpay ödeme sayfasına yönlendirir. Sayfa, site diline göre Lehçe, İngilizce veya Ukraynaca gösterilir (diğer diller İngilizce alır). Müşteri orada BLIK, banka havalesi, kart veya Tpay hesabınızda etkin olan başka bir yöntemi seçer ve öder.

Sipariş, yalnızca Tpay onayladıktan sonra ödenmiş olarak işaretlenir. Tpay mağazanıza bir bildirim gönderir; eklenti MD5 sağlama toplamını güvenlik kodu, Merchant ID ve (açıksa) JWS imzası ile doğrular, ardından tutarı kontrol eder: bu ödeme denemesi için istenen tutara ve sipariş toplamına eşit olmalıdır ve ödenen tutar daha düşük olamaz. Geçerli sağlama toplamı veya imzası olmayan bildirimler reddedilir.

Ödemeden sonra müşteri sipariş alındı sayfasına döner. Yalnızca geri dönmek siparişi ödenmiş olarak işaretlemez. Bildirim henüz gelmediyse sayfa, işlemin durumunu Tpay API'sinden sorar (en fazla 10 saniyede bir) ve aynı kontrolleri uygular. Ödeme onaylanana kadar sayfa 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: ifadesini ve Pay again bağlantısını gösterir. Tpay başarısız bir ödeme bildirdiğinde sayfa Tpay reports that the payment did not go through. You can try again: ifadesini aynı bağlantıyla gösterir. Ödeme Tpay sayfasında başarısız olursa Tpay müşteriyi aynı siparişin Pay for order sayfasına geri gönderir.

Her ödeme denemesinin kendi referansı vardır. Müşteri yeniden ödeme yaptığında, siparişin daha önce ödenmemiş Tpay işlemleri Tpay tarafında iptal edilir; önceki bir bağlantı üzerinden tamamlanmış bir ödeme yine kabul edilir. Ödenmemiş bir sipariş iptal edildiğinde, örneğin WooCommerce stok tutma zaman aşımı nedeniyle, aynı iptal işlemi yapılır.

Tpay ödemeyi başlatamazsa müşteri The Tpay payment could not be started. Please try again or choose another payment method. mesajını görür ve nedeni 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 PLN ile çalışır. Mağazada banka veya BLIK kodu seçimi yoktur (müşteri Tpay sayfasında seçer), kayıtlı kart, abonelik, mağazada Apple Pay veya Google Pay düğmesi ve taksit hesaplayıcısı yoktur.

Siparişler ve iadeler

Sipariş durumları

Pending payment: Tpay işlemi oluşturuldu ve ödeme henüz onaylanmadı. Sipariş notunda Tpay işlemi ve ortam gösterilir.

Processing: Tpay ödemeyi onayladı. Bu, ödeme sonrası WooCommerce'in standart durumudur (yalnızca sanal indirilebilir ürün içeren siparişler Tamamlandı olur). Notta ödemenin bildirimle mi yoksa durum kontrolüyle mi onaylandığı ve varsa fazla ödeme yazılır. İşlem kimliği Tpay işlem başlığıdır (TR-...).

On hold: bir ödeme geldi, ancak tutarı istenen tutardan veya sipariş toplamından farklıydı, yalnızca bir kısmı ödendi veya sipariş iptal edilmişti. Sipariş notu bunu açıklar. Ödemeyi Tpay panelinde kontrol edin ve siparişi tamamlayın veya iade edin.

Failed: Tpay ödemenin başarısız olduğunu bildirdi. Yalnızca ödeme bekleyen bir sipariş Başarısız olarak işaretlenir. Müşteri yeniden ödeme yapabilir.

Tpay, zaten ödenmiş veya iade edilmiş bir sipariş için başka bir ödeme bildirirse sipariş değişmez; bir not, gerekirse fazla ödemeyi Tpay panelinden iade etmenizi ister. Tpay'in bildirdiği bir itiraz (chargeback) bir not ekler.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Tpay düğmesine tıklayın (düğmede Title değeriniz görünür). Tpay üzerinden ödeme alınmış siparişler için tam ve kısmi iadeler desteklenir; ödenmemiş siparişlerde düğme gösterilmez. İade, siparişin ödendiği ortama (sandbox veya canlı) gönderilir, bu nedenle o ortamın anahtarları girilmiş 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 WooCommerce'e kaydedilmez. Başarılı bir iade, girdiğiniz nedenle birlikte sipariş notlarına eklenir (neden Tpay'e gönderilmez).

Tpay satıcı panelinde yapılan iadeler WooCommerce'e otomatik olarak eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarı ile çalışır. Lisans bloğu WooCommerce > Settings > Payments > Tpay sayfasının üstündedir. 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 aktif 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 düğmesini 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ın bir siteden kaldırılması alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Tpay, ö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, bir anahtar satın almadan önce eklentiyi kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder. Plugins 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.

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

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 (Merchant ID, Client ID, Client secret, Security code) girildiğini kontrol edin. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) PLN olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme yapıldı ama sipariş Pending payment durumunda kalıyor: Tpay bildirimi iletemedi veya bildirim reddedildi. Debug log seçeneğini açın ve WooCommerce > Status > Logs sayfasında wcp_tpay_payment kaynağına bakın. Yaygın nedenler, geçerli mod için yanlış güvenlik kodu veya Merchant ID, engellenmiş bildirim adresi (bakım modu, güvenlik duvarı, HTTP kimlik doğrulaması) veya JWS kontrolü için OpenSSL'si ya da giden HTTPS bağlantısı olmayan bir sunucudur. Sipariş alındı sayfası da müşteri geri döndüğünde durumu kontrol eder.

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

Notification answered FALSE - invalid JWS signature: imza doğrulanamadı; örneğin OpenSSL eksik olduğu için 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.

Sipariş On hold durumunda: sipariş notunu okuyun. Ödenen tutar siparişle eşleşmedi veya ödeme iptal edilmiş bir sipariş için geldi. Ödemeyi Tpay panelinde kontrol edin ve siparişi tamamlayın veya iade edin.

Müşteri The Tpay payment could not be started mesajını gördü: geçerli modun anahtarları yanlış veya Tpay isteği reddetti. Günlükte Tpay hatası görünür.

İade başarısız oluyor: mesaj anahtarların eksik olduğunu söylüyorsa, siparişin ödendiği ortamın anahtarlarını girin. Tpay iadeyi onaylamadıysa, tekrar denemeden önce işlemi Tpay satıcı panelinde kontrol 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 yuva 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 her zaman kaldırılır; önbelleğe alınmış Tpay erişim jetonları ve sertifikalar da öyle. Ağ geçidi ayarları ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, Tpay işlem verilerini ve işlem kimliklerini korur.

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