VibeFox Satispay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

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

PHP: OpenSSL eklentisi bulunan 8.0 veya üzeri. OpenSSL olmadan eklenti yönetim alanında bir hata gösterir ve ödeme yöntemi yüklenmez.

Para birimi: EUR. Satispay yalnızca euro tahsil eder; bu nedenle mağaza para birimi (ya da Pay for order sayfasında sipariş para birimi) EUR değilse ödeme yöntemi gizlenir.

Satispay hesabı: bir Satispay Business hesabı. Hiçbir API anahtarını kopyalamazsınız: eklenti, Satispay Business Dashboard'da oluşturacağınız tek kullanımlık bir aktivasyon koduyla bağlanır (bkz. Yapılandırma). Testler için, Satispay for developers üzerinden talep edeceğiniz bir Satispay sandbox hesabına ihtiyacınız vardır.

Herkese açık site: Satispay bir ödeme değiştiğinde sitenizi çağırabilmesi için siteniz internetten erişilebilir olmalıdır. Bunun için Satispay'de bir şey yapılandırmanız gerekmez.

VibeFox lisans anahtarı: vibefox.net'ten 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. wcp_satispay_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Satispay > Manage, ya da Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

5. Ortamı seçin: testler için Sandbox Mode kutusunu işaretleyin, gerçek ödemeler için işaretsiz bırakın.

6. O ortama ait bir aktivasyon kodunu Activation Code alanına yapıştırın ve kaydedin. Bağlantı durumu bundan sonra Key ID'yi gösterir.

7. Enable/Disable seçeneğini açın ve kaydedin. Sandbox'ta bir ödeme deneyin, ardından Sandbox Mode kutusunu kaldırın ve canlı ortamı canlı bir aktivasyon koduyla bağlayın.

Yapılandırma

Tüm ayarlar tek bir sayfada bulunur: WooCommerce > Settings > Payments > Satispay. Satispay connection bölümü her iki ortamın durumunu gösterir; örneğin Key ID ile Live: Connected ya da Sandbox: Not connected, ve kullanılan ortamı işaretler. Kullanılan ortam bağlı değilken sayfa şunu belirtir: Kullanılan ortam bağlanana kadar Satispay ödeme sayfasında gizlidir. WooCommerce ödeme yöntemleri listesinde Satispay, kullanılan ortam bağlanana kadar kurulum gerektiren olarak işaretlenir; Sandbox Mode açık olduğu sürece ise bir test modu rozeti gösterilir.

Enable/Disable: Enable Satispay payment ödeme yöntemini açar ya da kapatır. Varsayılan: kapalı.

Checkout

Müşterilerin ödeme yöntemleri listesinde gördükleri.

Title: ödeme sayfasında gösterilen ödeme yöntemi adı. Varsayılan: Satispay.

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay with the Satispay app: scan the QR code or confirm the payment on your phone.

Satispay connection

Sandbox Mode: Use the Satispay sandbox (staging) environment. Sandbox ödemeleri çekilmez. Varsayılan: kapalı. Sandbox ve canlı ortamların anahtarları ayrıdır: her ortamı o ortama ait bir aktivasyon koduyla bağlayın. Sandbox kullanımdayken müşteriler ödeme yönteminin altında Sandbox modu: Gerçek para çekilmez. ifadesini görür.

Activation Code: yukarıda seçilen ortamı bağlamak için yeni bir 6 karakterlik aktivasyon kodu yapıştırın ve kaydedin. Canlı kodlar Satispay Business Dashboard'da, Online shop bölümünde oluşturulur. Sandbox kodları bir Satispay sandbox hesabıyla birlikte verilir. Kod yalnızca bir kez kullanılır ve saklanmaz. Mevcut bağlantıyı korumak için alanı boş bırakın.

Bir kodla kaydettiğinizde eklenti bir RSA anahtar çifti oluşturur, genel anahtarı ve kodu Satispay'e gönderir ve WordPress veritabanına Key ID ile o ortamın anahtarlarını kaydeder. Başarılı olduğunda sayfa, örneğin Satispay Live connected. Key ID: ve ardından kimliği gösterir. Satispay kodu reddederse, sayfa Satispay'in mesajını gösterir ve kodun bu ortama ait olduğunu ve daha önce kullanılmadığını kontrol etmenizi ister. Harf ve rakam dışında karakter içeren bir kod, hiçbir şey gönderilmeden reddedilir. Bir ortam için yeni bir kod kaydetmek, o ortamın önceki bağlantısının yerine geçer.

Payment notifications

Satispay'de yapılandırılacak bir şey yoktur. Her ödemenin kendi callback URL'si vardır; Satispay ödeme değiştiğinde bu URL'yi çağırır ve eklenti bir siparişi değiştirmeden önce ödemeyi Satispay API'sinden yeniden okur. Bu bölüm, bu URL'nin bir örneğini gösterir. Şuna benzer: https://your-site/wc-api/satispay_payment_callback/?action=callback&order_id={order}&payment_id={uuid}. URL internetten erişilebilir olmalıdır: /wc-api/ üzerinde bakım modu ya da parola koruması olmamalıdır.

Advanced

Debug log: Log API calls and payment events seçeneği WooCommerce > Status > Logs kaydına, kaynak wcp_satispay_gateway olarak yazar; anahtar ya da müşteri verisi içermez. Bu seçenek kapalı olsa bile hatalar her zaman kaydedilir. Varsayılan: kapalı.

Delete data on uninstall: Remove the settings and Satispay keys when the plugin is deleted. Siparişlerde kayıtlı ödeme verileri korunur. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini seçer (varsayılan olarak Satispay) ve Pay with Satispay düğmesine tıklar. Eklenti, sipariş toplamı için euro cinsinden bir Satispay ödemesi oluşturur, referans olarak sipariş numarasını kullanır ve müşteriyi Satispay ödeme sayfasına gönderir. Bilgisayarda müşteri QR kodu Satispay uygulamasıyla tarar. Telefonda müşteri ödemeyi uygulamada onaylar.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, ancak Satispay ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir: eklenti ödemeyi Satispay API'sinden okur, bu siparişe ait olup olmadığını kontrol eder ve durumunu, tutarını (kuruş cinsinden) ve para birimini siparişle karşılaştırır. Bu, Satispay callback URL'sini çağırdığında da müşteri geri döndüğünde de gerçekleşir; hangisi önce gelirse. Ödeme henüz onaylanmamışsa, siparişin alındığı sayfa şunu gösterir: Satispay ödemenizi henüz onaylamadı. Onay geldiğinde sipariş otomatik olarak güncellenecektir.

Müşteri ödeme yapmadan Satispay sayfasından ayrılırsa, eklenti ödemeyi Satispay'de iptal eder; böylece terk edilen sayfa artık ödenemez. Müşteri, Your Satispay payment was cancelled and nothing was charged. You can try again or choose another payment method. mesajıyla ödeme sayfasına (ya da Pay for order sayfasına) geri gönderilir. Müşteri uygulamada ödemeyi reddettiğinde de aynı mesaj görünür.

Müşteri ödenmemiş bir siparişi yeniden ödeyebilir; örneğin Pay for order sayfasından. Yeni bir Satispay ödemesi oluşturulmadan önce öncekine bakılır: bekleyen bir ödeme Satispay'de iptal edilir ve zaten ödenmişse sipariş o ödemeyle ödenmiş olarak işaretlenir, ikinci bir ödeme oluşturulmaz.

Ödeme başlatılamazsa müşteri kısa bir mesaj görür ve başka bir ödeme yöntemi seçebilir: mağaza bağlı değilse ya da Satispay anahtarları reddederse Satispay is not available at the moment. Please choose another payment method., diğer hatalarda ise Unable to create the Satispay payment. Please try again or choose another payment method. mesajı gösterilir. Neden günlüğe yazılır.

Ö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 euro cinsinden tek seferlik ödeme kabul eder. Abonelik, kayıtlı ödeme yöntemi, ön provizyon ya da yemek kartı desteklemez. Bekleyen ödemeler için zamanlanmış bir kontrol yoktur: ne Satispay callback'i ne de müşterinin dönüşü sitenize ulaşırsa sipariş Pending payment olarak kalır ve ödeme Satispay Dashboard'da görünür.

Siparişler ve iadeler

Order statuses

Pending payment: Müşteri Satispay'e yönlendirildi ve henüz ödeme yapmadı ya da Satispay ödemeyi henüz onaylamadı. Sipariş notu Satispay ödeme kimliğini, tutarı ve ortamı (Live ya da Sandbox) gösterir.

Processing or Completed: Ödeme onaylandı. Sipariş standart WooCommerce kuralını izler: Processing, ya da yalnızca sanal indirilebilir ürün içeren siparişler için Completed. Sipariş notu Satispay ödemesini, tutarı ve doğrulama şeklini (callback, yönlendirme ya da ödeme sayfası) gösterir. İşlem kimliği Satispay ödeme kimliğidir.

On hold: Satispay, sipariş toplamından farklı bir tutar ya da para birimi bildirdi ya da ödeme, sipariş iptal edildikten sonra kabul edildi. Sipariş notu bunu açıklar ve ödeme, iade edilebilmesi için işlem kimliği olarak kaydedilir. Ödemeyi Satispay Dashboard'da kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin.

Cancelled: Siparişin en son Satispay ödemesi iptal edildi ya da süresi doldu; örneğin müşteri Satispay sayfasından ayrıldığı için. Süresi dolan eski bir ödeme, devam eden daha yeni bir ödemesi olan siparişi iptal etmez. Yönetim alanında oluşturduğunuz siparişler (ödeme bağlantıları) iptal edilmez: müşteri hâlâ ödeyebilmesi için Pending payment olarak not ile kalırlar.

Zaten ödenmiş bir sipariş için ikinci bir ödeme kabul edilirse sipariş değiştirilmez. Bir not, mükerrer ödemeyi Satispay Dashboard'dan iade etmenizi ister. Tekrarlanan bir onay, iptal edilmiş ya da iade edilmiş bir siparişi asla yeniden açmaz.

Refunds

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Satispay düğmesine tıklayın. Satispay ile ödenmiş siparişler için tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı ortama (canlı ya da sandbox) gönderilir; bu nedenle o ortam hâlâ bağlı olmalıdır. İade ancak Satispay kabul ettiğinde tamamlanmış sayılır: başarılı bir iade, Satispay iade kimliği ve nedeniyle birlikte sipariş notlarına eklenir. Satispay iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez.

Satispay Dashboard'da yapılan iadeler WooCommerce iadesine dönüştürülmez. Gerekirse Refund via Satispay kullanmadan WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > Satispay sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın etkin olduğu tarihi ve alan adınızı. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu siteden kaldırmak için Remove key kullanın. 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ı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Satispay ö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. Oturum açmış mağaza yöneticileri ödeme yöntemini (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece 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: zaten başlatılmış ödemeler yine onaylanı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. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Satispay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, kullanılan ortamın bağlı olduğunu (Satispay connection bölümü onun için Connected gösterir) ve para biriminin EUR olduğunu kontrol edin.

Ödeme yapıldı ama sipariş Pending payment olarak kalıyor: Sipariş, Satispay sitenizi çağırdığında ya da müşteri döndüğünde güncellenir. Sitenizin internetten erişilebilir olduğunu, /wc-api/ üzerinde bakım modu ya da parola koruması olmadığını kontrol edin ve WooCommerce > Status > Logs kaydına, kaynak wcp_satispay_gateway olarak bakın. Ödeme Satispay Dashboard'da görünür.

Callback şu yanıtı veriyor: Payment status unavailable, retry later ya da Not configured: Eklenti ödemeyi Satispay'den okuyamadı ya da siparişin ortamı bağlı değil. Sipariş değiştirilmez. Bağlantı durumunu ve günlüğü kontrol edin.

Callback şu yanıtı veriyor: Busy, retry later: Sipariş o anda başka bir istek tarafından güncelleniyordu. Bu callback siparişi değiştirmez. Sipariş bir sonraki callback'te ya da müşteri döndüğünde güncellenir.

Callback şu yanıtı veriyor: Unknown payment ya da Missing or invalid payment_id: Ödeme bu sipariş için oluşturulmadı ya da istek bir Satispay callback'i değil. Sipariş değiştirilmez.

Aktivasyon başarısız oluyor: Aktivasyon kodları yalnızca bir kez kullanılabilir. Kodun Sandbox Mode ile seçilen ortama ait olduğunu kontrol edin (canlı için canlı kod, sandbox için sandbox kodu), yeni bir kod oluşturun ve yeniden kaydedin. Sayfa bir RSA anahtar çiftinin oluşturulamadığını belirtiyorsa, barındırma sağlayıcınızdan PHP OpenSSL eklentisini etkinleştirmesini isteyin.

Sandbox'tan canlıya geçtikten sonra Satispay ödeme sayfasından kayboldu: Sandbox ve canlı ortamlar farklı anahtarlar kullanır. Sandbox Mode kutusu kaldırılmışken canlı bir aktivasyon kodu yapıştırın ve kaydedin.

Sipariş On hold durumunda ve not siparişle eşleşmiyor: Satispay, sipariş toplamından farklı bir tutar ya da para birimi bildirdi; örneğin ödeme başladıktan sonra sipariş düzenlendiği için. Ödemeyi Satispay Dashboard'da kontrol edin, ardından siparişi tamamlayın ya da ödemeyi iade edin.

Ortam artık bağlı olmadığı için iade başarısız oluyor: Ödeme canlı ya da sandbox ortamında yapıldı ve bu ortamın artık anahtarı yok. Ortamı bir aktivasyon koduyla yeniden bağlayın ya da ödemeyi Satispay Dashboard'dan iade edin.

İade şu mesajla başarısız oluyor: Satispay did not accept the refund: Satispay, accepted dışında bir durum döndürdü. WooCommerce iadeyi kaydetmedi. Satispay Dashboard'da kontrol edin.

Lisans bölümü bir hata gösteriyor: Bölümdeki mesajı izleyin. Örneğin anahtar zaten başka bir alan adında kullanılıyorsa, vibefox.net hesabınızda bir yuva boşaltın ve Check now düğmesine tıklayın. Site adresi değiştiyse, anahtarı yeni alan adı için 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 devre dışı bırakın ve Plugins sayfasından silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları, her iki ortamın Satispay anahtarları ve eklenti günlükleri yalnızca Delete data on uninstall açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için kalırlar. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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