Özel Yazılıma Sanal POS Entegrasyonu Nasıl Yapılır?
WooCommerce'te hazır eklenti işin çoğunu görür. Özel yazılmış bir panelde ise ödeme akışını sisteminizin mantığına göre sizin kurmanız gerekir.
Sanal POS entegrasyonu denince çoğu kişinin aklına WooCommerce eklentileri gelir. Oysa birçok işletme ödemesini kendine özel yazılmış bir sistemde alır: okul ve aidat panelleri, rezervasyon ve üyelik sistemleri, bayi sipariş ekranları ya da OpenCart, PrestaShop gibi farklı altyapılar. Bu sistemlerde hazır eklenti ya yoktur ya da işletmenin akışına uymaz. Bu yazıda özel bir sisteme sanal POS bağlarken hangi kararların verildiğini, hangi parçaların yazıldığını ve canlı ödeme alan bir okul panelinde karşılaştığımız hataları anlatıyoruz.
Sisteminize sanal POS bağlayalım
Kullandığınız yazılımı ya da altyapıyı ve çalıştığınız bankayı yazın; entegrasyon modelini ve kapsamını birlikte çıkaralım.
Sanal POS entegrasyonuÖnce model: kart bilgisini kim alacak?
Entegrasyonun ilk kararı, müşterinin kart bilgisini nereye yazacağıdır. Bankaların sunduğu modeller adlarıyla farklılık gösterse de iki ana yola ayrılır:
| Model | Kart bilgisi nerede alınır? | Size düşen güvenlik yükü |
|---|---|---|
| Bankanın ödeme sayfası (3D Host ve benzerleri) | Bankanın sayfasında | Düşük; kart verisi sunucunuza gelmez |
| Kendi formunuz (3D Pay, 3D model) | Sizin sayfanızda, bankaya siz iletirsiniz | Yüksek; kart verisi sisteminizden geçer |
Kendi formunuz görünüm üzerinde tam kontrol sağlar ve müşteri sitenizden ayrılmaz. Karşılığında kart numarası sunucunuzdan geçtiği için hiçbir log, hata kaydı ya da veritabanı alanının kart verisi tutmaması gerekir. Çoğu işletme için bankanın sayfası daha az riskli başlangıçtır.
Entegrasyonun parçaları
- Ödemenin başlatılması: Sistem, ödenecek borç ya da sipariş için tek bir işlem kimliği üretir; tutar bankanın istediği biçimde (çoğunlukla kuruş cinsinden) gönderilir.
- 3D Secure doğrulaması: Müşteri bankasının doğrulama ekranında SMS koduyla onay verir.
- Dönüşün doğrulanması: Bankanın gönderdiği sonuç, banka anahtarıyla hesaplanan imzayla kontrol edilir; tutar ve işlem kimliği sizin kaydınızla eşleşmeden hiçbir şey "ödendi" yapılmaz.
- Durumun güncellenmesi: Borç ya da sipariş tek bir veritabanı işlemiyle kapanır, makbuz ve bildirimler bunun ardından üretilir.
- İade ve mutabakat: Bankanın işlem numarası saklanır; iade ve ay sonu karşılaştırması bu numara üzerinden yapılır.
Altyapınız için hazır eklenti bulamadınız mı?
Özel yazılımlar için entegrasyon, işinizin akışına göre yazılır. Sisteminizi ve bankanızı anlatın.
Ücretsiz ön görüşme isteyinSahadan dört hata
Canlı ödeme alan bir okul panelinde VakıfBank ve Garanti BBVA'yı bağlarken karşılaştığımız sorunlar, özel yazılımlarda sık görülen tuzakları iyi özetliyor:
- Ters proxy arkasında müşteri IP'si: Garanti BBVA testinde 3D doğrulaması geçtiği hâlde işlem reddedildi. Uygulama Docker ve ters proxy arkasında çalıştığı için bankaya müşteri IP'si olarak iç ağ adresi gidiyordu. IP alanını temizleyip geçerli dış adres gönderilince işlem onaylandı.
- Aynı borca eş zamanlı iki ödeme: İki sekmeden aynı anda ödeme başlatılırsa, borç satırı kilitlenmeden okunduğunda iki çekim tek düşüm yapabilir. Ödeme sırasında borç satırını kilitleyerek bunu kapattık.
- Geç gelen olumsuz bildirim: Başarılı ödemeden sonra aynı işlem için imzalı ama olumsuz bir bildirim gelirse, ödenmiş kayıt "başarısız"a dönmemelidir. İşlem zaten ödendiyse bildirim kayda geçirilip durum korunuyor.
- Canlıda açık kalan test sağlayıcısı: Geliştirme için kullanılan sahte ödeme yöntemi canlıda kapatılmazsa borç para çekilmeden kapatılabilir. Canlı ortamda yalnız gerçek bankalara izin veren bir kontrol ekledik.
Test planı
Canlıya geçmeden önce bankanın test ortamında şu senaryoların hepsi denenir: başarılı ödeme, hatalı kart, yetersiz bakiye, 3D ekranında vazgeçme, zaman aşımı, kuruşlu tutar, aynı bildirimin iki kez gelmesi, tam ve kısmi iade. Test ve canlı ortam bilgileri ayrı tutulur; anahtarlar kodun içine değil, sunucudaki ayar dosyasına yazılır. Canlıya geçişte küçük tutarlı gerçek bir ödeme yapılır, banka panelindeki kayıtla sistemdeki kayıt karşılaştırılır ve ardından iade edilir.
OpenCart ve PrestaShop'ta durum
Bu altyapılarda bankaların ya da üçüncü tarafların hazır modülleri olabilir. Hazır modül kullanacaksanız sürüm uyumunu, dönüş imzasının doğrulanıp doğrulanmadığını ve iade desteğini kontrol edin; eksik olan kısım için modülü uyarlamak çoğu zaman sıfırdan yazmaktan daha hızlıdır. Kapsam için OpenCart ve PrestaShop sayfalarımıza bakabilirsiniz.
Süre ve fiyat
Süreyi en çok bankanın test ortamı erişiminin ne kadar hızlı geldiği belirler. Fiyat; banka sayısına, seçilen modele, taksit ve iade otomasyonuna göre değişir; projeler 5.000 ₺'den başlar. Genel kapsam sanal POS entegrasyonu sayfamızda, bankaya özel sayfalar VakıfBank ve Garanti BBVA için ayrıca var.
Sıkça sorulan sorular
Kart bilgisi kendi sunucumdan geçerse ne değişir?
Kart bilgisini kendi formunuzla alıp bankaya iletirseniz, kart verisi sisteminizden geçtiği için PCI DSS güvenlik gereksinimleri ağırlaşır; kart numarası ve CVV hiçbir kayıtta ve logda tutulmamalıdır. Bankanın barındırdığı ödeme sayfasını kullanan modelde bu yük büyük ölçüde bankada kalır.
Her banka için ayrı entegrasyon mu yazılır?
Akışın ortak kısmı bir kez yazılır; bankaya özel imza, alan adları ve adresler ayrı bir katmanda tutulur. Böylece ikinci bir bankayı eklemek baştan yazmayı gerektirmez.
Hangi bankalarla canlı tecrübeniz var?
VakıfBank, Garanti BBVA ve QNB ile canlı ödeme alan sistemler kurduk. Diğer bankalarda, bankanın verdiği entegrasyon dokümanı ve test ortamı üzerinden çalışıyoruz.
Taksitli ödeme nasıl eklenir?
Taksit sayısı bankaya ödeme isteğinin içinde gönderilir ve banka hesabınızın taksite açık olması gerekir. Yalnız ekranda vade farkı eklemek taksit değildir; kart yine tek çekim çekilir.
Resmî ve teknik kaynaklar
İlgili sayfalar
Sitenizin sağlığını 1 dakikada ücretsiz kontrol edin
Güvenlik sertifikası, mobil uyum, hız ve Google görünürlüğünü test edip sorunları sade bir dille gösteriyoruz. Kayıt gerekmez.
Ücretsiz Site Sağlık TestiÖdemeyi sisteminize güvenle bağlayalım
Yazılımınızın yapısını, bankanızı ve ödeme alacağınız senaryoları paylaşın; kapsamı ve net fiyatı çıkaralım.
WhatsApp'tan Yazın · Bilgi Alın+90 534 678 99 27