VibeFox Cardcom for OpenCart — Yardım

Gereksinimler

OpenCart: 3.0.x (3.0.5.0 üzerinde test edildi) veya 4.0.2 ve üzeri (4.1.0.3 üzerinde test edildi).

PHP: 8.0 veya üzeri.

HTTPS: Cardcom ödeme bildirimini gönderebilmesi için mağazanızın internet üzerinden HTTPS ile erişilebilir olması gerekir.

Para birimi: sipariş para birimi (müşterinin alışveriş yaptığı 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ı: canlı ödemeler için terminal numarası, API kullanıcı adı ve API şifresi 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 şifresi yalnızca OpenCart'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 bir alan adında çalışır.

Kurulum

İndirme, her iki OpenCart sürümü için paketleri içeren tek bir zip dosyasıdır. Bilgisayarınızda açın. İçinde README.txt, OpenCart 3 paketi wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip ve OpenCart 4 paketi wcp_cardcom_payment_gateway.ocmod.zip bulunur. Yalnızca OpenCart sürümünüze uygun paketi kurun. Lisans anahtarı iki sürüm için de aynıdır.

OpenCart 3

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_cardcom_payment_gateway-oc3-(version).ocmod.zip dosyasını seçin. Uzantının OCMOD değişikliği yoktur, bu nedenle Extensions > Modifications bölümünün yenilenmesi gerekmez. Yükleyici yerine bu paketin upload klasörünün içeriğini mağazanızın kök klasörüne de kopyalayabilirsiniz.

2. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Cardcom Payment Gateway öğesini bulun ve Install düğmesini (yeşil + düğmesi) tıklayın. Yönetici kullanıcınızın ödeme uzantıları listesini değiştirme iznine sahip olması gerekir.

3. Ayarlar sayfasını açmak için Edit düğmesini (kalem düğmesi) tıklayın. VibeFox lisans anahtarınızı sayfanın üst kısmındaki lisans bloğunda License key alanına yapıştırın ve Activate düğmesini 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üğmesini tıklayın. 4580 0000 0000 0000 numaralı kartla, herhangi bir gelecek son kullanma tarihi ve CVV 123 kullanarak 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üğmesini tıklayın. Cardcom panelinde herhangi bir ayar yapmanız gerekmez: bildirim ve dönüş adresleri her ödemeyle birlikte gönderilir.

OpenCart 4

1. Yönetici panelinde Extensions > Installer bölümüne gidin, Upload düğmesini tıklayın ve wcp_cardcom_payment_gateway.ocmod.zip dosyasını seçin. Dosyanın adını değiştirmeyin: OpenCart 4 uzantı kodunu dosya adından alır ve adı değiştirilmiş paket çalışmaz.

2. Paket, aynı sayfada kurulu uzantılar listesinde görünür. Yanındaki Install düğmesini (yeşil + düğmesi) tıklayın.

3. Extensions > Extensions bölümüne gidin ve Payments türünü seçin. VibeFox Cardcom Payment Gateway öğesini bulun, Install düğmesini (yeşil + düğmesi) ve ardından Edit düğmesini (kalem düğmesi) tıklayın.

4. Lisans anahtarını girin, ödemeyi test edin ve OpenCart 3 için 3–5. adımlarda olduğu gibi canlı bilgileri girin. Ayarlar sayfası ve alanları iki sürümde de aynıdır. Yalnızca bildirim URL'si farklıdır (bkz. Notification URL).

Yeni bir kurulum, ödeme yöntemi kapalı ve test modu açık olarak başlar.

Yapılandırma

Tüm ayarlar uzantı sayfasındadır: Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit. Bölümler solda listelenir; listenin altındaki Save düğmesi tüm sayfayı kaydeder. Ayarların üzerinde, test modu açıkken sayfa bir uyarı gösterir. Canlı modda terminal numarası veya API kullanıcı adı eksikse uyarır (bu durumda Cardcom ödeme sayfasında gizlenir); canlı alanlarda herkese açık test terminali 1000 / CardTest1994 bulunuyorsa uyarır (bu durumda da Cardcom gizlenir, çünkü gerçek para tahsil edilmez) ve API şifresi olmadan OpenCart'tan iade yapılamayacağını hatırlatır. Mağazanızın varsayılan para biriminin desteklenmediğini de belirtir. Uzantıyı değiştirme izniniz yoksa sayfa ayarları gösterir ancak kaydedemez.

Kaydederken Title boş olamaz (en fazla 128 karakter), Sort Order tam sayı olmalı, Total 0 veya daha büyük bir sayı olmalı ve coğrafi bölge ile sipariş durumları mevcut olmalıdır; aksi halde hiçbir şey kaydedilmez. Eksik veya test bilgileriyle canlı modu kaydettiğinizde, ayarlar kendi terminal numaranız ve API kullanıcı adınız girilene kadar ağ geçidinin ödeme sayfasında gizli kalacağı uyarısıyla kaydedilir.

Cardcom

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ı. Siparişte kaydedilen ödeme yöntemi adı da budur. Varsayılan: Credit Card (Cardcom). Zorunlu.

Description: müşterinin Confirm Order adımında, onay düğmesinin üstünde gördüğü metin. Varsayılan: Pay securely with your credit card via Cardcom.

Sort Order: Cardcom'un ödeme sayfasındaki ödeme yöntemleri arasındaki sırası. Boş bırakın veya bir tam sayı girin.

Geo Zone: Cardcom'u yalnızca seçilen coğrafi bölgedeki ödeme adresleri için sunun. Varsayılan: All zones. Coğrafi bölgeler System > Localisation > Geo Zones bölümünde ayarlanır.

Total: Cardcom'un sunulması için bir siparişin ulaşması gereken, mağazanın varsayılan para biriminde ödeme sayfası tutarı. Cardcom'u her tutar için sunmak üzere boş bırakın.

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, herhangi bir gelecek son kullanma tarihi ve CVV 123. Test modunda Confirm Order adımı bu test kartını içeren bir satır da gösterir.

Test Mode: test modunu açar (terminal 1000, gerçek para yok). Varsayılan: açık. Gerçek ödemeleri aşağıdaki canlı bilgilerle 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 şifresi, 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 diğer ayarlar bir uyarıyla kaydedilir ve önceki terminal numarası 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 şifreniz. Yalnızca OpenCart'tan yapılan iadeler için gereklidir. Kayıtlı şifre bir daha asla gösterilmez: alan boş kalır ve Kayıtlı — korumak için boş bırakın. ifadesini gösterir. Yalnızca değiştirmek istediğinizde yeni bir değer girin. Kaydedilmiş şifreyi kaldırmak için alanın altındaki Clear the saved API password kutusunu işaretleyin ve Save düğmesini tıklayın.

Ödeme sayfası

Notification URL: Cardcom ödeme bildirimlerini (IndicatorUrl) bu adrese gönderir. Adres, OpenCart 3'te https://your-store/index.php?route=extension/payment/wcp_cardcom_payment_gateway/webhook biçimindedir, OpenCart 4'te ise https://your-store/index.php?route=extension/wcp_cardcom_payment_gateway/payment/wcp_cardcom_payment_gateway.webhook biçimindedir ve OpenCart kurulumunuzun vitrin adresinden oluşturulur. Adres, sipariş numarasıyla birlikte her ödemede Cardcom'a otomatik olarak iletilir; bu nedenle Cardcom'da yapılandırılacak bir şey yoktur. İnternet üzerinden HTTPS ile erişilebilir olmalıdır.

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

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

Siparişler

OpenCart, siparişi Confirm Order adımında durumsuz (eksik bir sipariş) olarak oluşturur. Sipariş, yalnızca Cardcom ödemeyi onayladıktan sonra bir durum alır. Aşağıdaki her alan OpenCart sipariş durumlarınızı listeler.

Success Order Status: onaylanmış bir ödemeden sonra ayarlanan durum. Varsayılan: İşleniyor.

On Hold (Review) Status: siparişle eşleşmeyen ödemeler (tutar, para birimi, işlem numarası yok) bu durumu ve nedenini açıklayan bir not alır. Varsayılan: Beklemede, çünkü OpenCart'ta Askıda durumu yoktur. System > Localisation > Order Statuses bölümünde kendi durumunuzu oluşturabilir ve burada seçebilirsiniz.

Refunded Status: ödeme sipariş sayfasından tamamen iade edildikten sonra ayarlanır. Varsayılan: İade Edildi.

Gelişmiş

Debug log: API isteklerini ve bildirimleri OpenCart günlükleri klasöründeki (storage/logs) cardcom_p_debug.log.php dosyasına kaydeder. Dosya web üzerinden açılamaz ve 5 MB'a ulaştığında döndürülür. Hatalar her zaman kaydedilir. Kimlik bilgileri, kart jetonları ve kart sahibinin bilgileri hiçbir zaman yazılmaz. Varsayılan: kapalı.

Log: günlüğün boyutunu ve en son girişlerini gösterir. İçeriğini boşaltmak için Clear log düğmesini tıklayın.

Delete on Uninstall: açık olduğunda uzantının kaldırılması ayarları ve günlükleri kalıcı olarak siler. Siparişler ile Cardcom işlemleri ve iadeleri her zaman korunur, böylece eski siparişler yeniden kurulumdan sonra da iade edilebilir. Varsayılan: kapalı.

İçe / Dışa Aktarma

Export: Download JSON ayarları bir JSON dosyası olarak kaydeder. API şifresi dışa aktarılmaz.

Import: daha önce dışa aktarılmış JSON'u yapıştırın ve ayarları geri yüklemek için Import düğmesini tıklayın. Kayıtlı API şifresi korunur.

Ödeme

Payment Method adımında müşteri ödeme yöntemini seçer (varsayılan olarak Credit Card (Cardcom)). Confirm Order adımında müşteri açıklamanızı ve Güvenli Cardcom ödeme sayfasına yönlendirileceksiniz. notunu görür. OpenCart siparişi bu adımda, hâlâ durumsuz olarak oluşturur. Müşteri Confirm Order düğmesini tıkladığında uzantı, sipariş para biriminde sipariş tutarı için bir Cardcom ödeme sayfası oluşturur ve müşteriyi oraya yönlendirir. Sipariş dili İbranice ise sayfa İbranice, aksi halde İngilizce açılır. Sipariş ürünleri Cardcom'a ürün adı olarak iletilir. Müşteri kart bilgilerini girer ve taksitlere izin verilmişse ödeme sayısını seçer. OpenCart 4'te müşteri, ödeme yöntemi bloğundaki Choose düğmesiyle, Payment method options penceresinde ödeme yöntemini seçer ve ödeme adımının altındaki Confirm Order düğmesini tıklar.

Ö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 uzantı bu çağrıdan yalnızca ödeme sayfası kodunu alır. Bu kodun mağazanız tarafından bu sipariş için verildiğini kontrol eder, ardından Cardcom'dan sunucudan sunucuya gerçek sonucu ister. Bildirim gecikirse, müşteri geri döndüğünde aynı kontrol yapılır. Sipariş daha sonra OpenCart'ın standart yoluyla, olağan sipariş e-postaları ve stok güncellemesiyle bir durum alır ve müşteri OpenCart sipariş başarılı sayfasını Cardcom ile yaptığınız ödeme alındı. mesajıyla görür. Müşteri geri döndüğünde Cardcom ödemeyi henüz onaylamamışsa, bir Payment confirmation sayfası Ödemeniz Cardcom tarafından onaylanıyor. Onaylandığında size bir e-posta göndereceğiz. mesajını, Check again ve Back to checkout düğmeleriyle birlikte gösterir; bildirim geldiği anda sipariş durumunu ayarlar. OpenCart 4'te tarayıcı, Cardcom müşteriyi geri gönderdiğinde mağazanın oturumunu göndermez; bu nedenle eklenti önce aynı dönüş adresini mağazanızdan yeniden açan kısa bir sayfa gösterir: müşteri sepetini ve girişini korur.

Ödeme tamamlanmazsa veya Cardcom ödemeyi reddederse müşteri Kart ödemesi tamamlanamadı. Lütfen tekrar deneyin veya başka bir ödeme yöntemi seçin. mesajıyla ödeme sayfasına döner. OpenCart 4'te bu mesaj ödeme adımının üstünde gösterilir. Sipariş durumsuz kalır ve sepet korunur. Müşteri tekrar deneyebilir: OpenCart 3, Confirm Order adımı her gösterildiğinde yeni bir sipariş oluşturur; OpenCart 4 ise sipariş için tek bir sipariş tutar ve onu günceller; her denemede yeni bir Cardcom ödeme sayfası alınır. Yeni bir sayfa oluşturulmadan önce, son 24 saat içindeki bu siparişin ve aynı sepetin diğer siparişlerinin (aynı müşteri oturumu ve aynı sepet içeriği) açık Cardcom ödeme sayfaları Cardcom ile kontrol edilir. Bunlardan biri ödenmişse, o sipariş onaylanır ve müşteri iki kez ödeme yapmak yerine başarı sayfasına gider. Başka bir siparişle zaten ödenmiş bir sepetten tekrar tahsilat yapılmaz: müşteri başarı sayfasına gider. Eski bir sayfadaki red, daha yeni bir denemeyi etkilemez.

Ödeme yapılmadan bu arada siparişin ödeme adımı kapatıldıysa (örneğin siz iptal ettiyseniz), Confirm Order veya Cardcom'dan dönüş, müşteriyi This order can no longer be paid. Please confirm your order again. mesajıyla ödeme adımına geri gönderir ve bir sonraki Confirm Order, sepetin yeni bir siparişini öder. OpenCart 4, başarı sayfası gösterilene kadar siparişi ödeme adımında tutar: bu siparişin zaten bir durumu varsa ve o zamandan beri sepet değiştiyse (başka ürünler veya adetler), müşteri aynı mesajı görür; değişen sepet yeni bir sipariş ve kendi ödemesini alır, aynı sepet ise yeni bir ödeme olmadan başarı sayfasına gider.

Cardcom ödeme sayfasını açamazsa müşteri, düğmenin üstünde kısa bir mesajla Confirm Order adımında kalır; örneğin Cardcom'a bağlanılamadı. Lütfen birazdan tekrar deneyin. ya da Cardcom'un Cardcom koduyla birlikte ödeme sayfasını açamadığı mesajıyla. Müşteri başka bir ödeme yöntemi seçebilir.

Bildirim, mağaza bakım modundayken de çalışır: OpenCart 3 ödeme uzantısı isteklerine izin verir, OpenCart 4'te ise uzantı, bildirimin ve müşterinin dönüşünün geçmesini sağlayan bir başlangıç eylemi ekler.

Uzantı yalnızca Cardcom sayfasında tek seferlik kart ödemelerini kabul eder. Kayıtlı kart veya tek tıkla ödeme, abonelik, saklanan jetonların tahsili, Cardcom fatura veya makbuz ayarları, Cardcom üzerinden Bit, Apple Pay, Google Pay veya PayPal, iframe modu ve sonradan tahsilat anlaşmaları desteklenmez.

Siparişler ve iadeler

Sipariş durumları

Durum yok (eksik sipariş): müşteri Cardcom'a gönderildi ve ödeme yapmadı, ödeme reddedildi veya Cardcom ödemeyi henüz onaylamadı. Sales > Orders bölümünde bu tür siparişler yalnızca Order Status filtresi Missing Orders olarak ayarlandığında gösterilir.

Success Order Status (varsayılan İşleniyor): ödeme onaylandı. Bir not Cardcom işlemini ve Cardcom bildirdiğinde kartın son dört hanesini, fatura numarasını ve taksit sayısını, ayrıca ödemenin nasıl onaylandığını (bildirim, dönüş veya yeni bir deneme) gösterir. Test ödemeleri Test modu — gerçek para tahsil edilmedi. olarak işaretlenir.

On Hold (Review) Status (varsayılan Beklemede): Cardcom, siparişle eşleşmeyen bir ödeme onayladı; örneğin farklı bir tutar veya para birimi tahsil edildi ya da Cardcom bir işlem numarası döndürmedi. Not bunu açıklar ve sipariş sekmesi bunu Needs review: altında gösterir. Cardcom panelindeki ödemeyi siparişle karşılaştırın, ardından siparişi tamamlayın veya ödemeyi iade edin.

Refunded Status (varsayılan İade Edildi): ödeme uzantı üzerinden tamamen iade edildi.

Zaten bir durumu olan bir sipariş için ikinci bir başarılı ödeme gelirse (örneğin müşteri iki tarayıcı sekmesinde ödeme yaptıysa), sipariş değiştirilmez. Bir not, müşterinin iki kez tahsil edilmiş olabileceği konusunda uyarır ve Cardcom panelinde iade etmenizi ister. Aynı sepet başka bir siparişle bir kez daha ödendiğinde, aynı not ödenmiş siparişe de eklenir (örneğin ikinci bir sekmede); o diğer sipariş durum almaz.

Notlar, müşterinin görmediği sipariş History kayıtlarıdır.

VibeFox Cardcom Payment Gateway sekmesi

Sales > Orders bölümünde Cardcom ile ödenmiş bir siparişi açın. Sipariş sayfasının altında, History ve Additional yanında, VibeFox Cardcom Payment Gateway sekmesi; test ödemeleri için Test mode etiketli Transaction, Payment page (LowProfileCode), Status, Card, Installments, Invoice, Card token (Charge + Save token ile birlikte), Charged tutarını, Order total / refunded bilgisini, iade formunu, iade geçmişini ve siparişin Cardcom notes kayıtlarını gösterir. Sekme, uzantıya erişimi olan kullanıcılara gösterilir.

İadeler

Sekmede Amount alanına tutarı girin (henüz iade edilmemiş tutar otomatik doldurulur), isteğe bağlı olarak bir Reason (optional) ekleyin ve Refund via Cardcom düğmesini tıklayın. Refund this amount through Cardcom? This cannot be undone. sorusunu onaylayın. Tam ve kısmi iadeler desteklenir ve bir sipariş için birden fazla kısmi iade yapılabilir. Uzantıyı değiştirme iznine ihtiyacınız vardır (System > Users > User Groups bölümünde ayarlanır). İ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 ve canlı siparişler her zaman canlı bilgilerinizi kullanır. Canlı iadeler için API Username ve API Password gereklidir. Cardcom iadeyi kabul etmezse sekme 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 notlara eklenir. Tam iade, siparişi müşteriye bildirmeden ve ürünleri stoğa geri eklemeden, elle yapılan bir durum değişikliği gibi Refunded Status durumuna alır. Kısmi bir iade durumu değiştirmez.

Sales > Returns bölümündeki ürün iadeleri Cardcom üzerinden para geri göndermez. Cardcom panelinde yapılan iadeler mağazaya bildirilmez.

Lisans anahtarı

Uzantı, vibefox.net adresinden alınan bir VibeFox lisans anahtarıyla çalışır. License — VibeFox Cardcom Payment Gateway lisans bloğu, Extensions > Extensions > Payments > VibeFox Cardcom Payment Gateway > Edit bölümündeki ilk bloktur ve ayarların üzerindedir. Anahtarı License key alanına yapıştırın ve Activate düğmesini tıklayın. Bundan sonra blok anahtarı maskeli olarak, durumu (örneğin lisansın ne zamana kadar etkin olduğunu ve alan adınızı) ve Check now düğmesini (durumu yeniden kontrol eder), Change key düğmesini (başka bir anahtar girer) ve Remove key düğmesini (anahtarı bu mağazadan kaldırır) gösterir. Bunların altında Product: opencart-payment-cardcom satırı ve hesabınızda vibefox.net hesabınızı açan Manage licenses and domains in your account bağlantısı bulunur. Anahtarı yalnızca uzantı için Modify izni olan yönetici kullanıcılar değiştirebilir. Bloğun metinleri yönetici dilini izler (İngilizce ve Rusça dahildir).

Anahtar kabul edilmezse blok nedenini belirtir; örneğin Anahtar bulunamadı, Bu anahtar başka bir ürüne ait, Alan adı sınırına ulaşıldı veya tarihiyle birlikte Lisansın son kullanma tarihi. Mağaza adresi değiştikten sonra veya hesabınızda bir alan adı yuvası boşalttıktan sonra Check now düğmesini tıklayın. Lisans sunucusuna ulaşılamazsa uzantı son bilinen durumla çalışmaya devam eder.

Bir anahtar bir alan adında çalışır: OpenCart yapılandırmasındaki mağaza adresi. Anahtarı mağazadan kaldırmak, alan adı yuvasını serbest bırakmaz. Yuvayı vibefox.net hesabınızdan boşaltın.

Etkin bir anahtar olmadan Cardcom, müşterilere ödeme sayfasında gösterilmez. Yine de bir ödeme başlatılırsa müşteri Bu ödeme yöntemi kullanılamıyor. Lütfen başka bir yöntem seçin. mesajını görür. Yönetici paneline aynı tarayıcıda giriş yapmış bir yönetici kullanıcı, ödeme yöntemini mağazada (lisanssız — yalnızca yöneticilere görünür) işaretiyle görmeye devam eder; böylece bir anahtar satın almadan önce uzantıyı kurup test edebilirsiniz. OpenCart 4'te bu önizleme kullanılamaz: mağaza yönetici girişini görmez, bu nedenle etkin bir anahtar olmadan ödeme yöntemi herkes için gizlenir. Edit sayfasını bir kez açtıktan sonra yönetici Dashboard ekranında bir hatırlatma belirir. Bunu × ile kapatırsanız 7 gün gizlenir. Mevcut siparişler etkilenmez: başlatılmış ödemeler yine onaylanır ve iadeler çalışır.

Bir lisans sona erdiğinde uzantı çalışmaya devam eder, ancak güncellemeler ve destek için yenileme gerekir. Durum, yönetici Dashboard veya Edit sayfasını açtığınızda otomatik olarak yeniden kontrol edilir: anahtar girildikten sonraki ilk 14 gün boyunca günde bir kez, sonrasında haftada bir kez. Cron işi gerekmez. Uzantının kaldırılması her zaman lisans anahtarını ve lisans durumunu 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 müşterinin para biriminin ILS, USD, EUR veya GBP olduğunu kontrol edin. Canlı modda Terminal Number ve API Username alanlarının test terminali 1000 / CardTest1994 yerine kendi bilgilerinizle dolu olduğunu kontrol edin. Eksik bir şey olduğunda ayarlar sayfası uyarı gösterir. Ayrıca ödeme adresinin seçilen Geo Zone içinde olduğunu ve siparişin ayarlardaki Total tutarına ulaştığını kontrol edin.

Ödeme başarılı oldu ama sipariş durumsuz kaldı: Cardcom mağazanıza ulaşamadı; örneğin bir güvenlik duvarı, parola koruması veya yerel bir geliştirme sitesi nedeniyle. Bildirim adresi internet üzerinden HTTPS ile erişilebilir olmalıdır. Sipariş, müşteri ödemeden sonra mağazaya döndüğünde de durum alır. Debug log seçeneğini açın ve uzantı sayfasındaki Log alanına bakın.

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

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

Bildirim Busy, retry yanıtı veriyor: sipariş aynı anda başka bir istek tarafından onaylanıyordu veya sipariş durumu ayarlanamadı. Nedenini görmek için Debug log seçeneğini açın.

Bildirim ReturnValue mismatch veya Terminal mismatch yanıtı veriyor: Cardcom başka bir sipariş veya başka bir terminal için bir ödeme bildirdi. Hiçbir şey değişmez. Terminal Number değerinin hesabınızın terminali olduğunu kontrol edin.

Tarayıcıda bildirim URL'si Missing or invalid lowprofilecode gösteriyor: bu normaldir. URL yalnızca Cardcom'dan gelen çağrıları kabul eder.

Müşteri «Ödeme hatası: bu para birimi Cardcom tarafından desteklenmiyor.» mesajını görüyor: sipariş para birimi ILS, USD, EUR veya GBP değil.

Müşteri «Kart ödemesi geçici olarak kullanılamıyor. Lütfen başka bir ödeme yöntemi seçin.» mesajını görüyor: canlı mod açık, ancak terminal numarası veya API kullanıcı adı eksik ya da canlı alanlarda herkese açık test terminali bulunuyor.

Müşteri Confirm Order sonrasında «Bu ödeme yöntemi kullanılamıyor.» mesajını görüyor: ödeme oturumu artık siparişle eşleşmiyor ya da bu arada ödeme yöntemi kapatılmış. Müşteri ödeme sayfasını yeniden yükler.

Müşteri Confirm Order sonrasında başka bir hata görüyor: Debug log seçeneğini açın ve Log alanına bakın. Bağlantı sorunları ve Cardcom hata kodları oraya yazılır.

Sipariş ödemeden sonra inceleme durumunda: notları veya VibeFox Cardcom Payment Gateway sekmesindeki Needs review: bilgisini okuyun. Ödenen tutar veya para birimi siparişten farklıydı. Siparişi tamamlayın veya ödemeyi iade edin.

Sekmede iade formu yok: sekme nedenini belirtir: işlem henüz onaylanmamıştır, ödeme tamamen iade edilmiştir, kullanıcı grubunuzun uzantıyı değiştirme izni yoktur veya ödemenin modunun API kullanıcı adı ve API şifresi eksiktir.

İade «API username and API password are required for refunds» hatasıyla başarısız oluyor: ayarlarda API Password (ve API Username) alanını girin ve tekrar deneyin.

İade «Could not connect to Cardcom» hatasıyla başarısız oluyor: tekrar denemeden önce iadenin yapılıp yapılmadığı belirsiz olabileceğinden Cardcom panelini kontrol edin.

Geliştiriciler için: uzantı, para birimleri listesini genişleten OpenCart olaylarını (cardcom_p_supported_currencies; yalnızca Cardcom terminalinizde etkin olan para birimlerini ekleyin) ve ödeme sayfası oluşturulmadan önce parametrelerini değiştiren cardcom_p_low_profile_params olaylarını tetikler.

Kaldırma

Extensions > Extensions bölümüne gidin, Payments türünü seçin ve VibeFox Cardcom Payment Gateway yanındaki Uninstall düğmesini (kırmızı − düğmesi) tıklayın. Bu uzantının lisans anahtarı ve lisans durumu her zaman kaldırılır. OpenCart, uzantının kendi ayarlarını her zaman kaldırır: Enable/Disable, Sort Order, Geo Zone, Total ve Orders bölümündeki sipariş durumları; bunlar yeniden kurulumda varsayılan değerlerine döner. Uzantının OpenCart olayı da kaldırılır (OpenCart 4'te olayları ve bakım modunda Cardcom'un geçmesine izin veren başlangıç eylemi de kaldırılır). Delete on Uninstall açıksa diğer ağ geçidi ayarları (başlık, açıklama, test modu, bilgiler, ödeme sayfası seçenekleri, günlükleme) ve günlük kaldırılır. Kapalıysa bunlar sonraki bir yeniden kurulum için saklanır. Cardcom işlemleri ve iadeleri her zaman korunur, bu nedenle daha önce ödenmiş siparişler yeniden kurulumdan sonra da iade edilebilir. Mevcut siparişler ödeme notlarını korur.

OpenCart 4'te dosyaları da kaldırmak için kaldırma işleminden sonra Extensions > Installer bölümüne gidin, kurulu uzantılar listesinde VibeFox Cardcom Payment Gateway yanındaki Uninstall düğmesini (turuncu − düğmesi) tıklayın ve ardından yüklenen paketi kaldırmak için Delete düğmesini (kırmızı çöp kutusu düğmesi) tıklayın.

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