OpenCart E-Ticaret Sitenizde Güvenli Ödeme Alın

Neden OpenCart ile Sanal POS?

OpenCart, Türkiye dahil birçok pazarda küçük ve orta ölçekli mağazaların tercih ettiği bir alışveriş platformudur. Kurulumu görece basittir, yönetim paneli sade bir yapıdadır ve eklenti ekosistemi sayesinde kargo, muhasebe ya da pazaryeri bağlantıları gibi ihtiyaçlar sonradan eklenebilir. Ödeme tarafı da aynı mantıkla çalışır: sanal POS bağlantısı, mağazanın çekirdek koduna dokunulmadan bir modül olarak devreye alınır.

Açık kaynak kodlu olması, ödeme akışının mağazanın kendi yapısına göre düzenlenebilmesi anlamına gelir. Sepet sayfasının görünümü, ödeme adımında gösterilen seçenekler ve sipariş sonrası bilgilendirme akışı temanıza ve iş akışınıza göre uyarlanabilir. Desteklenen kart aileleri, taksit seçenekleri ve 3D Secure davranışı ise hesabınızın açıldığı ödeme kuruluşunun çözümüne bağlıdır; kesin kapsam başvuru değerlendirmesi sonrasında netleşir.

OpenCart'ın çoklu mağaza yapısı, tek bir kurulum üzerinden birden fazla mağaza yönetmeye imkân verir. Bu yapıda her mağaza için ayrı ödeme yapılandırması tanımlanabilir. Çoklu dil ve çoklu para birimi desteği de yurt dışına satış yapan mağazalarda ödeme adımının yerelleştirilmesini kolaylaştırır. Bu özelliklerin ödeme tarafındaki karşılığı seçilen çözüme göre değiştiğinden, mağaza yapınızı başvuru formunda belirtmeniz süreci kolaylaştırır.

Modül Kurulumu ve Ödeme Yöntemi Ayarları

Kurulum, ödeme modülünün OpenCart yönetim paneline yüklenmesiyle başlar. Eklenti yükleyici ekranından modül dosyası sisteme aktarılır, ardından eklenti listesinde ilgili kayıt kurulur ve düzenleme ekranı açılır. Eklenti veya modül dosyası, desteklenen OpenCart sürümleri ve gereken PHP sürümü, hesabınız açıldığında iletilen dokümantasyonda belirtilir. Modül dosyaları OpenCart’ın ana sürümüne göre hazırlanır; 4.0 ile eklenti yapısı değiştiği için 3.x’e hazırlanmış bir modül 4.x’te çalışmayabilir. Modül yerine doğrudan API ile ilerlemeyi tercih ederseniz uç nokta ve alan yapısı için API dokümantasyonu sayfasını kullanabilirsiniz.

Modül düzenleme ekranında tipik olarak şu alanlar bulunur: hesabınıza tanımlanan anahtarlar, ortam seçimi (test veya canlı), ödeme yönteminin görünür olacağı mağaza ve müşteri grupları, listedeki sıralama değeri ve etkinlik durumu. Ayrıca 3D Secure davranışı, kart sahibi doğrulaması sonrasında dönülecek adres ve ödeme sonucuna göre atanacak sipariş durumları burada eşlenir. Anahtarları tema dosyalarına ya da sürüm deposuna yazmayın; panel üzerindeki ilgili alanlarda tutun, test ve canlı anahtarları ayrı kullanın.

Ödeme akışı müşteri tarafında şöyle ilerler: sepet onaylandıktan sonra ödeme yöntemleri listesinden sanal POS seçilir, kart bilgileri girilir ve kart sahibi 3D Secure doğrulamasına yönlendirilir. Doğrulama sonrasında mağazaya dönüş yapılır ve sonuç sipariş kaydına işlenir. Buradaki kritik nokta, ödemenin başarılı sayılmasının tarayıcının döndüğü sayfaya değil, sunucunuza gelen bildirime bağlı olmasıdır. Bildirim adresi modül ayarlarında tanımlanır; alanlar, imza doğrulaması ve yeniden deneme davranışı için webhook ve callback sayfasına bakın. Doğrulama adımının ayrıntısı 3D Secure güvenli ödeme sayfasında, kart bilgisinin tekrar kullanımı ise tek tıkla ödeme sayfasında anlatılır.

Test ve Canlıya Geçiş

Canlıya geçmeden önce akışın test anahtarlarıyla uçtan uca çalıştırılması gerekir. Denenmesi gereken temel senaryolar şunlardır: başarılı ödeme, yetersiz bakiye veya reddedilen kart, hatalı doğrulama kodu ve 3D Secure adımının yarıda bırakılması. Her senaryoda sipariş durumunun doğru güncellendiğini, müşteriye gösterilen mesajın anlaşılır olduğunu ve bildirimin sunucunuza ulaştığını kontrol edin. Test ortamının kapsamı ve gerçek para hareketi olmadan yapılabilecek işlemler için test ortamı (sandbox) sayfasına bakabilirsiniz.

Aynı bildirimin iki kez gelebileceğini varsayarak sipariş güncellemesini, tekrar çalıştırıldığında sonucu değiştirmeyecek biçimde kurun. Günlük kayıtlarında kart numarası, doğrulama kodu ve anahtar bilgisi bulunmamalıdır. Akış doğrulandıktan sonra yalnızca ortam seçimi ve anahtar değerleri canlıya çevrilir; modül yapılandırmasının geri kalanı aynı kalır.

Mağazanızı başka bir platformda kurmayı düşünüyorsanız WooCommerce ve PrestaShop entegrasyon sayfalarına, e-ticaret sitelerinde ödeme adımının genel kurgusu için e-ticaret sanal POS sayfasına, modül yerine kendi yazılımınızdan bağlanmak için API ve SDK entegrasyonu sayfasına bakabilirsiniz.

Teknik gereksinimler

Sürüm bilgileri genel çerçevedir; kesin gereksinimler ve desteklenen sürümler, hesabınız açıldığında iletilen dokümantasyonda belirtilir.