VibeFox Yoco for WooCommerce — Yardım

Gereksinimler

WordPress: 6.2 veya üzeri.

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

PHP: 8.0 veya üzeri.

Mağaza para birimi: Güney Afrika randı (ZAR). Yoco yalnızca ZAR kabul eder. Başka bir para biriminde ödeme yöntemi ödeme sayfasında gösterilmez. Sipariş tutarı en az R2,00 olmalıdır.

Yoco hesabı: çevrimiçi ödemeleri olan bir Yoco hesabı. Yoco Business Portal'daki Selling Online > Payment Gateway bölümünde bulacağınız gizli anahtarlarına ihtiyacınız var. Yalnızca gizli anahtarlar girilir. Webhook eklenti tarafından kaydedilir ve imza sırrı sizin için doldurulur.

Herkese açık site: Yoco webhook'ları sitenize gönderir, bu yüzden internetten erişilebilir olmalıdır. Webhook URL'si, yönlendirme olmadan bir POST isteğini kabul etmelidir.

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 izleyin, eklenti ZIP dosyasını seçin ve Install Now düğmesine tıklayın. Ayrıca wcp_yoco_pay 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 > Yoco > Manage.

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

5. Test gizli anahtarını (sk_test_...) ve hazır olduğunuzda canlı gizli anahtarı (sk_live_...) yapıştırın. Ayarları kaydedin. Webhook, anahtarı olan her mod için kaydedilir.

6. Enable/Disable seçeneğini açın. Test mode açıkken bir Yoco test kartıyla deneme ödemesi yapın, ardından gerçek ödemeleri almak için Test mode seçeneğinin işaretini kaldırın.

Yapılandırma

Tüm ayarlar tek bir sayfadadır: WooCommerce > Settings > Payments > Yoco. Alanların üstünde sayfa, mağaza para birimi ZAR değilse (bu durumda Yoco ödeme sayfasında sunulmaz) ve mevcut modda gizli anahtar yoksa uyarır. Ödeme yöntemleri listesinde, mevcut modda gizli anahtar olana kadar Yoco kurulum gerektiren olarak işaretlenir. Kaydettiğinizde eklenti anahtarları ve webhook sırlarını kontrol eder ve webhook'ları kaydeder. Bununla ilgili mesajlar sayfanın üstünde görünür.

Genel

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Varsayılan: Card or Instant EFT (Yoco).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

API anahtarları

Gizli anahtarları Yoco Business Portal'da Selling Online > Payment Gateway bölümünden kopyalayın. Yoco her iki mod için tek bir API kullanır: ödemenin test mi gerçek mi olduğunu anahtar belirler. Test modu yalnızca test anahtarını, canlı mod yalnızca canlı anahtarı kullanır.

Test mode: Use the test secret key (no real payments). Gerçek para çekilmez; Yoco test kartlarıyla ödeme yapın. Varsayılan: on. Gerçek ödemeleri almak için işaretini kaldırın.

Test secret key: test modunun gizli anahtarı. sk_test_ ile başlar.

Live secret key: canlı modun gizli anahtarı. sk_live_ ile başlar.

Beklenen önekle başlamayan bir anahtar kaydedilmez: sayfa bir hata gösterir ve önceki değeri korur. Webhook kaydı sırasında Yoco bir anahtarın diğer moda ait olduğunu bildirirse sayfa bunu size söyler.

Webhook'lar

Yoco, ödemeleri ve iadeleri bu bölümde gösterilen webhook URL'sine bildirir. URL şöyle görünür: https://your-site/wc-api/yoco_pay_webhook/. Yoco portalında webhook oluşturmanız gerekmez. Ayarları kaydettiğinizde eklenti, gizli anahtarı olan ama webhook sırrı olmayan her mod için URL'yi Yoco'ya kaydeder ve imza sırrını o modun alanına yazar. Bu modun gizli anahtarı veya webhook URL'si değiştiğinde URL'yi yeniden kaydeder. URL değiştiğinde eski kayıt kaldırılır.

Her mod için bölüm webhook'un durumunu gösterir:

Eklenti şu olayları yönetir:

Geçerli imzası olmayan webhook'lar reddedilir. Sitenizde URL'lerde dil öneki kullanıyorsanız, URL'yi ayarların gösterdiği gibi aynen tutun; çünkü webhook'un yönlendirme olmadan mağazanıza ulaşması gerekir.

Test webhook secret: webhook kaydedildiğinde otomatik doldurulur. Yalnızca webhook URL'sini kendiniz kaydettiyseniz bir sır (whsec_...) yapıştırın.

Live webhook secret: webhook kaydedildiğinde otomatik doldurulur. Webhook'u yeniden kaydetmek için alanı boşaltıp kaydedin.

Bir webhook sırrı whsec_ ile başlamalı ve ardından base64 metin gelmelidir. Başka her değer kaydedilmez ve önceki değer korunur.

Gelişmiş

Debug log: Log Yoco requests and webhooks istekleri ve webhook'ları WooCommerce > Status > Logs altına, kaynak wcp_yoco_pay ile yazar. Hatalar ve uyarılar, örneğin Yoco'ya başarısız istekler ve reddedilen webhook'lar, her zaman günlüğe yazılır. Anahtarlar, webhook sırları ve e-posta adresleri maskelenir. Varsayılan: off.

Delete data: Delete the settings and logs of this plugin when it is deleted. Eklentiyi devre dışı bırakmak hiçbir şeyi silmez. Sipariş verileri (Yoco checkout ve ödeme kimlikleri) her zaman saklanır, çünkü iadeler için gereklidir. Varsayılan: off.

Ödeme

Müşteri ödeme yöntemini seçer (varsayılan olarak Card or Instant EFT (Yoco)) ve siparişi verir. Test modunda ödeme sayfası Test mode — use a Yoco test card; no real money is charged. gösterir. Eklenti, sipariş tutarı için kuruş cinsinden bir Yoco checkout'u oluşturur ve müşteriyi Yoco ödeme sayfasına gönderir; müşteri orada kartla veya Instant EFT ile öder.

Ödemeyi yaptıktan sonra müşteri mağazanıza döner. Sipariş yalnızca Yoco onayladıktan sonra ödenmiş olarak işaretlenir: eklenti müşteri döndüğünde ve imzalı webhook geldiğinde Yoco'dan checkout'u ister. Yoco ödemeyi henüz onaylamadıysa sipariş alındı sayfasında We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. yazar.

Müşteri Yoco sayfasında iptal ederse sipariş ödenmemiş kalır ve müşteri The Yoco payment was cancelled. Your order is saved — you can pay again below or choose another payment method. mesajıyla Pay for order sayfasına gelir. Ödeme başarısız olursa mesaj The Yoco payment was not successful. Please try again or choose another payment method. olur ve siparişe bir not eklenir.

Müşteri, ödenmemiş bir siparişi Pay for order sayfasından yeniden ödeyebilir. Yeni bir denemeden önce eklenti öncekini Yoco ile kontrol eder. Zaten ödenmişse, sipariş yeni bir ödeme sayfası gösterilmeden tamamlanır. Aynı tutar için hâlâ açıksa ve 30 dakikadan kısa süre önce oluşturulduysa, müşteri aynı Yoco sayfasını yeniden alır.

Yoco ödemeyi başlatamazsa müşteri Yoco could not start the payment. Please try again in a moment or choose another payment method. mesajını görür ve neden sipariş notlarına eklenir. R2,00'nin altındaki bir sipariş Yoco requires an order total of at least R2.00. mesajını alı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.

Ödemeler Yoco sayfasında hemen tahsil edilir. Eklentinin kayıtlı kartı, aboneliği veya yinelenen ödemesi, sitede kart formu ve ayrı yetkilendirme ile tahsilat özelliği yoktur ve ZAR dışındaki para birimlerinde çalışmaz.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Yoco'ya yönlendirildi ve henüz ödeme yapmadı, Yoco sayfasında iptal etti veya Yoco ödemeyi henüz onaylamadı.

Processing or Completed: ödeme onaylandı. WooCommerce, yalnızca indirilebilir sanal ürün içeren siparişler için İşleniyor veya Tamamlandı olarak ayarlar. Sipariş notu tutarı, Yoco ödeme ve checkout kimliklerini, modu ve ödemenin nasıl onaylandığını (müşterinin dönüşü, webhook veya yeni bir ödeme denemesinden önceki kontrol) gösterir. İşlem kimliği Yoco ödeme kimliğidir.

On hold: Yoco, ödeme başladıktan sonra sipariş düzenlendiği için gibi, sipariş toplamından farklı bir tutar veya para birimi bildirdi. Not bunu açıklar ve Yoco'dan dönen müşteri We received your payment and are reviewing it. We will contact you if anything else is needed. mesajını görür. Göndermeden önce ödemeyi kontrol edin.

Cancelled or Refunded: böyle bir siparişe gelen ödeme siparişi değiştirmez. Bir not, ödemeyi Yoco portalında iade etmenizi veya siparişi elle geri yüklemenizi ister. Yoco'dan dönen müşteri Your payment was received after the order had been cancelled. Please contact us — do not pay again. mesajını görür.

Zaten ödenmiş bir sipariş için ikinci bir ödeme gelirse sipariş yeniden değiştirilmez. Bir not, bunu Yoco portalında iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve ödeme yönteminizin adıyla birlikte Refund via düğmesine tıklayın (varsayılan olarak Card or Instant EFT (Yoco)). Tam ve kısmi iadeler desteklenir. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu yüzden o modun gizli anahtarı ayarlı olmalıdır. Yanıt alınamayan bir iade tekrarlandığında iki kez ödenmez.

Başarılı bir iade, Yoco iade kimliğiyle birlikte sipariş notlarına eklenir. Yoco iadeyi reddederse WooCommerce nedeniyle birlikte Yoco refused the refund: gösterir ve hiçbir iade kaydedilmez. Yoco iadeyi beklemede bildirirse WooCommerce hâlâ beklemede olduğunu gösterir ve hiçbir şey kaydetmez. Tekrarlamayın: Yoco webhook ile onayladığında siparişe eklenecektir.

Yoco portalında yapılan iadeler refund.succeeded webhook'u ile gelir ve ürünler stoğa geri alınmadan otomatik olarak WooCommerce iadesi olarak kaydedilir. İade edilebilir kalan tutardan büyük bir iade kaydedilmez ve bir not siparişi kontrol etmenizi ister. Başarısız bir iade, paranın müşteriye iade edilmediğini belirten bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bloğu WooCommerce > Settings > Payments > Yoco 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 aktif olduğu 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 tek bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Yoco, 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 ö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. Plugins sayfasında ve WooCommerce sayfalarında bir hatırlatma görünür. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler onaylanmaya devam eder ve iadeler çalışır.

Bir lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

Sorun giderme

Yoco ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve mevcut modda gizli anahtar bulunduğunu kontrol edin: test modunda Test secret key, canlı modda Live secret key. Mağaza veya sipariş para birimi ZAR olmalı ve sipariş toplamı en az R2,00 olmalıdır. Anahtar eksikse veya para birimi ZAR değilse ayarlar sayfası bir uyarı gösterir.

Ödeme yapıldı ama sipariş Pending payment kalıyor: webhook çalışmıyor. Ayarların Webhooks bölümünü açın ve kullandığınız modun durumunu kontrol edin. Kayıtlı değilse veya başka bir URL için kayıtlıysa ayarları kaydedin. Kayıt başarısız olursa sayfa nedenini gösterir. Sırrı kendiniz girdiyseniz, bunun bu URL ve mod için webhook'a ait olduğunu kontrol edin. Sipariş ayrıca müşteri ödemeden sonra mağazaya döndüğünde ve yeniden ödemeyi denediğinde de onaylanır.

Webhook kaydedilemedi: müşteriler mağazaya döndüğünde ödemeler yine de onaylanır. Mesajda gösterilen nedeni giderin; örneğin sitenin HTTPS üzerinden internetten erişilebilir olması gerekir ve tekrar kaydedin. URL'yi kendiniz kaydedip imza sırrını yapıştırabilirsiniz.

Webhook'lar reddediliyor: reddedilen webhook'lar wcp_yoco_pay kaynağıyla günlüğe yazılır. webhook secret not configured, hiçbir webhook sırrının ayarlanmadığı anlamına gelir. invalid signature, sırrın başka bir kayda veya moda ait olduğu anlamına gelir. timestamp outside the tolerance, sunucu saatinin yanlış olduğu anlamına gelir: imzalar sunucu zamanından 5 dakika içinde kabul edilir. checkout not completed yet — retry ve could not confirm the checkout with Yoco — retry geçicidir; Yoco webhook'u yeniden gönderir.

The secret key must start with sk_test_ / sk_live_ error on save: bir anahtar yanlış alana yapıştırılmış. Test anahtarı sk_test_, canlı anahtar sk_live_ ile başlar. Önceki değer korundu.

Müşteri sipariş verirken hata görüyor: sipariş notlarını veya WooCommerce > Status > Logs bölümünü, kaynak wcp_yoco_pay, okuyun. Yoco is not available at the moment. Please choose another payment method. mevcut modda gizli anahtar olmadığı anlamına gelir.

Müşteriye bir ödemenin incelenmesi gerektiği söyleniyor: önceki bir deneme farklı bir tutarla ya da sipariş iptal edildikten sonra ödenmiş. Sipariş notunu okuyun ve siparişi tamamlayın veya ödemeyi Yoco portalında iade edin.

İade, mod hakkında bir mesajla başarısız oluyor: ödeme test veya canlı modda yapıldı ve o modun gizli anahtarı ayarlı değil. Anahtarı girin ve yeniden deneyin.

İade, No answer from Yoco mesajıyla başarısız oluyor: WooCommerce'de hiçbir şey kaydedilmedi. Yoco iadeyi işlediyse aynı iadeyi tekrarlayın: iki kez iade edilmez.

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 yuva serbest bırakı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ı, Yoco'daki webhook kayıtları ve döndürülmüş günlük dosyaları dahil günlükler yalnızca Delete data açıksa kaldırılır. Aksi halde sonraki yeniden kurulum için kalır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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