Banka Sanal Pos Entegrasyonu

Tüm Bankalara Özel Sanal Pos Entegrasyonu ile Satışlarınızı Yönetebilirsiniz.

Garanti Bankası Sanal Pos

Akbank Sanal Pos

Finansbank Sanal Pos

Halkbank Sanal Pos

İş Bankası Sanal Pos

Anadolubank Sanal Pos

TEB Sanal Pos

Ziraatbank Sanal Pos

Vakıfbank Sanal Pos

Yapı Kredi Sanal Pos

Kuveyt Türk Sanal Pos

Denizbank Sanal Pos

Türkiye Finans Katılım Sanal Pos

Banka sanal pos entegrasyonu, e-ticaret sitenizin veya mobil uygulamanızın banka altyapılarıyla doğrudan konuşarak kart ödemelerini güvenli, hızlı ve otomatik biçimde kabul etmesini sağlayan teknik bir çözümdür. Bu entegrasyon, sadece tek bir ödeme yöntemi bağlamak değil; ödeme akışını güvence altına almak, iade ve iptal süreçlerini yönetmek, mutabakatları kolaylaştırmak ve dolandırıcılık riskiyle etkin mücadele etmek anlamına gelir. Aşağıda hem iş hem de teknik ekiplerin ihtiyaç duyacağı tüm başlıkları kapsayan ayrıntılı bir rehber bulacaksınız.

Neden banka sanal pos entegrasyonu gerekir?

• Müşteriye yerinde ve güvenli ödeme deneyimi sunmak.

• Kart verilerinin üçüncü taraf sistemlere sızmasını engellemek.

• Otomatik sipariş onayı, fatura ve kargo entegrasyonlarıyla operasyonel maliyeti düşürmek.

• İade, iptal, taksit ve provizyon yönetimini merkezi hale getirmek.

• Banka ve muhasebe mutabakatlarını kolaylaştırmak.

Temel özellikler — bir entegrasyonda olması gerekenler

• Güvenli ödeme sayfası veya API üzerinden tokenizasyon.

• 3D Secure (3DS) desteği ve güncel versiyonlarla uyumluluk.

• Taksit seçenekleri ve taksit simülasyonu.

• Otomatik provizyon, capture, refund (iade) ve void (iptal) işlemleri.

• Webhook veya callback ile gerçek zamanlı durum bildirimleri.

• Yazılım tarafında retry/muhasebe hata yönetimi ve idempotency kontrolü.

• Test (sandbox) ve canlı (production) ortamları.

• Çoklu banka veya ödeme sağlayıcı entegrasyon yönetimi (gateway aggregator desteği).

• Kapsamlı işlem raporlama ve mutabakat (settlement) verileri.

Güvenlik ve yasal uyumluluk

• PCI DSS: Kart bilgilerini işleyen tüm sistemlerin seviyesine göre PCI uyumluluğu gerekir. Tokenizasyon veya redirect (ödeme sayfasına yönlendirme) yöntemleriyle PCI kapsamını azaltabilirsiniz.

• TLS: Tüm API trafiği en az TLS 1.2 ile şifrelenmelidir.

• 3D Secure: Banka ve kart sağlayıcıların zorunluluklarına göre 3DS uygulanmalıdır.

• KVKK/GDPR benzeri veri koruma: Müşteri verilerinin saklanması ve erişimi konusunda yerel düzenlemelere uyum.

• Loglama ve denetim: İşlem logları güvenli bir biçimde saklanmalı, erişimler izlenmelidir.

Teknik mimari yaklaşımları

1. Redirect / Hosted Payment Page

   • Müşteri sitenizden banka/PSP’nin güvenli ödeme sayfasına yönlendirilir. Kart verileri doğrudan bankada tutulur; sizin altyapınız PCI riskini önemli oranda azaltır.

2. API (Direct Post) + Tokenizasyon

   • Kart bilgileri API ile alınır ve token olarak saklanır. Repeat ödemeler token ile yapılır; mahrem kart verileri sunucunuzda kalmaz.

3. Gateway Aggregator

   • Birden çok banka ve PSP’yi tek bir arayüz (gateway) üzerinden yönetirsiniz. Failover, yük dengeleme ve merkezi raporlama kolaylığı sağlar.

4. Mikroservis tabanlı ödeme katmanı

   • İş mantığı, doğrulama, kargo/sipariş entegrasyonları ve ödeme servisleri ayrı servisler halinde organize edilir; ölçeklenebilirlik ve güvenlik artar.

Entegrasyon adımları (iş akışı bazında)

• Teknik ön hazırlık: API dokümantasyonları, sertifika/kimlik bilgileri, test erişimleri temin edilir.

• Sandbox entegrasyonu: Test ortamında provizyon, capture, refund ve 3DS akışları doğrulanır.

• İş süreçleri uyumu: İade politikaları, provizyon süreleri, taksit politikaları belirlenir.

• Canlı onay süreci: Banka/PSP tarafından güvenlik ve operasyon testleri yapılır.

• İzleme & mutabakat: Gerçek zamanlı bildirimler, günlük reconciliation dosyaları ve raporlama kurulur.

• Sürekli optimizasyon: Hata oranları, iade oranları, chargeback yönetimi gözlemlenerek süreç geliştirilir.

Not: Yukarıdaki adımlar ayrıntılı test senaryoları ve işlem örnekleriyle belgelendirilmelidir.

Ödeme akışı örneği

Kullanıcı ödeme sayfasına gider.

1. Kart bilgileri alınır; 3DS gerekiyorsa yönlendirme yapılır.

2. Banka provizyonu verir (authorized).

3. Sipariş onaylandıktan sonra capture (tahsilat) yapılır.

4. Teslimat veya iptal durumunda refund/void işlemleri gerçekleştirilir.

5. Banka tarafından settlement (mutabakat) ve havale bildirimleri alınır; muhasebe kaydı oluşturulur.

Hata yönetimi, retry stratejileri ve idempotency

• Ağ veya banka hatalarında idempotent request-ID kullanarak çift işlemi engelleyin.

• Webhook’ları tekrar gönderme mantığı kurun; her webhook için doğrulama (signature) kontrolü yapın.

• Hata tiplerini sınıflandırın: ağ/zaman aşımı, bankaya red, 3DS başarısızlık, limit aşımları. Her kategori için ayrı aksiyon (kullanıcı bilgilendirme, otomatik retry, manuel müdahale) tanımlayın.

Dolandırıcılık önleme ve risk yönetimi

• İşlem bazlı kurallar: işlem tutarı, coğrafi risk, alışılmadık sipariş frekansı.

• CVC kontrolü, AVS (adres doğrulama) ve 3DS ile kimlik doğrulama.

• Üçüncü parti fraud servisleri entegrasyonu (risk skorlama).

• Chargeback takibi, itiraz süreçleri ve belge yönetimi.

Banka Raporlama ve mutabakat

• Günlük settlement raporları (bankadan gelen dosyalar) otomatik olarak çekilip muhasebe sistemine işlenmeli.

• İşlem düzeyinde durumlar: Authorized, Captured, Refunded, Voided, Settled.

• Finansal mutabakat: banka komisyonları, iade maliyetleri ve ücret kesintileri net olarak gösterilmeli.

Entegrasyonun iş ve operasyon kazanımları

• Daha hızlı ödeme onayı ve düşük insan müdahalesi.

• Hatalı fiyat/stok kaynaklı iptallerin azalması.

• Gelişmiş müşteri güveni ve tekrarlı alışveriş artışı.

• Muhasebe ve finans süreçlerinin otomatik akışıyla düşük maliyetli operasyon.