Günsonu Dosyaları

Payantis Platform üzerinde kart işlemleri, gün içinde real-time API’ler aracılığıyla otorizasyon, bakiye kontrolü ve işlem kararları alınarak ilerler. Ancak kart ekosisteminde finansal kesinlik, takas (clearing) ve mutabakat (settlement) süreçleri tamamlandıktan sonra oluşur.

Bu nedenle Payantis, gün sonunda Kuruma iki temel dosya iletir:

Settlement Dosyası

Expire Dosyası

Bu dosyalar, gün içindeki real-time akışların finansal olarak doğrulanması, uzlaştırılması ve tamamlanması amacıyla kullanılır.

Genel Yaklaşım ve Amaç

Günsonu dosyalarının temel amacı:

Kart ağlarından (BKM, Visa, Mastercard vb.) gelen kesinleşmiş takas kayıtları ile,

Gün içinde real-time olarak alınmış otorizasyon ve bakiye hareketlerini
karşılaştırmak (mutabakat yapmak) ve gerekli finansal düzeltmeleri gerçekleştirmektir.

Bu yapı sayesinde:

Gün içi işlemler ile kart ağı gerçekleri arasında tutarlılık sağlanır

Otorizasyon alınmış ancak gerçekleşmemiş işlemler temizlenir

Kurum muhasebesi, kart ağı settlement verileriyle uyumlu hale getirilir

Dosya Yapısı, Header / Footer ve Dosya İsimlendirme Kuralları

Payantis tarafından Kurum’a iletilen günsonu mutabakat dosyaları, hem Settlement hem de Expire işlemleri için standart ve tutarlı bir dosya formatı kullanılarak üretilir. Bu bölümde dosyaların genel yapısı, satır formatları ve dosya isimlendirme kuralları açıklanmaktadır.

Genel Dosya Yapısı

Dosyalar satır bazlı (row-based) düz metin dosyalarıdır.

Dosya içindeki alanlar:

Alanlar arası ayraç (separator) olarak ## kullanılır.

Her satırın başında, satır tipini belirten bir row belirteci yer alır.

Satır Tipleri (Row Indicators)

Dosya içerisinde üç farklı satır tipi bulunur:

1. Header Satırı

Dosyanın ilk satırıdır.

Dosyanın hangi güne ait olduğunu belirtir.

Header satırı H ile başlar ve sonrasında günün tarihi YYYYMMDD formatında yazılır. Formatı H_<EODDate> biçimindedir . Örnek: H_20250116

2. Detay Satırları

Settlement veya Expire işlemlerine ait asıl işlem kayıtlarıdır.

Her detay satırı R ile başlar.

Alanlar arasında ## ayıracı kullanılır.

Genel Format: R##<Alan1>##<Alan2>##<Alan3>##...

Örnek: R##1213##Purchase##...

3. Footer Satırı

Dosyanın son satırıdır.

Header ile aynı şekilde gün bilgisini içerir.

Footer satırı F ile başlar. Formatı F_<EODDate> biçimindedir . Örnek: F_20250116

Dosya İsimlendirmesi

Dosya isimleri, dosyanın ait olduğu gün, dosya türü ve üretim zamanı bilgisini içerecek şekilde standartlaştırılmıştır.

Genel Dosya Adı Formatı: <EODDate><DOSYA_TIPI><ItemCount>_<FileTime>.TXT

Dosya İsmindeki Alanlar

EODDate
Dosyanın ait olduğu gün (YYYYMMDD formatında)

DOSYA_TIPI

SETTLED_TRANSACTIONS → Settlement Dosyası

EXPIRED_TRANSACTIONS → Expire Dosyası

ItemCount
Dosya içerisindeki detay (R) satırı sayısı

FileTime
Dosyanın üretildiği saat ve dakika bilgisi (HHMM)

Örnek Dosya Adı: 20250116_SETTLED_TRANSACTIONS_7535_1145.TXT

Settlement Dosyası

Expire Dosyası

Settlement Dosyası, kart ağlarından (BKM, Visa, Mastercard) Payantis’e ulaşan takas (clearing) kayıtlarını içerir. Bu dosya, gün içinde gerçekleşmiş ve finansal olarak kesinleşmiş işlemlerin listesidir.

Bu işlemlerin:

Büyük bir kısmı için gün içinde otorizasyon alınmış olabilir

Ancak bazı işlemler için:

Otorizasyon alınmamış olabilir

Otorizasyon alınmış ama detayları farklılaşmış olabilir

Bu nedenle Settlement Dosyası, Kurum için nihai finansal gerçekliği temsil eder.

Kurumun Yapması Gerekenler (Settlement)

Kurum, Settlement Dosyası’nı aldığında aşağıdaki kontrolleri ve işlemleri yapmalıdır:

Otorizasyon – Settlement Kaydı Eşleştirmesi

Settlement kaydı, daha önce alınmış bir otorizasyon ile eşleştirilir. Eşleştirme işlem referansı olarak transactionId üzerinden yapılmalıdır.

Otorizasyonlu İşlemler

Otorizasyon daha önce bakiyeyi güncellemiştir, settlement ile bu düşüm kesinleştirilmiş olur. Settlement kaydı ile otorizasyon kaydı arasında tutar farkı varsa:

Kurum farkı hesaba yansıtmalıdır.

Otorizasyonsuz İşlemler

Settlement Dosyası’nda yer alıp otorizasyonu alınmamış işlemler olabilir. Bu durumda Kurum:

İşlemi doğrudan finansal kayıt olarak ele almalı

Gerekli bakiye düşümünü/muhasebe kaydını oluşturmalıdır.

Mükerrer ve Hatalı Kayıt Kontrolleri

Aşağıdaki kontroler yapılarak hata durumlarında uyarı üretilmelidir:

Aynı işlem birden fazla kez gelmiş mi?

Daha önce settle edilmiş bir işlem tekrar yer alıyor mu?

Settlement Dosyasındaki Alanlar

Settlement dosyasında işleme dair tüm bilgiler yer alır. Bu dosyadaki kayıtlar ile daha önceden alınmış otorizasyon kayıtları Token Id ve Transaction Id alanları kullanılarak eşleştirilir. Dosyadaki alanlara buradan ulaşılabilir.

Settlement ve Expire Dosyalarının Birlikte Değerlendirilmesi

Settlement ve Expire dosyaları birbirini tamamlayan yapılardır:

Settlement Dosyası

“Gerçekleşmiş ve kesinleşmiş işlemler”

Expire Dosyası

“Gerçekleşmemiş ve temizlenmesi gereken işlemler”

Kurum, bu iki dosyayı birlikte değerlendirerek:

Gün içi real-time işlemler

Kart ağı settlement gerçekleri
arasında tam ve doğru bir mutabakat sağlar.

Özet Olarak

Günsonu dosyaları:

Real-time API’lerle alınan kararların finansal doğrulamasını yapar

Kurum muhasebesi ile kart ağı kayıtları arasında uyum sağlar

Askıda kalan veya eksik işlemleri temizler

Sağlıklı, izlenebilir ve sürdürülebilir bir kart finansal mimarisi oluşturur

Bu nedenle Settlement ve Expire dosyaları, Payantis – Kurum entegrasyonunun vazgeçilmez tamamlayıcı bileşenleridir.

Genel Yaklaşım ve Amaç#

Dosya Yapısı, Header / Footer ve Dosya İsimlendirme Kuralları#

Genel Dosya Yapısı#

Satır Tipleri (Row Indicators)#

1. Header Satırı#

2. Detay Satırları#

3. Footer Satırı#

Dosya İsimlendirmesi#

Dosya İsmindeki Alanlar#

Kurumun Yapması Gerekenler (Settlement)#

Settlement Dosyasındaki Alanlar#

Settlement ve Expire Dosyalarının Birlikte Değerlendirilmesi#

Özet Olarak#