❓ 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.
| Kriter | Banka sanal POS'u | Ödeme kuruluşu |
|---|---|---|
| Başvuru | Bankanın ticari müşterisi olmanız ve kredi değerlendirmesi gerekebilir | Genellikle ç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 transferi | Bankanın valör takvimine göre hesabınıza | Kuruluş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ı
- 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.
- Ö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.
- 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.
- 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.
- 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.
- 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
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
- Adana E-Ticaret Sitesi Kurulumu: Ödeme, Kargo ve Stoğu Birlikte Kuran Firma
- Aladağ E-Ticaret Uzmanı: Andız Pekmezi ve Yayla Ürünleri İçin Aşamalı Mağaza
- Antakya E-Ticaret Uzmanı: Baharatçı, Tatlıcı ve Çarşı Esnafı İçin Online Mağaza
- Ceyhan E-Ticaret Sitesi Yaptırmak: Tarım, Makine ve Teknik Malzeme Firmaları İçin
- Çukurova E-Ticaret Sitesi Uzmanı: Butik Marka, Kafe ve Güzellik Markaları İçin Mağaza
- Feke E-Ticaret Firması: Kooperatif ve Üreticiler İçin Ortak Mağaza
- Gaziantep E-Ticaret Firması: Baklava, Fıstık ve Halı Markaları İçin Mağaza Kurulumu
- Hatay E-Ticaret Ajansı: Yöresel Ürün ve Yeniden Açılan İşletmeler İçin Online Mağaza
Bunlar da merak ediliyor
Sözlük, karşılaştırma ve teknoloji sayfaları
- Teknoloji · Param nedir, sanal pos seçerken nelere bakılır?
- Sözlük · Sanal pos nedir?
- Karşılaştırma · Banka sanal pos mu, ödeme kuruluşu mu?
- Karşılaştırma · Manuel ürün girişi mi, pazaryeri entegrasyonu mu?