# Sanal POS entegrasyonu nasıl yapılır? E-ticarette ödeme altyapısı seçimi

> Sanal POS entegrasyonu, e-ticaret sitenizin kartla ödemeyi bir bankanın ya da lisanslı bir ödeme kuruluşunun altyapısı üzerinden almasını sağlayan bağlantıdır. Önce altyapı seçilir: banka sanal POS'u ya da ödeme kuruluşu. Sonra 3D Secure ile ödeme akışı, taksit, iade ve bildirimler kurulur, test ortamında denenir ve canlıya alınır. Kart bilgisini kendi sunucunuzda tutmamak hem güvenlik hem PCI DSS yükü açısından en sade yoldur.

- Adres: https://radkod.com/blog/sanal-pos-entegrasyonu
- Yayıncı: RadKod
- Yayın: 2026-09-07

## Kısaca

- Sanal POS entegrasyonu iki yoldan yapılır: doğrudan bir bankanın sanal POS'u ya da lisanslı bir ödeme kuruluşu.
- Banka POS'u pazarlık payı verir ama her banka ayrı iştir. Ödeme kuruluşu tek bağlantıyla hızlı başlatır.
- Komisyon, valör ve taksit şartları altyapıya ve anlaşmanıza göre değişir. Teklifleri aynı senaryoyla karşılaştırın.
- Kart bilgisi sizin sunucunuza hiç uğramazsa hem güvenlik riski hem PCI DSS yükü azalır.
- Ödemenin sonucu tarayıcıya değil, sunucudan sunucuya gelen doğrulanmış bildirime göre kesinleşir.

## Sanal POS entegrasyonu nedir?

Sanal POS entegrasyonu, e-ticaret sitenizin kartla ödemeyi bir bankanın ya da ödeme kuruluşunun altyapısı üzerinden almasını sağlayan yazılım bağlantısıdır. Mağazadaki fiziksel POS cihazının internetteki karşılığıdır. Müşteri kart bilgisini girer, kartı veren banka ödemeyi onaylar ve para anlaşmanıza göre hesabınıza geçer.

Bu bağlantının iki tarafı vardır. Biri ticari taraftır: hangi kurumla anlaşacağınız, komisyon, valör ve taksit şartları. Diğeri teknik taraftır: ödeme ekranının nasıl açılacağı, sonucun nasıl doğrulanacağı, iadenin nasıl yapılacağı. Bu yazıda ikisini de anlatıyoruz. Kısa bir tanım için [sanal POS](/sozluk/sanal-pos) sözlük maddesine bakabilirsiniz.

## Banka sanal POS'u ile ödeme kuruluşu arasındaki fark nedir?

Fark, kiminle anlaştığınızdadır: banka sanal POS'unda doğrudan bir bankayla üye işyeri anlaşması yaparsınız, ödeme kuruluşunda ise bankalarla anlaşmış bir aracı kurumla tek anlaşma yaparsınız. Türkiye'de ödeme kuruluşları Türkiye Cumhuriyet Merkez Bankası'ndan lisans alarak çalışır. Anlaşma yapacağınız kurumun lisanslı olduğunu kontrol edin.

**Banka sanal POS'u ile ödeme kuruluşu karşılaştırması (genel eğilim, şartlar anlaşmaya göre değişir)**

|  | Banka sanal POS'u | Ödeme kuruluşu |
| --- | --- | --- |
| Anlaşma | Her bankayla ayrı üye işyeri anlaşması | Tek kurumla tek anlaşma |
| Başvuru | Banka değerlendirmesi, genellikle daha uzun sürer | Genellikle daha hızlı başlar |
| Komisyon | Hacminiz yüksekse pazarlık payı daha fazla | Genellikle sabit tarifeler, küçük hacimde pratik |
| Taksit | Çoğunlukla o bankanın kart programıyla sınırlı | Birçok bankanın kartında taksit tek bağlantıdan |
| Teknik iş | Her banka ayrı bağlantı ve ayrı test | Tek bağlantı, tek belge |
| Para akışı | Doğrudan bankadaki hesabınıza | Önce ödeme kuruluşuna, sonra hesabınıza |
| Kimin için uygun | Hacmi oturmuş, bankayla ilişkisi güçlü firmalar | Yeni başlayan ya da çok bankada taksit isteyen firmalar |

İkisi birbirinin alternatifi olmak zorunda değildir. Bazı firmalar ödeme kuruluşuyla başlar, hacim oturunca en çok satış yapılan kartın bankasıyla ayrıca anlaşır. Yazılım baştan birden fazla ödeme sağlayıcısını destekleyecek biçimde kurulursa bu geçiş küçük bir iş olur. Tek sağlayıcıya göre yazılmış bir sistemde ise ödeme kodunun yeniden yazılması gerekebilir.

## 3D Secure nedir, neden gerekli?

3D Secure, kart sahibinin ödeme sırasında kendi bankası tarafından doğrulandığı güvenlik adımıdır. Müşteri kart bilgisini girdikten sonra bankasının ekranına yönlenir ve telefonuna gelen kodla ya da bankacılık uygulamasındaki onayla ödemeyi doğrular. Böylece kartı çalınmış biri sadece kart numarasıyla ödeme yapamaz.

Türkiye'de e-ticaret ödemelerinin büyük çoğunluğu 3D Secure ile alınır. 3D doğrulaması olmadan ödeme almak ancak bankanın ya da ödeme kuruluşunun belirli koşullarla izin verdiği durumlarda mümkündür. Üstelik doğrulanmamış işlemlerde itiraz riski genellikle işyerinde kalır. Bu yüzden entegrasyonu 3D Secure ile kurarız. Terimin ayrıntısı [3D Secure](/sozluk/3d-secure) sözlük maddesinde.

Teknik olarak 3D akışında müşteri sitenizden çıkar, bankanın sayfasına gider ve geri döner. Bu dönüş anı entegrasyonun en hassas noktasıdır. Müşteri dönüşte sekmeyi kapatabilir, bağlantısı kopabilir ya da geri tuşuna basabilir. Sipariş durumu bu durumların hepsinde doğru kalmalıdır. Bunu aşağıda doğrulama başlığında anlatıyoruz.

## Komisyon ve valör nasıl işler?

Komisyon, her başarılı ödemeden kesilen hizmet bedelidir. Valör ise ödeme tutarının hesabınıza geçmesi için geçen süredir. İkisi birbirine bağlıdır: genel eğilim olarak parayı daha erken almak daha yüksek komisyon anlamına gelir, daha uzun valör kabul etmek komisyonu düşürebilir. Oranlar kuruma, sektöre, hacme ve anlaşmanıza göre değişir. Bu yüzden burada rakam vermiyoruz.

Teklifleri karşılaştırırken sadece ana komisyon oranına bakmayın. Şunları da sorun:

- Taksitli satışlarda komisyon nasıl değişiyor.
- Yurt dışı kartlarda ve ticari kartlarda farklı oran var mı.
- Valör süresi ne, para hangi gün hesaba geçiyor.
- İade yapıldığında kesilen komisyon geri veriliyor mu.
- Kurulum, aylık sabit ücret ya da asgari hacim şartı var mı.
- Tarife ne zaman ve nasıl değişebilir.

En doğru karşılaştırma, geçen yılki satışlarınızı örnek alıp her teklifte aynı senaryonun toplam maliyetini hesaplamaktır. Tek bir oranın düşük olması, toplamın da düşük olacağı anlamına gelmez.

## Taksit nasıl kurulur?

Taksit, müşterinin kart türüne göre ödeme ekranında sunulan ve vade farkının kime yansıyacağına sizin karar verdiğiniz bir seçenektir. Teknik olarak site, müşterinin girdiği kartın ilk hanelerinden kartın hangi programa ait olduğunu sorgular ve o kart için geçerli taksit seçeneklerini gösterir.

Taksitte üç karar vardır. Hangi taksit sayıları sunulacak. Vade farkını müşteri mi ödeyecek, siz mi üstleneceksiniz. Hangi ürünlerde taksit olacak. Bazı ürün gruplarında taksit sayısı mevzuatla sınırlandırılmıştır ve bu sınırlar zaman içinde değişebilir. Satış yaptığınız ürünler için güncel kuralları bankanıza ya da ödeme kuruluşunuza sorun.

Ekranda gösterilen taksit tutarı ile bankaya gönderilen tutarın birebir aynı olması gerekir. Vade farkı sepette bir yerde, ödemede başka bir yerde hesaplanırsa kuruşluk farklar çıkar ve muhasebede iş yaratır. Bu hesabı tek bir yerde yaparız.

## İade ve iptal nasıl yönetilir?

İptal, ödeme henüz günlük kapanışa girmeden işlemin tamamen geri alınmasıdır. İade ise kapanıştan sonra tutarın kısmen ya da tamamen müşteriye geri gönderilmesidir. Ekranda ikisi aynı "iade et" düğmesiyle görünebilir ama arka planda farklı işlemlerdir ve komisyon etkileri farklı olabilir.

- Yönetim panelinden kısmi iade yapılabilmeli. Üç ürünlü siparişte bir ürün iade edilir.
- Taksitli bir satışın iadesinin müşteriye nasıl yansıdığını kurumunuza sorun.
- İade kaydı siparişe, stoğa ve faturaya birlikte yansımalı. İade faturası ya da iptal işlemi için mali müşavirinize danışın.
- Her iade işlemi kimin, ne zaman yaptığıyla birlikte kaydedilmeli.

Fatura tarafını [e-fatura ve e-arşiv entegrasyonu](/blog/e-fatura-entegrasyonu) yazısında ayrıca anlattık. Ödeme, iade ve fatura aynı akışta çalışınca elle düzeltme ihtiyacı büyük ölçüde ortadan kalkar.

## Kart bilgisi sitenizden geçmeli mi?

Hayır, çoğu e-ticaret sitesi için kart bilgisinin sizin sunucunuza hiç uğramaması en doğru yoldur. Kart verisini işleyen, ileten ya da saklayan her sistem PCI DSS adlı kart endüstrisi güvenlik standardının kapsamına girer. Kart numarası sizin sunucunuzdan geçerse bu standardın gereklilikleri de size düşer.

Ödeme kuruluşları ve bankalar bunun için iki yol sunar. Birincisi ortak ödeme sayfasıdır: müşteri ödeme için kurumun sayfasına gider. İkincisi sayfanıza gömülen ödeme formudur: form sizin sitenizde görünür ama kart bilgisi doğrudan kuruma gider. İki yolda da kart numarası sizin veritabanınıza yazılmaz. Kayıtlı kartla tekrar ödeme istiyorsanız kurumun kart saklama hizmetini kullanır, sizde sadece kuruma ait bir anahtar tutarsınız.

Kapsamınızın ne olduğunu ve hangi uyum belgesini doldurmanız gerektiğini bankanız ya da ödeme kuruluşunuz söyler. Ayrıntılar PCI Security Standards Council'ın sitesinde yayımlanır.

## Sanal POS entegrasyonu adım adım

1. **Altyapıyı seçin** — Satış hacminize, taksit ihtiyacınıza ve başlangıç tarihinize göre banka ya da ödeme kuruluşu seçin. Teklifleri aynı senaryoyla karşılaştırın.
2. **Başvuruyu yapın** — Üye işyeri başvurusu firmanızın adına yapılır. Sitede mesafeli satış sözleşmesi, iade koşulları ve iletişim bilgileri gibi sayfaların hazır olması istenir.
3. **Test hesabını alın** — Kurum, test ortamı için ayrı anahtarlar ve test kartları verir. Geliştirme bu ortamda yapılır.
4. **Ödeme akışını kurun** — Sipariş oluşturma, ödeme ekranı, 3D Secure yönlendirmesi, dönüş sayfası ve taksit sorgusu yazılır.
5. **Sonucu sunucuda doğrulayın** — Kurumdan gelen bildirimin imzası ve tutarı kontrol edilir. Sipariş ancak bu doğrulamadan sonra ödendi sayılır.
6. **İade ve raporlamayı ekleyin** — Yönetim paneline iptal, kısmi iade ve ödeme durumu ekranı eklenir. Kayıtlar siparişle eşleşir.
7. **Tüm senaryoları test edin** — Başarılı, başarısız, yarım kalan ve iade edilen ödemeler test ortamında tek tek denenir.
8. **Canlıya alın** — Canlı anahtarlar girilir ve ilk gerçek ödemeler küçük tutarlarla kontrollü biçimde denenir.

## Ödeme sonucu nasıl doğrulanır?

Ödeme sonucu, tarayıcının getirdiği bilgiye göre değil, kurumun sunucunuza doğrudan gönderdiği ve imzasını kontrol ettiğiniz bildirime göre kesinleşir. Tarayıcıdan gelen bilgi değiştirilebilir. Sunucudan sunucuya gelen bildirim ise kurumun gizli anahtarıyla imzalanır ve sizin tarafınızda doğrulanır. Bu tür bildirime webhook denir.

Doğrulamada üç kontrol yaparız. İmza geçerli mi. Bildirimdeki tutar ve para birimi sipariş tutarıyla aynı mı. Bu ödeme daha önce işlenmiş mi. Üçüncüsü önemlidir, çünkü kurumlar aynı bildirimi birden fazla kez gönderebilir. Aynı ödeme iki kez işlenirse stok iki kez düşer, fatura iki kez kesilir.

Sepet tutarı da her zaman sunucuda hesaplanır. Tarayıcıdan gelen fiyata güvenilmez. Müşteri 3D ekranında sekmeyi kapatırsa sipariş "ödeme bekleniyor" durumunda kalır ve kurumdan gelen bildirimle ya da belirli aralıklarla yapılan durum sorgusuyla kesinleşir.

## Test ortamında neler denenmeli?

Test ortamında sadece başarılı ödemeyi değil, ters gidebilecek her durumu denemek gerekir. Bizim test listemizde şunlar bulunur:

- Tek çekim ve farklı taksit seçenekleriyle başarılı ödeme.
- Yetersiz bakiye, hatalı kod ve 3D doğrulamasının reddedilmesi.
- Müşterinin 3D ekranında sekmeyi kapatması ya da geri tuşuna basması.
- Aynı bildirimin iki kez gelmesi.
- Ödeme sırasında sepetteki bir ürünün stoğunun bitmesi.
- Tam iptal, kısmi iade ve iadenin stok ve faturaya yansıması.
- Kurumun servisine ulaşılamadığında müşteriye gösterilen mesaj.

## Canlıya geçişte nelere dikkat edilmeli?

Canlıya geçişte en önemli şey, test ve canlı anahtarların karışmamasıdır. Anahtarlar kodun içine yazılmaz, sunucu ayarlarında tutulur ve sadece gereken kişiler erişir. İlk gerçek ödemeler küçük tutarlarla yapılır, iade edilir ve hesaba yansıması takip edilir.

Üye işyeri hesabı, yönetim paneli girişi ve API anahtarları firmanızın adına olmalıdır. Ajansın ya da yazılımcının hesabı üzerinden ödeme almak, yollar ayrıldığında ciddi sorun çıkarır. Biz bu hesapları baştan sizin adınıza açtırırız. Tıpkı alan adı, sunucu ve kod gibi.

## Hangi ödeme altyapısı kime uygun?

Yeni başlayan ve çok bankanın kartında taksit sunmak isteyen bir mağaza için ödeme kuruluşu genellikle en hızlı yoldur. Hacmi oturmuş, belirli bir bankayla güçlü ilişkisi olan firma için doğrudan banka POS'u daha iyi şartlar sağlayabilir. Çoğu büyüyen mağaza zamanla ikisini birlikte kullanır.

Karar verirken yazılımın da bu esnekliği taşıması gerekir. Hazır bir e-ticaret altyapısında seçenekler o altyapının desteklediği sağlayıcılarla sınırlıdır. Özel yazılımda istediğiniz kurumu bağlayabilirsiniz. İki yolun artılarını [hazır altyapı mı özel e-ticaret yazılımı mı](/blog/hazir-altyapi-mi-ozel-e-ticaret) yazısında karşılaştırdık.

## RadKod sanal POS entegrasyonunu nasıl yapar?

Sanal POS entegrasyonunu, seçtiğiniz bankanın ya da ödeme kuruluşunun belgelerine göre yazarız. Kart bilgisi sizin sunucunuza uğramaz. Ödeme sonucunu imzalı bildirimle sunucuda doğrularız. İptal, kısmi iade ve ödeme durumu yönetim panelinde görünür. Ödeme kodunu tek bir sağlayıcıya kilitlemeyiz, gerekirse ikinci bir kurum eklenebilir.

Teklif tek sayfadır ve bitiş tanımı ilk gün imzalanır: test ortamında listelenen tüm senaryolar geçmiş, canlıda ilk ödemeler sizinle birlikte kontrol edilmiş. Teslimden sonraki 30 gün içinde çıkan hataları ücretsiz düzeltiriz. Yeni bir mağaza kuruyorsanız [e-ticaret](/hizmetler/e-ticaret) sayfamıza, mevcut sitenize ödeme ya da başka bir sistem bağlamak istiyorsanız [entegrasyon](/hizmetler/entegrasyon) sayfamıza bakın.

## Sık sorulanlar

### Sanal POS entegrasyonu ne kadar sürer?

Teknik kısım, kurumun belgeleri düzgünse genellikle birkaç haftayı geçmez. Süreyi çoğu zaman üye işyeri başvurusunun onaylanması belirler. Başvuruyu geliştirmeyle paralel başlatmak zaman kazandırır.

### Şahıs şirketi olarak sanal POS alabilir miyim?

Birçok banka ve ödeme kuruluşu şahıs şirketleriyle de çalışır. İstenen belgeler kuruma göre değişir. Doğrudan kurumun kendisine sorun.

### Birden fazla sanal POS kullanabilir miyim?

Evet. Yazılım buna göre kurulursa kart türüne ya da tutara göre farklı kurumlara yönlendirme yapılabilir. Bu, tek kurumda sorun olduğunda satışın durmamasını da sağlar.

### 3D Secure olmadan ödeme alabilir miyim?

Bu, bankanızın ya da ödeme kuruluşunuzun iznine bağlıdır ve genellikle belirli koşullara bağlanır. Doğrulanmamış işlemlerde itiraz riski çoğunlukla işyerinde kalır. Biz 3D Secure ile kurmayı öneririz.

### Müşterinin kartını kaydedip sonra tekrar çekebilir miyim?

Evet, ama kartı kendi veritabanınızda saklayarak değil. Kurumun kart saklama hizmetini kullanırsınız, sizde sadece kuruma ait bir anahtar durur.

### Yurt dışından gelen kartlarla ödeme alınabilir mi?

Çoğu kurum yurt dışı kartları destekler ama bu özellik ayrıca açtırılabilir ve komisyon farklı olabilir. Döviz ile satış yapacaksanız bunu da başvuru sırasında konuşun.

### Hazır e-ticaret altyapısında kendi sanal POS'umu kullanabilir miyim?

Altyapının desteklediği kurumlar arasındaysa genellikle evet. Desteklenmiyorsa seçenekler sınırlıdır. Özel yazılımda böyle bir sınır yoktur.

### Ödeme sağlayıcısını sonradan değiştirebilir miyim?

Evet. Ödeme kodu sağlayıcıdan bağımsız bir katmanla yazılırsa değişiklik küçük bir iştir. Kayıtlı kartlar gibi kuruma bağlı veriler ise genellikle yeni kuruma taşınamaz.

## Kaynaklar

- [PCI Security Standards Council](https://www.pcisecuritystandards.org/), PCI Security Standards Council
- [Türkiye Cumhuriyet Merkez Bankası](https://www.tcmb.gov.tr), Türkiye Cumhuriyet Merkez Bankası
- [EMVCo](https://www.emvco.com/), EMVCo

**Ödeme altyapınızı birlikte seçelim** [Teklif al](https://radkod.com/teklif-al)