Tahsilat (Sanal POS) Kullanım Kılavuzu

Genel Bakış

Tahsilat modülü, müşterilerinizin (bayi/cari kullanıcılarınızın) kendi kredi kartlarıyla, kendi sanal POS'unuz üzerinden portal içinden ödeme yapmasını sağlar. Ödeme bankanın 3D Secure ekranında doğrulanır; sonuç portala döner, tahsilat kaydı oluşur ve isterseniz cari + banka hareketi olarak muhasebeleştirilir.

Modül üç soruyu birlikte çözer:

• Kim, ne kadar ödeyebilir? — cari bakiyesi ödeme ekranında gösterilir, tutar için alt/üst sınır konulabilir.
• Hangi kart, kaç taksit görebilir? — kartın ilk hanelerinden (BIN) banka/kart ailesi çözülür, taksit listesi buna göre üretilir; cari bazında taksit kısıtı tanımlanabilir.
• Hangi işlem hangi POS'tan geçsin? — birden çok sanal POS anlaşmanız varsa, kart/tutar/taksit koşullarına göre yönlendirme kuralları yazarsınız.

Soldaki TAHSİLAT menü grubunda modülün tüm ekranları listelenir: Ödeme Yap, Ödemelerim, Tahsilatlar, Sağlayıcılar, Taksitler, Cari Taksit İzinleri, Kurallar.

Kart bilgisi (kart numarası ve CVV) hiçbir zaman veritabanına, günlüğe veya oturuma yazılmaz; yalnızca ilgili isteğin süresi boyunca bellekte kalır ve sağlayıcıya iletilir. Ekranlarda kart daima maskeli görünür.

Modülü Açma ve Yetkiler

Menünün görünmesi için üç katmanın birlikte açık olması gerekir:

1. Modül lisansı — YK Yazılım şirkete Tahsilat modülünü atar. Lisans yoksa TAHSİLAT menü grubu hiç görünmez.
2. Şirket şalteri — Ayarlar > Tahsilat Ayarları ekranındaki Modül aktif anahtarı. Lisans olsa bile bu kapalıyken menü görünmez.
3. Menü yetkisi — kullanıcının rolüne Ayarlar > Roller > Menü Yetkileri'nden verilen anahtarlar.

Tahsilat Ayarları ekranı bu listede yoktur: o ekran Ayarlar > Şirket Ayarları yetkisine (Menu.SirketAyarlari) ve Tahsilat modül lisansına bakar.

1. Tahsilat Ayarları

🎬 Videolu anlatım: Tahsilat Modülü Kurulumu: Ayarlar ve Sanal POS Sağlayıcı Tanımlama

Ayarlar > Tahsilat Ayarları ekranı modülün merkezidir. Beş bölümden oluşur.

Genel

• Modül aktif — yukarıdaki 2. katman. Kapatırsanız menü tüm kullanıcılardan kalkar, ödeme alınamaz.
• Tahsilat işlemleri aktif — modül açıkken tahsilatı geçici olarak durdurmak için. Kapalıyken ödeme ekranı "Tahsilat şu anda kapalı." der; tanım ekranları çalışmaya devam eder.
• Ortam — Test veya Canlı. Banka size hem test hem canlı kimlik verir; ortamı değiştirdiğinizde sağlayıcı tanımındaki adres/kimlik bilgilerini de ilgili ortama göre girmiş olmanız gerekir.

Bakiye ve Muhasebe

• Ödeme ekranında gösterilecek bakiye kaynağı
  • Portal defteri (varsayılan) — portalın kendi cari defteri.
  • Dış ERP aynası — dış ERP'den senkronize edilen salt-okunur ayna defter. Cari hareketleri portalda değil dış ERP'de tutuluyorsa bunu seçin.
• Muhasebeleştirme (cari + banka hareketi oluştur) — açıkken başarılı her tahsilat için otomatik olarak bir cari hareket ve bir banka hesap hareketi oluşturulur. Kapalıysa tahsilat yalnız Tahsilat listesinde durur, cari bakiyesine işlemez.
• POS Banka Hesabı — muhasebeleştirme açıkken banka bacağının yazılacağı hesap. Muhasebeleştirmeyi açıp bu hesabı seçmezseniz banka hareketi oluşturulamaz.

Fiyatlandırma

• Vade farkını müşteriye yansıt — açıkken taksitli seçeneklerde vade farkı ödeyicinin ekranında tutara eklenmiş olarak gösterilir; kapalıyken ödeyici ana tutarı görür, fark size kalır.
• Min. Tutar / Max. Tutar — ödeme ekranında kabul edilecek tutar aralığı. Max. Tutar = 0 yazarsanız üst sınır uygulanmaz. Sınır sunucuda da yeniden denetlenir.
• Varsayılan taksitler — hiçbir cari kısıtı yokken sunulacak taksit numaraları (virgülle: 1,3,6,9). Boş bırakılırsa sağlayıcı tanımındaki tüm taksitler serbesttir.
• Varsayılan Sağlayıcı — hiçbir yönlendirme kuralı eşleşmezse kullanılacak POS.
• Makbuz otomatik oluştur ve E-posta bildirimi gönder + Bildirim e-posta adresleri — başarılı/başarısız tahsilatlarda bilgilendirme maili gider. Adres alanına virgülle birden çok adres yazabilirsiniz; ödeyicinin kendi adresi ayrıca kullanıcı kartındaki e-postadan alınır.

BIN Sorgusu

Kartın ilk hanelerinden bankayı ve kart ailesini (Bonus, World, Maximum…) çözen servistir. Taksit listesi buna dayanır.

• Kapalı — kart ayrımı yapılmaz, taksit listesi yalnız genel tanımlardan üretilir.
• PayNkolay — PayNkolay'ın BIN servisi kullanılır.
• Harici servis — kendi BIN servisinizi bağlarsınız: Harici Servis URL, API Anahtarı ve yanıtın hangi alanının neye karşılık geldiğini anlatan Yanıt Alan Eşlemesi (JSON).

🎬 Videolu anlatım: Tahsilat Modülü Kurulumu: Ayarlar ve Sanal POS Sağlayıcı Tanımlama

2. Sağlayıcı Tanımlama

TAHSİLAT > Sağlayıcılar ekranında anlaşmalı sanal POS'larınızı tanımlarsınız. Birden fazla POS tanımlanabilir; hangisinin kullanılacağını Kurallar belirler.

Sağlayıcı Düzenle formunun bölümleri:

Tanım

• Kod — uygulamanın hangi entegrasyonu çalıştıracağını belirler; desteklenen kodlar: PAYNKOLAY, VAKIF, ZIRAAT, KUVEYTTURK. Kod yanlış yazılırsa ödeme anında "Sağlayıcı uygulaması bulunamadı." hatası alınır.
• Ad — listelerde ve raporlarda görünen ad (ör. "Ziraat Sanal POS").
• Altyapı / Model — serbest metin; anlaşmanızın hangi altyapı ve model üzerinden olduğunu not etmek için (ör. "PayNkolay", "Ortak Ödeme Sayfası").
• Altyapı Sürümü — yalnız VakıfBank (VAKIF) için anlamlıdır, diğer sağlayıcılar okumaz. Banka 2026'da ödeme altyapısını ikiye ayırdı: Eski altyapı (VposService/MPIAPI adresleri) ve Yeni altyapı (API Gateway) (apigw.vakifbank.com.tr / inbound.apigateway.vakifbank.com.tr; test ortamında …apigatewaytest…). Sürüm ile Adresler bölümündeki URL'ler birlikte değiştirilir; uyumsuz seçim kayıtta engellenir. Sağlayıcılar listesinde VakıfBank satırında seçili sürüm rozet olarak görünür.
• Gönderim
  • Sunucudan (3D Pay) — kart bilgisi portalın ödeme ekranından alınır, sunucumuz üzerinden bankaya iletilir.
  • Tarayıcıdan (3D Host) — kullanıcı bankanın kendi ödeme sayfasına yönlendirilir, kart bilgisi sunucumuza hiç uğramaz.
• Sıra No — listedeki sıralama.
• Aktif — kapalı sağlayıcı ödeme akışında hiç değerlendirilmez.

Kimlik Bilgileri — Merchant ID, Terminal No, Kullanıcı Adı, Şifre, Store Key, API Key, Secret. Hangilerinin dolacağı bankaya göre değişir; bankanın size verdiği entegrasyon dokümanındaki adlarla birebir eşleşir. Bu alanlar veritabanında şifrelenmiş tutulur ve ekranda bir daha açık gösterilmez; düzenlemede boş bırakırsanız mevcut değer korunur, yalnızca değiştirmek istediğinizi yazarsınız.

Adresler — Ödeme URL, Sorgu URL, İade URL, Callback URL. Test ve canlı ortamın adresleri farklıdır; Ortam ayarıyla uyumlu olmasına dikkat edin (canlı ortamda test adresleri kabul edilmez). VakıfBank yeni altyapısında Ödeme/İade için …/virtualPos/Vposreq, 3D başlatma (EnrollmentUrl) için inbound.apigateway…/threeDGateway/Enrollment, sorgu (IslemSorguUrl) için …/virtualPos/Search uçları kullanılır; ayrıntı ekrandaki yardım metnindedir.

ERP POS Kodu / ERP POS Kodu (taksitli) — Ayarlar > Şirket Ayarları'ndaki ERP Tahsilat Aktarımı açıksa bu sağlayıcıdan geçen ödemeler ERP'de bu POS koduna yazılır (Quantum örneği: 02 Ziraat, 03 Vakıf, 06 NKolay). Taksitli çekim ERP'de ayrı bir POS'ta tanımlıysa ikinci alanı doldurun (Kuveyt Türk: tek çekim 001 / taksitli 01); boşsa aynı POS kullanılır. Aktarım açıkken POS kodu boş bırakılırsa o sağlayıcının tahsilatları ERP'ye aktarılamaz ve listede aktarım hatası görünür.

Taksit ve Ek Ayar — Anlaşmadaki Taksitler (bankayla anlaştığınız taksit numaraları) ve bankaya özgü ek parametreler için Ek Ayar (JSON).

3. Taksit Tanımları

🎬 Videolu anlatım: Vade Farkı, Komisyon, Kart Ailesi

TAHSİLAT > Taksitler ekranında, her sağlayıcı için hangi taksidin hangi koşulda sunulacağını tanımlarsınız. Üstteki Sağlayıcı filtresi ile tek POS'a odaklanabilirsiniz.

Bir taksit satırının alanları:

Aynı taksit numarasını farklı kart aileleri ve farklı tutar aralıkları için ayrı satırlar hâlinde tanımlayabilirsiniz; ödeme anında karta ve tutara uyan satır seçilir.

4. Cari Taksit İzinleri

🎬 Videolu anlatım: Vade Farkı, Komisyon, Kart Ailesi

TAHSİLAT > Cari Taksit İzinleri ekranı, belirli müşterilere özel taksit kısıtı koymanızı sağlar (ör. riskli bir bayiye yalnız tek çekim).

1. Cari kutusundan müşteriyi seçin (arama kutusu koda ve isme göre arar).
2. İzin verilen taksitler listesinden kutucukları işaretleyin.
3. İsterseniz kısa bir Açıklama yazın (ör. "ödeme geçmişi nedeniyle").
4. Kaydet deyin. Tanımlı cariler alttaki tabloda listelenir, oradan düzenleyip silebilirsiniz.

İzin iki katmanlı çözülür:

1. Cariye özel tanım varsa yalnız o geçerlidir.
2. Yoksa Ayarlar'daki Varsayılan taksitler uygulanır.
3. O da boşsa taksit tanımlarındaki her şey serbesttir.

Bu kural sunucuda da uygulanır: ekranda gizlenen bir taksit elle gönderilse bile "Seçilen taksit bu kart için geçerli değil." yanıtıyla reddedilir.

5. Yönlendirme Kuralları

🎬 Videolu anlatım: Hangi İşlem Hangi POS'tan Geçsin

TAHSİLAT > Kurallar ekranı birden çok POS'unuz varsa devreye girer: "şu banka kartı şu POS'tan geçsin", "12 taksit yalnız şu POS'ta" gibi kararları burada yazarsınız.

Bir kuralın alanları:

Hiçbir kural eşleşmezse Ayarlar'daki Varsayılan Sağlayıcı kullanılır.

Kuralı Dene paneli sayfanın üstündedir: bir kart BIN'i (ilk 6-8 hane), tutar ve taksit girip Dene dediğinizde, o kombinasyonun hangi kurala takıldığını ve hangi POS'a gideceğini canlı ödeme yapmadan görürsünüz. Yeni kural yazdıktan sonra burada doğrulamanız önerilir.

6. Ödeme Yapma

🎬 Videolu anlatım: Bayi Ödeme Ekranı: Kartla Tahsilat, Taksit Seçenekleri ve 3D Secure

TAHSİLAT > Ödeme Yap ekranı ödeyen tarafın (bayi/cari kullanıcısının) ekranıdır. Kullanıcının hangi cariye ait olduğu kullanıcı kartındaki ERP kodundan çözülür; kullanıcı başka bir carinin adına ödeme yapamaz.

1. Üstte güncel bakiyeniz görünür. Tamamını Öde düğmesi tutar kutusunu bakiyeyle doldurur.
2. Ödenecek Tutar girin (Ayarlar'daki min/max sınırları içinde olmalı).
3. Kart Bilgileri: kart numarası, son kullanma (AA/YY), CVV ve kart üzerindeki ad soyad. Yazdıkça sağdaki kart görseli doldurulur.
4. Kart numarasının ilk haneleri yazılınca Taksit Seçenekleri otomatik yüklenir; bankası ve kart ailesi ekranda belirir. Banka kartı ve ön ödemeli kartlarda taksit sunulmaz.
5. Bir taksit seçip Öde deyin. Bankanın 3D Secure doğrulama ekranına yönlendirilirsiniz (SMS/uygulama onayı).
6. Doğrulama sonrası portala dönersiniz; Sonuç ekranı işlemin başarılı, başarısız, iptal veya iade olduğunu gösterir.

Ekranda kullanıcının ERP kodu tanımlı değilse "Kullanıcınıza ERP kodu tanımlanmamış." uyarısı çıkar — yöneticinin Ayarlar > Kullanıcılar > Düzenle ekranından ERP kodunu doldurması gerekir.

7. Ödemelerim

🎬 Videolu anlatım: Ödemelerim: Bayinin Ödeme Geçmişi ve Tahsilat Makbuzu

TAHSİLAT > Ödemelerim ekranı ödeyen kullanıcının kendi geçmişidir: Tarih, Sipariş No, Tutar, Taksit, Durum sütunları ve her satır için detay bağlantısı. Kullanıcı yalnız kendi carisine ait ödemeleri görür.

Tahsilat makbuzu (PDF): bankadan geçmiş (başarılı) ödemelerin satırında kırmızı PDF düğmesi bulunur; tıklayınca şirket bilgileri, cari, tutar, taksit, onay kodu ve tarih içeren Tahsilat Makbuzu yeni sekmede açılır (Tahsilat_Makbuzu_<Sipariş No>.pdf). Aynı makbuz, ödeme tamamlandığında açılan Sonuç ekranındaki Makbuz (PDF) düğmesinden de alınır. Makbuz yalnız oturum açmış kullanıcıya ve yalnız kendi carisinin ödemeleri için verilir; başarısız, iptal veya iade edilmiş kayıtta düğme çıkmaz.

8. Tahsilatlar ve Tahsilat Detayı

🎬 Videolu anlatım: Sanal POS Tahsilat Takibi

TAHSİLAT > Tahsilatlar şirketin tüm tahsilat kayıtlarının listesidir. Başlangıç / Bitiş tarihi ve Durum ile süzülür.

Durumlar: Beklemede / Oluşturuldu · Bankaya Yönlendirildi · Başarılı · Başarısız · İptal · İade · Kısmi İade.

Başarılı satırların sonunda kırmızı PDF simgesiyle tahsilat makbuzu indirilir (müşteriye verilebilir). ERP Tahsilat Aktarımı açıksa sipariş numarasının altında aktarım izi görünür: aktarılan kayıtta ERP fiş numarası, aktarılamayan kayıtta kırmızı "ERP aktarım hatası" uyarısı ve deneme sayısı (üzerine gelince hata metni).

Bir satırın Detay bağlantısı Tahsilat Detayı ekranını açar. Sağ üstte başarılı ödemeler için Makbuz (PDF) düğmesi vardır. Ekranda üç blok bulunur:

• Özet — Durum, Cari, İletişim, Sağlayıcı, Ana Tutar / Vade Farkı, Toplam Tutar, Taksit, (maskeli) Kart, Onay Kodu, Sağlayıcı İşlem No, Hata, Oluşturma Tarihi, Başarılı Tarih, Muhasebe (oluşturulan cari/banka hareketi bağlantıları) ve ERP Tahsilat Aktarımı açıksa ERP Fiş No (aktarım tarihiyle) ya da ERP Aktarımı hata satırı.
• Olay geçmişi — Tarih, Olay, Sağlayıcı, Sonuç, Tutar, Hata ve Ham İstek / Yanıt. Bankayla yaşanan bir anlaşmazlıkta kanıt buradadır: hangi isteğin gittiği ve hangi yanıtın geldiği kayıtlıdır.
• İptal / İade paneli (yetkisi olan kullanıcıda).

9. İptal ve İade

🎬 Videolu anlatım: Sanal POS Tahsilat Takibi

Tahsilat Detayı ekranındaki panelden yapılır. Kural bankalarda ortaktır:

• Aynı gün yapılan geri alma iptaltir; gün içi işlem tamamen geri alınır, kısmi olamaz — tutar ne yazılırsa yazılsın tam tutar iptal edilir.
• Sonraki günlerde yapılan geri alma iadedir ve kısmi olabilir. İade Tutarı boş bırakılırsa tamamı iade edilir.
• Gerekçe alanına kısa bir açıklama yazın (ör. "müşteri talebi / hatalı çekim"); kayda geçer.

İptal/iade yalnızca başarılı tahsilatlarda mümkündür. Başarısız, iptal edilmiş veya zaten iade edilmiş bir kayıtta düğme çalışmaz — aksi hâlde müşteriye iki kez para dönebilirdi.

Sağlayıcı işlem referansı (Sağlayıcı İşlem No) olmayan bir kayıt geri alınamaz; banka işlemi kendi referansıyla tanır, bizim sipariş numaramız onun yerine geçmez.

10. Askıda Kalan Ödemeler (Mutabakat)

3D doğrulaması ödeyicinin tarayıcısı üzerinden döner. Sekme kapanır, internet koparsa veya banka yönlendirmesi düşerse banka parayı çeker ama portal sonucu hiç öğrenemez; kayıt "Oluşturuldu" durumunda asılı kalır ve müşteri "ödedim" der.

Portal bu durumu kendi kapatır: arka planda periyodik bir mutabakat taraması çalışır, askıda kalmış talepleri sağlayıcıya sorar ve gerçek sonucu kayda işler. Sizin bir şey yapmanız gerekmez.

Sağlayıcının işlem sorgulama ucu yoksa kayıt otomatik sonuçlandırılamaz; bu durumda Tahsilat Detayı > Olay geçmişi'ne bir uyarı satırı yazılır. "Beklemede" durumunda uzun süre kalan bir kayıt görürseniz önce burayı, sonra banka ekranınızı kontrol edin.

11. ERP Tahsilat Aktarımı

Portalda başarılı olan kredi kartı tahsilatları, ERP aktarım programı üzerinden ERP'ye "Kredi Kartı Pos Tahsilatı" fişi olarak yazılabilir. Fişte cari, carinin plasiyeri, POS, tek çekim/taksit açıklaması ve banka onay kodu yer alır; ERP fiş numarası tahsilatta görünür.

1. Ayarlar > Şirket Ayarları > ERP Tahsilat Aktarımı kartında anahtarı Açık yapın. Başlangıç tarihi girerseniz bu tarihten önce başarılı olmuş tahsilatlar aktarılmaz (ERP'ye elle girilmiş eski kayıtları mükerrer yazmamak için); boş bırakılırsa sınır yoktur. Kaydet deyin. Kart yalnız Tahsilat modülü olan şirketlerde görünür ve Şirket Ayarları yetkisi ister.
2. TAHSİLAT > Sağlayıcılar'da her sağlayıcının ERP POS Kodu alanını (gerekirse taksitli POS kodunu) doldurun; bkz. 2. Sağlayıcı Tanımlama.
3. Aktarım, ERP aktarım programının her turunda otomatik yapılır; portalda ayrıca bir düğme yoktur. Sonuç Tahsilatlar listesinde ve Tahsilat Detayı'nda izlenir: ERP fiş no (aktarıldı) ya da aktarım hatası ve deneme sayısı. Hata giderilince (ör. POS kodu girilince) kayıt sonraki turda yeniden denenir.
4. Aktarım yalnız Başarılı tahsilatlar içindir; iptal ve iadeler ERP'ye yansıtılmaz, elle takip edilir.

Alan Açıklamaları