VibeFox Tap for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

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

PHP: 8.0 veya üzeri.

Mağaza para birimi: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR veya USD. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Sitenize internet erişimi: Tap, ödeme sonucunu mağazanızdaki bir webhook'a gönderir; bu nedenle sitenin internetten erişilebilir olması gerekir. Webhook URL'si her ödemeyle birlikte gönderilir; Tap panelinde herhangi bir ayar yapmanız gerekmez.

Tap hesabı: Tap panelinizdeki API anahtarlarına ihtiyacınız vardır (goSell, API kimlik bilgileri). Test anahtarları pk_test_ / sk_test_ ile, canlı anahtarlar pk_live_ / sk_live_ ile başlar. Gizli anahtar her zaman gereklidir; yayınlanabilir anahtar yalnızca Tap Checkout açılır penceresi için gereklidir. Sunulan ödeme yöntemleri (mada, KNET, Benefit ve diğerleri) ve Apple Pay alan adı doğrulaması Tap hesabınızda ayarlanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar yalnızca 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_tap_payment_gateway 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 > Tap Payments > 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. Tap test ve canlı anahtarlarınızı girin; ödeme işlemini, ödeme türünü ve Tap sayfasının dilini seçin (bkz. Yapılandırma).

6. Enable / Disable seçeneğini açın ve kaydedin. Tap test kartlarıyla deneme yapın, ardından Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfada yer alır: WooCommerce > Settings > Payments > Tap Payments. Alanların üstünde sayfa, test modu açıkken Test mode is on: payments use your Tap test keys and no real money is charged. uyarısını gösterir. Ayrıca geçerli mod için anahtarlar eksik olduğunda (bu durumda ağ geçidi ödeme sayfasında gösterilmez) ve mağaza para biriminin Tap tarafından desteklenmediği durumlarda bilgi verir. Ödeme yöntemleri listesinde Tap Payments, geçerli modda gizli anahtar (ve açılır pencere için yayınlanabilir anahtar) bulunana kadar kurulum gerektiren olarak işaretlenir.

Kaydetme sırasında alanına uygun olmayan öneke sahip bir anahtar kaydedilmez: bir hata gösterilir ve önceki değer korunur. Örneğin, test alanına girilen canlı anahtar reddedilir.

Genel

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

Title: ödeme sayfasında gösterilen ödeme yönteminin adı. Varsayılan: Tap Payments.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Tap API anahtarları

Anahtarlarınızı Tap panelinde bulun (goSell, API kimlik bilgileri). Test anahtarları pk_test_ / sk_test_ ile, canlı anahtarlar pk_live_ / sk_live_ ile başlar.

Test mode: Use the test keys (no real money is charged). Ödemeler, durum sorguları ve iadeler her zaman ödemenin yapıldığı modun anahtarlarını kullanır; bu nedenle bir test ödemesi, canlıya geçtikten sonra da test anahtarıyla sorgulanır ve iade edilir. Varsayılan: açık.

Test publishable key: pk_test_ ile başlar. Açılır pencere için gereklidir.

Test secret key: sk_test_ ile başlar.

Live publishable key: pk_live_ ile başlar. Açılır pencere için gereklidir.

Live secret key: sk_live_ ile başlar.

Merchant ID: isteğe bağlı. Tap merchant ID'niz; yalnızca Tap ödemeleri belirli bir satıcı hesabına yönlendirmenizi istediyse gerekir.

Ödeme

Payment action: müşteri ödeme yaptığında paranın ne olacağı.

Checkout type: müşterinin ödeme yaptığı yer.

Tap page language: English (varsayılan) veya Arabic.

Ödeme bildirimleri (webhook)

Tap, ödeme sonucunu bu bölümde gösterilen URL'ye gönderir. URL şu biçimdedir: https://your-site/wc-api/tap_p_webhook/. URL her ödemeyle birlikte gönderildiği için Tap panelinde bir şey yapılandırmanız gerekmez. Yalnızca internetten erişilebilir olduğundan emin olun (bir güvenlik duvarı, bakım modu veya HTTP kimlik doğrulaması tarafından engellenmemeli). Her bildirim, hashstring imzası ile doğrulanır (HMAC-SHA256, ödemenin modunun gizli anahtarıyla). Geçerli imzası olmayan webhook'lar reddedilir. İmzalı bir bildirim bile kendiliğinden güvenilir sayılmaz: eklenti, siparişi değiştirmeden önce ödemeyi Tap API'den yeniden okur. Çalışan bir webhook olmadan sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde güncellenir.

Gelişmiş

Debug log: Log payment events (WooCommerce → Status → Logs, source "wcp_tap_payment_gateway"). Hatalar her zaman kaydedilir. Günlük hiçbir zaman anahtarları, kart veya müşteri verilerini içermez. Varsayılan: kapalı.

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

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Tap Payments) ve siparişi verir. Test modunda ödeme sayfası Test mode: no real payment will be made. mesajını gösterir.

Tap payment page: eklenti, sipariş para biriminde sipariş toplamı için bir Tap tahsilatı (veya Authorize only modunda bir yetkilendirme) oluşturur; açıklama olarak Order # ve sipariş numarasını kullanır ve müşteriyi Tap ödeme sayfasına yönlendirir. Orada müşteri bir kart, mada, KNET, Benefit, Apple Pay veya Google Pay seçer (Tap hesabınızda etkinleştirilenlere göre) ve öder. Tap ödemeyi başlatamazsa müşteri The Tap payment could not be started. Please try again or choose another payment method. mesajını görür ve nedeni sipariş notlarına eklenir.

Tap checkout popup: müşteri, Tap ödeme formunun açıldığı sipariş ödeme sayfasına gider. Sayfa ayrıca Pay on the Tap payment page instead bağlantısını gösterir. Pencere kapatılırsa Pay now düğmesi onu yeniden açar. Form yüklenemezse müşteriden Tap ödeme sayfasını kullanması istenir.

Ödemeden sonra müşteri, siparişin alındığı sayfaya döner. Sipariş, yalnızca Tap onayladıktan sonra ödenmiş olarak işaretlenir: eklenti ödemeyi, ödemenin modunun anahtarıyla Tap API'den okur; ödemenin bu siparişe ait olduğunu ve siparişin ödeme sürecinden başlatıldığını doğrular; tutar ve para birimini siparişle karşılaştırır. Dönüş adresindeki Tap kimliği tek başına bir siparişi asla ödenmiş olarak işaretlemez. Webhook, aynı kontrolü arka planda yapar. Tekrarlanan webhook'lar ve dönüşler bir siparişi asla iki kez değiştirmez (sipariş başına aynı anda yalnızca bir değişiklik).

Ödeme henüz onaylanmadıysa, siparişin alındığı sayfa We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. mesajını gösterir. Yetkilendirilmiş bir ödeme için Your payment has been authorized. We will process the order as soon as the payment is captured. gösterilir.

Ödeme reddedilmiş veya yarıda bırakılmışsa sipariş Başarısız olarak işaretlenir ve müşteri, Your payment was not completed. Please try again or choose another payment method. mesajıyla (Tap bir neden verdiğinde bu nedenle birlikte) Pay for order sayfasına döner. Tamamlanmamış bir ödeme The payment was not completed. You can try again below. mesajını gösterir. Müşteri bu sayfadan siparişi yeniden ödeyebilir.

Ödeme yöntemi klasik ödeme sayfasında, Checkout bloğunda ve Pay for order sayfasında çalışır. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Eklentinin kayıtlı kartı veya tokenizasyonu, aboneliği ve ödeme sayfanıza gömülü kart alanı yoktur. Capture Tap payment her zaman sipariş toplamını tahsil eder; kısmi tahsilat desteklenmez.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Tap'e yönlendirildi ve henüz ödeme yapmadı ya da Tap henüz ödemeyi onaylamadı.

Processing: Tap, tahsil edilmiş bir ödemeyi onayladı. Ödeme sonrası standart WooCommerce durumudur (yalnızca sanal indirilebilir ürün içeren siparişler doğrudan Tamamlandı olur). Sipariş notunda tutar, Tap tahsilat kimliği (chg_...), ödeme yöntemi ve (test modunda) ödemenin test ödemesi olduğu bilgisi gösterilir. İşlem kimliği, Tap tahsilat kimliğidir.

On hold: ödeme yalnızca yetkilendirildi ve tahsilat bekliyor; ya da ödenen tutar veya para birimi siparişle eşleşmedi (Tap: amount/currency mismatch — manual review required.); ya da sipariş iptal edildikten sonra bir ödeme geldi. Sipariş notu nedenini açıklar.

Failed: ödeme reddedildi, yarıda bırakıldı, iptal edildi veya zaman aşımına uğradı. Yalnızca hâlâ ödeme bekleyen bir sipariş Başarısız olarak işaretlenir; başarısız bir deneme, ödenmiş, yetkilendirilmiş veya iptal edilmiş bir siparişi asla değiştirmez. Müşteri yeniden ödeme yapabilir.

Cancelled: yetkilendirme Void Tap authorization ile iptal edildi; böylece ayrılmış tutar serbest bırakıldı.

Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse sipariş yeniden değiştirilmez. Bir notta bunun mükerrer ödeme olduğu belirtilir ve Tap panelinde iade edilmesi istenir. Siparişle ilgili olup ödeme sürecinden başlatılmamış bir ödeme yalnızca not edilir.

Tahsilat ve iptal

Authorize only modunda, beklemedeki siparişi açın ve Order actions bölümünden seçin: Capture Tap payment sipariş toplamını tahsil eder; sipariş bundan sonra ödenmiş olur. Void Tap authorization tutarı serbest bırakır ve siparişi iptal eder. Tap işlemi reddederse bir hata gösterilir ve sipariş notlarına eklenir. Bir yetkilendirme doğrudan Tap panelinde tahsil edilirse webhook siparişi ödenmiş olarak işaretler; bu tür bir ödemenin iadeleri Tap panelinde yapılmalıdır.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Tap Payments düğmesine tıklayın (düğme Title alanınızı gösterir). Tahsil edilmiş Tap ödemeleri için tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modun gizli anahtarıyla gönderilir; bu nedenle o modun anahtarı ayarlanmış olmalıdır. Tap'in kabul ettiği bir iade, Tap iade kimliği ve durumuyla birlikte sipariş notlarına eklenir. Tap reddederse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Tap panelinde yapılan iadeler WooCommerce'de görünmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Tap Payments 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 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 yalnızca bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o alan adının yerini serbest bırakmaz. Alan adı yerini vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Tap Payments, ö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. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder; iadeler, tahsilat ve iptal ç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

Tap Payments ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu ve geçerli modda gizli anahtar bulunduğunu kontrol edin (Checkout type açılır pencere ise yayınlanabilir anahtar da gerekir). Mağaza para biriminin (veya Pay for order sayfasındaki sipariş para biriminin) AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD değerlerinden biri olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir.

Ödeme gerçekleşti ama sipariş hâlâ Pending payment durumunda: webhook sitenize ulaşamıyor. Ayarlarda gösterilen URL'nin (/wc-api/tap_p_webhook/) internetten erişilebilir olduğunu kontrol edin (güvenlik duvarı, bakım modu veya HTTP kimlik doğrulaması olmamalı) ve WooCommerce > Status > Logs bölümünde wcp_tap_payment_gateway kaynağına bakın. Müşteri Tap'ten döndüğünde sipariş de güncellenir.

Webhook answers invalid signature: bildirim, ödemenin modunun gizli anahtarıyla imzalanmamış. Ayarlardaki gizli anahtarları kontrol edin.

Webhook answers gateway not configured: ödemenin modunun (test veya canlı) gizli anahtarı boş. Bu anahtarı girin.

Webhook answers verification failed: ödemeyi doğrulamak için Tap API'sine ulaşılamadı. Tap webhook'u daha sonra yeniden dener.

Bir anahtar kaydedilmiyor: anahtar, bulunduğu alanın önekiyle başlamalıdır: pk_test_, sk_test_, pk_live_ veya sk_live_.

Sipariş On hold durumunda: sipariş notunu okuyun. Ödeme yalnızca yetkilendirildi (sipariş işlemlerinden tahsil edin), ödenen tutar veya para birimi siparişle eşleşmedi ya da ödeme sipariş iptal edildikten sonra geldi.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o mod için gizli anahtar ayarlanmamış. Anahtarı girin ve yeniden deneyin. Not, tahsil edilmiş bir Tap tahsilatı bulunamadığını söylüyorsa, ödemeyi Tap panelinde iade edin.

Geliştirici kancaları: tap_p_supported_currencies, tap_p_currency_decimals, tap_p_charge_payload, tap_p_icon, tap_p_checkout_sdk_url ve tap_p_payment_page_hosts filtreleri kullanılabilir.

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 yer açı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. Tamamen kaldırmak için devre dışı bırakın ve Plugins sayfasında silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, eklentinin diğer seçenekleri ve günlükler yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde, eklentinin yeniden kurulması için saklanır. Mevcut siparişler ödeme notlarını, Tap kimliklerini ve işlem kimliklerini korur.

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