VibeFox Tap for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 – 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerine kurulmayı reddeder.

Mağaza para birimi: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR veya USD. Diğer para birimlerindeki sepetler için ödeme yöntemi ödeme adımında gizlenir.

Mağazanıza 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 panelinizden (goSell, API kimlik bilgileri) API anahtarlarına ihtiyacınız vardır. 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 açılır pencere için gerekir. 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 bir alan adında çalışır.

Kurulum

1. Yönetim panelinde Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın ya da daha sonra modül listesinde VibeFox Tap Payments modülünü bulup Configure düğmesine tıklayın.

3. VibeFox lisans anahtarınızı Configure sayfasının üstündeki lisans bloğundaki License key alanına girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. 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).

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Tap test kartlarıyla deneyin, ardından Test mode seçeneğini kapatın.

Kurulumda modül iki sipariş durumu oluşturur: Tap payment authorized ve Tap payment on hold. PrestaShop, yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için etkinleştirir. Bunu Payment > Preferences bölümünden sınırlandırabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Tap Payments > Configure. Her bölümün kendi Save düğmesi vardır; bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa Test mode is on: payments use your Tap test keys and no real money is charged. veya Live mode: real payments are accepted. mesajını gösterir. Ayrıca geçerli modun anahtarları eksikse (bu durumda ödeme yöntemi ödeme adımında gösterilmez) ve mağazanın varsayılan para birimi Tap ile sunulmuyorsa uyarır.

Kaydetme sırasında, alanı için yanlış önek taşıyan bir anahtar kaydedilmez: önceki değer korunur, diğer ayarlar kaydedilir ve Test secret key was not saved: a Tap key for this field starts with "sk_test_". gibi bir mesaj gösterilir. Örneğin test alanına girilen canlı anahtar reddedilir. Boş bir Title kabul edilmez: sayfa Enter a title for the payment method. mesajını gösterir ve hiçbir şey kaydedilmez.

Tap Payments

Bölüm başlığı, geçerli mod için TEST veya LIVE ibaresini de gösterir.

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

Title: ödeme adımında gösterilen ödeme yöntemi adı. Siparişte de ödeme yöntemi adı olarak kaydedilir. Varsayılan: Tap Payments. Zorunlu.

Description: ödeme adımı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 (goSell, API kimlik bilgileri) bulabilirsiniz. Test anahtarları pk_test_ / sk_test_ ile, canlı anahtarlar pk_live_ / sk_live_ ile başlar.

Test mode: test anahtarlarını kullanır; gerçek para tahsil edilmez. Ödemeler, durum sorguları, tahsilatlar ve iadeler her zaman ödemenin yapıldığı modun anahtarlarını kullanır; bu nedenle canlıya geçtikten sonra da bir test ödemesi test anahtarıyla sorgulanır ve iade edilir. Varsayılan: açık. Açıkken müşteriler ödeme yönteminin altında Test mode: no real payment will be made. ifadesini görür.

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 kimliğiniz; yalnızca Tap ödemeleri belirli bir merchant hesabına yönlendirmenizi istediyse gereklidir.

Kayıtlı gizli anahtarlar bir daha gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Yayınlanabilir anahtarlar herkese açıktır ve görünür kalır.

Clear saved secrets: bir gizli anahtarın kutusunu işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan, kayıtlı değeri korur.

Ödeme

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

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

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

Ödeme bildirimleri (webhook)

Tap, ödeme sonucunu bu bölümdeki Webhook URL altında gösterilen adrese gönderir. Dostça URL'lerle şöyle görünür: https://your-shop/module/wcp_tap_payment_gateway/webhook; başında /en/ gibi bir dil kodu bulunabilir. 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 (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemiş olmalı). Her bildirim hashstring imzasıyla (HMAC-SHA256, ödemenin yapıldığı modun gizli anahtarıyla) doğrulanır. Geçerli imzası olmayan webhook'lar reddedilir. İmzalı bir bildirim bile tek başına güvenilir sayılmaz: modül, siparişi oluşturmadan veya değiştirmeden önce ödemeyi Tap API'den yeniden okur. Çalışan bir webhook olmadan sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde oluşturulur.

Gelişmiş

Debug log: ödeme olaylarını modül klasöründeki logs/tap_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden okunamaz. Hatalar ve uyarılar her zaman kaydedilir; her ödeme olayını da kaydetmek için bu seçeneği açın. Günlük hiçbir zaman anahtar, kart veya müşteri verisi içermez. Varsayılan: kapalı.

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 modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişlerin ödeme kayıtları korunur. Varsayılan: kapalı.

Ödeme adımı

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Tap Payments) ve siparişi onaylar. Bu noktada henüz sipariş yoktur.

Tap payment page: modül, sepet tutarı için sepetin para biriminde bir Tap tahsilatı (veya Authorize only modunda bir yetkilendirme) oluşturur; açıklama olarak Cart # ve sepet numarası yazılır ve müşteri Tap ödeme sayfasına yönlendirilir. Müşterinin adı, e-posta adresi ve telefon numarası Tap'e iletilir. Orada müşteri bir kart, mada, KNET, Benefit, Apple Pay veya Google Pay seçer (Tap hesabınızda etkinleştirilmiş olanlardan) ve öder. Tap ödemeyi başlatamazsa müşteri ödeme adımında kalır ve The Tap payment could not be started. Please try again or choose another payment method. mesajını görür; nedeni günlüğe yazılır.

Tap checkout popup: müşteri modülün Tap payment sayfasına gider; burada Tap ödeme formu açılır. Sayfada ayrıca Pay on the Tap payment page instead bağlantısı bulunur. Pencere kapatılırsa Pay now düğmesi onu yeniden açar. Form yüklenemezse müşteriden Tap ödeme sayfasını kullanması istenir. Sayfayı yenilemek aynı ödeme denemesini yeniden kullanır.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Tap onayladığında ödenmiş olarak işaretlenir: modül, ödemeyi ödemenin modunun anahtarıyla Tap API'den okur, bunun bu sepete ait olduğunu ve sepetin ödeme adımından başlatıldığını doğrular, tutarı ve para birimini sepetle karşılaştırır. Dönüş adresindeki Tap kimliği tek başına asla sipariş oluşturmaz. Webhook aynı kontrolü arka planda yapar. Sipariş ardından oluşturulur ve müşteri standart sipariş onay sayfasını görür. Yetkilendirilmiş bir ödemede sayfa Your payment has been authorized. We will process the order as soon as the payment is captured. mesajını, beklemedeki bir sipariş için ise Your payment is being reviewed. We will contact you if anything else is needed. mesajını gösterir.

Müşteri döndüğünde Tap ödemeyi henüz onaylamamışsa Payment confirmation sayfası açılır ve 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ın yanında Check again ve Back to checkout düğmelerini gösterir. Webhook ulaşır ulaşmaz siparişi oluşturur.

Ödeme reddedilir, yarıda bırakılır veya iptal edilirse sipariş oluşturulmaz. Müşteri Your payment was not completed. Please try again or choose another payment method. mesajıyla ödeme adımına döner (Tap bir neden verdiğinde, Tap'in nedeniyle birlikte). Tamamlanmamış bir ödeme The payment was not completed. You can try again or choose another payment method. mesajını gösterir. Sepet korunur ve yeniden ödenebilir.

Ödeme adımındaki diğer mesajlar: sepet para birimi desteklenmediğinde para birimiyle birlikte Tap does not accept payments in ve The order total must be greater than zero to pay with Tap.

Webhook, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Modülde kayıtlı kart veya tokenizasyon, abonelik ve ödeme adımını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ı

Henüz sipariş yok: müşteri Tap'e yönlendirildi ve ödeme yapmadı ya da Tap henüz ödemeyi onaylamadı. Yalnızca sepet mevcut.

Payment accepted: Tap, tahsil edilmiş bir ödemeyi onayladı. Ödeme, Tap tahsilat kimliği (chg_...) ile işlem kimliği olarak kaydedilir; bir not tutarı, tahsilat kimliğini, ödeme yöntemini ve test modunda ödemenin test ödemesi olduğunu gösterir.

Tap payment authorized: ödeme yalnızca yetkilendirildi ve tahsilat ya da iptal bekliyor.

Tap payment on hold: ödenen tutar veya para birimi sepetten farklıydı (Tap: amount/currency mismatch — manual review required.) ya da bir ödeme, sipariş iptal edildikten sonra geldi. Not durumu açıklar. Siparişi kontrol edip işleme alın veya ödemeyi iade edin.

Canceled: yetkilendirme Void Tap authorization ile iptal edildi ve ayrılan tutar serbest bırakıldı.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Başarısız bir deneme, ödenmiş, yetkilendirilmiş veya iptal edilmiş bir siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse sipariş değişmez. Bir not, bunun mükerrer bir ödeme olduğunu belirtir ve Tap panelinden iade edilmesini ister. Sepetle ilgili olup ödeme adımından başlatılmamış bir ödeme yalnızca not edilir.

Tap ödeme bloğu

Sipariş sayfasında Tap kimliği, yetkilendirme ve tahsilat, mod (test ödemeleri için Test mode rozeti), ödeme durumu ve yöntemi, Charged / refunded, iade geçmişi, sepetin ödeme denemeleri ve siparişin Payment notes bölümünü içeren bir Tap payment bloğu görüntülenir. Bloğun düğmeleri doğrudan sipariş sayfasında çalışır; modül ayarlarına erişim değil, siparişleri düzenleme yetkisine ihtiyacınız vardır.

Tahsilat ve iptal

Authorize only modunda, siparişi Tap payment authorized durumunda açın. Capture Tap payment (düğmede sipariş toplamıyla) Capture the reserved funds of this order through Tap? sorusundan sonra sipariş toplamını tahsil eder; sipariş ardından Payment accepted olur. Void Tap authorization, Release the reserved funds? The order will be canceled. sorusunu sorar, tutarı serbest bırakır ve siparişi Canceled durumuna getirir. Tap işlemi reddederse blokta bir hata gösterilir ve notlara eklenir. Bir yetkilendirme doğrudan Tap panelinde tahsil edilirse webhook siparişi ödenmiş olarak işaretler; bu ödemenin iadeleri Tap panelinde yapılmalıdır.

İadeler

Tap payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Tap düğmesine tıklayın. Refund this amount through Tap? This cannot be undone. sorusunu onaylayın. Tahsil edilmiş Tap ödemeleri için tam ve kısmi iadeler desteklenir. Sipariş daha sonra düzenlenmiş olsa bile Tap'in gerçekte tahsil ettiği tutar ve para birimine kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modun gizli anahtarıyla gönderilir; bu nedenle o modun anahtarı girilmiş olmalıdır. Tap tarafından kabul edilen bir iade, Tap iade kimliği ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tap reddederse blok hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna getirir; kısmi iade durumu değiştirmez. Yetkilendirilmiş bir sipariş için iadeler, yetkilendirme tahsil edildikten sonra kullanılabilir. Tutar veya para birimi uyuşmazlığından sonra beklemeye alınan bir sipariş Tap panelinden iade edilir.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri Tap üzerinden para geri göndermez. Tap panelinde yapılan iadeler PrestaShop'ta görünmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Tap Payments lisans bloğu, Modules > Module Manager > VibeFox Tap Payments > Configure 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 geçerli olduğu son tarihi ve alan adınızı) ve şu düğmeleri gösterir: 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. Bunların altında Product: presta-payment-tap satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini söyler; ö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 veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa modül son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Tap Payments ö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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce kurabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır; iade, tahsilat ve iptal çalışmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, back office'te çalışırken otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Tap Payments ö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 bir gizli anahtarı (ve Checkout type açılır pencere ise bir yayınlanabilir anahtarı) olduğunu kontrol edin. Sepet para biriminin AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD değerlerinden biri olduğunu doğrulayın. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu kontrol edin. Ayarlar sayfası, eksik anahtarlar ve desteklenmeyen mağaza para birimi için uyarı gösterir.

Ödeme yapıldı ama sipariş oluşturulmadı: webhook mağazanıza ulaşamıyor. Webhook URL altında gösterilen adresin internetten erişilebilir olduğunu (güvenlik duvarı veya HTTP kimlik doğrulaması olmadan) kontrol edin ve yanıtları Log alanında görmek için Debug log seçeneğini açın. Müşteri Tap'ten döndüğünde de sipariş oluşturulur.

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ş. Girin.

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

Webhook answers order not found: bildirim, bu mağazada hiçbir Tap ödeme denemesi olmayan bir sepeti belirtiyor.

Webhook answers busy, retry later or order could not be updated, retry later: sipariş, aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışıysa). Tap webhook'u yeniden dener. Nedeni Log alanında görün.

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

Müşteri The Tap payment could not be started mesajını görüyor: modül sayfasındaki Log alanına bakın. Yanlış bir anahtar veya reddedilen bir istek orada kayıtlıdır.

Müşteri We could not match this payment to an order mesajını görüyor: ödeme bu sepete ait değil veya sepetin ödeme adımından başlatılmadı. Para tahsil edildiyse ödemeyi Tap panelinde kontrol edin.

Sipariş Tap payment on hold durumunda: Tap payment bloğundaki notları okuyun. Ödenen tutar veya para birimi sepetle eşleşmedi ya da ödeme, sipariş iptal edildikten sonra geldi.

İade, mod hakkında bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve bu mod için bir gizli anahtar yapılandırılmamış. Anahtarı girin ve yeniden deneyin. Blok tahsil edilmiş bir Tap tahsilatının bulunamadığını söylüyorsa ödemeyi Tap panelinden iade edin.

Geliştirici kancaları: actionWcpTapChargePayload, actionWcpTapSupportedCurrencies ve actionWcpTapCurrencyDecimals kancaları, bir geliştiricinin ödeme isteğini, desteklenen para birimlerini ve para birimlerinin ondalık basamaklarını değiştirmesine izin verir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Tap Payments yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman kaldırılır. Delete data on uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Tap ödeme denemeleri ve iadeleri ile Tap payment authorized ve Tap payment on hold sipariş durumları her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler, ödeme notlarını ve işlem kimliklerini korur.

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