VibeFox Square for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmaz.

Para birimi: Sepet 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. Square, ABD, Kanada, Avustralya, Japonya, Birleşik Krallık, İrlanda, Fransa ve İspanya'daki satıcıları destekler.

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

VibeFox lisans anahtarı: vibefox.net'ten satın alınır. Bir anahtar bir alan adında çalışır.

Kurulum

1. Back office'te 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 veya daha sonra modül listesinde VibeFox Square Gateway'i bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğunda License key alanına VibeFox lisans anahtarınızı girin 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 değerlerini girin (bkz. Yapılandırma). Save düğmesine tıklayın: modül kimlik bilgilerini Square ile kontrol eder.

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ı kimlik bilgilerini girin ve yeniden kaydedin.

Kurulumda modül Square payment on hold sipariş durumunu oluşturur. PrestaShop, yeni bir ödeme modülüne kurulum sırasında aktif olan para birimleri, ülkeler ve müşteri grupları için izin verir. Bunları kontrol edin; sonradan eklediğiniz ülkeleri Payment > Preferences bölümünde işaretleyin.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Square Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Sandbox modu açıkken alanların üzerinde sayfa Square Gateway şu anda SANDBOX modunda. Gerçek tahsilat yapılmayacak. yazısını gösterir. Square etkinken seçili modun Application ID, Access Token veya Location ID değerlerinden biri 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 uyarır.

Kaydettiğinizde modül, seçili modun kimlik bilgilerini Square ile kontrol eder. Ayarlar her durumda kaydedilir. Square erişim jetonunu reddederse, bu jeton için Location ID bulunamazsa, kimlik bilgileri kontrol edilemezse veya konum para birimi mağaza para biriminden farklıysa bir uyarı görürsünüz. Square yalnızca konum para biriminde tahsilat yapabilir: modül, kontrol edilen konumun para birimini hatırlar ve ödeme yöntemini diğer para birimlerindeki sepetler için gizler. Ayrıca sandbox Application ID'nin canlı modda, ya da tersinin kullanılması durumunda uyarır.

Square

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

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

Description: müşterinin ödeme sırasında gördüğü ödeme yöntemi açıklaması. Varsayılan: Pay securely with your credit or debit card via Square. Sandbox modunda (SANDBOX MODE) eklenir.

Square hesabı

Square Developer Dashboard'u açın (bölümde bir bağlantı vardır), uygulamanızı seçin ve Credentials sayfasından Application ID ile Access token'ı (Sandbox ve Production için değerler ayrıdır), Locations sayfasından da Location ID'yi kopyalayın. Konumun para birimi, mağaza para biriminizle aynı olmalıdır. Sayfa yalnızca seçili modun kimlik bilgisi alanlarını gösterir: Sandbox Mode açıkken sandbox alanları, kapalıyken canlı alanları. İki set de 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: on.

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ı erişim jetonları bir daha gösterilmez. Alan boş kalır ve Kayıtlı — korumak için boş bırakın. yazısını gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin.

Clear saved secrets: bir access token'ı işaretleyip Save düğmesine tıklayarak kaldırın. Boş alan kayıtlı değeri korur.

Gelişmiş

Debug log: hatalar ve uyarılar her zaman günlüğe yazılır. Her istek ve yanıtı da kart verisi veya anahtar olmadan, modül klasöründeki logs/wc_sqg_debug.log.php dosyasına kaydetmek için açın. Dosya web üzerinden açılamaz. Varsayılan: off.

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çıkken modül kaldırıldığında gateway ayarları ve günlük dosyaları silinir. Siparişlerdeki Square ödemeleri ve iadeleri ile Square payment on hold sipariş durumu her zaman korunur. Varsayılan: off.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit / debit card) ve kartını açıklamanın altında görünen Square kart formuna girer. Müşteri siparişi onayladığında kart, tarayıcıda alıcı doğrulamasıyla (3-D Secure / SCA) jetonlaştırılır: sepet toplamı, para birimi ve fatura adresi Square'e iletilir ve müşterinin bankası onay isteyebilir. Mağazanız yalnızca tek kullanımlık bir jeton alır.

Ardından modül, jetonu Square Payments API üzerinden sepet toplamı için sepet para biriminde tahsil eder; referans olarak sepet kimliğini, sepet numarası ve mağaza adınızı içeren Cart # notunu ve müşterinin e-posta adresini gönderir. Ödeme hemen tahsil edilir. Sipariş yalnızca Square onayladıktan sonra ödenmiş olarak işaretlenir: Square'in yanıtı, sepet toplamı, para birimi, sepet kimliği ve konumla tam olarak eşleşen bir COMPLETED ödeme göstermelidir. Sipariş bu durumda Payment accepted ile oluşturulur ve müşteri Kart ödemeniz alındı. yazısını ve Square makbuzuna bağlantıyı içeren standart sipariş onay sayfasını görür. Ödeme COMPLETED değilse ya da bir değer eşleşmezse sipariş Square payment on hold durumuyla oluşturulur ve sayfa Kart ödemeniz alındı ve inceleniyor. İnceleme tamamlanır tamamlanmaz siparişinizi güncelleyeceğiz. yazısını gösterir.

Sepet başına aynı anda yalnızca bir ödeme denemesi yürütülür. Müşteri iki kez tıklarsa ya da iki sekmede ödeme yaparsa, ikinci deneme Bu sipariş zaten ödeniyor. Lütfen bir an bekleyin ve tekrar denemeden önce e-postanızı kontrol edin. mesajını görür. İstekler idempotenttir: aynı sepet, aynı kart jetonu ve aynı tutar hiçbir zaman ikinci bir ödeme oluşturmaz ve zaten siparişi olan bir sepet yeniden tahsil edilmez.

Square yanıt vermezse (ağ sorunu, zaman aşımı, sunucu hatası), istek aynı idempotency anahtarıyla bir kez daha gönderilir. Hâlâ yanıt yoksa modül, bu sepetin ödemesini hemen Square'de arar. Bulursa sipariş bu ödemeyle oluşturulur. Ödeme bulunamazsa müşteri ödeme sayfasında kalır ve Ödeme sağlayıcısından onay alamadık. Lütfen bir dakika bekleyip tekrar deneyin — kartınız zaten tahsil edildiyse ödeme tanınır ve çift tahsilat yapılmaz. mesajını görür. Bir sonraki deneme önce önceki ödemeyi yeniden arar. Bu arama için de Square'e ulaşılamazsa sipariş, kartın tahsil edilmiş olabileceğini belirten bir notla ödemesiz olarak Square payment on hold durumunda oluşturulur ve onay sayfası Kart ödemenizin onayını Square'den alamadık. Tekrar ödeme yapmadan önce e-postanızı ve kart ekstrenizi kontrol edin veya bizimle iletişime geçin. yazısını gösterir.

Banka kartı reddederse sipariş oluşturulmaz ve müşteri, Square'in hata koduna göre kısa bir mesajla ödeme sayfasında kalır; örneğin Kartınız reddedildi. Lütfen başka bir kart veya ödeme yöntemi kullanın., Kartın 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.

Modül yalnızca anında tahsil edilen kart ödemelerini kabul eder. Kayıtlı kart veya müşteri profili, abonelik, Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH veya Square hediye kartı, yalnızca yetkilendirme ile ödeme, Square webhook'ları ve Square ile ürün ya da stok senkronizasyonu yoktur. Anlaşmazlıklar Square Dashboard'da yönetilir.

Siparişler ve iadeler

Sipariş durumları

No order yet: kart reddedildi ya da Square'in yanıtı kayboldu ve hiçbir ödeme bulunamadı. Yalnızca sepet vardır.

Payment accepted: Square, sepet toplamına ait bir COMPLETED ödemeyi onayladı. Ödeme, Square ödeme kimliğiyle işlem kimliği olarak kaydedilir; bir not ödeme kimliğini, kart markasını ve son 4 hanesini ve modu (sandbox veya live) gösterir.

Square payment on hold: Square, COMPLETED olmayan bir ödemeyle (örneğin APPROVED) 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. COMPLETED bir ödeme, Square'in tahsil ettiği tutarla siparişe kaydedilir. Bu durum ayrıca ödeme sırasında sepet değiştiğinde ve Square'in yanıtı kaybolup kontrol edilemediğinde de kullanılır (bu durumda ödeme kaydedilmez). Sipariş hazırlanmadan önce ödemeyi Square Dashboard'da doğrulayın.

Refunded: ödeme, modül aracılığıyla tamamen iade edildi.

Zaten siparişi olan bir sepet için ikinci bir ödeme gelirse sipariş değişmez. Bir not, bunu kontrol edip kopyayı Square Dashboard'da iade etmenizi ister.

Square bloğu

Sipariş sayfasında Square ödeme kimliği (Square Dashboard'daki ödemeye bağlı), Square durumu, kart markası ve son 4 hanesi, Paid / order / refunded tutarları, ortam ve konum, Square makbuzuna bağlantı, sandbox ödemeleri için Sandbox rozeti, iade geçmişi ve siparişin Square notes alanı gösterilen bir Square bloğu bulunur. Kart numaraları asla saklanmaz.

İadeler

Square bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden 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. Siparişleri düzenleme yetkisine sahip olmanız gerekir. İadeler, Square'in tahsil ettiği tutar ve para biriminde yapılır; bu yüzden tutar uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekte ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı ortama (sandbox veya canlı) ve konuma gönderilir; bu nedenle o modun Access Token'ı tanımlı olmalıdır. İade istekleri idempotenttir ve Square yanıt vermezse bir kez daha 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 blok hatayı gösterir ve hiçbir iade kaydedilmez. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri 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 PrestaShop'ta görünmez.

Lisans anahtarı

Modül, vibefox.net'ten alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Square Gateway lisans bloğu, Modules > Module Manager > VibeFox Square Gateway > 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 tarih 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: presta-payment-square satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure izni olan çalışanlar değiştirebilir. Bloktaki metinler back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir; örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihle birlikte License expired on. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı hakkı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ı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızda serbest bırakın.

Etkin bir anahtar olmadan Square, ö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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu yüzden ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme sayfasında test edemezsiniz. Modules > Module Manager bölümünde Alerts sekmesinde bir hatırlatma görünür. Mevcut siparişler etkilenmez: ödenmiş siparişler ödenmiş kalır ve iadeler çalışır.

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, ardından haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu 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 değerlerinin doldurulduğunu kontrol edin. Sepet para biriminin USD, CAD, AUD, JPY, GBP veya EUR olduğunu ve Square konumunuzun para birimiyle eşleştiğini kontrol edin. Ayarlar sayfası bu sorunların her biri için bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu 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 değerlerinin 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 an bekleyip tekrar deneyin. mesajı gösterilir.

Kaydettikten sonra ödeme yöntemi kayboldu: Square konumunun para birimi, sepet 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 ya da 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, Ödeme sağlayıcısından onay alamadık mesajını gördü: Square yanıt vermedi ve henüz bir ödeme bulunamadı. Square Dashboard'da bu konumun ödemelerini kontrol edin (referans = sepet kimliği). Müşteri tekrar denerse modül önce önceki ödemeyi arar ve tekrar tahsilat yapmak yerine siparişi onunla oluşturur.

Müşteri, Ödemeniz alındı, ancak sipariş otomatik olarak tamamlanamadı mesajını gördü: kart tahsil edildi ama PrestaShop siparişi oluşturamadı (örneğin modül o anda devre dışıydı). Günlüğü okuyun, ardından siparişi elle oluşturun veya ödemeyi Square Dashboard'da iade edin.

Sipariş Square payment on hold durumunda: Square bloğundaki notları okuyun (bkz. Sipariş durumları). Ödemeyi Square Dashboard'da kontrol edin, ardından siparişi hazırlayın veya ödemeyi iade edin.

İade, mod hakkında bir mesajla başarısız oluyor: ödeme sandbox veya canlı modda yapıldı ve o modun Access Token'ı tanımlı değil. Token'ı girin ve tekrar deneyin.

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

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Square Gateway'in 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 gateway ayarları ve günlük dosyaları silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerdeki Square ödemeleri ve iadeleri ile Square payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını, Square ödeme kimliklerini ve işlem kimliklerini korur.

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