VibeFox Comgate for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 7.0 veya üzeri, kurulu ve etkin olmalı. WooCommerce olmadan eklenti etkinleştirilmez.

PHP: 8.0 veya üzeri.

HTTPS: sitenize internetten HTTPS üzerinden erişilebilmesi gerekir; böylece Comgate arka plan bildirimini iletebilir.

Para birimi: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK veya SEK. Diğer para birimlerinde ve Comgate minimumunun altındaki tutarlarda ödeme yöntemi gizlenir. HUF ödemeleri, Comgate'in gerektirdiği gibi tam forinte yuvarlanır.

Comgate hesabı: Comgate müşteri portalında mağaza bağlantınızın Merchant ID ve gizli anahtarına (arka plan iletişimi için parola, secret) ve orada ayarlanmış bildirim URL'sine ihtiyacınız var (bkz. Yapılandırma). Comgate, test ve canlı ödemelerde aynı Merchant ID ve gizli anahtarı kullanır.

VibeFox lisans anahtarı: vibefox.net üzerinden satın alınır. Bir anahtar 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_comgate_gateway klasörünü FTP ile /wp-content/plugins/ dizinine de yükleyebilirsiniz.

2. Activate düğmesine tıklayın.

3. Ayarları açın: WooCommerce > Settings > Payments > Comgate > Manage yolunu izleyin veya Plugins sayfasında eklenti adının altındaki Settings bağlantısına tıklayın.

4. Sayfanın üstündeki lisans bölümüne VibeFox lisans anahtarınızı girin ve Activate düğmesine tıklayın.

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

6. Enable / Disable seçeneğini açın. Deneme ödemesi için Test Mode seçeneğini açık tutun, ardından kapatın.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Comgate. Alanların üstünde sayfa, Comgate etkinken Merchant ID veya gizli anahtar eksikse (ödeme yöntemi, ikisi de doldurulana kadar ödeme sayfasında gizlenir) ve mağaza para birimi desteklenmiyorsa 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. ifadesini gösterir.

Genel

Enable / Disable: Enable Comgate Payment Gateway ödeme yöntemini açar veya kapatır. Varsayılan: kapalı.

Title: müşterilerin ödeme sayfasında gördüğü ödeme yöntemi adı. Varsayılan: Comgate.

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

Comgate bağlantısı

Mağaza tanımlayıcısını (Merchant ID) ve parolayı (secret) Comgate müşteri portalından, 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ümde gösterilen adrese ayarlayın. Adres şuna benzer: https://your-site/wc-api/comgate_payment_callback/. Comgate bunu her ödemeden sonra çağırır; eklenti siparişi değiştirmeden önce ödemeyi Comgate durum API'si ile yeniden kontrol eder. Müşteri için dönüş URL'leri her ödemeyle birlikte gönderilir. Portal dönüş URL'lerini (ödendi, iptal edildi, beklemede) de isterse, bu bölümde gösterilen ikinci URL'yi kullanın; adres şuna benzer: https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

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

Secret: bu mağaza bağlantısının arka plan iletişimi için parolası (secret).

Test Mode: Create test payments (no money is charged). Comgate, test ve canlı ödemeler için aynı Merchant ID ve gizli anahtarı kullanır; test ödemeleri test=true ile işaretlenir. İadeler her zaman orijinal ödemenin modunda gönderilir. Varsayılan: açık.

Ödeme sayfası

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

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

Siparişler

Order Status After Payment: Comgate ödemeyi onayladığında ayarlanan durum. Durum, ikinci bir durum değişikliği olmadan hemen ayarlanır.

Gelişmiş

Debug Log: Log API requests and notifications seçeneği, WooCommerce > Status > Logs bölümüne, kaynak wcp_comgate_gateway olarak yazar. Gizli anahtar ve kişisel veriler hiçbir zaman günlüğe yazılmaz. Hatalar her zaman kaydedilir. Varsayılan: kapalı.

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Siparişler ve Comgate işlem kimlikleri her zaman korunur. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Comgate) ve siparişi verir. Eklenti, sipariş toplamı için Comgate'te sipariş para biriminde bir ödeme oluşturur ve müşteriyi Comgate ödeme sayfasına yönlendirir. Fatura e-posta adresi ve adı Comgate'e iletilir; ödeme sipariş numarasıyla etiketlenir. Geçerli bir fatura e-posta adresi zorunludur. Comgate sayfasında müşteri, izin verdiğiniz yöntemlerden biriyle öder.

Ödemeden sonra müşteri mağazanıza döner. Sipariş, yalnızca Comgate onayladıktan sonra ödenmiş olarak işaretlenir: eklenti, ödemeyi hem arka plan bildirimi geldiğinde hem de müşteri geri döndüğünde Comgate durum API'sinden okur. Ödeme henüz onaylanmamışsa, örneğin yolda olan bir banka havalesi, sipariş alındı sayfası Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. mesajını gösterir. Sipariş beklemeye alındıysa sayfa Your payment is being reviewed. We will contact you if anything else is needed. mesajını 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 (veya sepete) döner. Müşteri ödenmemiş bir siparişi yeniden ödeyebilir; örneğin Pay for order sayfasından. Önceki deneme önce kontrol edilir; böylece zaten tamamlanmış bir ödeme iki kez tahsil edilmez ve hâlâ açıksa Comgate'te iptal edilir. Eski bir denemenin geç gelen ödemesi de ödenmemiş bir siparişi yine öder.

Comgate ödemeyi başlatamazsa müşteri kısa bir mesaj görü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ığı yönünde bir mesaj. Teknik neden günlüğe yazılı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.

Eklenti tek seferlik ödemeleri yalnızca Comgate sayfasında kabul eder. Yinelenen ödeme, abonelik veya kayıtlı kart yoktur; gömülü Comgate ödeme sayfası, sitenizde Apple Pay veya Google Pay düğmeleri yoktur (bunlar Comgate sayfasında sunulur) ve WooCommerce'ten ön provizyonların tahsilatı veya iptali yoktur. Bildirim olmadan ödeme durumu otomatik olarak sorgulanmaz; yalnızca müşteri geri döndüğünde kontrol edilir.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Comgate'e yönlendirildi ve henüz ödeme yapmadı ya da Comgate ödemeyi beklemede olarak bildirdi. Sipariş notunda oluşturulan Comgate ödemesi gösterilir.

Processing or Completed: Comgate ödemeyi aynı tutar ve para birimiyle PAID olarak bildirdi. Durum, Order Status After Payment ayarını izler. Siparişin işlem kimliği Comgate işlem kimliğidir; tüm denemeler siparişle birlikte saklanır. Test ödemelerine Comgate test payment — no money was charged. notu eklenir.

On hold: ödenen tutar veya para birimi siparişten farklı; bir test ödemesi canlı modda onaylandı (hiçbir para alınmadı) veya ödeme yalnızca ön provizyonlu (Comgate hesabınızda ön provizyon). Ön provizyonlu bir ödeme, Comgate portalında tahsil ettiğinizde otomatik olarak ödenmiş olur. Sipariş notu nedeni açıklar.

Cancelled: mevcut Comgate ödemesi iptal edildi veya süresi doldu. WooCommerce ödenmemiş siparişi iptal ettikten sonra Comgate ödemeyi onaylarsa (örneğin yavaş bir banka havalesi), sipariş ödenmiş olarak yeniden açılır ve gönderimden önce stoku kontrol etme notu eklenir.

Comgate, zaten ödenmiş bir siparişe başka bir PAID ödeme bildirirse, sipariş yeniden değiştirilmez. Bir not, bunu Comgate portalında kontrol etmenizi ve mükerrer ödemeyi iade etmenizi ister. Tekrarlanan bir onay, iade edilmiş bir siparişi veya ödemeden sonra iptal edilmiş bir siparişi asla yeniden açmaz.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Comgate düğmesine tıklayın (düğme, ödeme yönteminin başlığını gösterir). Tam ve kısmi iadeler desteklenir. İade, ödenmiş Comgate işlemine ve orijinal ö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 WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, tutar, Comgate işlemi ve nedeniyle birlikte sipariş notlarına eklenir.

Comgate portalında yapılan iadeler mağazaya geri bildirilmez. Gerekirse, ağ geçidi üzerinden Refund via seçeneğini kullanmadan WooCommerce'te manuel bir iade oluşturun.

Lisans anahtarı

Eklenti, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. Lisans bölümü, WooCommerce > Settings > Payments > Comgate sayfasının üstündedir. Anahtarı License key alanına yapıştırın ve Activate düğmesine tıklayın. Bölüm durumu gösterir; örneğin lisansın hangi tarihe kadar etkin olduğunu 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 bir alan adında çalışır. Anahtarı bir siteden kaldırmak alan adı hakkını serbest bırakmaz. Bu hakkı vibefox.net hesabınızdan serbest bırakın.

Etkin bir anahtar yoksa Comgate ödeme sayfasında müşterilere gösterilmez. Ödeme yine de 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 yine görür; yöntem (unlicensed — visible to admins only) etiketiyle işaretlenir. Böylece bir 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 yine onaylanır ve iadeler çalışır.

Lisans süresi dolduğunda eklenti çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum arka planda otomatik olarak yeniden kontrol edilir.

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, sipariş para biriminin desteklendiğini ve sipariş toplamının Comgate minimumunun altında olmadığını kontrol edin (örneğin 1 CZK, 0,10 EUR veya 100 HUF). Ayarlar sayfası kimlik bilgileri eksik olduğunda ya da para birimi desteklenmediğinde uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: Comgate arka plan bildirimini iletemedi. Comgate portalındaki URL for passing the payment result değerini, sitenizin internetten HTTPS üzerinden erişilebilir olduğunu (bakım modu veya parola koruması yok) ve günlüğü kontrol edin (Debug Log seçeneğini açın). Comgate iletilemeyen bildirimleri tekrarlar; eklenti işlemediği her bildirimde hata yanıtı verir, bu nedenle yeniden denenecektir. Sipariş ayrıca müşteri mağazaya döndüğünde de onaylanır.

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

Bildirim şu yanıtı veriyor: Gateway not configured: ayarlarda Merchant ID veya gizli anahtar boş. Bunlar doldurulduğunda Comgate yeniden dener.

Bildirim şu yanıtı veriyor: Order not found, Unknown transaction veya Reference mismatch: bildirim, bu sipariş için bu mağazanın oluşturmadığı bir ödemeye ait. Sipariş 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 sipariş aynı anda başka bir istek tarafından işleniyordu. Comgate bildirimi yeniden dener.

Müşteri şunu görüyor: We could not verify the Comgate payment: dönüş bağlantısı siparişle eşleşmedi. Para tahsil edildiyse bildirim siparişi yine onaylar. 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: sipariş, mevcut haliyle Comgate ile ödenemez.

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

İade başarısız oluyor: mesajı okuyun. Comgate rejected the refund: the amount exceeds the refundable amount. iadenin, iade edilebilir kalan tutardan yüksek olduğu 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.

Lisans bölümü bir hata gösteriyor: bölümdeki mesajı izleyin. Örneğin anahtar başka bir alan adında zaten kullanılıyorsa, vibefox.net hesabınızda bir alan adı hakkını 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. Tamamen kaldırmak için Plugins sayfasında devre dışı bırakıp silin. Bu eklentinin lisans anahtarı ve lisans durumu her zaman kaldırılır. Ağ geçidi ayarları ve günlük dosyaları yalnızca Delete Data on Uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Siparişler ve Comgate verileri her zaman korunur. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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