VibeFox Square for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin. Eklenti WooCommerce olmadan etkinleştirilmez.

PHP: 8.0 veya üzeri.

Mağaza para birimi: Square konumunuzun para birimi: 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. Buradan 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: 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

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_square_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 > Square > Manage, veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bloğuna VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Sandbox Mode seçeneğini açık bırakın ve sandbox Application ID, Access Token ve Location ID değerlerini girin (bkz. Yapılandırma). Kaydedin: eklenti kimlik bilgilerini Square ile doğrular.

6. Enable/Disable seçeneğini açın ve Square'in sandbox test kılavuzundaki test kartlarıyla bir ödeme deneyin. Ardından Sandbox Mode işaretini kaldırın, canlı kimlik bilgilerini girin ve yeniden kaydedin.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Square. Sandbox modu açıkken sayfa, alanların üstünde Square Gateway şu anda SANDBOX modunda. Gerçek tahsilat yapılmayacak. uyarısını gösterir. Square etkinleştirilmiş ancak seçili modun Application ID, Access Token veya Location ID değeri eksikse (bu durumda ödeme yöntemi ödeme sayfasında gizlenir) ve Square mağaza para birimini işleyemiyorsa sizi uyarır. Ödeme yöntemleri listesinde Square, sandbox modu açıkken bir Test mode rozeti gösterir.

Kaydettiğinizde eklenti, seçili modun kimlik bilgilerini Square ile kontrol eder. Square Access Token'ı reddederse, bu jeton için Location ID bulunamazsa, kimlik bilgileri kontrol edilemezse veya konum para birimi mağaza para birimiyle farklıysa bir hata görürsünüz. Square yalnızca konum para biriminde tahsilat yapabilir: eklenti kontrol edilen konumun para birimini hatırlar ve diğer her para birimi için ödeme yöntemini ödeme sayfasında gizler; ayarlar sayfası uyarıyı göstermeye devam eder. Ayrıca sandbox Application ID'sinin canlı modda, ya da tersinin kullanılması durumunda da uyarır.

General

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ığı. Varsayılan: Credit / debit card.

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.

Square account

Square Developer Dashboard'u açın, 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 ise Location ID'yi kopyalayın. Konum para birimi, mağaza para biriminizle eşleşmelidir. Sayfa yalnızca seçili modun kimlik bilgisi alanlarını gösterir: Sandbox Mode açıkken sandbox alanlarını, kapalıyken canlı alanlarını.

Sandbox Mode: Enable sandbox (test) mode. Ödemeler Square sandbox'ına gönderilir ve gerçek para tahsil edilmez. Square test kartlarını kullanın. Varsayılan: on.

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

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

Sandbox Location ID: Square sandbox Location ID'niz.

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

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

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

Advanced

Debug log: Log API requests and responses. Hatalar her zaman kaydedilir. Her isteği de kaydetmek için açın; kart verileri ve anahtarlar kaydedilmez. Günlükler WooCommerce > Status > Logs bölümündedir, kaynak wcp_square_gateway. Varsayılan: off.

Delete data on uninstall: Remove all plugin data when the plugin is deleted. Eklentiyi sildiğinizde ağ geçidi ayarlarını ve günlük dosyalarını siler. Sipariş ödeme verileri korunur. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan Credit / debit card) ve kartını açıklamanın altında gösterilen Square kart formuna girer. Sandbox modunda ödeme sayfası bir sandbox bildirimi gösterir. Müşteri Place order düğmesine tıkladığında kart, tarayıcıda alıcı doğrulamasıyla (3-D Secure / SCA) jetonlaştırılır: tutar, para birimi ve fatura iletişim bilgisi Square'e iletilir ve müşterinin bankası onay isteyebilir. Sunucunuz yalnızca tek kullanımlık bir jeton alır.

Ardından eklenti, jetonu Square Payments API üzerinden sipariş para biriminde sipariş toplamı için tahsil eder; referans olarak sipariş kimliğini, sipariş numarası ve site adınızı içeren bir Order # notunu ve fatura e-postasını gönderir. Ödeme anında tahsil edilir. Sipariş, yalnızca Square onayladıktan sonra ödenmiş olarak işaretlenir: Square yanıtı, sipariş toplamı, para birimi, sipariş kimliği ve konum ile tam olarak eşleşen bir COMPLETED ödeme göstermelidir. Ardından müşteri sipariş alındı sayfasına gider. Ödeme COMPLETED değilse veya herhangi bir değer farklıysa sipariş bir notla beklemeye alınır ve müşteri yine de sipariş alındı sayfasına gider.

Sipariş 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 biraz bekleyin ve tekrar denemeden önce e-postanızı kontrol edin. mesajını gösterir. İstekler idempotenttir: aynı sipariş, jeton ve tutar hiçbir zaman ikinci bir ödeme oluşturmaz.

Square yanıt vermezse (ağ sorunu, zaman aşımı, sunucu hatası), istek aynı idempotency anahtarıyla bir kez yeniden denenir. Hâlâ yanıt alınamazsa müşteri Ö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 tahsil edilmeyeceksiniz. mesajını görür. Sipariş notu, Square Dashboard'u kontrol etmenizi ister. Bir sonraki denemede eklenti önce Square'de bu siparişin önceki ödemesini arar ve kartı yeniden tahsil etmek yerine siparişi bu ödemeyle tamamlar.

Banka kartı reddederse müşteri, Square'in hata koduna göre kısa bir mesaj görü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. Teknik neden sipariş notlarına ve günlüğe yazılır. Müşteri başka bir kartla tekrar deneyebilir; daha sonra Pay for order sayfasından da deneyebilir.

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

Eklenti yalnızca anında tahsil edilen kart ödemelerini kabul eder. Kayıtlı kartlar veya müşteri profilleri, WooCommerce Subscriptions veya Pre-Orders, Apple Pay, Google Pay, Cash App Pay, Afterpay, ACH veya Square hediye kartları, yalnızca yetkilendirme ile ödemeler, Square webhook'ları ve Square ile ürün veya stok senkronizasyonu desteklenmez. İtirazlar Square Dashboard'da yönetilir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: Sipariş oluşturuldu ancak henüz ödenmedi; örneğin kart reddedildiğinde veya Square'den yanıt alınamadığında.

Processing: Square, sipariş toplamı için bir COMPLETED ödeme onayladı. Bu, ödeme sonrası WooCommerce'in standart durumudur (yalnızca sanal indirilebilir ürün içeren siparişler Tamamlandı olur). Sipariş notu Square ödeme kimliğini, son 4 hanesiyle kart markasını ve modu (sandbox veya canlı) gösterir. İşlem kimliği Square ödeme kimliğidir ve sipariş ekranında Square Dashboard'daki ödemeye bağlanır.

On hold: Square, COMPLETED olmayan bir ödemeyle veya farklı tutar, para birimi, referans ya da konumla yanıt verdi. Square payment needs review notu ödeme kimliğini, durumu ve tutarları gösterir. Siparişi yerine getirmeden önce tahsilatı, tutarı ve para birimini Square Dashboard'da doğrulayın.

Eklenti, siparişte Square ödeme kimliğini, kart markasını ve son 4 haneyi, ortamı ve konumu saklar. Kart numaraları hiçbir zaman saklanmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit / debit card düğmesine tıklayın (düğmede Title değeriniz görünür). Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (sandbox veya canlı) ve konuma gönderilir; bu nedenle o modun Access Token'ının girilmiş olması gerekir. İade istekleri idempotenttir ve Square yanıt vermezse bir kez yeniden denenir. Square'in kabul ettiği bir iade (PENDING veya COMPLETED durumu) Square iade kimliğiyle birlikte sipariş notlarına eklenir. Square reddederse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez.

Square iadeleri kendi tarafında tamamlar. Square'in daha sonra reddettiği bir iade WooCommerce'e bildirilmez; Square Dashboard'da yapılan iadeler de WooCommerce'te görünmez.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Square 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 geçerli olduğunu ve alan adınızı. Check now ile durumu yeniden kontrol edebilir, Change key ile başka bir anahtar girebilir ve Remove key ile anahtarı bu siteden kaldırabilirsiniz. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar bir alan adında çalışır. Anahtarı bir siteden kaldırmak, o sitenin alan adı hakkını serbest bırakmaz. Hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa 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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. Eklentiler sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: ödenmiş siparişler ödenmiş kalır ve iadeler çalışmaya devam eder.

Lisans 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

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 doldurulduğunu kontrol edin. Mağaza para biriminin (veya Pay for order sayfasındaki sipariş 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.

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 biraz bekleyip tekrar deneyin. mesajı gösterilir.

Kart uygun olmasına rağmen ödemeler reddediliyor: Konum para birimi, mağaza para birimiyle aynı olmalıdır. Kimlik bilgisi kontrolünün sonucunu görmek için ayarları kaydedin; kontrol başarılı olduktan sonra yöntem diğer para birimleri için gizlenir.

Square, seçili modun Access Token'ını reddetti: Jeton diğer moda ait veya hatalıdır. Uygulamanızın Credentials sayfasından yeniden kopyalayın ve Sandbox Mode ayarını 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 alınamadı» mesajını gördü: Square yanıt vermedi. Sipariş notunu okuyun ve Square Dashboard'da bu konumun ödemelerini kontrol edin (referans = sipariş kimliği). Müşteri tekrar denerse eklenti önce önceki ödemeyi arar ve kartı yeniden tahsil etmek yerine siparişi bu ödemeyle tamamlar.

Sipariş On hold durumunda: Square payment needs review notunu okuyun. Ödeme COMPLETED değildi veya tutarı, para birimi ya da konumu siparişten farklıydı. Square Dashboard'da kontrol edin, ardından siparişi yerine getirin 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'ı girilmemiş. Token'ı girip tekrar deneyin.

Diğer hatalar: Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümüne, kaynak wcp_square_gateway olacak şekilde bakın.

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 hak serbest bırakın ve Check now düğmesine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı 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. Kaldırmak için eklentiyi Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlük dosyaları yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki bir yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını, Square ödeme kimliklerini ve işlem kimliklerini korur.

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