Sanal POS basvurusu 2 yontemle yapılır:

1. Banka direk sanal POS - kendi bankaniza basvuru
2. Aracilik kurulusu - iyzico, PayTR vb. ile online basvuru

Banka direk basvuru:

• Bankanin "Ticari Bankacilik" portali veya şubesi
• Imza sirkuleri, vergi levhasi, faaliyet belgesi
• Şirket banka hesabı (TL ve gerekirse döviz)
• Web site (URL adresi) bilgisi
• 1-4 hafta onay süresi

Aracilik kurulusu basvuru:

• Online form (5-15 dakika)
• Vergi numarası, banka hesabı IBAN
• Kimlik fotokopisi yetkili kisi
• Web sitesi (sosyal medya da kabul edilebilir)
• 1-3 gün onay süresi (genellikle daha hızlı)

Onay sonrası API anahtarları (merchant ID, API key, secret key, hash key) email ile veya panelden gelir.

API anahtarları alindiktan sonra Pratik Esnaf içine girilir:

1. Sol menü → Ayarlar → E-Tahsilat Ayarlari
2. Sanal POS Ekle butonu
3. Saglayici seç (iyzico, PayTR, Param vb.)
4. Anahtarlari gir:
   • Merchant ID (uye işyeri numarası)
   • API Key (genel anahtar)
   • Secret Key (gizli anahtar - sifrelenmis saklanır)
   • Hash Key (varsa)
5. Mod seç: Test / Canli
6. Kaydet

Önemli ayar parametreleri:

• Komisyon orani (tek cekim ve taksit bazlı)
• Maksimum taksit sayısı (sektor sinirlamasi)
• 3D Secure zorunlulugu (Evet/Hayir)
• Default banka hesabı (valor sonrası paranin geldigi hesap)

Canliya gecmeden önce mutlaka test yapilmalidir. Saglayici test ortami sunar:

1. Sanal POS ayarlarinda Test Modunu aktif et
2. Saglayicinin test kart numaralarini kullan:
   • iyzico: 5528790000000008 (3DS test karti)
   • PayTR: 4355084355084358
   • Garanti: 4282209004348015
3. Test ödeme bağlantısı oluştur
4. Test kartla 1 TL ödeme yap
5. Basarili sonuç gozukmeli, banka hesabı etkilenmemeli (test modu)

Test asamasinda kontrol edilecekler:

• Ödeme sayfasi açılır ve form gözükür
• 3D Secure ekranı basarili çalışır
• Basarili ödeme sonrası sistem cari kapatma yapar
• Basarisiz ödeme doğru kayıt edilir
• Iade test edilir (kısmı ve tam)

Webhook / Callback URL:

• Saglayici panelinde callback URL'i Pratik Esnaf URL'i olarak girilmeli
• Örnek: https://siteniz.com/api/sanal-pos/callback
• Bu URL otomatik işlem sonuclarini sisteme bildirir

Test asamasi basarili tamamlandiktan sonra canliya geçiş:

1. Saglayici panelinden canli API anahtarlarini al (test anahtarlardan farklidir)
2. Pratik Esnaf Ayarlar → E-Tahsilat menüsü
3. Sanal POS ayarinda Mod: Canli seç
4. Canli API anahtarlarini gir (eskileri üzerine yaz)
5. Kaydet
6. Küçük tutarla canli test yap (kendi kartiniz, 1 TL gibi)
7. Iade et
8. Operasyon basla

Coklu sanal POS yönetimi:

• Birden fazla saglayici aynı anda tanimlanabilir
• Her saglayici için ayri komisyon orani ve banka hesabı
• Default saglayici belirlenebilir
• Saglayici bazlı rapor cikartilabilir

Stratejik yaklasim:

• Tek cekim için iyzico (düşük komisyon)
• Taksitli satış için banka direk POS (taksit komisyonu daha avantajli)
• Mobil/QR için BKM Express veya FAST

Yaygin kurulum sorunlari ve cozumleri:

• "Yetkisiz işlem" hatasi → API anahtari yanlis girilmis veya canli/test modu uyumsuz
• "Hash doğrulama hatasi" → secret key veya hash key yanlis
• 3DS sayfasi acilmiyor → saglayici tarafinda 3DS aktif degil, panel ayarlarini kontrol et
• Callback gelmiyor → webhook URL'i yanlis veya SSL sertifika sorunu
• "Tutarsizlik" hatasi → saglayici taraflarinda günlük limit asilmis olabilir

SSL sertifika kontrolu:

• Sanal POS calismasi için sitenizde geçerli SSL sertifikasi olmalı
• Self-signed sertifikalar kabul edilmez
• Let's Encrypt veya ücretli SSL yeterli

Aylik limit kontrolu:

• Aracilik kuruluslarinda paket bazlı aylık işlem limiti vardir
• Limit asildiginda işlem reddedilir
• Paket yukseltme veya direk banka sanal POS gecisi yapilabilir

Sertifika ve uyum:

• BDDK kayıt kontrolu (Bankalar Birligi)
• Mesafeli satış sozlesmesi web sitesinde olmalı
• Iade ve cayma haklari açıkça belirtilmeli
• KVKK aydinlatma metni mecburi