İstanbul yazılım firması · 12 yıllık deneyim

Sanal POS entegrasyonu nedir, nasıl yapılır?

Sanal POS entegrasyonu, web sitenizin ya da yazılımınızın bir bankanın veya ödeme kuruluşunun ödeme altyapısına bağlanarak kartla tahsilat yapmasıdır. Siteniz ödemeyi sunucudan başlatır, müşteri kart bilgisini sağlayıcının güvenli formuna girer, sonuç sitenize geri bildirilir ve sipariş buna göre onaylanır. İşin zor kısmı formu göstermek değil, sonucu sunucuda doğrulamak ve aynı ödemeyi iki kez işlememektir.

Sanal POS entegrasyonu nedir, nasıl yapılır?

İstanbul Yazılım · · 12 dk okuma

Yapay zeka ile özetle:ChatGPTGeminiPerplexityClaude

İçindekiler
  1. Sanal POS entegrasyonu nedir?
  2. Banka sanal POS’u mu, ödeme kuruluşu mu?
  3. Entegrasyon yöntemleri: Yönlendirme, iframe ve API
  4. Sanal POS entegrasyonu nasıl yapılır?
  5. Kart bilgisi ve PCI DSS: Sorumluluk kimde?
  6. Maliyet neye göre değişir?
  7. Sık yapılan hatalar
  8. Mobil uygulamada durum farklı mı?
  9. Entegrasyonu kim yapmalı?
  10. Sık sorulan sorular

Teknik ayrıntıları Kasım 2026 itibarıyla iyzico’nun ve PayTR’nin herkese açık geliştirici dokümanlarından, kuruluş listelerini Merkez Bankası’nın sitesinden, kart güvenliği kısmını PCI Güvenlik Standartları Konseyi’nin yayınlarından kontrol ettik. Sağlayıcılar dokümanlarını sık günceller; kurulumdan önce kendi sağlayıcınızın güncel sayfasına bakın.

Sanal POS entegrasyonu nedir?

Sanal POS, mağazadaki kart cihazının internetteki karşılığıdır: fiziksel cihaz olmadan kredi kartı ve banka kartıyla tahsilat yapmanızı sağlayan yazılım altyapısı. Entegrasyon ise bu altyapıyı sitenizin sipariş akışına bağlama işidir.

Bağlantı kurulduğunda üç şey otomatik olur:

  • Müşteri sepeti onayladığında siteniz ödeme tutarını ve sipariş numarasını sağlayıcıya iletir.
  • Müşteri kartını sağlayıcının formuna girer, bankası gerekirse SMS koduyla doğrulama ister (3D Secure).
  • Sağlayıcı sonucu sitenize bildirir; siteniz siparişi onaylar, stoğu düşer, faturayı keser ve müşteriye bilgi verir.

Entegrasyon olmadan bu adımların her biri elle yapılır: havale beklenir, dekont kontrol edilir, sipariş elle onaylanır.

Banka sanal POS’u mu, ödeme kuruluşu mu?

Sanal POS’u iki yerden alabilirsiniz: doğrudan bir bankadan ya da iyzico, PayTR gibi bir ödeme kuruluşundan. İkisi de aynı işi görür ama başvurusu, entegrasyonu ve para akışı farklıdır.

Banka sanal POS’u Ödeme kuruluşu
Sözleşme Her bankayla ayrı üye iş yeri sözleşmesi Tek sözleşme, birçok bankanın kartı
Entegrasyon Her banka için ayrı doküman ve ayrı bağlantı Tek API ile bütün kartlar
Paranın hesaba geçişi Bankayla anlaştığınız modele göre Kuruluşun ödeme takvimine göre
Kime uygun? Cirosu yüksek, oranı bankayla pazarlık edebilen işletme Yeni başlayan ya da tek entegrasyonla ilerlemek isteyen işletme

Banka tarafında modelin nasıl değiştiğine bir örnek: Akbank, Sanal POS sayfasında “Ertesi Gün Ödeme” ve paranın 30 gün sonra hesaba geçtiği “Blokeli Çalışma” gibi farklı modeller sunduğunu yazar. Komisyon oranı da bu seçime göre değişir; oranları karşılaştırırken paranın kaç gün sonra hesaba geçtiğini mutlaka yanına yazın.

Ödeme kuruluşu seçecekseniz önce lisansını kontrol edin. Türkiye’de ödeme hizmeti sunan kuruluşlar 6493 sayılı Kanun kapsamında faaliyet izni alır ve Merkez Bankası faaliyette olanları iki ayrı listede yayımlar: ödeme kuruluşları ve elektronik para kuruluşları. Kasım 2026’da iyzico (İyzi Ödeme ve Elektronik Para Hizmetleri A.Ş.) ve PayTR ikinci listede yer alıyor. Aynı sayfalarda izni iptal edilen kuruluşlar da listelenir; adını ilk kez duyduğunuz bir sağlayıcıyla çalışmadan önce bu listeye bakmak iki dakikanızı alır.

İkisini birlikte kullanmak da mümkündür: örneğin oranını pazarlıkla düşürdüğünüz bir banka POS’u ve yanında bir ödeme kuruluşu. Bu durumda hangi ödemenin hangi POS’tan geçeceğine karar veren kuralı yazılım uygular.

Entegrasyon yöntemleri: Yönlendirme, iframe ve API

Sağlayıcılar aynı ödemeyi birkaç farklı yöntemle almanıza izin verir. Aradaki asıl fark, kart numarasının sizin sunucunuza değip değmediğidir.

Yöntem Müşteri ne görür? Kart bilgisi nereden geçer? Size düşen iş
Yönlendirme (ortak ödeme sayfası) Sağlayıcının sayfasına gider, ödeyip sitenize döner Yalnızca sağlayıcıdan En az
Gömülü form (iframe, pop-up) Sitenizden ayrılmaz, form sayfanın içinde açılır Yalnızca sağlayıcıdan Az; formu barındıran sayfanın güvenliği sizde
Doğrudan API Kart formu tamamen sizin tasarımınızdır Sizin sunucunuzdan En çok; kart verisi güvenliği yükü sizde

iyzico’nun ödeme formu ilk iki yöntemi tek üründe verir: dokümana göre form responsive, pop-up, iframe ya da yönlendirme biçiminde kullanılabilir. PayTR’nin iFrame API’si de aynı mantıkla çalışır: sunucunuz bir token alır, form bu token ile sayfanıza gömülür.

Çoğu e-ticaret sitesi için doğru başlangıç gömülü form ya da yönlendirmedir. Doğrudan API, ödeme ekranının her pikselini kendiniz tasarlamak istediğinizde anlam kazanır ve karşılığında ciddi bir güvenlik sorumluluğu getirir. Bu konuya aşağıda dönüyoruz.

Sanal POS entegrasyonu nasıl yapılır?

Adımlar sağlayıcıdan sağlayıcıya ad değiştirir ama sıra hep aynıdır.

1. Sitenizi başvuruya hazırlayın

Sağlayıcı başvuruyu değerlendirirken sitenize bakar. Akbank’ın sanal POS rehberi sitede aranan başlıkları şöyle sayar: SSL sertifikası, mesafeli satış sözleşmesi, iade ve iptal politikası, gizlilik politikası, açık iletişim bilgileri, ürün ya da hizmet açıklamaları, firma bilgileri ve teslimat koşulları. Aynı rehbere göre şahıs şirketleri de gerekli belgeleri tamamlayarak başvurabilir; istenen belgeler arasında vergi levhası, imza sirküleri ve kimlik örneği sayılır, şirket türüne göre liste değişir.

Bu metinlerin ne olduğunu ve nasıl hazırlandığını e-ticaret sitesi kurmak için gerekli evraklar yazımızda anlattık. Başvuruyu, site yayına hazır hâle geldikten sonra yapın; yarım bir siteyle yapılan başvuru geri döner.

2. Test ortamını ve anahtarları alın

Entegrasyon gerçek kartla değil, test ortamında yazılır. iyzico’da bunun için ayrı bir sandbox hesabı açılır; dokümana göre test ortamının adresi de anahtarları da canlıdan tamamen farklıdır, sandbox anahtarları “sandbox-” önekiyle gelir ve bu ortamda yalnızca test kartları çalışır. PayTR’de mağaza canlıdayken bile istek test_mode alanıyla test işlemi olarak gönderilebilir.

Anahtarlar parola değerindedir. Koda yazılmaz, depoya gönderilmez; sunucuda ortam değişkeni ya da gizli anahtar kasasında durur. Test ve canlı anahtarlarını ayrı ayar dosyalarında tutun ki biri diğerinin yerine geçmesin.

3. Ödemeyi sunucudan başlatın

Ödeme isteği tarayıcıdan değil, sunucunuzdan gider. Sunucu sipariş numarasını, tutarı, sepeti ve müşteri bilgilerini sağlayıcıya gönderir, karşılığında o ödemeye özel bir token alır. İstek, gizli anahtarınızla üretilen bir imza taşır; sağlayıcı böylece isteğin sizden geldiğini ve yolda değişmediğini anlar. PayTR bu değeri dokümanında tam da böyle tanımlar.

İki kural burada belirlenir:

  • Tutarı sunucu hesaplar. Tarayıcıdan gelen fiyata güvenilmez; sunucu sepeti kendi veritabanından okuyup tutarı kendisi yazar.
  • Tutarın biçimine dikkat edilir. PayTR’de tutar 100 ile çarpılarak gönderilir (34,56 TL için 3456). Kuruşu yanlış yere koyan bir entegrasyon, müşteriden yüz kat fazla ya da eksik tahsilat ister.

4. Ödeme formunu gösterin

Alınan token ile form açılır: ya müşteri sağlayıcının sayfasına yönlendirilir ya da form sayfanıza gömülür. Kart numarası, son kullanma tarihi ve güvenlik kodu bu formda girilir, 3D Secure doğrulaması da burada yapılır. Sitenizin bu adımda tek görevi, formu doğru siparişle açmak ve müşteri “Öde” düğmesine bastıktan sonra sayfayı kapatmaması için açık bir bekleme mesajı göstermektir.

5. Sonucu sunucuda doğrulayın

Entegrasyonların en sık hata yapılan yeri burasıdır. Müşterinin “ödeme başarılı” sayfasına dönmesi, ödemenin alındığını kanıtlamaz. O adresi bilen biri tarayıcısına elle yazabilir.

Kesin sonuç iki yoldan gelir ve ikisi de sunucudan sunucuyadır:

  • Sorgu: iyzico’da müşteri sitenize bir token ile döner. Sunucunuz bu token ile ikinci bir sorgu yapar ve ödemenin gerçek durumunu iyzico’dan okur.
  • Bildirim (callback, webhook): Sağlayıcı sonucu arka planda sizin belirlediğiniz adrese gönderir. PayTR altyapısı bu şekilde çalışır; başarılı sayfasına hiçbir veri gönderilmez, sipariş yalnızca Bildirim URL’sine gelen sonuçla onaylanır.

Bildirim sayfasını yazarken sağlayıcının kurallarına harfiyen uyulur. PayTR örneğinde:

  • Gelen bildirimin imzası (hash) kendi anahtarınızla yeniden hesaplanıp karşılaştırılır. Dokümanın uyarısı açık: “Bu kontrolü yapmamanız durumunda maddi kayıplar ile karşılaşabilirsiniz.”
  • Yanıt düz metin olarak yalnızca OK olmalıdır; öncesinde ya da sonrasında HTML basılmaz. Aksi hâlde PayTR bildirimi başarısız sayar ve sipariş panelde “Devam Ediyor” görünür.
  • Sayfa üye girişi arkasında olamaz ve oturum (session) değerlerine güvenemez; siparişi sipariş numarasından bulur.

iyzico tarafında webhook, dokümana göre ödeme denemesinden 10-15 saniye sonra gönderilir ve sunucunuz 2xx yanıtı vermezse 15 dakika arayla üç kez yinelenir. İmza X-IYZ-SIGNATURE-V3 başlığında gelir. iyzico ayrıca webhook’un tek başına yeterli sayılmamasını, bildirim geldikten sonra sonucun sorguyla teyit edilmesini önerir.

6. Aynı ödemeyi iki kez işlemeyin

Bildirimler birden fazla kez gelebilir. PayTR bunu dokümanında yazar ve yalnızca ilk bildirimin dikkate alınmasını, sonrakilerde müşteriye yeniden ürün ya da hizmet verilmemesini ister. iyzico da servislerinin çoğunun aynı isteği ikinci kez gönderdiğinizde bunu ayırt etmediğini, aynı ödeme isteği iki kez giderse iki ayrı çekim oluşabileceğini belirtir.

Bu yüzden korumayı kendi tarafınızda kurarsınız:

  • “Öde” düğmesi ilk tıklamada kilitlenir.
  • Sipariş “ödendi” durumuna yalnızca bir kez geçer; aynı sipariş numarasıyla gelen ikinci bildirim yalnızca onaylanır, stok ve e-posta yeniden tetiklenmez.
  • İstek zaman aşımına uğradıysa ödeme körü körüne yeniden gönderilmez; önce sağlayıcıdan durumu sorgulanır.
  • Gece çalışan bir mutabakat işi, “bekliyor” durumunda kalmış siparişleri sağlayıcıdan sorgulayıp kapatır.

7. İptal ve iadeyi panelinize bağlayın

Satış kadar iade de entegrasyonun parçasıdır. Yoksa her iade için sağlayıcının paneline girip elle işlem yapar, sonra kendi sisteminizde siparişi ayrıca güncellersiniz. Kurallar sağlayıcıya göre değişir; iyzico’da iptal aynı gün ve yalnızca tam tutar için, iade ise 365 gün içinde tam ya da kısmi olarak yapılır. Yönetim panelinizde “iade et” düğmesi bu servisleri çağırmalı, kısmi iade tutarını denetlemeli ve muhasebe kaydını oluşturmalıdır.

8. Canlıya geçmeden önce test edin

Yalnızca başarılı ödemeyi denemek yetmez. Canlıya geçmeden önce en az şu senaryolar çalıştırılır:

  • Başarılı ödeme: sipariş onaylandı, stok düştü, e-posta bir kez gitti
  • Yetersiz bakiye ve reddedilen kart: müşteriye anlaşılır mesaj, sepet kaybolmadı
  • 3D Secure ekranında vazgeçme: sipariş ödenmemiş kaldı
  • Müşteri ödedi ama tarayıcıyı kapattı: sipariş yine de bildirimle onaylandı
  • Aynı bildirim iki kez geldi: sipariş bir kez işlendi
  • Sahte imzalı bildirim: istek reddedildi, sipariş değişmedi
  • “Öde” düğmesine çift tıklama: tek çekim
  • Tam ve kısmi iade: tutarlar doğru, sipariş durumu güncel
  • Taksitli ödeme: vade farkı varsa tahsil edilen tutar doğru kaydedildi

Test ortamı bittikten sonra canlı anahtarlarla küçük bir gerçek işlem yapılır. iyzico, canlıda gerçek kartla düşük tutarlı bir ödeme yapılmasını, bildirimin geldiğinin doğrulanmasını ve ödemenin aynı gün iptal edilmesini önerir.

Kart bilgisi ve PCI DSS: Sorumluluk kimde?

Kart verisine dokunan her sistem, kart kuruluşlarının ortak güvenlik standardı olan PCI DSS kapsamına girer. Yöntem seçimi bu yükün ne kadarının size kalacağını belirler.

Yönlendirmede ve gömülü formda kart numarası sizin sunucunuza hiç gelmez; saklama ve işleme sorumluluğu sağlayıcıdadır. Yine de gömülü form sizin sayfanızın içinde açıldığı için sayfanın kendisi önem kazanır. PCI Güvenlik Standartları Konseyi’nin Şubat 2025 tarihli açıklamasına göre sağlayıcının formunu iframe gibi bir yöntemle sayfasına gömen işletme, sitesinin zararlı script saldırılarına açık olmadığını doğrulamalıdır. Bunun iki yolu vardır: sayfadaki script’leri denetleyen ve değişiklikleri izleyen teknikleri uygulamak ya da sağlayıcıdan, çözümünün talimatlara uygun kurulduğunda ödeme sayfasını bu saldırılardan koruduğuna dair teyit almak. Aynı açıklama, bu koşulun müşteriyi sağlayıcının sayfasına yönlendiren işletmeler için geçerli olmadığını da belirtir.

Uygulamadaki karşılığı şudur: ödeme sayfanıza gereksiz üçüncü taraf script’i koymayın, eklentileri güncel tutun ve hangi beyan formunu doldurmanız gerektiğini sağlayıcınıza ya da bankanıza sorun.

Doğrudan API’de kart numarası sunucunuzdan geçer ve standardın çok daha geniş bir bölümü size uygulanır. Kart bilgisini kendi veritabanınıza yazmak ise hiçbir koşulda yapılacak iş değildir; “kartımı kaydet” özelliği sağlayıcının kart saklama servisiyle kurulur, sizde yalnızca sağlayıcının verdiği anahtar durur.

Maliyet neye göre değişir?

İki ayrı kalem vardır: sağlayıcıya ödediğiniz işlem maliyeti ve entegrasyonun geliştirme bedeli.

İşlem tarafında herkese uyan tek bir oran yoktur. Akbank’ın rehberi maliyeti belirleyen başlıkları aylık işlem hacmi, sektör, risk seviyesi, taksit sayısı, tek çekim oranı, ters ibraz riski ve yurt dışı kartlarla ödeme alınıp alınmadığı olarak sıralar. Teklif alırken şunları aynı tabloya yazın:

  • Tek çekim ve taksitli işlem oranları
  • Paranın hesaba geçiş süresi ve bu sürenin orana etkisi
  • İşlem başına sabit ücret, aylık ya da yıllık kullanım bedeli olup olmadığı
  • İade ve ters ibraz işlemlerinde kesinti yapılıp yapılmadığı
  • Yabancı kartlarda oranın değişip değişmediği

Geliştirme tarafında bedeli kapsam belirler: kaç sağlayıcının bağlanacağı, taksit seçeneklerinin sepette gösterilip gösterilmeyeceği, kart saklama, abonelik, iade ekranı, e-fatura ve muhasebe bağlantısı. Hazır bir e-ticaret altyapısında yaygın sağlayıcıların eklentisi çoğu zaman hazırdır ve iş anahtarları girmekten ibarettir. Özel yazılmış bir sitede ya da kurala bağlı bir akışta (birden fazla POS arasında yönlendirme, pazaryeri modeli, parçalı ödeme) entegrasyon ayrı bir geliştirme kalemidir.

Sık yapılan hatalar

  • Siparişi “başarılı” sayfasında onaylamak. Onay yalnızca imzası doğrulanmış bildirimle ya da sunucudan yapılan sorguyla verilir.
  • Bildirim imzasını kontrol etmemek. Adresi bilen herkes sahte “ödendi” bildirimi gönderebilir.
  • Tekrarlanan bildirimi yeniden işlemek. Aynı siparişe iki kez ürün gönderilir ya da iki kez e-posta gider.
  • Tutarı tarayıcıdan almak. Fiyat, sayfadaki gizli bir alandan okunuyorsa değiştirilebilir.
  • Test anahtarıyla canlıya çıkmak. Ödeme alıyor gibi görünür ama para gelmez. Ters durumda test sırasında gerçek kartlar çekilir.
  • Bildirim adresini giriş ekranının ya da güvenlik duvarının arkasında bırakmak. Sağlayıcı ulaşamaz, siparişler “bekliyor” durumunda kalır.
  • İadeyi unutmak. Satış otomatik, iade elle yürürse muhasebe ile panel kısa sürede birbirini tutmaz.
  • Hata mesajını ham göstermek. “İşlem reddedildi, kod 51” yerine müşteriye ne yapacağını söyleyen bir cümle yazılır ve sepet korunur.

Mobil uygulamada durum farklı mı?

Fiziksel ürün ve hizmet satan uygulamalarda aynı sanal POS kullanılır; dijital içerik ve abonelikte ise mağazaların kendi ödeme sistemi devreye girer. Ayrımı ve kuralları mobil uygulamaya ödeme sistemi ekleme yazımızda ayrıntılı anlattık.

Entegrasyonu kim yapmalı?

Hazır altyapı kullanıyorsanız ve tek bir sağlayıcıyla çalışacaksanız eklentiyi kurup yukarıdaki test listesini kendiniz yürütebilirsiniz. Site özel yazılmışsa, birden fazla POS kullanılacaksa ya da ödeme ERP, muhasebe ve kargo akışlarına bağlanacaksa işi bir geliştiriciye bırakmak daha ucuza gelir, çünkü hatanın bedeli doğrudan paradır.

Biz yeni kurduğumuz mağazalarda ödeme adımını baştan bu kurallarla yazıyoruz: E-ticaret sitesi yaptırma hizmetimizde sanal POS bağlantısı, bildirim doğrulaması, iade ekranı ve test listesi teslimin parçasıdır. Mevcut bir sisteme ödeme eklemek, POS değiştirmek ya da birden fazla POS’u tek akışta toplamak istiyorsanız özel yazılım geliştirme tarafında mevcut kodunuzu inceleyip kapsamı ve süreyi yazılı olarak bildiriyoruz.

Sık sorulan sorular

Sanal POS entegrasyonu için şirket gerekir mi?

Bankalar ve ödeme kuruluşları sanal POS’u genellikle vergi kaydı olan bir işletmeye açar ve başvuruda vergi levhası ister. Şirketin limited ya da anonim olması gerekmez; Akbank’ın rehberine göre şahıs şirketleri de gerekli belgelerle başvurabilir. Belge listesi sağlayıcıya göre değiştiği için başvurmadan önce seçtiğiniz sağlayıcının listesine bakın.

Sanal POS entegrasyonu ne kadar sürer?

İki ayrı süre vardır. Başvurunun onayı sağlayıcıya ve belgelerinizin eksiksiz olmasına bağlıdır. Teknik entegrasyonun süresini ise kapsam belirler: hazır eklentiyle tek sağlayıcı kısa bir iştir; özel yazılımda iade, taksit, kart saklama ve mutabakat eklendikçe süre uzar. Başvuru beklenirken geliştirme test ortamında ilerleyebilir.

3D Secure zorunlu mu?

3D Secure, ödeme sırasında kart sahibinin bankası tarafından SMS koduyla doğrulanmasıdır ve kart dolandırıcılığı riskini düşürür. Sağlayıcıların hazır ödeme formları bu adımı kendisi yönetir. 3D Secure’suz işlem açılıp açılamayacağı sağlayıcınızla yaptığınız sözleşmeye bağlıdır; biz yeni mağazalarda kapatılmasını önermiyoruz.

Birden fazla sanal POS kullanılabilir mi?

Evet. Her sağlayıcıyla ayrı sözleşme yapılır ve her biri ayrı bağlanır. Hangi ödemenin hangi POS’tan geçeceğini (örneğin orana, taksit seçeneğine ya da bir POS’un o an yanıt verip vermediğine göre) yazılımınızdaki kural ya da bu işi yapan bir ara katman belirler. POS sayısı arttıkça test edilecek senaryo sayısı da artar.

Sanal POS ile ödeme linki arasındaki fark nedir?

Ödeme linkinde site entegrasyonu yoktur: sağlayıcının panelinden bir bağlantı üretir, müşteriye gönderirsiniz. Sipariş, stok ve fatura sisteminize kendiliğinden işlenmez. Az sayıda ve elle takip edilen satışlar için yeterlidir; sepeti olan bir sitede entegrasyonun yerini tutmaz.

Yabancı kartlardan ve dövizle ödeme alınır mı?

Sağlayıcıya ve sözleşmenize bağlıdır. Akbank’ın rehberi yurt dışı kartlarla ödeme alınmasını maliyeti etkileyen başlıklar arasında sayar; oran ve koşullar yerli kartlardan farklı olabilir. Yurt dışına satış planlıyorsanız bunu başvuruda belirtin ve teklifte ayrı satır olarak isteyin.

Bu yazı genel bilgi verir; oranlar, ödeme takvimleri ve teknik kurallar sağlayıcıya göre değişir. Kurulumdan önce sağlayıcınızın güncel dokümanını ve sözleşmenizi esas alın.

Projenizi anlatın, kapsamı ve fiyatı yazılı olarak iletelim.

İlk görüşme ücretsizdir. Fikriniz henüz net değilse de yazın; neyin yapılmaya değer olduğunu birlikte çıkarırız.