RentonDiji
Özel Yazılım ve Ödeme

Ö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.

Kısa cevap: Özel yazılıma sanal POS entegrasyonu beş parçadan oluşur: ödeme modeli seçimi (kart bilgisini bankanın sayfası mı, sizin formunuz mu alacak), ödemenin başlatılması, 3D Secure dönüşünün imza ve tutar kontrolüyle doğrulanması, borcun ya da siparişin tek seferde güncellenmesi ve iade ile mutabakat. Her parça bankanın test ortamında başarılı ödeme, hatalı kart, doğrulamada vazgeçme, zaman aşımı ve iade senaryolarıyla denendikten sonra canlıya alınır; ilk canlı işlem küçük tutarla yapılır.

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:

ModelKart bilgisi nerede alınır?Size düşen güvenlik yükü
Bankanın ödeme sayfası (3D Host ve benzerleri)Bankanın sayfasındaDüşük; kart verisi sunucunuza gelmez
Kendi formunuz (3D Pay, 3D model)Sizin sayfanızda, bankaya siz iletirsinizYü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ı

  1. Ö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.
  2. 3D Secure doğrulaması: Müşteri bankasının doğrulama ekranında SMS koduyla onay verir.
  3. 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.
  4. Durumun güncellenmesi: Borç ya da sipariş tek bir veritabanı işlemiyle kapanır, makbuz ve bildirimler bunun ardından üretilir.
  5. İ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 isteyin

Sahadan 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.
Kurulumdan bir not: Aynı panelde ekranda "taksit" seçeneği vardı ama bankaya taksit sayısı hiç gönderilmiyordu; veli vade farkını ödüyor, kart yine tek çekim çekiliyordu. Taksit sayısını bankaya ödeme isteğinin içinde gönderecek şekilde düzelttik ve taksit uygulanmaması gereken kalemleri tek çekime sabitledik. Taksit kuruyorsanız ilk kontrolünüz banka ekstresinde işlemin gerçekten taksitli göründüğü olmalı.

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.

İlgili sayfalar

Sanal POS entegrasyonuBanka ve ödeme kuruluşlarıOpenCart entegrasyonuOpenCart için eklentiPrestaShop entegrasyonuPrestaShop modülüÜcretsiz ön görüşmeSisteminizi anlatın

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
Teklif Alın

Ö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

Ya da numaranızı bırakın, biz arayalım

Kısa bir not yeterli. Mesai içinde aynı gün dönülür.

Parola, API anahtarı veya kart bilgisi yazmayın. Bilgileriniz yalnızca talebinize dönüş yapmak için kullanılır (KVKK).