E-ticaret sitesinde ödeme almak için sanal POS bağlamak teknik olarak birkaç API isteği gibi görünebilir. Fakat doğru sağlayıcı ve doğru entegrasyon modeli seçilmezse ödeme sayfasında hata artar, sipariş durumu karışır, iade süreci uzar, muhasebe mutabakatı zorlaşır ve müşteri güveni zarar görür.
Sanal POS entegrasyonu seçerken yalnızca komisyon oranına bakmak yeterli değildir. Taksit seçenekleri, 3D Secure akışı, ödeme sayfası deneyimi, API kalitesi, webhook desteği, iade ve iptal süreçleri, ödeme güvenliği, mutabakat raporları ve teknik destek hızı birlikte değerlendirilmelidir.
Özellikle e-ticaret projesi yeni kuruluyorsa ödeme altyapısı sonradan eklenen küçük bir modül gibi düşünülmemelidir. Sepet, sipariş durumu, stok rezervasyonu, fatura, kargo ve muhasebe akışı ödeme sonucuna göre tetikleneceği için sanal POS kararı sitenin bütün operasyonunu etkiler.
Sanal POS entegrasyonu nedir?
Sanal POS entegrasyonu, e-ticaret sitesinin banka veya ödeme kuruluşu üzerinden kartla ödeme almasını sağlayan teknik bağlantıdır. Kullanıcı ödeme sayfasında kart bilgilerini girer, ödeme sağlayıcı işlemi doğrular, başarılı veya başarısız sonucu siteye bildirir ve sipariş akışı bu sonuca göre ilerler.
Bu yapı doğrudan banka sanal POS’u ile kurulabilir veya ödeme kuruluşları üzerinden yönetilebilir. Türkiye’de ödeme kuruluşları ve elektronik para kuruluşları için resmi listeler TCMB tarafından yayınlanır; ödeme hizmeti sağlayıcısı seçerken yetki ve faaliyet bilgilerini güncel resmi kaynaklardan kontrol etmek gerekir TCMB Ödeme Kuruluşları TCMB Elektronik Para Kuruluşları.
Banka sanal POS’u mu ödeme kuruluşu mu?
İlk karar genellikle burada verilir. Banka sanal POS’u, işletmenin doğrudan bankayla çalıştığı modeldir. Ödeme kuruluşu ise birden fazla banka, kart, taksit, alternatif ödeme ve panel özelliğini tek çatıdan sunabilir. Hangisinin daha doğru olduğu işletmenin hacmine, teknik ekibine, muhasebe ihtiyacına ve operasyon modeline göre değişir.
Doğrudan banka sanal POS’u bazı işletmeler için maliyet ve banka ilişkisi açısından avantajlı olabilir. Ödeme kuruluşları ise hızlı kurulum, tek panel, farklı banka kartlarına taksit, linkle ödeme, saklama, pazar yeri ödeme dağıtımı veya gelişmiş API kolaylığı sunabilir. Fakat her sağlayıcının komisyon, bloke, ödeme aktarım süresi ve teknik kapsamı farklıdır; güncel şartlar sağlayıcıdan yazılı olarak alınmalıdır.
| Kriter | Banka sanal POS’u | Ödeme kuruluşu | Karar notu |
|---|---|---|---|
| Kurulum | Banka süreçlerine bağlı ilerler. | Çoğu zaman daha hızlı başlayabilir. | Belge ve onay süreci değişebilir. |
| Taksit seçenekleri | Bankaya göre sınırlı olabilir. | Birden fazla banka taksiti tek panelde sunabilir. | Sektör ve kart türüne göre kural değişebilir. |
| Teknik entegrasyon | Her banka için ayrı teknik akış gerekebilir. | Tek API ile farklı ödeme kanalları yönetilebilir. | API dokümantasyonu incelenmelidir. |
| Mutabakat | Banka raporları üzerinden yürür. | Panel ve API raporları sunabilir. | Muhasebe ekibiyle test edilmelidir. |
| Komisyon/bloke | Banka anlaşmasına göre değişir. | Sağlayıcı paketine göre değişir. | Güncel oranlar yazılı alınmalıdır. |
| Destek | Banka destek süreci kullanılabilir. | Teknik destek ve doküman kalitesi önemlidir. | Canlıya çıkmadan test edilmelidir. |
Komisyon oranı tek başına neden yanıltıcıdır?
Komisyon oranı önemlidir; fakat tek karar kriteri olursa yanlış seçim yapılabilir. Daha düşük komisyon sunan bir yapı, iade süreci zayıfsa, panel raporları yetersizse, taksit seçenekleri sınırlıysa veya ödeme hata oranı yüksekse toplam operasyon maliyeti artabilir. Ayrıca para aktarım süresi, bloke gün sayısı, işlem başı ücret, chargeback süreci ve taksit maliyeti de değerlendirilmelidir.
Örneğin iki sağlayıcı düşünelim. Birincisi daha düşük komisyon verir fakat webhook desteği zayıftır; ödeme sonucu geciktiğinde sipariş “ödeme bekleniyor” durumunda kalır. İkincisi biraz daha yüksek maliyetlidir ama ödeme sonucu, iade ve mutabakat verisini panel ve API üzerinden net gösterir. Hacim büyüdüğünde ikinci yapı operasyon açısından daha sağlıklı olabilir.
3D Secure deneyimi nasıl değerlendirilir?
3D Secure, kartla yapılan çevrim içi ödemelerde kimlik doğrulama ve güvenlik katmanı olarak kullanılır. EMVCo, EMV 3-D Secure’un kartın fiziksel olarak bulunmadığı e-ticaret ödemelerinde dolandırıcılığı önlemeye ve güvenliği artırmaya yardımcı olduğunu açıklar EMVCo. Ancak 3D Secure akışı kullanıcı deneyimini de etkilediği için doğru uygulanmalıdır.
Kötü tasarlanmış ödeme deneyiminde kullanıcı bankanın doğrulama ekranına geçtiğinde ne olduğunu anlayamaz, geri dönerse sipariş durumu bozulur veya doğrulama tamamlanmasına rağmen site siparişi açık bırakır. Bu yüzden 3D Secure yalnızca güvenlik özelliği değil, sipariş akışının hassas bir parçasıdır.
3D Secure için kontrol edilmesi gerekenler
- Zorunlu mu, opsiyonel mi? Bazı sektör veya risk durumlarında 3D Secure zorunlu çalışabilir.
- Başarısız doğrulamada ne olur? Sipariş iptal mi edilir, ödeme bekleniyor mu kalır?
- Mobilde akış rahat mı? Banka doğrulama ekranından siteye dönüş mobilde sorunsuz olmalıdır.
- Yeniden deneme var mı? Kullanıcı ödeme hatasında farklı kartla tekrar deneyebilmelidir.
- Log tutuluyor mu? 3D doğrulama sonucu ve ödeme sonucu ayrı izlenmelidir.
API ve dokümantasyon kalitesi neden kritik?
Sanal POS entegrasyonu yapılırken teknik dokümantasyon açık, güncel ve test edilebilir olmalıdır. Ödeme başlatma, ödeme sonucu sorgulama, 3D Secure dönüşü, iptal, iade, taksit sorgulama, kart saklama, ödeme linki ve webhook gibi işlemler net örneklerle anlatılmalıdır. Doküman belirsizse entegrasyon süresi uzar ve canlıda hata riski artar.
API entegrasyon hizmeti açısından en önemli konulardan biri hata kodlarının anlaşılır olmasıdır. “Ödeme başarısız” tek başına yeterli değildir. Kart limiti mi yetersiz, banka mı reddetti, 3D doğrulama mı tamamlanmadı, güvenlik kontrolü mü takıldı, bağlantı mı zaman aşımına uğradı? Bu ayrımlar hem müşteri mesajı hem operasyon takibi için gereklidir.
| Teknik özellik | Neden önemli? | Kontrol sorusu | Risk |
|---|---|---|---|
| Test ortamı | Canlıya çıkmadan senaryolar denenir. | Başarılı, başarısız, 3D, iade testleri yapılabiliyor mu? | Canlıda ödeme hatası |
| Webhook | Ödeme sonucu siteye otomatik bildirilir. | İmza doğrulama ve tekrar deneme var mı? | Sipariş durumu karışır. |
| Ödeme sorgulama | Belirsiz durumda işlem tekrar kontrol edilir. | transaction ID ile sorgu yapılabiliyor mu? | Çift sipariş veya eksik kayıt |
| İade API’si | Panelden veya sistemden iade yapılır. | Kısmi iade destekleniyor mu? | Manuel operasyon artar. |
| Taksit sorgulama | Kart tipine göre taksit gösterilir. | BIN bazlı taksit bilgisi alınabiliyor mu? | Yanlış taksit deneyimi |
| Hata kodları | Müşteri ve ekip doğru aksiyon alır. | Hata mesajları anlaşılır mı? | Destek talebi artar. |
Webhook ve ödeme sonucu neden ayrı kontrol edilmeli?
Ödeme sayfasında kullanıcı bankadan döndüğünde siteye “başarılı” yanıtı gelebilir; fakat bazı durumlarda sayfa kapanabilir, bağlantı kesilebilir veya kullanıcı geri dönüş ekranını tamamlamadan çıkabilir. Bu yüzden ödeme sonucu yalnızca tarayıcı dönüşüne bağlanmamalıdır. Webhook veya ödeme sorgulama akışıyla sunucu tarafında doğrulama yapılmalıdır.
iyzico dokümantasyonunda webhook bildirimlerinin ödeme süreçlerinden sonra gerçek zamanlı bildirim sağladığı ve HTTPS URL gerektirdiği açıklanır iyzico Docs. Sağlayıcı fark etmeksizin prensip aynıdır: ödeme sonucu güvenilir şekilde doğrulanmalı, sipariş durumu buna göre güncellenmelidir.
İade, iptal ve kısmi iade senaryoları baştan konuşulmalı
Ödeme almak kadar ödemeyi geri almak da doğru planlanmalıdır. Sipariş iptal edilirse ödeme provizyondan mı düşecek, tahsilat alındıysa iade mi yapılacak, tek ürünü iade eden müşteride kısmi iade çalışacak mı, kargo bedeli nasıl ele alınacak? Bu sorular canlıya çıkmadan önce cevaplanmalıdır.
İade süreci yazılım tarafında stok ve muhasebe ile birlikte ele alınmalıdır. Ürün depoya gelmeden stok geri eklenecek mi, iade onaylanınca ödeme sağlayıcıya otomatik istek gidecek mi, kısmi iade rapora nasıl yansıyacak? Bu akış net değilse müşteri hizmetleri ve muhasebe aynı sipariş üzerinde farklı kayıt tutabilir.
Taksit, kart tipi ve sepet kuralları nasıl planlanmalı?
Sanal POS seçiminde taksit seçenekleri işletme için önemli olabilir. Ancak taksit tüm ürünlerde, tüm kartlarda ve tüm sektörlerde aynı şekilde uygulanmayabilir. Banka, kart tipi, ürün kategorisi, kampanya koşulu ve mevzuat kısıtları taksit yapısını etkileyebilir. Bu nedenle panelde taksit kuralları esnek yönetilebilmelidir.
Örneğin elektronik kategorisinde farklı, mobilya kategorisinde farklı, B2B siparişlerde farklı taksit kuralı uygulanabilir. Sepette birden fazla kategori varsa hangi kuralın geçerli olacağı baştan belirlenmelidir. Müşteri ödeme adımına geldiğinde göremeyeceği taksit seçeneğiyle karşılaşmamalıdır.
| Kural | Örnek | Panelde gereken alan | Dikkat noktası |
|---|---|---|---|
| Kart bankasına göre taksit | Banka A’ya 6 taksit, Banka B’ye 3 taksit | BIN/taksit yönetimi | Güncel banka koşulları takip edilmelidir. |
| Kategoriye göre taksit | Mobilyada 9, elektronik üründe farklı kural | Kategori bazlı taksit sınırı | Sepet karma ürün içerirse kural net olmalıdır. |
| Tutar bazlı taksit | 1.000 TL üstüne taksit | Minimum tutar alanı | Kampanya ile çakışmamalıdır. |
| B2B özel kural | Bayi grubuna özel ödeme koşulu | Müşteri grubu bazlı ayar | Cari limit ve vade ile uyumlu olmalıdır. |
| Peşin fiyat ayrımı | Peşin ödemede farklı avantaj | Ödeme yöntemi indirimi | Fatura ve rapora doğru yansımalıdır. |
Güvenlik ve PCI DSS tarafı nasıl düşünülmeli?
Kart verisiyle çalışan ödeme sistemlerinde güvenlik kritik konudur. PCI Security Standards Council, PCI DSS’nin hesap verilerini korumak için teknik ve operasyonel gereklilikler sunduğunu açıklar; PCI DSS v4.0.1’in de 2024’te yayınlanan sınırlı revizyon olduğunu belirtir PCI SSC. E-ticaret projesinde kart verisinin nerede işlendiği ve saklanıp saklanmadığı bu nedenle önemlidir.
Birçok işletme için en sağlıklı model, kart bilgilerinin doğrudan ödeme sağlayıcının güvenli alanında işlenmesidir. Böylece site kart numarasını kendi sunucusunda saklamaz veya işlemeye çalışmaz. Ancak kullanılan model, sağlayıcı dokümanı ve güvenlik sorumlulukları teknik ekip tarafından net değerlendirilmelidir.
E-ticaret güvenliği tarafında SSL, güvenli form yapısı, işlem logları, yetki kontrolü, webhook imza doğrulama, hata mesajlarının sınırlı gösterimi ve yönetim paneli erişim güvenliği birlikte ele alınmalıdır. Ödeme ekranı güvenli olsa bile panel zayıfsa operasyon riski devam eder.
Mutabakat ve muhasebe raporları nasıl olmalı?
Sanal POS seçiminde mutabakat raporları çoğu zaman geç fark edilir. Oysa her gün hangi siparişin ödendiği, hangi işlemin iade edildiği, hangi tutarın hesaba geçtiği, komisyonun ne olduğu ve hangi siparişin sağlayıcı referans numarasıyla eşleştiği görülebilmelidir. Bu bilgiler yoksa muhasebe ekibi Excel dosyalarıyla manuel eşleştirme yapmak zorunda kalır.
Stok, kargo ve muhasebe entegrasyonu planlanırken ödeme sağlayıcıdan gelen işlem ID’si, sipariş numarası, brüt tutar, komisyon, net tutar, taksit, iade, ödeme tarihi ve aktarım tarihi gibi alanlar rapora dahil edilmelidir. Böylece sipariş, ödeme ve fatura kayıtları daha kolay eşleştirilir.
Ödeme sayfası kullanıcı deneyimi nasıl olmalı?
Ödeme sayfası, kullanıcının güven ve hız beklentisinin en yüksek olduğu alandır. Form sade olmalı, hata mesajları anlaşılır yazılmalı, kart logosu ve taksit seçenekleri doğru gösterilmeli, ödeme sırasında çift tıklamayı engelleyen yüklenme durumu kullanılmalı ve kullanıcıya işlem sonucunu net anlatan bir ekran sunulmalıdır.
E-ticaret dönüşüm optimizasyonu açısından ödeme adımında gereksiz alanlar, belirsiz güven mesajları, yavaş yönlendirme, görünmeyen hata uyarıları ve mobilde zor kullanılan form alanları terk oranını artırabilir. Ödeme sayfası tasarımında estetikten önce güven, açıklık ve hız gelmelidir.
Sanal POS seçimi için karar tablosu
Aşağıdaki tablo, sağlayıcıları yalnızca komisyonla değil bütün ödeme operasyonu üzerinden değerlendirmek için kullanılabilir. Her işletmenin önceliği farklı olabilir; bu yüzden tabloyu kendi satış hacminize ve operasyon modelinize göre puanlamak daha doğru olur.
| Kriter | Neden önemli? | Sorulacak soru | Öncelik |
|---|---|---|---|
| 3D Secure | Güvenlik ve doğrulama akışını etkiler. | 3D akışı mobilde sorunsuz mu? | Çok yüksek |
| Webhook | Sipariş durumunu güvenilir günceller. | İmza doğrulama ve tekrar deneme var mı? | Çok yüksek |
| İade/kısmi iade | Müşteri hizmetleri ve muhasebeyi etkiler. | API ve panelden kısmi iade yapılabiliyor mu? | Yüksek |
| Taksit yönetimi | Sepet dönüşümünü ve kampanyayı etkiler. | Kategori ve kart bazlı taksit destekleniyor mu? | Orta/yüksek |
| Mutabakat raporu | Muhasebe eşleşmesini kolaylaştırır. | Net/brüt tutar, komisyon ve aktarım tarihi var mı? | Yüksek |
| API dokümantasyonu | Entegrasyon süresini belirler. | Test kartı ve örnek hata senaryoları var mı? | Yüksek |
| Teknik destek | Canlı hata çözümünü etkiler. | Ödeme hatasında ne kadar hızlı destek alınır? | Yüksek |
Canlıya çıkmadan önce test edilmesi gereken senaryolar
Sanal POS canlıya alınmadan önce yalnızca başarılı ödeme testi yapılmamalıdır. Başarısız kart, 3D doğrulama iptali, yetersiz limit, bankadan ret, bağlantı zaman aşımı, kullanıcı sekmeyi kapatma, çift tıklama, kısmi iade, tam iade ve mutabakat raporu gibi farklı senaryolar test edilmelidir.
- Başarılı tek çekim ödeme testi yapıldı mı?
- Başarılı 3D Secure ödeme testi yapıldı mı?
- Başarısız ödeme sonucu siparişi doğru durumda bırakıyor mu?
- Kullanıcı bankadan dönmezse webhook siparişi güncelliyor mu?
- Ödeme butonuna çift tıklama çift işlem oluşturmuyor mu?
- Kısmi iade ve tam iade test edildi mi?
- Ödeme sağlayıcı işlem ID’si sipariş kaydına yazılıyor mu?
- Mutabakat raporunda sipariş numarası ile ödeme eşleşiyor mu?
- Mobil ödeme formu farklı cihazlarda test edildi mi?
- Canlı anahtarlar test ortamında bırakılmadı mı?
Sık yapılan sanal POS entegrasyonu hataları
En yaygın hata, ödeme sonucunu yalnızca kullanıcının dönüş sayfasına bağlamaktır. Kullanıcı bankadan dönerken bağlantı kesilirse ödeme alınmış ama sipariş beklemede kalabilir. İkinci hata, ödeme sağlayıcı işlem ID’sini siparişe kaydetmemektir. Bu durumda iade, mutabakat ve destek süreçleri zorlaşır.
Üçüncü hata, ödeme başarısız olduğunda kullanıcıya anlaşılır mesaj göstermemektir. “Hata oluştu” yerine kart limiti, banka reddi veya doğrulama iptali gibi daha açıklayıcı ama güvenli mesajlar kullanılmalıdır. Dördüncü hata ise iade ve iptal akışını canlıya çıktıktan sonra düşünmektir. E-ticarette ödeme süreci satışla bitmez; iade, iptal ve mutabakatla tamamlanır.
| Hata | Sonuç | Doğru yaklaşım |
|---|---|---|
| Webhook kullanmamak | Ödeme ve sipariş durumu ayrışabilir. | Webhook + ödeme sorgulama birlikte planlanır. |
| İade API’sini düşünmemek | Manuel iade ve muhasebe yükü artar. | Tam ve kısmi iade senaryoları test edilir. |
| Komisyona göre karar vermek | Teknik ve operasyon maliyeti gözden kaçar. | Toplam ödeme operasyonu değerlendirilir. |
| Hata kodlarını loglamamak | Sorun kaynağı bulunamaz. | İşlem ID, hata kodu ve zaman bilgisi tutulur. |
| Mobil ödeme deneyimini test etmemek | Sepet terk oranı artabilir. | Gerçek cihazlarda ödeme akışı denenir. |
Sonuç: doğru sanal POS seçimi ödeme almakla sınırlı değildir
Sanal POS entegrasyonu seçerken en düşük komisyonu bulmak önemlidir; fakat tek başına yeterli değildir. Güvenlik, 3D Secure deneyimi, API ve webhook kalitesi, iade akışı, taksit kuralları, mutabakat raporları, teknik destek ve yönetim paneli uyumu birlikte değerlendirilmelidir.
İyi planlanan ödeme altyapısı, müşterinin ödeme adımında güven duymasını sağlar; işletme tarafında ise sipariş, stok, muhasebe ve iade süreçlerini daha düzenli çalıştırır. E-ticarette büyüme hedefleniyorsa sanal POS kararı yalnızca finansal teklif değil, operasyonel altyapı kararı olarak ele alınmalıdır.
Sıkça Sorulan Sorular
Sanal POS entegrasyonu nedir?
Sanal POS entegrasyonu, e-ticaret sitesinin banka veya ödeme kuruluşu üzerinden kartla ödeme almasını sağlayan teknik bağlantıdır. Kullanıcı ödeme sayfasında kart bilgilerini girer, ödeme sağlayıcı işlemi doğrular ve başarılı ya da başarısız sonucu siteye bildirir. Site de bu sonuca göre sipariş durumunu, stok rezervasyonunu, fatura sürecini ve müşteri bilgilendirmesini yönetir.
Sanal POS seçerken sadece komisyon oranına bakmak doğru mu?
Hayır. Komisyon oranı önemli olsa da tek başına yeterli değildir. 3D Secure deneyimi, API ve webhook kalitesi, iade ve kısmi iade desteği, taksit seçenekleri, ödeme aktarım süresi, mutabakat raporları, teknik destek hızı ve güvenlik sorumlulukları birlikte değerlendirilmelidir. Düşük komisyonlu ama operasyonu zorlaştıran bir yapı uzun vadede daha maliyetli olabilir.
3D Secure sanal POS entegrasyonunda neden önemlidir?
3D Secure, çevrim içi kart ödemelerinde ek kimlik doğrulama ve güvenlik katmanı sağlar. Ancak yalnızca güvenlik açısından değil, kullanıcı deneyimi açısından da doğru uygulanmalıdır. Kullanıcı bankanın doğrulama ekranından döndüğünde sipariş durumu doğru güncellenmeli, başarısız doğrulamada anlaşılır mesaj verilmeli ve mobilde akış sorunsuz çalışmalıdır.
Webhook sanal POS entegrasyonunda ne işe yarar?
Webhook, ödeme sağlayıcının ödeme sonucu gibi kritik bilgileri sitenize sunucu tarafında bildirmesini sağlar. Kullanıcı ödeme sonrası tarayıcıyı kapatırsa veya bağlantı kesilirse sadece teşekkür sayfasına güvenmek risklidir. Webhook ve ödeme sorgulama mekanizması, siparişin gerçekten ödenip ödenmediğini daha güvenilir şekilde doğrulamaya yardımcı olur.
Sanal POS entegrasyonunda iade ve iptal neden baştan planlanmalı?
E-ticarette ödeme süreci satışla bitmez. Sipariş iptali, tam iade, kısmi iade, kargo bedeli iadesi ve stok geri ekleme gibi senaryolar canlıya çıkmadan önce planlanmalıdır. İade API’si, panelden iade yetkisi, muhasebe kaydı ve sipariş durumu birlikte çalışmazsa müşteri hizmetleri ve muhasebe ekibi manuel işlem yapmak zorunda kalır.
Sanal POS canlıya alınmadan önce hangi testler yapılmalı?
Canlıya çıkmadan önce başarılı ödeme, başarısız ödeme, 3D Secure doğrulama, bankadan ret, bağlantı kesilmesi, webhook bildirimi, ödeme sorgulama, çift tıklama, kısmi iade, tam iade, taksit gösterimi ve mutabakat raporu test edilmelidir. Ayrıca mobil cihazlarda ödeme formu ve bankadan dönüş akışı gerçek kullanıcı gibi denenmelidir.