VibeFox GoPay for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ile 9.x.

PHP: 8.0 veya üzeri. Modül, daha eski PHP sürümlerinde kurulmayı reddeder.

Para birimi: GoPay, CZK, EUR, PLN, USD, GBP, HUF, RON ve BGN kabul eder. Sepet para birimi başka bir değerdeyse ödeme yöntemi ödeme adımında gizlenir.

GoPay hesabı: GoPay satıcı hesabınızın GoID, Client ID ve Client Secret bilgilerine ihtiyacınız var. Bunlar hesabın entegrasyon ayarlarında bulunur. Sandbox (test) hesabının kendi kimlik bilgileri vardır. Bildirimler için GoPay hesabında bir ayar yapmanız gerekmez, ancak mağazanızın internetten erişilebilir olması gerekir.

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

Kurulum

1. Back office'te Modules > Module Manager bölümüne gidin ve Upload a module düğmesine tıklayın. Modülün ZIP dosyasını seçin.

2. Yükleme tamamlandığında Configure düğmesine tıklayın veya daha sonra modül listesinde VibeFox GoPay Gateway öğesini bulup Configure düğmesine tıklayın.

3. Configure sayfasının üstündeki lisans bloğundaki License key alanına VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın (bkz. Lisans anahtarı).

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ı ortam bilgilerini girin ve Test Mode seçeneğini kapatın.

Kurulumda modül GoPay payment on hold sipariş durumunu oluşturur. PrestaShop yeni ödeme modülünü tüm para birimleri, ülkeler ve müşteri grupları için sunar. Bunları Payment > Preferences bölümünde sınırlayabilirsiniz.

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox GoPay Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Alanların üstünde sayfa Sandbox mode — test payments only veya Production mode — real payments ifadesini 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. Her iki durumda da GoPay ödeme adımında sunulmaz. Kaydettiğinizde önbelleğe alınmış GoPay erişim belirteçleri temizlenir, 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 adımında gösterilen ödeme yöntemi başlığı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: GoPay. Zorunlu: boş bir başlık kaydedilmez.

Description: ödeme adımı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, GoPay satıcı hesabınızda (entegrasyon ayarları) gösterilir. Sandbox (test) hesabının kendi kimlik bilgileri vardır. API belgeleri doc.gopay.com adresindedir.

Test Mode: ödemeleri sandbox kimlik bilgileriyle gw.sandbox.gopay.com adresine gönderir. Gerçek para tahsil edilmez. Canlı ortam 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 değeri.

Sandbox Client ID: sandbox hesabının OAuth Client ID değeri.

Sandbox Client Secret: sandbox hesabının OAuth Client Secret değeri.

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

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

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

GoID yalnızca rakamlardan oluşur, örneğin 8123456789. Başka bir değer girerseniz sayfa bir hata gösterir ve önceki değer korunur.

Kaydedilmiş Client Secret değerleri bir daha 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 yazın.

Clear saved client secrets: kutuyu işaretleyip Save düğmesine tıklayarak kaydedilmiş her iki Client Secret değerini 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 seçenek müşterinin sepetinin dilini kullanır; GoPay bu dili desteklemiyorsa fatura ülkesi belirler, aksi halde İngilizce kullanılır. Ayrıca 19 dilden birini sabitleyebilirsiniz: Czech, English, Slovak, German, Polish, Hungarian, Romanian, Bulgarian, Croatian, Slovenian, Estonian, Latvian, Lithuanian, French, Italian, Spanish, Portuguese, Ukrainian veya Russian.

Order Status After Payment: ödeme onaylandığında ayarlanan sipariş durumu.

Siparişle eşleşmeyen ödemeler, iptalden sonra yapılan ödemeler ve ön provizyonlu ödemeler her zaman GoPay payment on hold durumuna gider.

Ödeme bildirimleri

Bildirim, mağazanıza bir ödeme yapıldığını bildirir. Notification URL bu bölümde gösterilir ve her ödemeyle birlikte GoPay'e gönderilir; bu yüzden GoPay hesabında bir ayar yapmanız gerekmez. Kullanıcı dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_gopay_gateway/webhook; önüne /en/ gibi bir dil kodu da gelebilir. İ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 ve mağazanızdaki ülke kısıtlamasıyla engellenmez.

GoPay bildirimleri yalnızca ödeme kimliğini taşır, imza içermez. Her bildirim, ödemenin yapıldığı modun kimlik bilgileriyle GoPay API'sine ödeme durumu sorularak doğrulanır ve ödeme, mağazanızdaki bir sepet için modül tarafından oluşturulmuş olmalıdır. Durum GoPay'den okunamazsa mağazanız bir hata yanıtı verir ve GoPay bildirimi yeniden gönderir. Bildirim olmadan, sipariş yalnızca müşteri ödemeden sonra mağazaya döndüğünde oluşturulur.

Gelişmiş

Logging: GoPay olaylarını modül klasöründeki 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 son kayıtlarını gösterir. İçeriğini silmek için Clear log düğmesine tıklayın.

Delete Data on Uninstall: açıksa modül kaldırıldığında modül ayarları, önbelleğe alınmış GoPay erişim belirteçleri ve günlük silinir. Siparişler, GoPay ödeme verileri ve GoPay payment on hold sipariş durumu her zaman korunur. Varsayılan: kapalı.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak GoPay) ve onaylar. Modül, sepet toplamı için sepet para biriminde, ürünler, kargo ve hediye paketiyle birlikte 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 ödeme kartları, banka havaleleri ve dijital cüzdanlar. Müşterinin fatura adı, e-posta adresi, telefonu ve adresi GoPay'e iletilir; boş alanlar gönderilmez. Ödeme GoPay'de Order PS- ve sepet numarasıyla görünür. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri 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, bu yüzden yalnızca bir sipariş oluşturulur. Müşteri ardından standart sipariş onay sayfasını görür. Sipariş GoPay payment on hold durumuna geçtiyse sayfaya Your payment is being reviewed. We will contact you if anything else is needed. mesajı eklenir.

Müşteri döndüğünde GoPay ödemeyi henüz onaylamamışsa (ö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 created automatically as soon as the payment is confirmed — please do not pay again. mesajını ve bir Check again düğmesini 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 adımına döner. Sepet korunur ve yeni bir deneme yeni bir GoPay ödemesi oluşturur. Zaten siparişi olan bir sepetten bir daha asla tahsilat yapılmaz.

GoPay ödemeyi başlatamazsa müşteri, ö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. gibi kısa bir mesajla ödeme adımında kalır. Teknik neden günlüğe yazılır.

Müşteri ödeme yöntemini GoPay sayfasında seçer; PrestaShop'ta seçilemez. Modül abonelikleri veya yinelenen ödemeleri, kayıtlı kartları, gömülü ödeme formunu ya da PrestaShop'tan ön provizyon tahsilatı veya iptalini desteklemez.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri GoPay'e yönlendirildi ve henüz ödeme yapmadı ya da GoPay ödemeyi henüz onaylamadı. Yalnızca sepet vardır.

Payment accepted or Delivered: ödeme onaylandı. Durum Order Status After Payment ayarını izler. Ödeme, GoPay ödeme kimliği işlem kimliği olarak kaydedilir ve bir notta ödeme kimliği ile ödeme aracı gösterilir.

GoPay payment on hold: GoPay ödemeyi onayladı, ancak tutar, para birimi veya sipariş numarası sepetten farklı (örneğin ödeme başladıktan sonra sepet değiştirildi); ya da ödeme, sipariş iptal edildikten sonra geldi; ya da ödeme yalnızca ön provizyonlu ve para henüz tahsil edilmedi. Not durumu açıklar. Ön provizyonlu bir ödemenin GoPay'de tahsil edilmesi gerekir; GoPay ödemeyi tamamlandı olarak bildirdiğinde sipariş ödenmiş duruma geçer.

Refunded: siparişin GoPay ödemesi, modül üzerinden veya GoPay hesabında tamamen iade edildi.

Zaten ödenmiş bir siparişin başka bir ödeme denemesi de ödenirse sipariş değişmez. Bir not, kopya ödemenin GoPay hesabında iade edilmesini ister. Bir GoPay ödemesi, GoPay olmadan (örneğin elle) zaten ödenmiş olarak işaretlenmiş bir sipariş için yapıldığında benzer bir not eklenir. İptal edilmiş veya iade edilmiş bir sipariş, sonraki bir bildirimle asla yeniden açılmaz.

GoPay ödeme bloğu

Sipariş sayfasında GoPay ödeme kimliği, GoPay durumu ve ödeme aracı, ödeme tutarı, ödenen ve iade edilen tutar, sandbox ödemeleri için bir Sandbox rozeti, manuel inceleme nedeni, iade geçmişi ve siparişin GoPay notes bilgilerini içeren bir GoPay payment bloğu gösterilir.

İadeler

GoPay payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın 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. Siparişleri düzenleme yetkisine sahip olmanız gerekir; Modules sayfalarına erişim gerekmez. GoPay kısmi iadeleri yalnızca ödemeden sonraki 24 saat içinde 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 fiilen ödediği tutara kadar iade yapabilirsiniz. İade, ödemenin yapıldığı modda (sandbox veya canlı) gönderilir; bu yüzden o modun kimlik bilgileri ayarlanmış olmalıdır. GoPay iadeyi reddederse blok 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 sonradan işlenmek üzere kabul ettiği bir iade, kabul edildi olarak not edilir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu (credit slip) oluşturmaz. Sipariş sayfasındaki PrestaShop'un standart iade düğmeleri GoPay üzerinden para göndermez.

GoPay hesabında yapılan iadeler bildirim yoluyla gelir. Tam iade siparişi Refunded durumuna getirir; kısmi iade bir not ekler. Bunlar bloğun iade geçmişine eklenmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox GoPay Gateway lisans bloğu, Modules > Module Manager > VibeFox GoPay Gateway > Configure sayfasında ayarların üstünde yer alan ilk bloktur. Anahtarı License key alanına girin 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) gösterir; ayrıca 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 düğmeleri bulunur. Bunların altında Product: presta-payment-gopay satırı ile vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı yer alır. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloktaki metinler back office dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini gösterir, örneğin Key not found, This key belongs to another product, Domain limit reached veya License expired on ve bir tarih. 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 modül son bilinen durumla çalışmaya devam eder.

Bir anahtar tek bir alan adında çalışır: ana mağazanın alan adında, çoklu mağaza kurulumunda da. 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 adımı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. PrestaShop vitrini back office'e giriş yaptığınızı bilmez, bu nedenle ödeme yöntemi sizin için de gizlenir: modülü anahtar satın almadan önce ayarlayabilirsiniz, ancak ödeme adımında test edemezsiniz. Modules > Module Manager sayfasında Alerts sekmesinde 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ın süresi dolduğunda modül çalışmaya devam eder, ancak güncellemeler ve destek yenileme gerektirir. Back office'te çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonra haftada bir. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak her zaman lisans anahtarını ve lisans durumunu siler.

Sorun giderme

GoPay ödeme adımı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 sepet para biriminin CZK, EUR, PLN, USD, GBP, HUF, RON veya BGN olduğunu kontrol edin. Kimlik bilgileri eksikse ayarlar sayfası bir uyarı gösterir. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşterinin grubu için izinli olduğunu kontrol edin.

Ödeme başarılı oldu, ancak sipariş oluşturulmadı: GoPay, ayarlarda gösterilen Notification URL'ye ulaşamadı ve müşteri mağazaya geri 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 bu bilgilerle doğrulanır. Logging seçeneğini açın ve Log alanına bakın. GoPay, başarılı yanıt alamayan bildirimleri yeniden gönderir.

Notification answers Order not found: ödeme bu mağaza tarafından oluşturulmadı veya sepeti silindi.

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: sepet aynı anda başka bir istek tarafından işleniyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). GoPay bildirimi yeniden gönderir. Nedenini görmek için Logging seçeneğini açın.

Müşteri GoPay'i seçerken bir hata görüyor: Logging seçeneğini açın ve Log alanına bakın. Hatalı kimlik bilgileri veya diğer modun kimlik bilgileri genellikle nedendir. Fatura bilgileriyle ilgili bir mesaj, GoPay'in e-postayı, telefonu veya adresi kabul etmediği anlamına gelir.

Test ödemeleri canlı bir siparişi onaylamıyor: 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.

Ödemeden sonra sipariş GoPay payment on hold durumunda: GoPay payment bloğundaki notları okuyun. Ödenen tutar veya para birimi sepetten farklıydı, ödeme siparişin iptalinden sonra geldi ya da ödeme yalnızca ön provizyonludur.

İade başarısız oluyor: bloktaki GoPay mesajını okuyun. Kısmi iade yalnızca ödemeden sonraki 24 saat içinde 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.

Geliştiriciler için: actionGopayPaymentPayload hook'u, ödeme isteği GoPay'e gönderilmeden önce onu değiştirir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox GoPay Gateway yanındaki menüyü açın ve Uninstall seçeneğini seçin. Bu modülün lisans anahtarı ve lisans durumu her zaman silinir. Delete Data on Uninstall açıksa modül ayarları, önbelleğe alınmış GoPay erişim belirteçleri ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Siparişlerin GoPay ödeme verileri ve GoPay payment on hold sipariş durumu her zaman korunur; böylece daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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