VibeFox Yoco for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

Mağaza para birimi: Güney Afrika randı (ZAR), System > Localisation > Currencies bölümünde etkin bir para birimi olmalıdır. Yoco yalnızca ZAR kabul eder. Müşteri başka bir para biriminde ödeme yaptığında ödeme yöntemi ödeme sayfasında gizlenir. Sipariş toplamı en az R2.00 olmalıdır.

Yoco hesabı: çevrim içi ödemeleri olan bir Yoco hesabı. Gizli anahtarlarına ihtiyacınız var; bunları Yoco Business Portal'da Selling Online > Payment Gateway altında bulursunuz. Yalnızca gizli anahtarlar girilir. Webhook eklenti tarafından kaydedilir ve imza gizli anahtarı sizin için doldurulur.

Herkese açık site: Yoco mağazanıza webhook gönderir, bu nedenle internetten erişilebilir olmalıdır.

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

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_yoco_pay-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_yoco_pay.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_yoco_pay-oc3-(version).ocmod.zip dosyasını seçin. Eklentinin OCMOD değişikliği yoktur, bu yüzden Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine bu paketteki upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Yoco Pay Gateway eklentisini bulun ve Install düğmesine (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme eklentilerinin listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem düğmesi) tıklayın. Sayfanın üst kısmındaki lisans bloğunda License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. License key).

4. Test gizli anahtarınızı (sk_test_...) ve hazır olduğunuzda canlı gizli anahtarınızı (sk_live_...) yapıştırın. Save düğmesine tıklayın. Webhook, anahtarı bulunan her mod için kaydedilir.

5. Enable/Disable seçeneğini açın ve Save düğmesine tıklayın. Test mode açıkken bir Yoco test kartıyla test ödemesi yapın, ardından gerçek ödemeleri kabul etmek için Test mode seçeneğini kapatın.

OpenCart 4

1. Yönetim panelinde Extensions > Installer bölümüne gidin, Upload düğmesine tıklayın ve wcp_yoco_pay.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklenti kodunu dosya adından alır ve yeniden adlandırılmış paket çalışmaz.

2. Paket, aynı sayfada kurulu eklentilerin listesinde görünür. Yanındaki Install düğmesine (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve türü Payments olarak seçin. VibeFox Yoco Pay Gateway eklentisini bulun, Install düğmesine (yeşil + düğmesi) ve ardından Edit düğmesine (kalem düğmesi) tıklayın.

4. Lisans anahtarını ve Yoco anahtarlarını OpenCart 3 için 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca webhook URL'si farklıdır (bkz. Webhook'lar); kaydedildiğinde Yoco'ya aynı şekilde kaydedilir.

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar eklenti sayfasındadır: Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Eklentiyi değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Sayfa, ayarların üzerinde etkin modu gösterir (Test mode: the test secret key is used, no real money is charged. veya Live mode: real payments are accepted.). Mağazanın varsayılan para birimi ZAR değilse uyarır (bu durumda Yoco yalnızca müşteri ZAR ile ödeme yaptığında sunulur; hiçbir ZAR para birimi etkin değilse hiç sunulmaz) ve geçerli modda gizli anahtar yoksa uyarır; örneğin Enter the test secret key to offer Yoco at checkout (test mode).

Kaydederken Title en fazla 128 karakter olabilir, Sort Order tam sayı olmalıdır (negatif değerlere izin verilir), Total 0 veya daha büyük bir sayı olmalıdır ve coğrafi bölge ile sipariş durumları mevcut olmalıdır. Aksi takdirde hiçbir şey kaydedilmez ve sayfa alanı belirtir. Ardından eklenti anahtarları ve webhook gizli anahtarlarını kontrol eder ve webhook'ları kaydeder. Bununla ilgili mesajlar ayarların üzerinde görünür.

Yoco

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

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Card or Instant EFT (Yoco). En fazla 128 karakter; boşsa müşteriler Card or Instant EFT (Yoco) görür.

Description: müşteriye Confirm Order adımında, onay düğmesinin üstünde gösterilen metin. Varsayılan: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

Sort Order: Yoco'nun ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın ya da tam sayı girin.

Geo Zone: Yoco'yu yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunar. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Yoco sunulmadan önce bir siparişin ulaşması gereken, mağazanın varsayılan para birimindeki ödeme sayfası toplamı. Her toplam için Yoco sunmak üzere boş bırakın. Yoco'nun kendisi her zaman en az R2.00 ister.

API anahtarları

Gizli anahtarları Yoco Business Portal'da Selling Online > Payment Gateway altından kopyalayın (bölümde bu sayfaya bağlantılar vardır). Yoco'nun her iki mod için tek bir API'si vardır: bir ödemenin test mi yoksa gerçek mi olduğunu anahtar belirler. Test modu yalnızca test anahtarını, canlı mod yalnızca canlı anahtarı kullanır.

Test mode: test gizli anahtarını kullanır. Gerçek para tahsil edilmez; Yoco test kartlarıyla ödeme yapın. Varsayılan: on. Gerçek ödemeleri kabul etmek için kapatın. Açıkken müşteriler Confirm Order adımında Test mode — use a Yoco test card; no real money is charged. ifadesini görür.

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, örneğin Yoco: the test secret key must start with sk_test_ — the previous value was kept. Diğer ayarlar kaydedilir. Yoco, webhook kaydı sırasında bir anahtarın diğer moda ait olduğunu bildirirse sayfa bunu size söyler.

Kaydedilmiş anahtarlar ve gizli değerler bir daha asla gösterilmez. Alan boş kalır ve Saved — leave empty to keep it. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kayıtlı bir değeri kaldırmak için alanın altındaki Clear the saved value kutusunu işaretleyin ve Save düğmesine tıklayın.

Webhook'lar

Yoco, ödemeleri ve iadeleri bu bölümdeki Webhook URL alanında gösterilen adrese bildirir. Adres, OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_yoco_pay/webhook, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_yoco_pay/payment/wcp_yoco_pay.webhook. OpenCart kurulumunuzun vitrin adresinden oluşturulur. Webhook'u Yoco portalında oluşturmanız gerekmez. Ayarları kaydettiğinizde eklenti, gizli anahtarı olan ama webhook gizli anahtarı olmayan her mod için URL'yi Yoco'ya kaydeder ve imza gizli anahtarı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şirse eski kayıt kaldırılır.

Her mod için (Test ve Live) bölüm webhook'un durumunu gösterir:

Eklenti bu olayları işler (bunlar da bu bölümde listelenir):

Geçerli imzası olmayan webhook'lar reddedilir. Bir olay, ödemenin yapıldığı modun gizli anahtarıyla imzalanmış olmalıdır; bu nedenle bir test gizli anahtarı hiçbir zaman gerçek bir ödemeyi onaylamaz.

Test webhook secret: webhook kaydedildiğinde otomatik doldurulur. Bir gizli değeri (whsec_...) yalnızca webhook URL'sini kendiniz kaydettiyseniz yapıştırın.

Live webhook secret: webhook kaydedildiğinde otomatik doldurulur. Webhook'u yeniden kaydetmek için temizleyin ve kaydedin.

Bir webhook gizli değeri whsec_ ile başlayan ve ardından base64 metin gelen bir biçimde olmalıdır. Başka herhangi bir değer kaydedilmez ve önceki değer korunur. Bir webhook gizli değerini temizleyip kaydetmek webhook'u yeniden kaydeder.

Siparişler

OpenCart siparişi Confirm Order adımında durumsuz olarak oluşturur (eksik sipariş). Sipariş, ancak Yoco ödemeyi API üzerinden onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Paid Order Status: onaylanmış bir ödemeden sonraki durum. Varsayılan: Processing.

On Hold Status: sipariş toplamıyla eşleşmeyen bir tutar veya para birimiyle yapılan bir ödeme, siparişi bir notla birlikte bu duruma alır. Doğru tutarlı sonraki bir ödeme bunu kapatır. Varsayılan: Pending, çünkü OpenCart'ta On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup burada seçebilirsiniz.

Refunded Status: iadeler ödenen tutara ulaştığında ayarlanır. Varsayılan: Refunded.

Gelişmiş

Debug log: Yoco isteklerini ve webhook'ları OpenCart günlükleri klasöründeki (storage/logs, OpenCart 4'te system/storage/logs) yoco_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında yoco_p_debug.old.log.php olarak taşınır. Yoco'ya yapılan başarısız istekler ve reddedilen webhook'lar gibi hatalar ve uyarılar her zaman kaydedilir. Gizli anahtarlar, webhook gizli değerleri ve e-posta adresleri gizlenir. 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: açıksa eklentiyi kaldırmak ağ geçidi ayarlarını, günlüğü ve eklentinin Yoco'da kaydettiği webhook'ları siler. Sipariş verileri (Yoco ödeme sayfası ve ödeme kimlikleri, iadeler) her zaman saklanır, çünkü iadeler için gereklidir. Varsayılan: off.

İçe / dışa aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. Gizli anahtarlar ve webhook gizli değerleri dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesine tıklayın. Kayıtlı gizli değerler korunur ve bir içe aktarma ile hiçbir webhook kaydedilmez.

Ödeme sayfası

Müşteri ZAR ile ödeme yaptığında ve sipariş toplamı en az R2.00 olduğunda ödeme yöntemi gösterilir. Müşteri bunu Payment Method adımında seçer (varsayılan olarak Card or Instant EFT (Yoco)). Confirm Order adımında müşteri açıklamanızı görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve sayfanın altındaki Confirm Order düğmesine tıklar. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş toplamı için kuruş cinsinden bir Yoco ödeme sayfası oluşturur ve müşteriyi Yoco ödeme sayfasına gönderir; müşteri orada kartla veya Instant EFT ile öder.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Yoco onayladığında ödenmiş olarak işaretlenir: eklenti, müşteri döndüğünde ve imzalı webhook geldiğinde Yoco'dan ödeme sayfasını ister. Sipariş ardından OpenCart'ın standart yöntemiyle, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarı sayfasını Your payment with Yoco has been received. ifadesiyle görür. Müşteri döndüğünde Yoco ödemeyi henüz onaylamadıysa, bir Payment confirmation sayfası We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. ifadesini, Check again ve Back to checkout düğmeleriyle birlikte gösterir; webhook gelir gelmez sipariş durumunu ayarlar. OpenCart 4'te müşteri Yoco sayfasından döndüğünde, kısa bir ara sayfa dönüş adresini mağazanızdan yeniden açar; böylece sepet ve müşteri girişi korunur.

Müşteri Yoco sayfasında iptal ederse, The Yoco payment was cancelled. Your cart is saved — you can pay again or choose another payment method. mesajıyla ödeme sayfasına döner. Ö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. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir.

OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise ödeme sırasındaki siparişi günceller. Yeni bir ödemeden önce eklenti sepeti kontrol eder: aynı sepetin başka bir siparişi zaten ödenmişse, müşteri doğrudan başarı sayfasına gider. Bu siparişin ve son 24 saatteki sepetin ödenmemiş Yoco ödeme sayfaları önce Yoco'da kontrol edilir; bunlardan biri bu sırada ödenmişse, yeni bir ödeme yerine o ödeme onaylanır. Aynı siparişin açık ödeme sayfası aynı tutar ve moddaysa ve 30 dakikadan kısa süre önce oluşturulmuşsa, müşteri aynı Yoco sayfasını yeniden alır. Aksi takdirde yeni bir Yoco ödeme sayfası oluşturulur. Sepetteki bir değişiklik, bu arada yeni adet de dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sırasında tutar; bu nedenle iptal edilmiş veya başarısız bir ödemeden sonra müşteri aynı siparişi yeniden öder. Sipariş ödeme yapılmadan kapatılmışsa (örneğin siz iptal ettiyseniz), müşteri Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order. mesajıyla ödeme adımına geri gönderilir ve bir sonraki Confirm Order yeni bir siparişi öder.

Yoco ödemeyi başlatamazsa müşteri, düğmenin üstünde Yoco could not start the payment. Please try again in a moment or choose another payment method. mesajıyla Confirm Order adımında kalır ve neden günlüğe ve sipariş notlarına yazılır. R2.00'in altındaki bir sipariş Yoco requires an order total of at least R2.00. mesajını alır.

Mağaza bakım modundayken de webhook çalışır, çünkü OpenCart ödeme eklentisi isteklerine izin verir. OpenCart 4'te eklentinin bir başlangıç eylemi webhook'u ve müşterinin dönüşünü geçirir.

Ödemeler Yoco sayfasında anında tahsil edilir. Eklentinin kayıtlı kartı, aboneliği veya tekrarlayan ödemesi, mağazada kart formu, ayrı yetkilendirme ve tahsilat yoktur ve ZAR dışındaki para birimleriyle çalışmaz.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Yoco'ya gönderildi ve ödeme yapmadı, Yoco sayfasında iptal etti ya da Yoco ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir. OpenCart 4.1'de bu tür bir siparişe, onay adımı yeniden gösterildiğinde OpenCart'ın atadığı Voided durumu da verilebilir; eklenti bunu durumsuz bir sipariş olarak değerlendirir.

Paid Order Status (varsayılan Processing): ödeme onaylandı. Bir not tutarı, Yoco ödeme ve ödeme sayfası kimliklerini, modu ve ödemenin nasıl onaylandığını gösterir (müşterinin dönüşü, webhook veya yeni bir ödeme denemesinden önceki kontrol).

On Hold Status (varsayılan Pending): Yoco, sipariş toplamından farklı bir tutar veya para birimi bildirdi; örneğin ödeme başladıktan sonra sepet başka bir sekmede değiştirildi. Not bunu açıklar ve müşteri We received your payment and are reviewing it. We will contact you if anything else is needed. ifadesini görür. Göndermeden önce ödemeyi kontrol edin. Müşteri daha sonra başka bir denemeyle doğru tutarı öderse, sipariş Paid Order Status durumuna geçer.

Refunded Status (varsayılan Refunded): iadeler ödenen tutara ulaştı.

İptal edilmiş veya iade edilmiş gibi başka bir durumdaki bir sipariş için ödeme gelirse, sipariş değiştirilmez. Bir not, ödemeyi Yoco portalında iade etmenizi veya siparişi elle geri yüklemenizi ister. Müşteri Your payment was received after the order had been cancelled. Please contact us — do not pay again. ifadesini görür.

Zaten ödenmiş bir sipariş için veya zaten ödenmiş bir sepetin başka bir siparişi için ikinci bir ödeme gelirse, sipariş değiştirilmez. Ödenmiş siparişteki bir not, bunu Yoco portalında iade etmenizi ister.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır. Yoco kelimesiyle başlarlar.

VibeFox Yoco Pay Gateway sekmesi

Sales > Orders bölümünde Yoco ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında VibeFox Yoco Pay Gateway sekmesi Checkout ID, Payment ID, Mode (test ödemeleri için Test etiketiyle), ödemenin Status bilgisini, Paid / refunded tutarlarını, iade formunu, Yoco checkouts of this order tablosunu, Refunds geçmişini ve siparişin Yoco notes bölümünü gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

VibeFox Yoco Pay Gateway sekmesinde Amount girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir Reason (optional) ekleyin ve Refund via Yoco düğmesine tıklayın. Refund this amount through Yoco? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme izniniz olmalıdır (System > Users > User Groups bölümünde ayarlanır). İadeler, Yoco'nun tahsil ettiği tutardan hesaplanır; bu nedenle siparişte sonradan değişiklik yapılmış olsa bile müşterinin gerçekten ödediğinden fazlasını iade edemezsiniz. İade, ödemenin yapıldığı modda (test veya canlı) gönderilir; bu nedenle o modun gizli anahtarı ayarlanmış olmalıdır. Yanıt kaybolduktan sonra tekrarlanan bir iade iki kez ödenmez.

Başarılı bir iade, iade geçmişine ve Yoco iade kimliğiyle birlikte notlara eklenir. İadeler ödenen tutara ulaştığında sipariş, müşteriye bildirilmeden ve ürünler stoğa geri alınmadan Refunded Status alır; kısmi bir iade durumu değiştirmez. Yoco iadeyi reddederse sekme nedenle birlikte Yoco refused the refund: gösterir ve hiçbir iade kaydedilmez. Yoco iadeyi bekleyen olarak bildirirse sekme bunu belirtir. Tekrarlamayın: Yoco onaylayıp webhook gönderdiğinde kaydedilecektir. İadeler, Yoco ödeme sayfasıyla ödenmiş siparişler için kullanılabilir. On Hold Status durumundaki bir siparişin iade edilecek onaylı bir ödemesi yoktur; onu Yoco portalında iade edin.

Sales > Returns bölümündeki ürün iadeleri Yoco üzerinden para geri göndermez.

Yoco portalında yapılan iadeler refund.succeeded webhook'u ile gelir ve iade geçmişine ve notlara kaydedilir. Ödenen tutara ulaştıklarında sipariş Refunded Status alır. Geri ödenebilecek tutarı aşan bir iade kaydedilmez ve bir not siparişi kontrol etmenizi ister. Başarısız bir iade, paranın müşteriye geri verilmediğini belirten bir not ekler.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Yoco Pay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit sayfasında, ayarların üstündeki ilk bloktur. Anahtarı License key alanına girip Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu son tarihi 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. Altında Product: opencart-payment-yoco 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 eklenti için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloktaki metinler yönetici paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar geçersiz bulunursa blok nedenini gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ardından bir tarih. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvasını serbest bıraktıktan sonra Check now düğmesine tıklayın. Lisans sunucusuna ulaşılamazsa eklenti son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar olmadan Yoco ödeme sayfasında müşterilere gösterilmez. Bir ödeme yine de başlatılırsa müşteri This payment method is not available. Please choose another one. mesajını görür. Yönetim paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini yine de mağazada (unlicensed — visible to admins only) işaretiyle görür; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu ön izleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkesten gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard sayfasında bir hatırlatma görünür. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Lisans sona erdiğinde eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard sayfasını veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, ardından haftada bir kez. Cron işi gerekmez. Eklentiyi kaldırmak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Yoco ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modda bir gizli anahtar bulunduğunu (test modunda Test secret key, canlı modda Live secret key) kontrol edin. Müşteri ZAR ile ödeme yapmalıdır ve sipariş toplamı en az R2.00 olmalıdır. Anahtar eksikse veya mağaza para birimi ZAR değilse ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

Ödeme yapıldı ama sipariş durumsuz 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 ya da başka bir URL için kayıtlıysa ayarları kaydedin. Kayıt başarısız olursa sayfa nedenini gösterir. Gizli değeri kendiniz girdiyseniz, bunun bu URL'nin ve bu modun webhook'una ait olduğunu kontrol edin. Sipariş, müşteri ödemeden sonra mağazaya döndüğünde ve müşteri tekrar ödeme yapmayı denediğinde de bir durum alır.

Webhook kaydedilemedi: müşteriler mağazaya döndüğünde ödemeler yine onaylanır. Mesajda gösterilen nedeni düzeltin, örneğin mağazanın internetten erişilebilir olması gerektiğini, ve tekrar kaydedin. URL'yi kendiniz de kaydedebilir ve imza gizli değerini yapıştırabilirsiniz.

Webhook'lar reddediliyor: reddedilen webhook'lar günlüğe yazılır. webhook secret not configured hiçbir webhook gizli değerinin ayarlanmadığı anlamına gelir. invalid signature gizli değerin 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 saatinden 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.

Webhook URL'si tarayıcıda yalnızca POST gösteriyor: bu normaldir. URL yalnızca Yoco'dan gelen istekleri kabul eder.

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

Müşteri Confirm Order sonrasında bir hata görüyor: eklenti sayfasındaki Log alanına bakın. Yoco is not available at the moment. Please choose another payment method. geçerli modda gizli anahtar olmadığı anlamına gelir.

Müşteriye bir ödemenin incelenmesi gerektiği söyleniyor: bir deneme farklı bir tutarla ya da siparişin iptal edilmesinden sonra ödenmiş. VibeFox Yoco Pay Gateway sekmesindeki notları okuyun ve siparişi yerine getirin 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ı ayarlanmamış. Girin ve tekrar deneyin.

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

Geliştiriciler için: Yoco ödeme sayfası oluşturulmadan önce eklenti, başka bir eklentinin isteğe ekleme yapabilmesi için istek verileri ve siparişle birlikte OpenCart olayı yoco_p_checkout_payload'ı tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox Yoco Pay Gateway yanındaki Uninstall düğmesine (kırmızı − düğmesi) tıklayın. Eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılanlarına döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda webhook ile müşterinin dönüşünü geçiren başlangıç eylemi de kaldırılır). Delete data açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, anahtarlar, webhook gizli değerleri, günlük kaydı), günlük ve eklentinin Yoco'da kaydettiği webhook'lar kaldırılır. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Yoco ödeme sayfaları ve iadeleri her zaman saklanır; bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te dosyalarını da kaldırmak için, kaldırma işleminden sonra Extensions > Installer sayfasına gidin, kurulu eklentiler listesinde VibeFox Yoco Pay Gateway yanındaki Uninstall düğmesine (turuncu − düğmesi) tıklayın, ardından yüklenen paketi kaldırmak için Delete düğmesine (kırmızı çöp kutusu düğmesi) tıklayın.

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