VibeFox Cardcom for WooCommerce — Yardım

Gereksinimler

WordPress: 6.0 veya üzeri.

WooCommerce: 8.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 Cardcom ödeme bildirimini gönderebilir.

Para birimi: sipariş para birimi ILS, USD, EUR veya GBP olmalıdır. Diğer para birimlerinde ödeme yöntemi ödeme sayfasında gizlenir.

Cardcom hesabı: canlı ödemeler için terminal numarası, API kullanıcı adı ve API parolası bulunan bir Cardcom satıcı hesabına ihtiyacınız vardır. Ödemeler için yalnızca terminal numarası ve API kullanıcı adı gerekir. API parolası yalnızca WooCommerce'ten yapılan iadeler için kullanılır. Test modu Cardcom hesabı olmadan çalışı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_cardcom_payment_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 > Cardcom > 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. Enable/Disable seçeneğini açın, Test Mode seçeneğini açık bırakın ve 4580 0000 0000 0000 numaralı kartla, gelecekteki herhangi bir son kullanma tarihi ve CVV 123 ile test siparişi verin.

6. Gerçek ödemeler için Test Mode seçeneğinin işaretini kaldırın ve Cardcom'dan aldığınız Terminal Number, API Username ve API Password bilgilerini girin.

Yapılandırma

Tüm ayarlar tek bir sayfada: WooCommerce > Settings > Payments > Cardcom. Test modu açıkken alanların üstünde sayfa Test mode is on. ifadesini gösterir. Canlı modda terminal numarası veya API kullanıcı adı eksikse sayfa uyarır (Cardcom bu durumda ödeme sayfasında gizlenir) ve API parolası olmadan WooCommerce'ten iade yapılamayacağını hatırlatır. Mağaza para birimi desteklenmiyorsa da uyarı gösterir. Canlı modu, terminal numarası veya API kullanıcı adı olmadan kaydederseniz, bunlar girilene kadar ağ geçidinin ödeme sayfasında gizli kalacağını belirten bir hata mesajı görünür.

Genel

Enable/Disable: Enable Cardcom 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: Credit Card (Cardcom).

Description: ödeme sayfasında ödeme yönteminin altında gösterilen metin. Varsayılan: Pay securely with your credit card via Cardcom.

Test modu

Test modu, genel Cardcom test terminali 1000'i (API kullanıcısı CardTest1994) kullanır. Gerçek para tahsil edilmez ve Cardcom hesabı gerekmez. Test kartı: 4580 0000 0000 0000, gelecekteki herhangi bir son kullanma tarihi, CVV 123. Test modunda ödeme sayfası ayrıca bu test kartını gösteren bir satır içerir.

Test Mode: Enable test mode (terminal 1000, no real money). Varsayılan: açık. Gerçek ödemeleri aşağıdaki canlı kimlik bilgileriyle kabul etmek için işaretini kaldırın. İadeler her zaman siparişin ödendiği modun kimlik bilgileriyle gönderilir.

Canlı kimlik bilgileri

Terminal numarası, API kullanıcı adı ve API parolası, satıcı hesabınızla birlikte Cardcom tarafından sağlanır: Cardcom panelinde API ayarları altında veya Cardcom desteğinden. Bu alanlar yalnızca canlı modda kullanılır.

Terminal Number: Cardcom terminal numaranız. Yalnızca rakamlardan oluşmalıdır. Başka bir şey girerseniz hata gösterilir ve önceki değer korunur.

API Username: bu terminal için Cardcom API kullanıcı adınız (ApiName). Kaydederken boşluklar kaldırılır.

API Password: Cardcom API parolanız. Yalnızca WooCommerce'ten yapılan iadeler için gerekir ve yazdığınız gibi saklanır.

Ödeme sayfası

Cardcom ödeme bildirimlerini (IndicatorUrl), bu bölümde gösterilen adrese gönderir. Adres şuna benzer: https://your-site/wc-api/cardcom_p_callback/. Adres, her ödemede sipariş kimliğiyle birlikte Cardcom'a otomatik olarak iletilir; Cardcom tarafında bir ayar yapmanız gerekmez. Adrese internetten erişilebilmelidir.

Operation: Cardcom'un ödeme sayfasında ne yapacağı.

Max Installments: müşterinin Cardcom sayfasında seçebileceği en yüksek taksit (ödeme) sayısı, 1 ile 36 arasında. 1, taksit olmadığı anlamına gelir. Varsayılan: 1.

Success Order Status: onaylanmış bir ödemeden sonra sipariş durumu. 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_cardcom_payment_gateway olarak yazar. Hatalar her zaman kaydedilir. Kimlik bilgileri, kart jetonları ve kart sahibi bilgileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

Delete on Uninstall: Delete all plugin data when uninstalling. Açıkken eklentiyi silmek ayarları, siparişlerde saklanan Cardcom verilerini ve günlükleri kalıcı olarak kaldırır. Siparişlerin kendisi korunur. Varsayılan: kapalı.

Ödeme süreci

Müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Cardcom)) ve siparişi verir. Eklenti, sipariş toplamı için sipariş para biriminde bir Cardcom ödeme sayfası oluşturur ve müşteriyi oraya yönlendirir. Site dili İbranice ise sayfa İbranicede, değilse İngilizce açılır. Sipariş kalemleri Cardcom'a ürün adı olarak iletilir. Müşteri kart bilgilerini girer ve taksite izin veriliyorsa ödeme sayısını seçer.

Ödemeyi yaptıktan sonra müşteri mağazanızın sipariş alındı sayfasına döner. Sipariş, yalnızca Cardcom onayladıktan sonra ödenmiş olarak işaretlenir. Cardcom bildirim adresini çağırır ve eklenti bu çağrıdan yalnızca ödeme sayfası kodunu alır. Kodun, bu sipariş için mağazanız tarafından üretildiğini kontrol eder ve ardından sunucudan sunucuya Cardcom'dan gerçek sonucu ister. Bildirim gecikirse, aynı kontrol müşteri sipariş alındı sayfasına geldiğinde yapılır.

Ödeme tamamlanmazsa Cardcom müşteriyi ödeme sayfasına (veya Pay for order sayfasına) geri gönderir; orada The card payment was not completed. Please try again or choose a different payment method. mesajı gösterilir. Cardcom'un onayladığı reddedilmiş bir ödeme siparişi Başarısız yapar. Müşteri ödenmemiş bir siparişi yeniden ödeyebilir; örneğin Pay for order sayfasından. Aynı siparişin daha eski bir ödeme sayfasında yapılan ödeme hâlâ tanınır. Müşteri başka bir ödeme yöntemine geçip Cardcom sayfasında ödeme yaparsa, ödeme kaydedilir ve ödeme yöntemi tekrar Cardcom olarak ayarlanır.

Cardcom ödeme sayfasını açamazsa müşteri kısa bir mesaj görür, örneğin Could not connect to Cardcom. Please try again in a moment. veya Cardcom kodu ile birlikte Cardcom ödeme sayfasını açamadığına dair bir mesaj; ardından başka bir ödeme yöntemi seçebilir.

Ö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 kart ödemelerini yalnızca Cardcom sayfasında kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik yoktur; kayıtlı jetonları tahsil etmez, Cardcom fatura veya makbuz ayarı yoktur; Cardcom üzerinden Bit, Apple Pay, Google Pay veya PayPal yoktur, iframe modu ve tahsilatı sonradan yapılan işlemler yoktur. Terk edilen ödeme sayfaları otomatik olarak kontrol edilmez.

Siparişler ve iadeler

Sipariş durumları

Pending payment: müşteri Cardcom'a yönlendirildi ve henüz ödeme yapmadı ya da Cardcom ödemeyi henüz onaylamadı.

Processing, Completed or On Hold: ödeme onaylandı. Durum, Success Order Status ayarını izler. Sipariş notunda Cardcom işlemi gösterilir; Cardcom bildirdiğinde kartın son dört hanesi, fatura numarası ve taksit sayısı da yer alır. Test ödemeleri Test mode — no real money was charged. ifadesiyle işaretlenir. Siparişin işlem kimliği, Cardcom işlem numarasıdır.

On hold after payment: Cardcom, siparişle eşleşmeyen bir ödemeyi onayladı; örneğin ödeme sayfası açıldıktan sonra sipariş toplamı değiştirildi ya da farklı bir tutar veya para birimi tahsil edildi. Sipariş notu bunu açıklar. Cardcom panelindeki ödemeyi siparişle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi iade edin.

Failed: Cardcom ödemeyi reddetti. Sipariş notunda Cardcom yanıt kodu gösterilir. Daha eski bir ödeme sayfasındaki ret, daha yeni bir denemeyi başarısız yapmaz; geç gelen bir ret de ödenmiş bir siparişi hiçbir zaman değiştirmez.

Zaten ödenmiş bir siparişe ikinci bir başarılı ödeme gelirse (örneğin müşteri iki tarayıcı sekmesinde ödeme yaptıysa), sipariş yeniden değiştirilmez. Bir not, müşterinin iki kez tahsil edilmiş olabileceği konusunda uyarır ve bunu Cardcom panelinden iade etmenizi ister.

İadeler

Siparişi açın, Refund düğmesine tıklayın, tutarı girin ve Refund via Credit Card (Cardcom) düğmesine tıklayın (düğme, ödeme yönteminin başlığını gösterir). Tam ve kısmi iadeler desteklenir; bir sipariş için birden fazla kısmi iade yapılabilir. İade, siparişin ödendiği modun kimlik bilgileriyle gönderilir: test siparişleri, canlı moda geçmiş olsanız bile Cardcom test terminalinde iade edilir; canlı siparişler her zaman canlı kimlik bilgilerinizi kullanır. Canlı iadeler için API Username ve API Password gerekir. Cardcom iadeyi kabul etmezse WooCommerce hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Cardcom iade işlemi ve nedeniyle birlikte sipariş notlarına eklenir.

Cardcom panelinde 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 > Cardcom 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 Cardcom, ö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

Cardcom ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve sipariş para biriminin ILS, USD, EUR veya GBP olduğunu kontrol edin. Canlı modda Terminal Number ve API Username alanlarının doldurulduğunu kontrol edin. Ayarlar sayfası eksik olan bir şey olduğunda uyarı gösterir.

Ödeme yapıldı, ancak sipariş hâlâ Pending payment durumunda: Cardcom sitenize ulaşamamış olabilir; örneğin bakım modu, güvenlik duvarı, parola koruması veya yerel bir geliştirme sitesi nedeniyle. Bildirim adresine internetten HTTPS üzerinden erişilebilmelidir. Sipariş ayrıca müşteri sipariş alındı sayfasına döndüğünde de onaylanır. Debug log seçeneğini açın ve WooCommerce > Status > Logs bölümünde, kaynak wcp_cardcom_payment_gateway kayıtlarına bakın.

Bildirim şu yanıtı veriyor: Missing or invalid lowprofilecode veya Unknown lowprofilecode for this order: çağrı, mağazanız tarafından bu sipariş için üretilmiş bir ödeme sayfası kodu taşımadı. Sipariş değiştirilmez.

Bildirim şu yanıtı veriyor: Gateway not configured veya Indicator check failed: ödeme sayfasının oluşturulduğu modun kimlik bilgileri eksik ya da kontrol için Cardcom'a ulaşılamadı. Sipariş değiştirilmez ve müşteri mağazaya döndüğünde yeniden kontrol edilir.

Bildirim şu yanıtı veriyor: ReturnValue mismatch veya Terminal mismatch: Cardcom, başka bir siparişe veya başka bir terminale ait bir ödeme bildirdi. Sipariş değiştirilmez. Terminal Number değerinin hesabınızın terminali olduğunu kontrol edin.

Müşteri şunu görüyor: Payment error: this currency is not supported by Cardcom.: sipariş para birimi ILS, USD, EUR veya GBP değil.

Müşteri şunu görüyor: Card payment is temporarily unavailable. Please choose another payment method.: canlı mod açık, ancak terminal numarası veya API kullanıcı adı eksik.

Müşteri sipariş verirken bir hata görüyor: sipariş notlarını açın ya da Debug log seçeneğini açıp günlüğe bakın. Bağlantı sorunları ve Cardcom hata kodları orada yazılır.

Sipariş ödemeden sonra On hold durumunda: sipariş notunu okuyun. Ödenen tutar veya para birimi siparişten farklıydı. Siparişi tamamlayın veya ödemeyi iade edin.

İade şu hatayla başarısız oluyor: API username and API password are required for refunds: ayarlarda API Password (ve API Username) alanlarını girin ve yeniden deneyin.

İade şu hatayla başarısız oluyor: Could not connect to Cardcom: iade yapılmış olabilir ya da olmayabilir; tekrar denemeden önce Cardcom panelini kontrol edin.

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.

Geliştiriciler için: readme dosyası, desteklenen para birimi listesini genişleten cardcom_p_supported_currencies filtresini listeler (yalnızca Cardcom terminalinizde etkin olan para birimlerini ekleyin).

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ı, siparişlerde saklanan Cardcom verileri ve günlükler yalnızca Delete on Uninstall açıksa kaldırılır. Aksi halde yeniden kurulum için saklanır. Mevcut siparişler ödeme notlarını ve işlem kimliklerini korur.

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