VibeFox GoPay for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.6 veya üzeri, kurulu ve etkin. Eklenti, WooCommerce olmadan etkinleştirilemez.

PHP: 8.0 veya üzeri.

Para birimi: GoPay CZK, EUR, PLN, USD, GBP, HUF, RON ve BGN para birimlerini kabul eder. Başka bir para biriminde ödeme yöntemi ödeme sayfasında gizlenir.

GoPay hesabı: GoPay satıcı hesabınızın GoID, Client ID ve Client Secret bilgileri gerekir. Bunları hesabın entegrasyon ayarlarında bulabilirsiniz. Test (sandbox) hesabının kimlik bilgileri ayrıdır. Bildirimler için GoPay hesabında herhangi bir ayar yapmak gerekmez; ancak mağazanıza internet üzerinden erişilebilmelidir.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar tek bir alan adında çalışır.

Kurulum

1. WordPress'te Plugins > Add New > Upload Plugin yolunu açın, eklentinin ZIP dosyasını seçin ve Install Now düğmesine tıklayın. wcp_gopay_gateway klasörünü FTP ile /wp-content/plugins/ konumuna da yükleyebilirsiniz.

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

3. Ayarları açın: WooCommerce > Settings > Payments > GoPay > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

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

5. Test ortamının GoID, Client ID ve Client Secret bilgilerini girin, Test Mode seçeneğini açık bırakın ve Enable/Disable seçeneğini etkinleştirin.

6. Bir test siparişi verin. Her şey çalıştığında canlı ortam kimlik bilgilerini girin ve Test Mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > GoPay. Ağ geçidi açıklamasının altında Sandbox mode — test payments only veya Production mode — real payments gösterilir. Geçerli modun GoID, Client ID veya Client Secret bilgileri eksikse ya da GoPay mağaza para birimini kabul etmiyorsa uyarı alırsınız. Her iki durumda da GoPay ödeme sayfasında sunulmaz. Geçerli moda ait kimlik bilgileri girilene kadar ödeme yöntemleri listesinde ağ geçidinin kurulması gerektiği belirtilir. Kaydettiğinizde önbelleğe alınmış GoPay erişim jetonları temizlenir ve yeni kimlik bilgileri hemen kullanılmaya başlar.

Enable/Disable: Enable GoPay payment gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: ödeme sayfasında gösterilen ödeme yöntemi başlığı. Varsayılan: GoPay.

Description: ödeme sayfasında gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely via GoPay - cards, wallets, bank transfers.

API kimlik bilgileri

GoID, Client ID ve Client Secret bilgileri GoPay satıcı hesabınızda (entegrasyon ayarları) gösterilir. Test (sandbox) hesabının kimlik bilgileri ayrıdır. API belgeleri doc.gopay.com adresindedir.

Test Mode: Enable sandbox/test mode, test ortamı kimlik bilgileriyle ödemeleri gw.sandbox.gopay.com adresine gönderir. Gerçek para tahsil edilmez. Canlı ortam kimlik bilgileriyle gerçek ödeme almak için seçeneğin işaretini kaldırın (gate.gopay.cz). Varsayılan: açık.

Sandbox GoID: GoPay test (sandbox) hesabınızın GoID bilgisi.

Sandbox Client ID: test hesabının OAuth Client ID bilgisi.

Sandbox Client Secret: test hesabının OAuth Client Secret bilgisi.

Production GoID: GoPay satıcı kimliğiniz (GoID).

Production Client ID: GoPay tarafından sağlanan OAuth Client ID bilgisi.

Production Client Secret: GoPay tarafından sağlanan OAuth Client Secret bilgisi.

GoID yalnızca rakamlardan oluşur; örneğin 8123456789. Farklı bir değer girerseniz sayfada hata gösterilir ve önceki değer korunur.

Ödeme

Payment Page Language: GoPay ödeme sayfasının dili. Varsayılan: Automatic (site language, then billing country). Otomatik seçimde sitenizin dili kullanılır; GoPay bu dili desteklemiyorsa fatura ülkesi dikkate alınır, o da uygun değilse İngilizce kullanılır. Ayrıca şu 19 dilden birini seçebilirsiniz: Çekçe, İngilizce, Slovakça, Almanca, Lehçe, Macarca, Rumence, Bulgarca, Hırvatça, Slovence, Estonca, Letonca, Litvanca, Fransızca, İtalyanca, İspanyolca, Portekizce, Ukraynaca veya Rusça.

Order Status After Payment: ödeme onaylandığında siparişe verilecek durum. Tek bir durum değişikliği ve müşteriye tek bir e-posta ile hemen uygulanır.

Ödeme bildirimleri

Bildirim, mağazanıza ödeme yapıldığını bildirir. Bildirim URL'si her ödemeyle GoPay'e gönderildiği için GoPay hesabında bir ayar yapılması gerekmez. URL ayarlarda gösterilir ve şu biçimdedir: https://your-site/?gopay-api=gopay_payment_notification. İnternet üzerinden erişilebilir olmalı; parola koruması, bakım modu veya önünde erişimi engelleyen bir güvenlik duvarı bulunmamalıdır.

GoPay bildirimleri yalnızca ödeme kimliğini içerir, imza içermez. Her bildirimde ödeme durumu GoPay API'sinden sorgulanarak doğrulanır ve ödeme, mağazanızdaki bir sipariş için eklenti tarafından oluşturulmuş olmalıdır. Durum GoPay'den okunamazsa mağazanız hata yanıtı verir ve GoPay bildirimi tekrar gönderir. Bildirim olmadan sipariş yalnızca müşteri ödeme yaptıktan sonra mağazaya döndüğünde onaylanır.

Gelişmiş

Logging: Enable logging, GoPay olaylarını WooCommerce > Status > Logs konumuna wcp_gopay_gateway kaynağıyla yazar. Hatalar her zaman günlüğe kaydedilir. Kimlik bilgileri, jetonlar, kart verileri ve müşterinin e-posta adresi, telefonu ve adresi hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Delete Data on Uninstall: Delete plugin settings, cached access tokens and log files when uninstalled. Açık olduğunda eklenti silinince ağ geçidi ayarları, önbelleğe alınmış GoPay erişim jetonları ve günlükler silinir. Varsayılan: kapalı.

Ödeme sayfası

Müşteri ödeme yöntemini (varsayılan olarak GoPay) seçer ve sipariş verir. Eklenti; sipariş kalemleri, kargo ve ücretler dâhil, sipariş para birimindeki toplam tutar için GoPay ödemesi oluşturur ve müşteriyi GoPay ödeme sayfasına gönderir. GoPay burada hesabınızda etkinleştirilmiş ödeme kartları, Apple Pay, Google Pay ve banka havaleleri gibi ödeme yöntemlerini sunar. Müşterinin fatura adı, e-posta adresi, telefonu ve adresi GoPay'e iletilir; boş alanlar gönderilmez. GoPay'de ödeme, Order ve sipariş numarasıyla gösterilir.

Ödemeden sonra müşteri mağazanıza döner. Sipariş yalnızca GoPay onayladıktan sonra ödenmiş olarak işaretlenir: bildirimle veya müşteri döndüğünde GoPay API'sine yapılan sorguyla. Bildirim ve dönüş aynı anda gelirse sırayla işlenir; böylece sipariş hiçbir zaman iki kez tamamlanmaz. Ödeme onaylandığında müşteri sipariş alındı sayfasına yönlendirilir.

Ödeme tamamlanmadıysa, iptal edildiyse veya süresi dolduysa müşteri Pay for order sayfasına yönlendirilir ve The GoPay payment was not completed. You can try again or choose another payment method. ya da The GoPay payment was cancelled or has expired. You can try again or choose another payment method. mesajını görür. Müşteri bu sayfadan ödenmemiş bir sipariş için yeniden ödeme yapabilir. Zaten ödenmiş bir sipariş için ikinci bir GoPay ödemesi oluşturulmaz.

GoPay ödemeyi başlatamazsa müşteri kısa bir mesaj görür; örneğin GoPay could not accept the payment details. Please check your billing details (e-mail, phone, address) or choose another payment method. ya da GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. Teknik neden sipariş notlarına eklenir.

Ödeme yöntemi klasik ödeme sayfasında, Cart ve Checkout bloklarında ve Pay for order sayfasında çalışır. Test modunda Checkout bloğu Sandbox mode: no real payment will be made. mesajını gösterir. WooCommerce High-Performance Order Storage (HPOS) ile uyumludur.

Müşteri ödeme yöntemini GoPay sayfasında seçer; WooCommerce'de seçemez. Eklenti abonelikleri veya yinelenen ödemeleri, kayıtlı kartları, gömülü ödeme formunu ya da WooCommerce'den ön provizyon tahsilatı veya iptalini desteklemez.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri GoPay'e yönlendirildi ve henüz ödeme yapmadı ya da GoPay ödemeyi henüz onaylamadı.

Processing or Completed: ödeme onaylandı. Durum, Order Status After Payment ayarına göre belirlenir. Sipariş notunda GoPay ödeme kimliği ve ödeme aracı gösterilir. İşlem kimliği, GoPay ödeme kimliğidir.

On hold: GoPay ödemeyi onayladı ancak tutar veya para birimi siparişten farklı; ya da ödeme sipariş iptal edildikten sonra geldi; ya da ödeme yalnızca ön provizyon olarak alındı ve henüz tahsil edilmedi. Nedeni sipariş notunda açıklanır. Ön provizyon GoPay'de tahsil edilmeli, ardından siparişi manuel olarak tamamlamalısınız.

Failed: ödenmemiş bir sipariş için yapılan son GoPay ödemesi iptal edildi veya süresi doldu.

Refunded: siparişin GoPay ödemesi tamamen iade edildi; örneğin GoPay hesabından.

Zaten ödenmiş bir siparişin başka bir ödeme denemesi de ödenirse sipariş değişmez. Bir not, kopya ödemeyi GoPay hesabından iade etmenizi ister. GoPay ile yapılmayan, örneğin elle ödenmiş olarak işaretlenen bir sipariş için GoPay ödemesi yapılırsa benzer bir not eklenir. İptal ettiğiniz veya iade ettiğiniz ödenmiş bir sipariş daha sonraki bir bildirimle yeniden açılmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via GoPay düğmesine tıklayın. Tam ve kısmi iadeler desteklenir. GoPay kısmi iadeleri yalnızca ödemenin üzerinden 24 saat geçtikten sonra kabul eder. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu nedenle ilgili modun kimlik bilgileri ayarlanmış olmalıdır. GoPay iadeyi reddederse WooCommerce GoPay'in mesajını gösterir ve iade kaydedilmez. Başarılı iade sipariş notlarına eklenir. GoPay'in daha sonra işleme almak üzere kabul ettiği iade de kabul edildi olarak not edilir.

GoPay hesabından yapılan iadeler bildirimle gelir. Tam iade sipariş durumunu “İade edildi” olarak değiştirir; kısmi iade not ekler. Bunlar WooCommerce iadeleri olarak otomatik kaydedilmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü WooCommerce > Settings > Payments > GoPay sayfasının üst kısmındadır. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölümde lisansın etkin olduğu son tarih ve alan adınız gibi durum bilgileri gösterilir. Durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key, anahtarı bu siteden kaldırmak için Remove key seçeneğini kullanın. Manage licenses and domains in your account bağlantısı vibefox.net hesabınızı açar.

Bir anahtar tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak o alan adı yuvasını boşaltmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin lisans anahtarı yoksa GoPay 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. Oturum açmış mağaza yöneticileri, eklentiyi anahtar satın almadan önce kurup test edebilmeniz için ödeme yöntemini (unlicensed — visible to admins only) olarak işaretlenmiş şekilde görmeye devam eder. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Lisansın süresi dolduğunda eklenti çalışmaya devam eder; ancak güncellemeler ve destek için lisans yenilenmelidir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

GoPay ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda GoID, Client ID ve Client Secret bilgilerinin bulunduğunu ve para biriminin CZK, EUR, PLN, USD, GBP, HUF, RON veya BGN olduğunu kontrol edin. Pay for order sayfasında siparişin para birimi geçerlidir. Kimlik bilgileri veya para birimi hatalıysa ayarlar sayfasında uyarı görünür.

Ödeme yapıldı ancak sipariş Pending payment durumunda kaldı: GoPay ayarlarda gösterilen bildirim URL'sine ulaşamadı ve müşteri mağazaya dönmedi. URL'yi engelleyen parola korumasını, bakım modunu veya güvenlik duvarı kurallarını kaldırın. Her bildirim bu bilgilerle doğrulandığından ödemenin yapıldığı modun kimlik bilgilerinin ayarlandığını kontrol edin. WooCommerce > Status > Logs konumundaki wcp_gopay_gateway kaynağına bakın. Başarılı yanıt alamayan bildirimler GoPay tarafından yeniden gönderilir.

Bildirim “Order not found” yanıtını veriyor: ödeme bu mağaza tarafından oluşturulmamış veya sipariş silinmiş.

Bildirim “Payment state could not be verified” yanıtını veriyor: GoPay API'sine erişilemiyor veya bu modun kimlik bilgileri yanlış. GoPay bildirimi tekrar gönderir.

Müşteri sipariş verirken hata görüyor: sipariş notlarını açın veya Logging seçeneğini etkinleştirin. Notta GoPay hatası görünür. Genellikle yanlış kimlik bilgileri veya diğer modun kimlik bilgileri neden olur. Fatura bilgileriyle ilgili mesaj, GoPay'in e-posta adresini, telefonu veya adresi kabul etmediği anlamına gelir.

Test ödemeleri canlı siparişi onaylamıyor: test ve canlı ortamlar birbirinden ayrıdır. Her ödeme oluşturulduğu modda kontrol edilir. Test Mode seçeneğini istediğiniz moda ayarlayın ve o modun kimlik bilgilerini kullanın.

Ödemeden sonra sipariş On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı, ödeme sipariş iptal edildikten sonra geldi ya da ödeme yalnızca ön provizyon olarak alındı.

İade başarısız: GoPay mesajını okuyun. Kısmi iade yalnızca ödemenin üzerinden 24 saat geçtikten sonra mümkündür. Modla ilgili bir mesaj, ödemenin test veya canlı modda yapıldığı ve bu modun kimlik bilgilerinin ayarlanmadığı anlamına gelir.

Lisans bölümü hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında kullanılıyorsa vibefox.net hesabınızdan bir yuvayı boşaltın ve Check now seçeneğine tıklayın. Site adresi değiştiyse yeni alan adı için anahtarı etkinleştirmek üzere Check now seçeneğine tıklayın. Lisans sunucusuna erişilemiyorsa eklenti bilinen son durumla çalışmaya devam eder.

Geliştiriciler için: gopay_p_payment_payload filtresi ödeme isteğini, gopay_p_icon filtresi ödeme yöntemi simgesini değiştirir.

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ı, önbelleğe alınmış erişim jetonları ve günlükler yalnızca Delete Data on Uninstall açıkken kaldırılır. Aksi takdirde daha sonraki bir yeniden kurulum için saklanırlar. Siparişlerde saklanan GoPay ödeme kimlikleri her zaman korunur. Mevcut siparişlerde ödeme notları ve işlem kimlikleri tutulur.

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