VibeFox Comgate for PrestaShop — Yardım

Gereksinimler

PrestaShop: 8.0 ila 9.x.

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

HTTPS: Comgate'in arka plan bildirimini iletebilmesi için mağazanız internetten HTTPS üzerinden erişilebilir olmalıdır.

Para birimi: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK veya SEK. Diğer para birimleri ve Comgate'in asgari tutarının altındaki toplamlar için ödeme yöntemi gizlenir. HUF ödemeleri, Comgate'in gerektirdiği şekilde tam forinte yuvarlanır.

Comgate hesabı: Comgate müşteri portalında mağaza bağlantınıza ait Merchant ID ve Secret (arka plan iletişimi için şifre) bilgilerine ve orada ayarlanmış bildirim URL'sine (bkz. Yapılandırma) ihtiyacınız vardır. Comgate, test ve canlı ödemeler için aynı Merchant ID ve Secret'ı kullanır.

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

Kurulum

1. Yönetim panelinde 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 Comgate Gateway modülünü bulup Configure düğmesine tıklayın.

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

4. Comgate müşteri portalındaki Merchant ID ve Secret bilgilerini girin ve orada bildirim URL'sini ayarlayın (bkz. Yapılandırma).

5. Enable / Disable seçeneğini açın ve Save düğmesine tıklayın. Deneme ödemesi için Test Mode seçeneğini açık tutun, ardından kapatın.

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

Yapılandırma

Tüm ayarlar modül sayfasındadır: Modules > Module Manager > VibeFox Comgate Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme sayfanın tamamını kaydeder. Alanların üstünde sayfa, Comgate etkinken Merchant ID veya Secret eksikse (bu durumda her ikisi de doldurulana kadar ödeme yöntemi ödeme sayfasında gizlenir) ve mağazanın varsayılan para birimi Comgate tarafından desteklenmiyorsa sizi uyarır. Test modu açıkken Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live. mesajını gösterir.

Comgate

Enable / Disable: Enable Comgate Payment Gateway ödeme yöntemini açar veya kapatır. Default: off.

Title: Müşterilerin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte de ödeme yöntemi adı olarak kaydedilir. Default: Comgate. Zorunlu.

Description: Ödeme sayfasında ödeme yönteminin altında gösterilen metin. Default: Pay securely via Comgate — cards, bank transfers, wallets and more. Test modunda buna TEST MODE: no real money is charged. eklenir veya açıklama boşsa yalnızca bu metin gösterilir.

Comgate bağlantısı

Mağaza tanımlayıcısını (Merchant ID) ve şifreyi (Secret) Comgate müşteri portalındaki Integration > shop connection settings bölümünden alın. Aynı yerde URL for passing the payment result (arka plan bildirimi) alanını, bu bölümdeki Notification URL altında gösterilen URL'ye ayarlayın. Dostu URL'ler kullanıldığında şöyle görünür: https://your-shop/module/wcp_comgate_gateway/webhook; başına /en/ gibi bir dil kodu eklenmiş olabilir. URL'yi ayarların gösterdiği biçimiyle birebir kopyalayın. Comgate bunu her ödemeden sonra çağırır; modül, bir değişiklik yapmadan önce ödemeyi Comgate durum API'si ile yeniden doğrular. Müşteri için dönüş URL'leri her ödemeyle birlikte gönderilir. Portal ayrıca dönüş URL'leri (ödendi, iptal edildi, beklemede) isterse, bu bölümde gösterilen ve return?id=${id}&refId=${refId} ile biten ikinci URL'yi kullanın.

Merchant ID: Comgate'teki mağaza tanımlayıcısı (merchant).

Secret: Bu mağaza bağlantısının arka plan iletişimi için şifresi (secret). Kaydedilmiş bir gizli anahtar 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ı gizli anahtarı temizle: Kutuyu işaretleyin ve kayıtlı gizli anahtarı kaldırmak için Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Test Mode: Test ödemeleri oluşturur (hiçbir tutar tahsil edilmez). Comgate, test ve canlı ödemeler için aynı Merchant ID ve Secret'ı kullanır; test ödemeleri test=true ile işaretlenir. İadeler her zaman özgün ödemenin modunda gönderilir. Default: on.

Ödeme sayfası

Payment Methods: Müşterinin seçebileceği Comgate ödeme yöntemleri. Yalnızca mağazanız için Comgate'te etkinleştirilmiş yöntemler gösterilir.

Language: Comgate ödeme sayfasının dili. Automatic (shop language, English as fallback) (varsayılan) veya 26 dilden biri.

Siparişler

Order Status After Payment: Comgate ödemeyi onayladığında ayarlanan durum.

Siparişle eşleşmeyen ödemeler, canlı moddaki test ödemeleri ve ön provizyonlu ödemeler her zaman Comgate payment on hold durumuna gider.

Gelişmiş

Debug Log: API isteklerini ve bildirimleri modül klasöründeki logs/comgate_p_debug.log.php dosyasına yazar. Dosya web üzerinden açılamaz. Gizli anahtar ve kişisel veriler hiçbir zaman günlüğe yazılmaz. Hatalar her zaman günlüğe yazılır. Default: off.

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

Delete Data on Uninstall: Açıksa modül kaldırıldığında ağ geçidi ayarları ve günlük silinir. Siparişler ve Comgate işlem kimlikleri her zaman korunur. Default: off.

Ödeme

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Comgate) ve siparişi onaylar. Modül, sepet tutarı için sepet para biriminde Comgate'te bir ödeme oluşturur ve müşteriyi Comgate ödeme sayfasına yönlendirir. Müşterinin e-posta adresi ve adı Comgate'e iletilir; ödeme Cart ve sepet numarasıyla etiketlenir. Geçerli bir e-posta adresi gereklidir. Comgate sayfasında müşteri, izin verdiğiniz yöntemlerden biriyle öder. Bu noktada henüz bir sipariş yoktur.

Ödemeden sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Comgate onayladıktan sonra ödenmiş olarak işaretlenir: Modül, arka plan bildirimi geldiğinde de müşteri geri döndüğünde de ödemeyi Comgate durum API'si üzerinden okur. Ardından sipariş oluşturulur ve müşteri standart sipariş onay sayfasını görür. Sipariş beklemeye alındıysa sayfaya Your payment is being reviewed. We will contact you if anything else is needed. mesajı eklenir. Ön provizyonlu bir sipariş daha sonra iptal edildiyse sayfa Your Comgate payment was not completed. Please contact us about this order. mesajını gösterir.

Müşteri geri döndüğünde ödeme henüz onaylanmamışsa, örneğin yolda olan bir banka havalesi gibi, Payment confirmation sayfası Comgate 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ı, bir Check again düğmesi ve bir Back to checkout düğmesiyle gösterir.

Ödeme iptal edilir veya süresi dolarsa müşteri The Comgate payment was cancelled or has expired. You can try again or choose another payment method. mesajıyla ödeme sayfasına döner. Sepet korunur. Her yeni deneme önce bir öncekini kontrol eder; böylece zaten geçmiş bir ödeme ikinci kez tahsil edilmez ve önceki deneme hâlâ açıksa Comgate'te iptal edilir. Daha eski bir denemenin geç gelen ödemesi yine de siparişi oluşturur.

Comgate ödemeyi başlatamazsa müşteri ödeme sayfasında kısa bir mesajla kalır; örneğin The Comgate payment could not be started. Please try again or choose another payment method. ya da Comgate'in bu tutarı veya para birimini kabul edemediği ya da seçilen Comgate ödeme yönteminin kullanılamadığı bilgisi. Teknik neden günlüğe yazılır.

Bildirim, mağaza bakım modundayken de çalışır ve mağazanızın ülke kısıtlamasından etkilenmez.

Modül, tek seferlik ödemeleri yalnızca Comgate sayfasında kabul eder. Düzenli ödeme, abonelik veya kayıtlı kart, sitenizde gömülü Comgate ödeme sayfası, Apple Pay veya Google Pay düğmeleri (bunlar Comgate sayfasında kullanılabilir) ve PrestaShop'tan ön provizyonların yakalanması veya iptali desteklenmez. Bildirim olmadan ödeme durumu otomatik olarak sorgulanmaz; yalnızca müşteri geri döndüğünde kontrol edilir.

Siparişler ve iadeler

Sipariş durumları

Henüz sipariş yok: Müşteri Comgate'e yönlendirildi ve henüz ödeme yapmadı ya da Comgate ödemeyi beklemede olarak bildirdi. Yalnızca sepet mevcut.

Payment accepted or Delivered: Comgate ödemeyi aynı tutar ve para birimiyle PAID olarak bildirdi. Durum Order Status After Payment ayarını izler. Ödeme, Comgate işlem kimliğiyle kaydedilir. Test ödemeleri Comgate test payment — no money was charged. notunu alır.

Comgate payment on hold: Ödenen tutar veya para birimi siparişten farklıdır, mağaza canlı moddayken bir test ödemesi onaylanmıştır (hiçbir para alınmamıştır) ya da ödeme yalnızca ön provizyonludur (Comgate hesabınızda ön provizyon). Ön provizyonlu bir ödeme, Comgate portalında tahsil ettiğinizde otomatik olarak ödenmiş olur. Not nedenini açıklar.

Canceled: Ön provizyonlu bir ödeme Comgate'te iptal edildi veya süresi doldu. Bundan sonra Comgate ödemeyi onaylarsa sipariş, gönderimden önce stoğu kontrol etmenizi hatırlatan bir notla birlikte ödenmiş olarak yeniden açılır.

Refunded: Ödeme, modül üzerinden tamamen iade edildi.

Comgate, zaten ödenmiş bir sipariş için başka bir PAID ödeme bildirirse sipariş değiştirilmez. Bir not, bunu Comgate portalında kontrol etmenizi ve çift ödemeyi iade etmenizi ister. Tekrar gönderilen bir onay, iade edilmiş bir siparişi asla yeniden açmaz.

Comgate ödeme bloğu

Sipariş sayfasında işlem kimliği, Comgate durumu, ödeme tutarı, sipariş toplamı ve iade edilen tutarın yer aldığı bir Comgate payment bloğu; test ödemeleri için Test mode rozeti, bir incelemenin nedeni, iade geçmişi ve siparişin Comgate notes bölümü gösterilir.

İadeler

Comgate payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir neden yazın ve Refund via Comgate düğmesine tıklayın. Refund this amount through Comgate? 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. İade, ödenmiş Comgate işlemine gider ve özgün ödemenin modunda (test veya canlı) gönderilir. Comgate yalnızca PAID ödemeleri ve en fazla ödenen tutarı iade eder; HUF iadeleri tam forint olmalıdır. Comgate iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, tutar, Comgate işlemi ve nedeniyle birlikte iade geçmişine ve notlara eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

İadeler yalnızca ödenmiş siparişler için kullanılabilir. Tutar veya para birimi uyuşmazlığı nedeniyle beklemeye alınmış bir sipariş PrestaShop'tan iade edilemez; Comgate portalından iade edin. Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Comgate üzerinden para geri göndermez. Comgate portalında yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Modül, vibefox.net'ten alınmış bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Comgate Gateway lisans bloğu, Modules > Module Manager > VibeFox Comgate Gateway > Configure sayfasında ayarların üstündeki ilk bloktur. Anahtarı License key alanına girin ve Activate düğmesine tıklayın. Bundan sonra blok anahtarı gizlenmiş olarak, durumu (örneğin lisansın geçerli olduğu son tarih ve alan adınız) ve 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üğmelerini gösterir. Bunların altında Product: presta-payment-comgate satırı ve vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca modül için Configure yetkisine sahip çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli 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 tarihli License expired on. 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 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ızda serbest bırakın.

Etkin bir anahtar olmadan Comgate, ö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. Mağaza ön yüzü, yönetim paneline giriş yaptığınızı bilmez; bu nedenle ödeme yöntemi sizin için de gizlenir: modülü bir anahtar satın almadan önce kurabilirsiniz, ancak ödeme sayfası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 yine onaylanır ve iadeler çalışmaya devam eder.

Bir lisans sona erdiğinde modül çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Yönetim panelinde çalışırken durum otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün her gün, sonrasında haftada bir kez. Cron işi gerekmez. Modülü kaldırmak veya sıfırlamak lisans anahtarını ve lisans durumunu her zaman siler.

Sorun giderme

Comgate ödeme sayfasında görünmüyor: Lisansın etkin olduğunu, Enable / Disable seçeneğinin açık olduğunu, Merchant ID ve Secret alanlarının doldurulduğunu, sepet para biriminin desteklendiğini ve sipariş toplamının Comgate'in asgari tutarının (örneğin 1 CZK, 0,10 EUR veya 100 HUF) altında olmadığını kontrol edin. Payment > Preferences bölümünde modülün sepet para birimi, müşterinin ülkesi ve müşteri grubu için izinli olduğunu doğrulayın.

Ödeme geçti ama sipariş oluşturulmadı: Comgate arka plan bildirimini iletemedi. Comgate portalındaki URL for passing the payment result alanını (ayarlardaki Notification URL ile birebir aynı olmalı), mağazanızın internetten HTTPS ile erişilebilir olduğunu ve günlüğü kontrol edin (Debug Log seçeneğini açın). Comgate, iletilemeyen bildirimleri yeniden gönderir; modül bir bildirimi işleyemediğinde her seferinde hata yanıtı verir, bu nedenle bildirim yeniden denenecektir. Müşteri mağazaya döndüğünde de sipariş oluşturulur.

Bildirim şu yanıtı veriyor: Invalid merchant or secret: Ayarlardaki Merchant ID veya Secret, Comgate portalındaki mağaza bağlantısıyla eşleşmiyor.

Bildirim şu yanıtı veriyor: Gateway not configured: Ayarlardaki Merchant ID veya Secret boş. Doldurulduklarında Comgate yeniden dener.

Bildirim şu yanıtı veriyor: Unknown transaction, Order not found veya Reference mismatch: Bildirim, bu mağazanın o sepet için oluşturmadığı bir ödemeye ait. Hiçbir şey değiştirilmez.

Bildirim şu yanıtı veriyor: Status verification failed, Status verification rejected veya Busy, retry later: Comgate durum API'sine ulaşılamadı, isteği reddetti ya da sepet aynı anda başka bir istek tarafından işleniyordu. Busy yanıtı, siparişin oluşturulamadığı durumda da verilir; nedeni günlükte yer alır. Comgate bildirimi yeniden dener.

Bildirim URL'si tarayıcıda code=1&message=POST%20required gösteriyor: Bu normaldir. URL yalnızca Comgate'ten gelen istekleri kabul eder.

Müşteri şunu görüyor: We could not verify the Comgate payment: Dönüş bağlantısı sepetle eşleşmedi. Para tahsil edildiyse bildirim yine de siparişi oluşturur. Müşteri yeniden ödeme yapmadan önce ödemeyi Comgate portalında kontrol edin.

Müşteri şunu görüyor: The order total is below the minimum amount accepted by Comgate veya A valid billing e-mail address is required for Comgate payments: Bu sepet olduğu gibi Comgate ile ödenemez.

Sipariş, ödemeden sonra Comgate payment on hold durumunda: Comgate payment bloğundaki notları okuyun. Ödenen tutar veya para birimi farklıydı, canlı modda bir test ödemesi geldi ya da ödeme yalnızca ön provizyonludur. Ödemeyi Comgate portalında kontrol edin ve siparişi elle tamamlayın veya iade edin.

İade başarısız: Bloktaki mesajı okuyun. Comgate rejected the refund: the amount exceeds the refundable amount. tutarın iade edilebilir tutarı aştığı anlamına gelir; PAID dışında bir durumdaki ödeme iade edilemez. Comgate could not be reached. The refund was not made — please try again later. bir bağlantı sorunu anlamına gelir.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Comgate 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 kaldırılır. Delete Data on Uninstall açıksa ağ geçidi ayarları ve günlük silinir. Kapalıysa tüm ayarlar sonraki bir yeniden kurulum için saklanır. Comgate işlemleri ve iadeleri ile Comgate 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.

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