VibeFox Square for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Para birimi: sipariş para birimi, Square konumunuzun para birimi olmalıdır: USD, CAD, AUD, JPY, GBP veya EUR. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir. JPY, tam yen olarak tahsil edilir.

Square hesabı: Square Developer Dashboard'da bir uygulamanız olmalıdır. Bu panelden Application ID ve Access Token (Credentials sayfası) ile Location ID (Locations sayfası) değerlerini kopyalarsınız. Sandbox ve Production için değerler ayrıdır. Webhook gerekmez: eklenti ödeme sonucunu doğrudan Square'in yanıtından alır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_square_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_square_gateway.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önetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_square_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden 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ü Payments olarak seçin. VibeFox Square Gateway eklentisini bulun ve Install düğmesine (yeşil +) 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 düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda bulunan License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

4. Sandbox Mode seçeneğini açık tutun ve sandbox Application ID, Access Token ve Location ID bilgilerini girin (bkz. Yapılandırma). Save düğmesine tıklayın: eklenti kimlik bilgilerini Square ile doğrular.

5. Enable/Disable seçeneğini açın, kaydedin ve Square'in sandbox test kılavuzundaki test kartlarıyla bir ödeme deneyin. Ardından Sandbox Mode seçeneğini kapatın, canlı (production) kimlik bilgilerini girin ve yeniden kaydedin.

OpenCart 4

1. Yönetici panelinde Extensions > Installer sayfasına gidin, Upload düğmesine tıklayın ve wcp_square_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve adı değiştirilmiş paket ç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 Square Gateway eklentisini bulun, Install düğmesine (yeşil +) ve ardından Edit düğmesine (kalem simgesi) tıklayın.

4. Lisans anahtarını ve Square kimlik bilgilerini OpenCart 3 için 3-5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır.

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 Square Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde, sandbox modu açıkken sayfa Square Gateway şu anda SANDBOX modunda. Gerçek ödeme alınmayacak. uyarısını gösterir. Square etkinken seçili modun Application ID, Access Token veya Location ID bilgisi eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir), Square mağazanızın varsayılan para birimini işleyemiyorsa ve Square konumunuzun para birimi bundan farklıysa sayfa sizi uyarır. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), 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 bölge (geo zone) ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Ardından eklenti seçili modun kimlik bilgilerini Square ile doğrular. Ayarlar her durumda kaydedilir ve uyarılar ayarların üstünde kırmızı bir blokta görünür: Square Access Token'ı reddetti, bu token için Location ID bulunamadı, kimlik bilgileri doğrulanamadı veya konumun para birimi mağaza para biriminden farklı. Square yalnızca konum para biriminde tahsilat yapabilir: eklenti doğrulanan konumun para birimini saklar ve başka bir para birimindeki siparişler için ödeme yöntemini gizler. Ayrıca sandbox Application ID'nin canlı modda, ya da tersinin kullanıldığını da uyarır.

Square

Enable/Disable: Enable Square Payment Gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit / debit card. Zorunlu.

Description: müşterinin Confirm Order adımında, kart formunun üstünde gördüğü metin. Varsayılan: Pay securely with your credit or debit card via Square.

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

Geo Zone: kart formunu yalnızca seçili bölgedeki ödeme adresleri için gösterin. Varsayılan: All zones. Bölgeler System > Localisation > Geo Zones altında tanımlanır.

Total: ödeme yönteminin sunulması için siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme sayfası tutarı. Her tutar için sunmak üzere boş bırakın.

Square hesabı

Square Developer Dashboard sayfasını açın (bölümde bağlantısı vardır), uygulamanızı seçin ve Credentials sayfasından Application ID ile Access token değerlerini (Sandbox ve Production için değerler ayrıdır), Locations sayfasından da Location ID değerini kopyalayın. Konumun para birimi, mağazanızın para birimiyle aynı olmalıdır. Sayfa yalnızca seçili modun kimlik bilgisi alanlarını gösterir: Sandbox Mode açıkken sandbox alanlarını, kapalıyken canlı alanları. İki kümenin de değerleri kayıtlı kalır.

Sandbox Mode: ödemeler Square sandbox'ına gider ve gerçek para tahsil edilmez. Square test kartlarını kullanın. Varsayılan: açık. Bir siparişin iadeleri her zaman siparişin ödendiği ortamı ve konumu kullanır.

Sandbox Application ID: sandbox Square Application ID'niz (sandbox-sq0idb- ile başlar).

Sandbox Access Token: sandbox Square Access Token'ınız.

Sandbox Location ID: sandbox Square Location ID'niz.

Live Application ID: canlı Square Application ID'niz (sq0idp- ile başlar).

Live Access Token: canlı Square Access Token'ınız.

Live Location ID: canlı Square Location ID'niz.

Kayıtlı Access Token'lar bir daha gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir Access Token'ı silmek için alanın altındaki Clear the saved value on save kutusunu işaretleyin ve Save düğmesine tıklayın.

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik sipariş) olarak oluşturur. Sipariş, Square ödemeye yanıt verdikten sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: Square, ödemeyi tam sipariş tutarı ve para birimi için tamamladı. Varsayılan: Processing.

On Hold (Review) Status: ödemenin sizin incelemenizi gerektirdiği durum (bkz. Sipariş durumları). Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses altında kendi durumunuzu oluşturup burada seçebilirsiniz.

Refunded Status: ödeme, sipariş sekmesinden tamamen iade edildikten sonra ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: hatalar ve uyarılar her zaman kaydedilir. Açıldığında her istek ve yanıt da, kart verisi veya anahtar olmadan, OpenCart günlük klasöründeki (storage/logs) wc_sqg_debug.log.php dosyasına yazılır. Dosya web üzerinden açılamaz ve 5 MB olduğunda wc_sqg_debug.old.log.php adına taşınır. 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, eklentiyi kaldırdığınızda ağ geçidi ayarları ve günlük dosyaları silinir. Siparişlerin Square ödemeleri ve iadeleri her zaman korunur. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Access Token'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ı Access Token'lar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit / debit card). Confirm Order adımında müşteri Credit / debit card (Square) seçeneğini, açıklamanızı, sandbox modu açıkken SANDBOX MODU — gerçek ödeme alınmayacak. notunu ve Square kart formunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesine tıkladığında kart tarayıcıda, alıcı doğrulamasıyla (3-D Secure / SCA) jetonlaştırılır: sipariş tutarı, para birimi ve ödeme adresi Square'e iletilir ve müşterinin bankası onay isteyebilir. Mağazanız yalnızca tek kullanımlık bir jeton alır. OpenCart 4'te müşteri ödeme yöntemini, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde seçer. Square kart formu bu durumda ödeme sayfasının altındaki onay bloğunda, Confirm Order düğmesinin üstünde görünür.

Ardından eklenti, jetonu Square Payments API üzerinden sipariş para biriminde sipariş tutarı için tahsil eder; referans olarak sipariş numarası, sipariş numarası ve mağaza adınızı içeren bir Order # notu ve müşterinin e-postası kullanılır. Ödeme hemen tahsil edilir. Sipariş, yalnızca Square onayladıktan sonra ödenmiş olarak işaretlenir: Square'in yanıtı tam sipariş tutarı, para birimi, sipariş numarası ve konum için COMPLETED bir ödeme göstermelidir. Sipariş ardından OpenCart'ın standart yoluyla Order Status After Payment durumunu alır; olağan sipariş e-postaları ve stok güncellemesi yapılır ve müşteri Kart ödemeniz alındı. mesajını ve Square makbuzuna giden View the receipt bağlantısını içeren OpenCart sipariş başarı sayfasını görür. Ödeme COMPLETED değilse veya herhangi bir değer farklıysa sipariş On Hold (Review) Status durumunu alır ve sayfa Kart ödemeniz alındı ve inceleniyor. İnceleme tamamlanır tamamlanmaz siparişinizi güncelleyeceğiz. mesajını gösterir.

Sepet başına aynı anda yalnızca bir ödeme denemesi çalışır. Müşteri iki kez tıklarsa veya iki sekmede ödeme yaparsa, ikinci deneme Bu sipariş zaten ödeniyor. Lütfen bir süre bekleyin ve tekrar denemeden önce e-postanızı kontrol edin. mesajını görür. İstekler idempotenttir ve OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturduğu için eklenti sepeti takip eder: zaten ödenmiş bir sepetten asla tekrar tahsilat yapılmaz ve müşteri doğrudan başarı sayfasına gider.

Square yanıt vermezse (ağ sorunu, zaman aşımı, sunucu hatası), istek aynı idempotency anahtarıyla bir kez daha denenir. Hâlâ yanıt yoksa eklenti bu siparişin ödemesini hemen Square'de arar. Bulursa sipariş durumunu ondan alır. Ödeme bulunamazsa müşteri Confirm Order adımında kalır ve Ödeme sağlayıcısından onay alınamadı. Lütfen bir dakika bekleyip tekrar deneyin — kartınız zaten tahsil edildiyse ödeme tanınacak ve iki kez ücret alınmayacaktır. mesajını görür. Aynı sepetin bir sonraki denemesi önce önceki ödemeyi tekrar arar. Square bu arama için de ulaşılamazsa, sipariş ödeme olmadan On Hold (Review) Status durumunu alır; kartın tahsil edilmiş olabileceğini belirten bir not eklenir ve başarı sayfası Kart ödemenizin onayı Square'den alınamadı. Lütfen tekrar ödeme yapmadan önce e-postanızı ve kart ekstrenizi kontrol edin veya bizimle iletişime geçin. mesajını gösterir.

Banka kartı reddederse sipariş durumsuz kalır ve müşteri, Square hata koduna göre kısa bir mesajla Confirm Order adımında kalır; örneğin Kartınız reddedildi. Lütfen başka bir kart veya ödeme yöntemi kullanın., Kart güvenlik kodu (CVV) hatalı. Lütfen kontrol edip tekrar deneyin. veya Bankanız ek doğrulama istiyor (3-D Secure). Lütfen kartınızı yeniden girin ve doğrulamayı tamamlayın. Sepet korunur ve müşteri başka bir kartla tekrar deneyebilir. Teknik neden günlüğe yazılır.

OpenCart 4, ödeme sayfası için tek bir siparişi saklar ve onu günceller. Bu nedenle kart reddedildiğinde müşteri aynı siparişi yeniden öder; Square'den yanıt gelmeyen bir ödemeden sonra ise o siparişin bir sonraki denemesi önce önceki ödemeyi arar. Ödeme sayfasındaki sipariş zaten bir duruma sahipse (ödenmiş veya mağaza tarafından kapatılmış) ve sepette yeni ürünler varsa, müşteri ödeme sayfasına geri gönderilir ve yeni sepet yeni bir siparişle ödenir.

Eklenti yalnızca kart ödemelerini kabul eder ve bunlar hemen tahsil edilir. Kayıtlı kart, müşteri profili, abonelik, Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH veya Square hediye kartı desteği yoktur; yalnızca yetkilendirme ödemeleri, Square webhook'ları ve Square ile ürün veya stok senkronizasyonu da yoktur. İtirazlar Square Dashboard üzerinden yönetilir.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri henüz ödeme yapmadı, kart reddedildi veya Square'in yanıtı kayboldu ve hiçbir ödeme bulunamadı. Sales > Orders sayfasında bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): Square, sipariş tutarı için COMPLETED bir ödeme onayladı. Bir notta Square ödeme kimliği, kart markası ve son 4 hane ile mod (sandbox veya canlı) gösterilir.

On Hold (Review) Status (varsayılan Pending): Square, COMPLETED olmayan bir ödemeyle (örneğin APPROVED veya PENDING) ya da farklı bir tutar, para birimi, referans veya konumla yanıt verdi. Square ödemesi incelenmeli notu ödeme kimliğini, durumu ve tutarları gösterir. Bu durum, ödeme sırasında siparişin değişmesi durumunda ve Square'in yanıtı kaybolup kontrol edilemediğinde de kullanılır (o zaman ödeme kaydedilmez ve not, sipariş numarasını referans alarak Square Dashboard'da konumun ödemelerini kontrol etmenizi ister). Siparişi yerine getirmeden önce ödemeyi Square Dashboard'da doğrulayın.

Refunded Status (varsayılan Refunded): ödeme, eklenti üzerinden tamamen iade edildi.

Zaten ödenmiş bir siparişi olan bir sepet için ikinci bir ödeme gelirse, ödenmiş sipariş değiştirilmez. Bir not, bunu kontrol etmenizi ve çift ödemeyi Square Dashboard'da iade etmenizi ister.

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

VibeFox Square Gateway sekmesi

Sales > Orders sayfasında Square ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında bulunan VibeFox Square Gateway sekmesi, Square Payment ID değerini (Square Dashboard'daki ödemeye bağlantılı) gösterir; sandbox ödemeleri için Sandbox etiketi, Square Status değeri, Card markası ve son 4 hanesi, Paid / order / refunded tutarları, Environment / location bilgisi, Square receipt bağlantısı, iade formu, iade geçmişi ve siparişin Square notes notları. Kart numaraları asla saklanmaz. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Square Gateway sekmesinde Amount değerini girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) yazın ve Refund via Square düğmesine tıklayın. Bu tutar Square üzerinden iade edilsin mi? Bu işlem geri alınamaz. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups altında ayarlanır). İadeler, Square'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar uyuşmazlığından sonra sipariş tutarına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (sandbox veya canlı) ve konuma gönderilir; bu nedenle o modun Access Token'ı ayarlanmış olmalıdır. İade istekleri idempotenttir ve Square yanıt vermezse bir kez tekrar denenir. Square'in kabul ettiği bir iade (PENDING veya COMPLETED durumu), Square iade kimliğiyle birlikte iade geçmişine ve notlara eklenir. Square reddederse sekme hatayı gösterir ve iade kaydedilmez. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoka geri koymadan Refunded Status durumuna alır; tıpkı manuel bir durum değişikliği gibi. Kısmi iade durumu değiştirmez.

Sales > Returns altındaki ürün iadeleri Square üzerinden para geri göndermez. Square iadeleri kendi tarafında tamamlar: Square'in daha sonra reddettiği bir iade geri bildirilmez ve Square Dashboard'da 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 Square Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Square Gateway > 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 geçerli olduğu tarih 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 ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-payment-square 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önetici panelinin dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Anahtar bulunamadı, Bu anahtar başka bir ürüne ait, Alan adı limitine ulaşıldı veya tarihle birlikte Lisans şu tarihte sona erdi. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Square, ödeme sayfasında müşterilere gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka birini seçin. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada yine görür ve (unlicensed — visible to admins only) ibaresiyle işaretlenir; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza, yönetici panelinde oturum açıldığını görmez; bu yüzden etkin anahtar yoksa ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: ödenmiş siparişler ödenmiş kalır ve iadeler çalışır.

Bir lisansın süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetici 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, sonrasında haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Square ö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 Application ID, Access Token ve Location ID alanlarının dolu olduğunu kontrol edin. Müşterinin para biriminin USD, CAD, AUD, JPY, GBP veya EUR olduğunu ve Square konumunuzun para birimiyle aynı olduğunu kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Kart formu yüklenmiyor: müşteri Kart formu yüklenemedi. Lütfen sayfayı yenileyin veya başka bir ödeme yöntemi seçin. mesajını görür. Application ID ve Location ID'nin seçili moda ait olduğunu kontrol edin (sandbox kimlikleri sandbox- ile başlar). Müşteri çok erken tıklarsa Kart formu hâlâ yükleniyor. Lütfen bir süre bekleyip tekrar deneyin. mesajı gösterilir.

Kaydettikten sonra ödeme yöntemi kayboldu: Square konumunun para birimi, sipariş para biriminden farklı. Mağaza para biriminizdeki bir Square konumunun Location ID'sini girin ve yeniden kaydedin: başarılı bir kontrolden sonra yöntem tekrar görünür.

Square, seçili modun Access Token'ını reddetti: token diğer moda ait veya hatalı. Uygulamanızın Credentials sayfasından yeniden kopyalayın ve Sandbox Mode seçeneğini kontrol edin.

Bu Access Token için Location ID bulunamadı: Location ID'yi aynı uygulamanın ve aynı modun Locations sayfasından kopyalayın.

Müşteri şu mesajı gördü: Ödeme sağlayıcısından onay alınamadı: Square yanıt vermedi ve henüz bir ödeme bulunamadı. Square Dashboard'da bu konumun ödemelerini kontrol edin (referans = sipariş numarası). Müşteri tekrar denerse eklenti önce önceki ödemeyi arar ve yeniden tahsilat yapmak yerine onu kullanır.

Müşteri şu mesajı gördü: Ödemeniz alındı ancak sipariş otomatik olarak tamamlanamadı: kart tahsil edildi, ancak OpenCart sipariş durumunu ayarlayamadı. Günlüğü okuyun, ardından siparişi elle tamamlayın veya Square Dashboard'da ödemeyi iade edin.

Müşteri şu mesajı görüyor: Bu ödeme yöntemi siparişiniz için kullanılamıyor: ödeme sayfası artık siparişle eşleşmiyor, bu sırada ödeme yöntemi kapatılmış olabilir veya siparişin para birimi tahsil edilemiyor. Müşteri ödeme sayfasını yeniler veya başka bir ödeme yöntemi seçer.

Sipariş ödemeden sonra inceleme durumunda: VibeFox Square Gateway sekmesindeki notları okuyun (bkz. Sipariş durumları). Square Dashboard'da ödemeyi kontrol edin, ardından siparişi yerine getirin veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: bu sipariş için para tahsil eden bir Square ödemesi yok, kayıtlı bir Square ödeme kimliği yok (sekme bu durumda Square Dashboard'da aranacak konumu ve sipariş numarasını belirtir), ödeme tamamen iade edilmiş veya kullanıcı grubunuzun eklentiyi değiştirme yetkisi yok.

İade, mod ile ilgili bir mesajla başarısız oluyor: ödeme sandbox veya canlı modda yapıldı ve o modun Access Token'ı ayarlanmamış. Girin ve tekrar deneyin.

Diğer hatalar: Debug log seçeneğini açın ve eklenti sayfasındaki Log alanına bakın.

Kaldırma

Extensions > Extensions sayfasına gidin, türü Payments olarak seçin ve VibeFox Square Gateway yanındaki Uninstall düğmesine (kırmızı −) 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. Delete data on uninstall açıksa, diğer ağ geçidi ayarları (başlık, açıklama, sandbox modu, kimlik bilgileri, günlük kaydı) ve günlük dosyaları silinir. Kapalıysa, sonraki bir yeniden kurulum için saklanırlar. Siparişlerin Square ödemeleri 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 Square Gateway 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.

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