VibeFox Cardcom 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: Cardcom ödeme bildirimini gönderebilmesi için mağazanıza internetten HTTPS üzerinden erişilebilmelidir.

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

Cardcom hesabı: gerçek ö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 PrestaShop'tan yapılan iadelerde kullanılır. Test modu, Cardcom hesabı olmadan çalışı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 Cardcom Payment Gateway öğesini bulup Configure düğmesine tıklayın.

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

4. Enable/Disable seçeneğini açın, Test Mode seçeneğini açık bırakın ve Save düğmesine tıklayın. 4580 0000 0000 0000 numaralı kartla, gelecekteki herhangi bir son kullanma tarihi ve CVV 123 ile bir test siparişi verin.

5. Gerçek ödemeler için Test Mode seçeneğini kapatın, Cardcom'dan aldığınız Terminal Number, API Username ve API Password bilgilerini girin ve Save düğmesine tıklayın.

Kurulum sırasında modül Cardcom 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 Cardcom Payment Gateway > Configure. Her bölümün kendi Save düğmesi vardır ve bu düğme tüm sayfayı kaydeder. Test modu açıkken sayfa alanların üstünde bir uyarı gösterir. Canlı modda; terminal numarası veya API kullanıcı adı eksikse (bu durumda Cardcom ödeme sayfasında gizlenir), canlı alanlarda herkese açık test terminali 1000 / CardTest1994 yazılıysa (bu durumda da Cardcom ödeme sayfasında gizlenir, çünkü gerçek para tahsil edilmez) sizi uyarır ve API parolası olmadan PrestaShop'tan iade yapılamayacağını hatırlatır. Mağazanızın varsayılan para birimi desteklenmiyorsa da uyarır. Canlı modu eksik veya test bilgileriyle kaydettiğinizde, kendi terminal numaranızı ve API kullanıcı adınızı girene kadar ağ geçidinin ödeme sayfasında gizli kalacağını belirten bir hata mesajı görünür.

Cardcom

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

Title: müşterinin ödeme sayfasında gördüğü ödeme yönteminin adı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit Card (Cardcom). Zorunlu.

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, herkese açık Cardcom test terminali 1000'i kullanır (API kullanıcısı CardTest1994). 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ı, bu test kartını gösteren bir satır da içerir.

Test Mode: test modunu açar (terminal 1000, gerçek para yok). Varsayılan: açık. Aşağıdaki canlı bilgilerle gerçek ödemeleri kabul etmek için kapatın. İadeler her zaman siparişin ödendiği modun bilgileriyle gönderilir.

Canlı bilgiler

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 bir 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 silinir.

API Password: Cardcom API parolanız. Yalnızca PrestaShop'tan yapılan iadeler için gereklidir. Kayıtlı parola 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 girin.

Clear the saved API password: parolayı kaldırmak için kutuyu işaretleyin ve Save düğmesine tıklayın. Boş bir alan kayıtlı değeri korur.

Ödeme sayfası

Notification URL: Cardcom, ödeme bildirimlerini (IndicatorUrl) bu adrese gönderir. Dostu URL'lerle şöyle görünür: https://your-shop/module/wcp_cardcom_payment_gateway/webhook; başında /en/ gibi bir dil kodu da olabilir. Adres, her ödemeyle birlikte sepet kimliğiyle otomatik olarak Cardcom'a iletilir, bu nedenle Cardcom'da herhangi bir ayar yapmanız gerekmez. İnternetten HTTPS üzerinden erişilebilir olmalıdır.

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

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

Success Order Status: onaylanmış bir ödemeden sonraki sipariş durumu. Sipariş doğrudan bu durumda oluşturulur.

Siparişle eşleşmeyen ödemeler her zaman Cardcom payment on hold durumuna gider.

Gelişmiş

Debug log: API isteklerini ve bildirimleri modül klasöründeki logs/cardcom_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz. Hatalar her zaman kaydedilir. Kimlik bilgileri, kart jetonları ve kart sahibi bilgileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

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

Delete on Uninstall: açıkken modül kaldırıldığında ayarlar ve günlükler kalıcı olarak silinir. Siparişler, Cardcom işlemleri ve iadeleri ile Cardcom payment on hold sipariş durumu her zaman korunur; böylece eski siparişler yeniden kurulumdan sonra da iade edilebilir. Varsayılan: kapalı.

Ödeme sayfası

Ödeme adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Cardcom)) ve You will be redirected to the secure Cardcom payment page. notunu görür. Onaylandıktan sonra modül, sepet toplamı için sepet para biriminde bir Cardcom ödeme sayfası oluşturur ve müşteriyi oraya yönlendirir. Bu noktada henüz bir sipariş yoktur. Müşterinin dili İbranice ise sayfa İbranice, aksi halde İngilizce açılır. Sepetteki ürünler Cardcom'a ürün adı olarak iletilir. Müşteri kart bilgilerini girer ve taksitlere izin veriliyorsa ödeme sayısını seçer.

Ödemeyi yaptıktan sonra müşteri mağazanıza geri döner. Sipariş, yalnızca Cardcom ödemeyi onayladıktan sonra ödenmiş olarak işaretlenir. Cardcom bildirim adresini çağırır ve modül bu çağrıdan yalnızca ödeme sayfası kodunu alır. Bu kodun mağazanız tarafından bu sepet için verildiğini kontrol eder, ardından gerçek sonucu sunucudan sunucuya Cardcom'dan sorgular. Bildirim gecikirse, müşteri geri döndüğünde aynı kontrol yapılır. Sipariş bu noktada oluşturulur ve müşteri standart sipariş onay sayfasını Your payment with Cardcom has been received. ifadesiyle görür. Müşteri geri döndüğünde Cardcom ödemeyi henüz onaylamamışsa, Payment confirmation sayfasında Your payment is being confirmed by Cardcom. You will receive an e-mail as soon as it is confirmed. mesajı ve Check again düğmesi gösterilir; bildirim geldiği anda sipariş oluşturulur.

Ödeme tamamlanmazsa veya Cardcom ödemeyi reddederse müşteri ödeme sayfasına geri döner ve The card payment was not completed. Please try again or choose a different payment method. mesajını görür. Sipariş oluşturulmaz ve sepet korunur. Müşteri yeniden deneyebilir: her deneme yeni bir Cardcom ödeme sayfası alır. Aynı sepetin daha eski bir ödeme sayfasında yapılan ödeme yine tanınır ve eski bir sayfadaki red, yeni bir denemeyi etkilemez.

Cardcom ödeme sayfasını açamazsa müşteri ödeme sayfasında kalır ve kısa bir mesaj görür, örneğin Could not connect to Cardcom. Please try again in a moment. ya da Cardcom'un ödeme sayfasını açamadığına dair bir mesaj ve Cardcom kodu gösterilir; müşteri başka bir ödeme yöntemi seçebilir.

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

Modül kart ödemelerini yalnızca Cardcom sayfasında kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik desteği 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 de yoktur.

Siparişler ve iadeler

Sipariş durumları

No order yet: müşteri Cardcom'a yönlendirildi ve henüz ödeme yapmadı, ödeme reddedildi veya Cardcom ödemeyi henüz onaylamadı. Yalnızca sepet mevcuttur.

Payment accepted, Delivered or Cardcom payment on hold: ödeme onaylandı. Durum, Success Order Status ayarını izler. Ödeme, işlem kimliği olarak Cardcom işlem (deal) numarasıyla kaydedilir. Siparişte görünen özel bir mesajda Cardcom işlemi ve Cardcom bunları bildirdiğinde kartın son dört hanesi, fatura numarası ve taksit sayısı gösterilir. Test ödemeleri Test mode — no real money was charged. ifadesiyle işaretlenir.

Cardcom payment on hold after payment: Cardcom, siparişle eşleşmeyen bir ödemeyi onayladı; örneğin ödeme sayfası açıldıktan sonra sepet değiştirildi ya da farklı bir tutar veya para birimi tahsil edildi. Mesaj bunu açıklar ve Cardcom bloğu bunu Needs review başlığı altında gösterir. Para birimi siparişle aynıysa ödeme, Cardcom'un tahsil ettiği tutar için kaydedilir. Cardcom panelindeki ödemeyi siparişle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded: ödeme modül üzerinden tamamen iade edildi.

Zaten siparişi olan bir sepet için ikinci bir başarılı ödeme gelirse (örneğin müşteri iki tarayıcı sekmesinde ödeme yaptıysa), sipariş değişmez. Bir mesaj, müşterinin iki kez ücretlendirilmiş olabileceği konusunda uyarır ve Cardcom panelinden iade etmenizi ister.

Cardcom ödeme bloğu

Sipariş sayfasında işlem, ödeme sayfası kodu, durum, kart, taksitler, fatura, kart jetonu (Charge + Save token ile), tahsil edilen tutar, sipariş toplamı ve iade edilen tutar, test ödemeleri için bir Test mode rozeti ve iade geçmişini içeren bir Cardcom payment bloğu gösterilir.

İadeler

Cardcom payment bloğunda tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isterseniz bir neden yazın ve Refund via Cardcom düğmesine tıklayın. Refund this amount through Cardcom? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir; aynı sipariş için birden fazla kısmi iade yapılabilir. Siparişleri düzenleme yetkisine sahip olmanız gerekir; modül sayfalarına erişim gerekmez. İadeler, Cardcom'un tahsil ettiği tutar ve para biriminde yapılır; bu nedenle tutar veya para birimi uyuşmazlığından sonra sipariş toplamına değil, müşterinin gerçekten ödediği tutara kadar iade yapabilirsiniz. İade, siparişin ödendiği modun bilgileriyle gönderilir: test siparişleri, canlı moda geçtikten sonra bile Cardcom test terminalinde iade edilir, canlı siparişler ise her zaman canlı bilgilerinizi kullanır. Canlı iadeler için API Username ve API Password gerekir. Cardcom iadeyi kabul etmezse blok hatayı gösterir ve hiçbir iade kaydedilmez. Başarılı bir iade, Cardcom iade işlemi ve nedeniyle birlikte iade geçmişine ve sipariş mesajlarına eklenir. Tam iade siparişi Refunded durumuna getirir. Kısmi iade durumu değiştirmez.

Modül kredi notu oluşturmaz. Sipariş sayfasındaki standart PrestaShop iade düğmeleri Cardcom üzerinden para geri göndermez. Cardcom panelinde yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Modül, vibefox.net üzerinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Cardcom Payment Gateway lisans bloğu, Modules > Module Manager > VibeFox Cardcom Payment Gateway > Configure 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 son tarih ve alan adınız) ve Check now (durumu yeniden kontrol eder), Change key (başka bir anahtar girer) ve Remove key (anahtarı bu mağazadan kaldırır) düğmelerini gösterir. Bunların altında Product: presta-payment-cardcom satırı ve Manage licenses and domains in your account bağlantısı bulunur; bağlantı vibefox.net hesabınızı açar. Anahtarı yalnızca modül için Configure yetkisi olan çalışanlar değiştirebilir. Bloğun metinleri yönetim paneli dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini açıklar; ö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, bilinen son 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 Cardcom, ö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ü anahtar satın almadan önce kurabilirsiniz, ama ödeme sayfasında test edemezsiniz. Modules > Module Manager içinde 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.

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 boyunca günde bir kez, ardından 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

Cardcom ödeme sayfasında görünmüyor: lisansın etkin olduğunu, Enable/Disable seçeneğinin açık olduğunu ve sepet para biriminin ILS, USD, EUR veya GBP olduğunu kontrol edin. Canlı modda Terminal Number ve API Username alanlarının kendi bilgilerinizle doldurulduğunu, test terminali 1000 / CardTest1994 ile doldurulmadığını kontrol edin. Ayarlar sayfası eksik bir şey olduğunda 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 yapıldı ama sipariş oluşturulmadı: Cardcom mağazanıza ulaşamadı; örneğin bir güvenlik duvarı, parola koruması veya yerel bir geliştirme sitesi nedeniyle. Bildirim adresi internetten HTTPS üzerinden erişilebilir olmalıdır. Sipariş, müşteri ödemeden sonra mağazaya döndüğünde de oluşturulur. Debug log seçeneğini açın ve modül sayfasındaki Log alanına bakın.

Bildirim şu yanıtı veriyor: Missing or invalid lowprofilecode or Unknown lowprofilecode for this order: çağrı, mağazanız tarafından bu sepet için verilmiş bir ödeme sayfası kodu içermedi. Hiçbir şey değiştirilmez.

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

Bildirim şu yanıtı veriyor: Busy, retry: sepet aynı anda başka bir istek tarafından onaylanıyordu ya da sipariş oluşturulamadı (örneğin modül devre dışı). Nedeni görmek için Debug log seçeneğini açın.

Bildirim şu yanıtı veriyor: ReturnValue mismatch or Terminal mismatch: Cardcom, başka bir sepet ya da başka bir terminal için bir ödeme bildirdi. Hiçbir şey 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.: sepet 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 ya da canlı alanlarda herkese açık test terminali yazıyor.

Müşteri Cardcom'u seçerken hata görüyor: Debug log seçeneğini açın ve Log alanına bakın. Bağlantı sorunları ve Cardcom hata kodları orada yazılır.

Sipariş ödemeden sonra Cardcom payment on hold durumunda: sipariş mesajını veya Cardcom payment bloğundaki Needs review alanını 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: yeniden denemeden önce Cardcom panelini kontrol edin; iade yapılmış da olabilir, yapılmamış da olabilir.

Geliştiriciler için README, para birimi listesini genişleten actionCardcomSupportedCurrencies kancasını (yalnızca Cardcom terminalinizde etkin olan para birimlerini ekleyin) ve ödeme sayfasının parametrelerini değiştiren actionCardcomLowProfileParams kancasını listeler.

Kaldırma

Modules > Module Manager bölümüne gidin, VibeFox Cardcom Payment 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 on Uninstall açıksa ayarlar ve günlükler silinir. Kapalıysa, daha sonraki bir yeniden kurulum için tüm ayarlar korunur. Cardcom işlemleri ve iadeleri ile Cardcom 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 mesajlarını ve işlem kimliklerini korur.

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