VibeFox Tap 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 sonrası (4.1.0.3 sürümünde test edilmiştir).

PHP: 8.0 veya üzeri.

Sipariş para birimi: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR veya USD. Diğer para birimlerindeki siparişlerde ödeme yöntemi ödeme sayfasında gösterilmez.

Mağazanıza internet erişimi: Tap, ödeme sonucunu mağazanızdaki bir webhook'a gönderir; bu nedenle sitenizin 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 ise pk_live_ / sk_live_ ile başlar. Gizli anahtar her zaman gereklidir; yayınlanabilir anahtar yalnızca ödeme sayfası açılır penceresi (popup) için gereklidir. Sunulacak ödeme yöntemleri (mada, KNET, Benefit ve diğerleri) ile 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 tek bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart 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_tap_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_tap_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı her 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_tap_payment_gateway-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 Tap Payments 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. 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 deneme yapın, ardından 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_tap_payment_gateway.ocmod.zip dosyasını seçin. Dosyayı yeniden adlandırmayın: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş bir paket çalışmaz.

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

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

4. Lisans anahtarını, Tap anahtarlarını ve ödeme seçeneklerini OpenCart 3 için 3 ila 5. adımlardaki gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

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 Tap Payments > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarları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ı eksik olduğunda (bu durumda ödeme yöntemi ödeme sayfasında gösterilmez) ve mağazanın varsayılan para birimi Tap ile sunulmadığında 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. Alanına uygun olmayan bir önek taşıyan 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.

Tap Payments

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Tap Payments. 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 Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order: Tap'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: Tap'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: Tap sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Her tutar için Tap sunmak üzere boş bırakın.

Tap API anahtarları

Anahtarlarınızı Tap panelinde (goSell, API kimlik bilgileri) bulabilirsiniz. Bu bölüm Tap geliştirici belgelerine bağlantı verir.

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 bile bir test ödemesi test anahtarıyla sorgulanır ve iade edilir. Varsayılan: açık. Açıkken müşteriler Confirm Order adımında ve açılır ödeme sayfasında Test mode: no real payment will be made. mesajını 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 satıcı kimliğiniz; yalnızca Tap ödemeleri belirli bir satıcı 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. gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir anahtarı silmek için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın. Yayınlanabilir anahtarlar herkese açıktır ve görünür kalır.

Ödeme

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

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

Tap page language: Tap ödeme sayfasının ve açılır pencerenin dili: English (varsayılan) veya Arabic.

Ödeme bildirimleri (webhook)

Tap, ödeme sonucunu bu bölümdeki Webhook URL alanında gösterilen adrese gönderir. OpenCart 3'te adres https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook biçimindedir, OpenCart 4'te https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook biçimindedir ve OpenCart kurulumunuzun mağaza adresinden oluşturulur. URL her ödemeyle birlikte gönderildiğinden Tap panelinde bir şey ayarlamanız gerekmez. Yalnızca internetten erişilebilir olduğundan emin olun (güvenlik duvarı veya HTTP kimlik doğrulaması tarafından engellenmemeli); bakım modu bunu engellemez (OpenCart 4'te eklentinin bir başlangıç eylemi, webhook'un ve müşterinin dönüşünün geçmesine izin verir). Her bildirim hashstring imzasıyla doğrulanır (ödemenin yapıldığı modun gizli anahtarıyla HMAC-SHA256). Geçerli imzası olmayan webhook'lar reddedilir. İmzalı bir bildirim bile tek başına güvenilir sayılmaz: eklenti, siparişi değiştirmeden önce ödemeyi Tap API'sinden yeniden okur. Çalışan bir webhook yoksa sipariş, müşteri ödemeden sonra mağazaya döndüğünde durum alır.

Siparişler

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

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

Authorized Status: Authorize only: tutar ayrılmıştır, henüz tahsil edilmemiştir. Varsayılan: Beklemede.

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.

Voided Status: Void Tap authorization ayrılmış tutarı serbest bıraktıktan sonra ayarlanı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ı OpenCart günlük klasöründe (storage/logs, OpenCart 4'te system/storage/logs) tap_p_debug.log.php dosyasına yazar. Dosya web üzerinden okunamaz ve 5 MB'a ulaştığında tap_p_debug.old.log.php dosyasına taşınır. Hatalar ve uyarılar her zaman günlüğe yazılır; her ödeme olayını da günlüğe yazmak için bunu 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 eklentinin kaldırılması ağ geçidi ayarlarını ve günlüğü siler. Siparişlerin ödeme kayıtları her zaman korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar 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ı gizli anahtarlar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Tap Payments). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Ardından müşteri Confirm Order düğmesine tıklar. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar.

Tap payment page: eklenti, sipariş tutarı için sipariş para biriminde 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. 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 Confirm Order 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; neden günlüğe yazılır.

Tap checkout popup: müşteri eklentinin 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 ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, ödemeyi ödeme modunun anahtarıyla Tap API'sinden yeniden 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 siparişi asla değiştirmez. Webhook aynı kontrolü arka planda yapar. Sipariş, ardından olağan OpenCart yöntemiyle, standart sipariş e-postaları ve stok güncellemesiyle durum alır; müşteri OpenCart sipariş başarılı sayfasını görür. OpenCart 4'te müşteri Tap ödeme sayfasından döndüğünde, kısa bir ara sayfa dönüş adresini mağazanızdan yeniden açar; böylece sepet ve müşteri girişi korunur. Yetkilendirilmiş bir ödeme için sayfa ayrıca Your payment has been authorized. We will process the order as soon as the payment is captured. mesajını gösterir. İncelemedeki bir ödeme için 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ı 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ı ve Check again ile Back to checkout düğmelerini gösterir. Webhook ulaşır ulaşmaz sipariş durumunu ayarlar.

Ödeme reddedilir, terk edilir veya iptal edilirse sipariş durumsuz kalır. Müşteri Your payment was not completed. Please try again or choose another payment method. mesajıyla (Tap bir neden verirse onunla birlikte) ödeme sayfasına döner. 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. 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 sürecinin siparişini günceller. Aynı sepetin başka bir siparişi zaten ödenmişse, müşteri yeniden ödeme yapmak yerine doğrudan başarı sayfasına gider. Yeni bir ödeme başlatılmadan önce, siparişin ve sepetin son 24 saatteki açık Tap ödeme sayfaları Tap'te kontrol edilir; böylece başka bir sekmede yapılan bir ödeme çift tahsil edilmek yerine onaylanır. Sepetteki bir değişiklik, yeni miktar dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarılı sayfası gösterilene kadar siparişi ödeme sürecinde tutar. Reddedilen veya iptal edilen bir ödemeden sonra bir sonraki Confirm Order işlemi aynı sipariş için yeni bir Tap ödemesi başlatır. Bu sipariş bu arada ödeme olmadan kapatılmışsa (örneğin siz iptal ettiyseniz ya da yetkilendirmesi iptal edildiyse), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder.

Ödeme sayfasındaki diğer mesajlar: sipariş para birimi desteklenmediğinde Tap does not accept payments in ve ardından para birimi; ve The order total must be greater than zero to pay with Tap.

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

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Tap'e yönlendirildi ve ödeme yapmadı ya da Tap henüz ödemeyi onaylamadı. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir. OpenCart 4.1'de böyle bir sipariş, onay adımı yeniden gösterildiğinde OpenCart'ın atadığı Voided durumunda da olabilir; eklenti bunu durumsuz bir sipariş sayar.

Paid Order Status (default Processing): Tap tahsil edilmiş bir ödemeyi onayladı. Bir not tutarı, Tap tahsilat kimliğini (chg_...), ödeme yöntemini ve (test modunda) test ödemeleri için bu bilgiyi gösterir.

Authorized Status (default Pending): ödeme yalnızca yetkilendirildi ve tahsilat veya iptal bekliyor.

On Hold (Review) Status (default Pending): ö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. Not bunu açıklar. Siparişi kontrol edip tamamlayın veya ödemeyi iade edin.

Voided Status (default Canceled): yetkilendirme Void Tap authorization ile iptal edildi ve ayrılmış tutar serbest bırakıldı.

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

Başarısız bir deneme, zaten bir durumu olan siparişi asla değiştirmez. Zaten ödenmiş bir sipariş için ikinci bir başarılı ödeme gelirse sipariş değiştirilmez. Bir not, bunun mükerrer bir ödeme olduğunu belirtir ve Tap 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. Siparişe ait olan ama ödeme sayfasından başlatılmayan bir ödeme yalnızca not edilir.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır. "Tap" ile başlarlar.

VibeFox Tap Payments sekmesi

Sales > Orders sayfasında Tap ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Tap Payments sekmesi Tap ID, Authorization ve Charge bilgilerini, Mode alanını (test ödemeleri için Test etiketi), ödemenin Status bilgisini ve yöntemini, Charged / refunded bilgisini, iade formunu, iade geçmişini, siparişin Payment attempts kayıtlarını ve Tap notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir; tahsilat, iptal ve iadeler için eklentiyi değiştirme yetkisi gerekir (System > Users > User Groups bölümünde ayarlanır).

Tahsilat ve iptal

Authorize only modunda yetkilendirilmiş siparişi açın. Capture Tap payment (düğmede sipariş toplamıyla birlikte) Capture the reserved funds of this order through Tap? sorusundan sonra sipariş toplamını tahsil eder; sipariş ardından Paid Order Status alır. Void Tap authorization Release the reserved funds? The order will be canceled. sorusunu sorar, tutarı serbest bırakır ve Voided Status ayarlar. 2 dakika içinde ikinci bir tahsilat tıklaması engellenir. Tap işlemi reddederse sekmede bir hata gösterilir ve notlara eklenir. Bu durum değişiklikleri müşteriye bildirilmeden ve elle durum değişikliği gibi stok değiştirilmeden yapılır. 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

Sekmede Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) 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 tahsilatları için tam ve kısmi iadeler desteklenir. Sipariş daha sonra düzenlenmiş olsa bile, Tap'in gerçekten tahsil ettiği tutara ve para birimine kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modun gizli anahtarıyla gönderilir; bu nedenle o anahtarın ayarlanmış olması gerekir. Tap'in kabul ettiği bir iade, Tap iade kimliği ve durumuyla birlikte iade geçmişine ve notlara eklenir. Tap reddederse sekme hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade, müşteriye bildirilmeden ve ürünleri stoğa geri eklemeden Refunded Status değerini ayarlar; kısmi iade ise durumu değiştirmez. Yetkilendirilmiş bir sipariş için iadeler, yetkilendirme tahsil edildikten sonra kullanılabilir. Tutar veya para birimi uyuşmazlığından sonra incelemede olan bir sipariş Tap panelinde iade edilir.

Sales > Returns sayfasındaki ürün iadeleri Tap üzerinden para geri göndermez. Tap panelinde yapılan iadeler OpenCart'ta görünmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Tap Payments lisans bloğu, Extensions > Extensions > Payments > VibeFox Tap Payments > 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-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 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 Tap Payments 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 girişini görmez, bu nedenle etkin anahtar olmadan ödeme yöntemi herkes için 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, tahsilat ve iptal ç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

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 modun bir gizli anahtarının (ve Checkout type açılır pencere olduğunda bir yayınlanabilir anahtarın) bulunduğunu kontrol edin. Sipariş para biriminin AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD değerlerinden biri olduğunu, ö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 desteklenmeyen mağaza para birimi için uyarı gösterir.

Ödeme geçti ama sipariş durumsuz kaldı: webhook mağazanıza ulaşamıyor. Webhook URL alanı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 sipariş de durum alır.

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

Webhook answers gateway not configured: ödeme 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 siparişi 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ş durumu ayarlanamadı. 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: eklenti sayfasındaki Log alanına bakın. Yanlış bir anahtar veya reddedilen bir istek orada kaydedilir.

Müşteri This payment method is not available mesajını görüyor: ö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örüyor: ödeme bu siparişe ait değil veya siparişin ödeme sürecinden başlatılmadı. Para çekildiyse ödemeyi Tap panelinde kontrol edin.

Sipariş inceleme durumunda: VibeFox Tap Payments sekmesindeki notları okuyun. Ö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 bir gizli anahtar ayarlanmadı. Anahtarı girin ve yeniden deneyin. Sekme yakalanmış bir Tap tahsilatı bulunamadığını söylüyorsa ödemeyi Tap panelinde iade edin.

Geliştiriciler için: OpenCart olayları tap_p_charge_payload, tap_p_supported_currencies ve tap_p_currency_decimals ödeme isteğini, desteklenen para birimlerini ve para birimi ondalık basamaklarını değiştirmenize olanak tanır.

Kaldırma

Extensions > Extensions sayfasına gidin, tür olarak Payments seçin ve VibeFox Tap Payments 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ı da kaldırılır (OpenCart 4'te ayrıca olayları ve webhook'un ile müşterinin bakım modunda dönüşüne izin veren başlangıç eylemi de kaldırılır). Delete data on uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, anahtarlar, ödeme seçenekleri, hata ayıklama günlüğü anahtarı) ve günlük silinir. Kapalıysa daha sonraki bir yeniden kurulum için saklanırlar. Tap ödeme denemeleri 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 Tap Payments yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi silmek için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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.