İçeriğe geç
Rebitra

❓ Rehber · Soru-cevap

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

Kısa cevap

Sanal POS entegrasyonu için önce bir banka ya da lisanslı ödeme kuruluşuyla sözleşme yapılır ve size API anahtarları ile bir test ortamı verilir. Ödeme formu 3D Secure doğrulamasıyla siteye bağlanır, ödeme sonucunu bildiren geri dönüş adresi imza kontrolüyle doğrulanır, test kartlarıyla başarılı, başarısız ve iade senaryoları denenir. Testler bitince canlı anahtarlara geçilir.

Son güncelleme: 21 Ekim 2026 · Hazırlayan: Rebitra ekibi

İlk karar: banka sanal POS'u mu, ödeme kuruluşu mu?

Kartla ödeme almanın iki yaygın yolu var. Birincisi bankanızdan doğrudan sanal POS almak; ikincisi ödeme hizmeti veren bir kuruluşun altyapısını kullanmak. İkisinin teknik entegrasyonu benzer, ama başvuru ve işletme tarafı farklıdır.

KriterBanka sanal POS'uÖdeme kuruluşu
BaşvuruBankanın ticari müşterisi olmanız ve kredi değerlendirmesi gerekebilirGenellikle çevrim içi başvuru ve daha hızlı onay
TaksitÇoğunlukla o bankanın kart ailesiyle sınırlıFarklı bankaların kartlarında taksit seçeneği sunulabilir
Ödeme sayfasıKendi formunuz ya da bankanın ortak ödeme sayfasıHazır ödeme formu, iFrame ya da yönlendirmeli sayfa
Para transferiBankanın valör takvimine göre hesabınızaKuruluşun hakediş takvimine göre

Hangi kuruluşla çalışacaksanız, Türkiye Cumhuriyet Merkez Bankası'nın yayımladığı ödeme kuruluşları ve elektronik para kuruluşları listesinde faaliyet izninin güncel olduğunu kontrol edin. TCMB bu listelerde izni iptal edilen kuruluşları da ayrıca gösteriyor.

Teknik entegrasyonun adımları

  1. Sözleşme ve test hesabı: Başvuru onaylanınca üye işyeri numarası, API anahtarı ve gizli anahtar gibi bilgiler ile bir test (sandbox) ortamı verilir.
  2. Ödeme yöntemini seçmek: Kart bilgisini kendi formunuzda mı alacaksınız, yoksa kuruluşun ödeme sayfasına mı yönlendireceksiniz? Hazır ödeme sayfası ya da iFrame kullanmak, kart verisinin sizin sunucunuzdan hiç geçmemesini sağlar ve güvenlik yükünü azaltır.
  3. 3D Secure akışı: Müşteri kart bilgisini girdikten sonra bankasının doğrulama ekranına gider, SMS kodunu onaylar ve sitenize geri döner. Bu dönüşte gelen cevap, siparişin onaylanıp onaylanmayacağını belirler.
  4. Geri dönüş ve bildirim doğrulaması: Ödeme sonucu sitenize bir geri dönüş adresiyle (callback) bildirilir. Bu isteğin gerçekten ödeme kuruluşundan geldiğini, kuruluşun belirttiği imza ya da hash yöntemiyle doğrulamadan siparişi "ödendi" saymayın. Bu kontrolün atlanması, sahte bildirimle ücretsiz sipariş geçilmesine kapı açar.
  5. Taksit, iade ve iptal: Taksit tablosunun ödeme sayfasında doğru gösterildiği, kısmi iade ve gün içi iptal işlemlerinin yönetim panelinden yapılabildiği test edilir.
  6. Canlıya geçiş: Test anahtarları canlı anahtarlarla değiştirilir, gerçek bir kartla küçük tutarlı bir işlem yapılır ve hemen iade edilerek uçtan uca akış doğrulanır.

Güvenlikte dikkat edilecekler

  • Kart numarasını, son kullanma tarihini ve CVV'yi hiçbir koşulda kendi veritabanınıza kaydetmeyin. Kart verisi işleyen sistemler PCI DSS standardına tabidir.
  • API'nin gizli anahtarını tarayıcı tarafındaki koda ya da herkese açık bir depoya koymayın; yalnızca sunucuda tutun.
  • Site tamamen HTTPS üzerinden çalışmalı, ödeme adımında üçüncü taraf eklenti sayısı en aza indirilmelidir.

Hazır altyapılarda durum

WooCommerce, Shopify ya da ikas gibi altyapılarda çoğu ödeme kuruluşunun hazır eklentisi bulunur; anahtarları girmek ve test etmek çoğu zaman yeterlidir. Özel yazılım bir sitede ise entegrasyonu kuruluşun API dokümanına göre biz yazarız. Her iki durumda da başvurunun onaylanması için sitede mesafeli satış sözleşmesi, iade koşulları ve iletişim bilgilerinin yayında olması beklenir.

E-ticaret sitesi projelerimizde ödeme entegrasyonunu test senaryolarıyla birlikte teslim ediyoruz; mevcut WooCommerce mağazanız varsa WooCommerce e-ticaret kapsamında bağlantıyı kurabiliriz. Hangi altyapıyı kullandığınızı yazarak teklif isteyebilirsiniz.

Kaynaklar

E-Ticaret Sitesi için ücretsiz ön görüşme: sorunuzu kendi işinize göre netleştirelim.

Bununla ilgili diğer sorular

Sanal POS başvurusu için hangi belgeler istenir?

Banka ve ödeme kuruluşları genellikle vergi levhası, kimlik, imza sirküleri ya da imza beyannamesi, banka hesap bilgisi ve sitenizin adresini ister. Başvuru değerlendirilirken sitede iletişim bilgileri, mesafeli satış sözleşmesi ve iade koşullarının yayında olup olmadığı da kontrol edilir.

Sanal POS entegrasyonu ne kadar sürer?

Hazır bir altyapıda eklentiyle bağlantı genellikle kısa sürer; asıl bekleme, başvurunun onaylanmasındadır. Özel yazılım sitelerde 3D Secure akışı, bildirim doğrulaması, taksit ve iade senaryolarının yazılıp test edilmesi daha fazla zaman alır.

İlgili hizmetler

Bölgelere göre

Bunlar da merak ediliyor

Sözlük, karşılaştırma ve teknoloji sayfaları

Projenizi konuşalım.

İlk görüşme ücretsiz. Yazılı teklif ve takvim 48 saat içinde.

Ara WhatsAppTeklif Al