VibeFox GoPay 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.

Para birimi: GoPay, CZK, EUR, PLN, USD, GBP, HUF, RON ve BGN kabul eder. Ödeme sayfasında başka bir para birimiyle ödeme yapılırsa ödeme yöntemi gizlenir.

GoPay hesabı: GoPay satıcı hesabınızın GoID, Client ID ve Client Secret bilgilerine ihtiyacınız vardır. Bunlar hesabın entegrasyon ayarlarındadır. Test (sandbox) hesabının kendi kimlik bilgileri vardır. Bildirimler için GoPay hesabında bir şey ayarlamanız gerekmez, ancak mağazanıza internetten erişilebiliyor 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_gopay_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_gopay_gateway.ocmod.zip bulunur. Yalnızca kullandığınız OpenCart sürümünün paketini kurun. Lisans anahtarı her 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_gopay_gateway-oc3-(version).ocmod.zip dosyasını seçin. Eklentide OCMOD değişikliği olmadığı için Extensions > Modifications bölümünü yenilemeniz gerekmez. Yükleyici yerine, bu paketin 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 GoPay Gateway öğesini bulun ve Install düğmesine (yeşil +) tıklayın. Yönetici kullanıcınızın ödeme eklentileri listesini değiştirme yetkisi olmalıdır.

3. Ayarlar sayfasını açmak için Edit düğmesine (kalem simgesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üstündeki lisans bloğunda License key alanına yapıştırın ve Activate düğmesine tıklayın (bkz. License key).

4. Sandbox GoID, Client ID ve Client Secret bilgilerini girin, Test Mode seçeneğini açık bırakın, Enable/Disable seçeneğini açın ve Save düğmesine tıklayın.

5. Bir test siparişi verin. Her şey çalıştığında canlı kimlik bilgilerini girin ve 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_gopay_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 eklentinin kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

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

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

4. Lisans anahtarını ve GoPay kimlik bilgilerini OpenCart 3'teki 3 ila 5. adımlarda olduğu gibi girin. Ayarlar sayfası ve alanları her iki sürümde aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Payment notifications).

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 GoPay Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üstünde sayfa Sandbox mode — test payments only veya Production mode — real payments gösterir. Geçerli modun GoID, Client ID veya Client Secret bilgisi eksikse ve GoPay mağazanın varsayılan para birimini kabul etmiyorsa uyarır. Kimlik bilgileri olmadan GoPay ödeme sayfasında sunulmaz; desteklenmeyen bir varsayılan para birimi varsa yalnızca desteklenen bir para birimine geçen müşterilere sunulur. Eklentiyi değiştirme yetkiniz yoksa sayfa ayarları gösterir ama kaydedemez.

Kaydederken geçersiz bir değere sahip alan önceki değerini korur ve sayfa bir hata gösterir; diğer alanlar kaydedilir. Bu durum; boş veya 128 karakterden uzun bir Title, 6 ila 20 rakamdan oluşmayan bir GoID, tam sayı olmayan bir Sort Order, 0 veya daha büyük bir sayı olmayan bir Total ve var olmayan bir coğrafi bölge veya sipariş durumu için geçerlidir. Kaydetme ayrıca önbelleğe alınmış GoPay erişim belirteçlerini temizler, böylece yeni kimlik bilgileri hemen kullanılır.

GoPay

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

Title: ödeme sayfasında görüntülenen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: GoPay. Zorunlu, en fazla 128 karakter.

Description: Confirm Order adımında, onay düğmesinin üstünde gösterilen ödeme yöntemi açıklaması. Varsayılan: Pay securely via GoPay - cards, wallets, bank transfers.

Sort Order: GoPay'in ödeme sayfasındaki ödeme yöntemleri arasındaki konumu. Boş bırakın veya bir tam sayı girin.

Geo Zone: GoPay'i 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: GoPay'in sunulması için siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası toplamı. Herhangi bir toplamda sunmak için boş bırakın.

API kimlik bilgileri

GoID, Client ID ve Client Secret, GoPay satıcı hesabınızda (entegrasyon ayarları) gösterilir. Test (sandbox) hesabının kendi kimlik bilgileri vardır. Bu bölüm GoPay API belgelerine bağlantı verir.

Test Mode: ödemeleri sandbox kimlik bilgileriyle gw.sandbox.gopay.com adresine gönderir. Gerçek para tahsil edilmez. Canlı kimlik bilgileriyle gerçek ödemeleri kabul etmek için kapatın. Varsayılan: açık.

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

Sandbox Client ID: sandbox hesabının OAuth Client ID'si.

Sandbox Client Secret: sandbox hesabının OAuth Client Secret'ı.

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

Production Client ID: GoPay'den alınan OAuth Client ID.

Production Client Secret: GoPay'den alınan OAuth Client Secret.

GoID yalnızca 6 ila 20 rakamdan oluşur, örneğin 8123456789. Başka bir şey girerseniz sayfa GoID must contain digits only, 6 to 20 digits (for example 8123456789). The previous value was kept. mesajını gösterir.

Kayıtlı client secret'lar 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.

Clear saved client secrets: işaretleyip Save düğmesine tıklayarak kayıtlı iki client secret'ı da kaldırın. Boş bir alan, kayıtlı değeri korur.

Ödeme

Payment Page Language: GoPay ödeme sayfasının dili. Varsayılan: Automatic (site language, then billing country). Otomatik modda mağaza dilinizi kullanılır; GoPay bu dili desteklemiyorsa fatura ülkesi belirleyici olur, aksi halde İngilizce kullanılır. 19 dilden birini de sabitleyebilirsiniz: Czech, English, Slovak, German, Polish, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Estonian, Latvian, Lithuanian, French, Italian, Spanish, Portuguese, Ukrainian veya Russian.

OpenCart siparişi Confirm Order adımında, durumsuz olarak oluşturur (eksik sipariş, missing order). Sipariş, GoPay ödemeyi bildirim veya müşterinin dönüşüyle onayladıktan sonra bir durum alır; durum her zaman GoPay API'sinden okunur. Aşağıdaki her durum alanı, OpenCart sipariş durumlarınızı listeler.

Order Status After Payment: ödeme onaylandığında ayarlanan sipariş durumu. Varsayılan: İşleniyor. Örneğin sanal ürünler için Tamamlandı seçin.

GoPay Payment On Hold Status: siparişle eşleşmeyen ödemeler, iptalden sonra gelen ödemeler ve yalnızca ön izinli ödemeler. Bir not nedenini açıklar; ödemeyi GoPay hesabınızda kontrol edin. Varsayılan: Beklemede, çünkü OpenCart'ın On hold durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturup buradan seçebilirsiniz.

Cancelled Order Status: bu durumdaki (veya iade edilmiş durumdaki) bir sipariş için gelen bir GoPay ödemesi, siparişi sessizce yeniden açmak yerine beklemeye alır. Varsayılan: İptal Edildi.

Refunded Status: ödeme sipariş sayfasından veya GoPay'in bildirmesiyle tam olarak iade edildikten sonra ayarlanır. Varsayılan: İade Edildi.

Ödeme bildirimleri

Bildirim, mağazanıza bir ödemenin yapıldığını bildirir. Notification URL bu bölümde gösterilir ve her ödemeyle birlikte GoPay'e gönderilir; bu nedenle GoPay hesabında bir şey ayarlamanız gerekmez. OpenCart 3'te şuna benzer: https://your-store/index.php?route=extension/payment/wcp_gopay_gateway/notify, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_gopay_gateway/payment/wcp_gopay_gateway.notify gibidir. Bu adres, OpenCart kurulumunuzun mağaza adresinden oluşturulur. İnternetten erişilebilir olmalıdır: önünde parola koruması veya güvenlik duvarı olmamalıdır. Mağaza bakım modundayken de çalışır: OpenCart 3 ödeme eklentisi isteklerini geçirir, OpenCart 4'te ise eklenti, bildirimin ve müşterinin GoPay'den dönüşünün geçmesini sağlayan bir başlangıç eylemi (startup action) ekler.

GoPay bildirimleri yalnızca ödeme kimliğini taşır ve imzası yoktur. Her bildirim, ödemenin yapıldığı modun kimlik bilgileriyle GoPay API'sinden ödeme durumu sorgulanarak doğrulanır; ödeme, eklentinin mağazanızdaki bir sipariş için oluşturduğu bir ödeme olmalıdır. Durum GoPay'den okunamazsa mağazanız bir hata ile yanıt verir ve GoPay bildirimi yeniden gönderir. Bildirim olmadan sipariş, yalnızca müşteri ödemeden sonra mağazaya döndüğünde bir durum alır.

Gelişmiş

Logging: GoPay olaylarını OpenCart günlük klasöründeki (storage/logs) gopay_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Hatalar ve uyarılar her zaman kaydedilir. Kimlik bilgileri, belirteçler, kart verileri ile müşterinin e-postası ve adı hiçbir zaman kaydedilmez. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son kayıtlarını gösterir. Boşaltmak için Clear log düğmesine tıklayın.

Delete Data on Uninstall: açıksa, eklentiyi kaldırmak ağ geçidi ayarlarını, önbelleğe alınmış GoPay erişim belirteçlerini ve günlüğü siler. Siparişler ve GoPay ödeme verileri her zaman korunur. Varsayılan: kapalı.

İçe / Dışa aktarma

Export: Download JSON ayarları bir JSON dosyasına kaydeder. Client secret'lar 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ı client secret'lar korunur.

Ödeme sayfası

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak GoPay). 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. Müşteri Confirm Order düğmesine tıkladığında eklenti, sipariş para biriminde, siparişin ürünleri, hediye sertifikaları, kargo ve diğer sipariş toplamlarıyla birlikte, sipariş toplamı için bir GoPay ödemesi oluşturur ve müşteriyi GoPay ödeme sayfasına yönlendirir. Orada GoPay, GoPay hesabınızda etkinleştirilmiş ödeme yöntemlerini sunar; örneğin banka kartları, banka havaleleri ve cüzdanlar. Müşterinin adı, e-postası, telefonu ve ödeme adresi GoPay'e iletilir; boş alanlar gönderilmez. Ödeme GoPay'de OC- sipariş numarası ve OpenCart sipariş numarasıyla görünür.

OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle Payment method options penceresinden ödeme yöntemini seçer ve ödeme sayfasının altındaki Confirm Order düğmesine tıklar. OpenCart 4'te hediye sertifikası yoktur, bu nedenle GoPay'e hiçbiri gönderilmez. OpenCart 4 varsayılan olarak ödeme adresi sormaz; bu durumda eklenti, GoPay'e teslimat adresindeki ad ve adresi iletir.

Ö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 bir istekle. Aynı anda gelen bir bildirim ve dönüş birbiri ardına işlenir, böylece ödeme yalnızca bir kez uygulanır. Sipariş ardından OpenCart'ın standart yöntemiyle durumunu alır; olağan sipariş e-postaları ve stok güncellemesi yapılır ve müşteri OpenCart sipariş başarı sayfasını görür. Sipariş beklemeye alınmış durumuna geçtiyse sayfaya Your payment is being reviewed. We will contact you if anything else is needed. eklenir.

Müşteri geri döndüğünde GoPay ödemeyi henüz onaylamadıysa (örneğin bir banka havalesi yoldaysa veya GoPay'e ulaşılamıyorsa), bir Payment confirmation sayfası GoPay has not confirmed your payment yet. Your order will be confirmed automatically as soon as the payment is confirmed — please do not pay again. mesajını ve Check again ile Back to checkout düğmelerini gösterir.

Ödeme tamamlanmadıysa, iptal edildiyse veya süresi dolduysa, müşteri The GoPay payment was not completed. You can try again or choose another payment method. veya The GoPay payment was cancelled or has expired. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur. OpenCart 4'te bu mesajlar ödeme sayfasının üstünde gösterilir. Her yeni deneme (OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise siparişi ödeme sayfasında günceller ve aynı sipariş numarasıyla yeni bir GoPay ödemesiyle öder), sepetteki açık GoPay ödemelerini önce GoPay API'siyle kontrol eder. Bunlardan biri zaten ödenmişse, o ödeme onaylanır ve müşteri yeniden ödeme yapmadan başarı sayfasına gider. Sepetin değiştirilmesi, yeni bir adet dahil, kendi ödemesini gerektiren yeni bir sepet sayılır.

OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme sayfasında tutar. Bu sipariş bu arada ödeme yapılmadan kapatıldıysa (örneğin siz iptal ettiyseniz veya iade ettiyseniz), müşteri Your previous order was cancelled or refunded. Please confirm the order again. mesajıyla (veya iptal edilen ödemeyle ilgili mesajla) ödeme sayfasına geri gönderilir ve bir sonraki Confirm Order işlemi yeni bir siparişi öder. Ödenmiş bir sipariş, farklı bir sepet için asla ödenmiş gibi gösterilmez.

GoPay ödemeyi başlatamazsa, müşteri Confirm Order adımında kalır ve düğmenin üstünde 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. veya GoPay is temporarily unavailable. Please try again in a moment or choose another payment method. Teknik neden günlüğe yazılır.

Müşteri ödeme yöntemini GoPay sayfasında seçer; OpenCart'ta seçilemez. Eklentinin abonelik veya yinelenen ödemeleri, kayıtlı kartları, gömülü bir ödeme formu ve OpenCart'tan ön izinlerin tahsil edilmesi ya da iptal edilmesi yoktur.

Siparişler ve iadeler

Sipariş durumları

No status (missing order): Müşteri GoPay'e yönlendirildi ve ödemedi ya da GoPay ödemeyi henüz onaylamadı. İptal edilmiş veya süresi dolmuş bir GoPay ödemesi, siparişi bir notla birlikte durumsuz bırakır. Sales > Orders bölümünde bu siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Order Status After Payment (varsayılan Processing): ödeme onaylandı. Bir not, GoPay ödeme kimliğini gösterir.

GoPay Payment On Hold Status (varsayılan Pending): GoPay ödemeyi onayladı, ancak tutar, para birimi veya sipariş numarası siparişle eşleşmiyor; ya da ödeme, sipariş iptal edildikten veya iade edildikten sonra geldi; ya da ödeme yalnızca ön izinli ve tutar henüz tahsil edilmedi. Not bunu açıklar. Ön izinli bir ödemenin GoPay'de tahsil edilmesi gerekir; GoPay ödemeyi ödenmiş olarak bildirdiğinde sipariş ödenmiş durumuna geçer.

Refunded Status (varsayılan Refunded): siparişin GoPay ödemesi, eklenti aracılığıyla veya GoPay hesabında tam olarak iade edildi.

Zaten ödenmiş bir siparişin başka bir ödeme denemesi de ödenirse veya aynı sepetin daha eski bir siparişi ödenirse, ödenmiş sipariş değiştirilmez. Bir not, kopya ödemeyi GoPay hesabında iade etmenizi ister. GoPay ödemesi olmadan, örneğin elle, zaten ödenmiş olarak işaretlenmiş bir siparişin GoPay ödemesi ödendiğinde benzer bir not eklenir. İptal edilmiş veya iade edilmiş bir sipariş, sonraki bir bildirimle asla yeniden açılmaz.

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

VibeFox GoPay Gateway sekmesi

Sales > Orders bölümünde GoPay ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında yer alan VibeFox GoPay Gateway sekmesi; GoPay payment ID (sandbox ödemeleri için Sandbox etiketiyle), GoPay state ve ödeme aracı, Payment amount, Paid / refunded, sipariş beklemedeyken nedeniyle birlikte Needs review, iade formu, iade geçmişi ve siparişin GoPay notes kayıtlarını gösterir. Sekme, eklentiye erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanını girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak Reason (optional) alanını doldurun ve Refund via GoPay düğmesine tıklayın. Refund this amount through GoPay? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir. Eklentiyi değiştirme yetkisine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). GoPay kısmi iadeleri yalnızca ödemeden 24 saat sonrasına kadar kabul eder. İadeler, GoPay'in tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İadeler, ödenmiş siparişler ve uyuşmazlık ya da geç ödeme sonrasında beklemedeki siparişler için kullanılabilir. İade, ödemenin yapıldığı modda (sandbox veya canlı) gönderilir; bu nedenle o modun kimlik bilgileri ayarlanmış olmalıdır. GoPay iadeyi reddederse sekme GoPay'in mesajını gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, iade geçmişine ve notlara eklenir; GoPay'in daha sonra işlenmek üzere kabul ettiği bir iade ise kabul edildi olarak not edilir. Tam iade, müşteriye bildirim göndermeden ve ürünleri stoka geri koymadan, elle yapılan bir durum değişikliği gibi siparişi Refunded Status durumuna getirir. Kısmi iade durumu değiştirmez.

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

GoPay hesabında yapılan iadeler bildirimle gelir. Tam iade siparişi iade edilmiş durumuna getirir; kısmi iade bir not ekler. Bunlar sekmenin iade geçmişine eklenmez.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox GoPay Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox GoPay Gateway > Edit sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bundan sonra blok, anahtarı maskeli olarak, durumu (örneğin lisansın geçerli olduğu tarih ve alan adınız) ve şu düğmeleri gösterir: durumu yeniden kontrol etmek için Check now, başka bir anahtar girmek için Change key ve anahtarı bu mağazadan kaldırmak için Remove key. Bunların altında Product: opencart-payment-gopay satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca eklenti için Modify yetkisi olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini bildirir, örneğin Key not found, This key belongs to another product, Domain limit reached veya tarihli License expired on. Mağaza adresi değiştikten 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 GoPay ö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. Aynı tarayıcıda yönetim paneline giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (unlicensed — visible to admins only) işaretiyle görmeye devam eder; böylece anahtar satın almadan önce eklentiyi kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetim paneli Dashboard sayfasında bir hatırlatma belirir. Bunu × ile kapatarak 7 gün gizleyebilirsiniz. Mevcut siparişler etkilenmez: zaten başlatılmış ödemeler yine onaylanır, 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, yönetim paneli Dashboard veya Edit sayfası açıldığında otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Eklentinin kaldırılması lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

GoPay does not appear at checkout: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu, geçerli modun GoID, Client ID ve Client Secret bilgilerine sahip olduğunu ve ödeme sayfasındaki para biriminin CZK, EUR, PLN, USD, GBP, HUF, RON veya BGN'den biri olduğunu kontrol edin. Kimlik bilgileri eksikse ayarlar sayfasında uyarı görünür. Ayrıca ödeme adresinin seçili Geo Zone içinde olduğunu ve siparişin ayarlardaki Total değerine ulaştığını kontrol edin.

The payment went through, but the order stays without a status: GoPay, ayarlarda gösterilen bildirim URL'sine ulaşamadı ve müşteri mağazaya dönmedi. URL'yi engelleyen parola korumasını veya güvenlik duvarı kurallarını kaldırın. Ödemenin yapıldığı modun kimlik bilgilerinin ayarlı olduğunu kontrol edin, çünkü her bildirim bunlarla doğrulanır. Logging seçeneğini açın ve Log alanına bakın. GoPay, başarılı bir yanıt almayan bildirimleri yeniden gönderir.

Notification answers Order not found: ödeme bu mağaza tarafından oluşturulmamış.

Notification answers Missing payment ID: istek GoPay'den gelmedi veya URL değiştirildi. Yapılacak bir şey yok.

Notification answers Payment state could not be verified: GoPay API'sine ulaşılamadı veya o modun kimlik bilgileri eksik ya da hatalı. GoPay bildirimi yeniden gönderir.

Notification answers Busy, retry later: sipariş aynı anda başka bir istek tarafından işleniyordu. GoPay bildirimi yeniden gönderir. Nedenini görmek için Logging seçeneğini açın.

The customer sees an error after Confirm Order: Logging seçeneğini açın ve Log alanına bakın. Yanlış kimlik bilgileri veya diğer modun kimlik bilgileri en olası nedendir. Fatura bilgileriyle ilgili bir mesaj, GoPay'in e-postayı, telefonu veya adresi kabul etmediği anlamına gelir. This payment method is not available. Please reload the checkout page. mesajı, ödeme oturumunun artık siparişle eşleşmediği veya bu arada ödeme yönteminin kapatıldığı anlamına gelir.

The customer comes back and sees We could not verify the GoPay payment. If money was charged, please contact us before paying again.: dönüş bağlantısı mağazadaki hiçbir siparişle eşleşmedi; örneğin başka bir tarayıcıda açıldı veya değiştirildi. Ödemeyi GoPay hesabında kontrol edin; bildirim yine de gerçek bir ödemeyi onaylar.

Test payments do not confirm a live order: sandbox ve canlı ortam ayrıdır. Her ödeme, oluşturulduğu modda kontrol edilir. Test Mode seçeneğini istediğiniz moda getirin ve o modun kimlik bilgilerini kullanın.

Order is in the on hold status after payment: VibeFox GoPay Gateway sekmesindeki notları okuyun. Ödenen tutar veya para birimi siparişten farklıydı, ödeme sipariş iptal edildikten sonra geldi ya da ödeme yalnızca ön izinliydi.

Refund fails: sekmede GoPay'in mesajını okuyun. Kısmi iade yalnızca ödemeden 24 saat sonra mümkündür. Mod ile ilgili bir mesaj, ödemenin sandbox veya canlı modda yapıldığını ve o modun kimlik bilgilerinin ayarlanmadığını gösterir. You do not have permission to refund (modify this extension). mesajı, kullanıcı grubunuzun eklentiyi değiştirme yetkisi olmadığı anlamına gelir.

Geliştiriciler için: ödeme GoPay'e gönderilmeden önce eklenti, ödeme isteği ve siparişle birlikte gopay_p_payment_payload OpenCart olayını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, türü Payments olarak seçin ve VibeFox GoPay Gateway yanındaki Uninstall düğmesine (kırmızı −) tıklayın. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, eklentinin kendi ayarlarını her zaman siler: Enable/Disable, Sort Order, Geo Zone, Total ve dört sipariş durumu alanı; bunlar yeniden kurulumda varsayılan değerlerine döner. Eklentinin OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda bildirimin ve müşterinin GoPay'den dönüşünün geçmesini sağlayan başlangıç eylemi de). Delete Data on Uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, kimlik bilgileri, ödeme sayfası dili, günlükleme), önbelleğe alınmış GoPay erişim belirteçleri ve günlük silinir. Kapalıysa sonraki bir yeniden kurulum için saklanırlar. Siparişlerin GoPay ödeme verileri ve iadeler her zaman korunur; bu sayede daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

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

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