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ı — süper admin ş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ı

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).

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ı").
• 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.

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ı

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

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ı

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

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

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.

8. Tahsilatlar ve Tahsilat Detayı

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.

Bir satırın Detay bağlantısı Tahsilat Detayı ekranını açar. Burada üç blok vardır:

• Ö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 ve Muhasebe (oluşturulan cari/banka hareketi bağlantıları).
• 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

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.

Alan Açıklamaları