← Tüm yazılar

Banka Entegrasyon Projelerinde Kritik Başarı Faktörleri

Banka entegrasyonlarında erişim, veri anlamı, işlem durumu, güvenli tekrar ve mutabakatı birlikte ele almak için teknik ve operasyonel kontroller.

Kariyerimin ilk 11 yılında kurumsal finans yazılımlarında geliştirme, analiz ve banka entegrasyonları üzerinde çalıştım. Bu teknik temel, entegrasyonları değerlendirirken bağlantının yanında verinin anlamına ve işlem sonucuna da bakmamı sağlıyor.

Banka entegrasyonunda erişimin kurulması ve verinin alınması önemli kilometre taşlarıdır. Ancak finans ekibinin günlük işini güvenle yürütebilmesi için eksik, mükerrer veya sonucu belirsiz işlemlerin de yönetilebilmesi gerekir.

Bu nedenle entegrasyonu teknik bağlantı, finansal doğrulama ve operasyon hazırlığıyla birlikte ele almak gerekir.

1. Test ve canlı erişimlerini ayrı doğrulayın

Test ve canlı ortam adresleri, yetkiler, ağ erişimleri ve gerekli sertifikalar başlangıçta netleşmelidir. Banka ve kurum tarafındaki tanımların kim tarafından hazırlanacağı belirlenmelidir.

Test ortamına bağlanabiliyor olmak, canlı ortamın da hazır olduğunu göstermez. Ortamlar arasında adres, yetki veya ağ kuralı farklılıkları bulunabilir.

Bu hazırlıkları gerçek bağlantı kontrolleriyle doğrulayın. Sertifika yenileme ve erişim değişikliği gibi bakım ihtiyaçlarının sorumlusu da belli olsun.

İşlem saatleri veya kesim zamanları akışı etkiliyorsa bunları bankanın ilgili hizmeti için teyit edin. Teknik erişimin sürekli açık olması, her finansal işlemin aynı anda sonuçlanacağı anlamına gelmeyebilir.

2. Alanları finans ekibiyle birlikte yorumlayın

İşlem tarihi, valör tarihi, banka referansı, kurumun işlem kimliği, para birimi ve borç/alacak yönü farklı amaçlara hizmet eder.

Bir alanın teknik olarak okunabilmesi, doğru iş kuralıyla kullanıldığını göstermez. Yanlış yorumlanan tarih raporlamayı, yanlış yön bilgisi ise hareketin değerlendirilmesini etkileyebilir.

Örnek kayıtları finans ekibiyle birlikte inceleyin. Dosya tabanlı akışlarda tarih ve tutar biçimlerini de kontrol edin. Zorunlu alanları, kodların anlamını ve eksik veride uygulanacak davranışı yazılı olarak netleştirin.

Aynı tarih ve tutara sahip iki kayıt da mutlaka aynı işlem değildir. Mükerrer kayıt kontrolünü yalnızca bu alanlara dayandırmayın; bankanın referans yapısını ve diğer ayırt edici bilgileri değerlendirin.

3. Gönderim, kabul ve nihai sonucu ayrı izleyin

SFTP üzerinden dosyanın bankaya ulaşması, içindeki bütün talimatların işlendiğini göstermez. Web servisinden alınan başarılı teknik yanıt da bankanın protokolüne göre farklı aşamaları ifade edebilir.

Gönderildi, kabul edildi, işleniyor, bekliyor, reddedildi ve tamamlandı durumlarının anlamını netleştirin. Nihai sonucun hangi yanıt, sorgu veya dosyadan öğrenileceğini belirleyin.

Çok kayıtlı dosyalarda bazı işlemler kabul edilirken diğerleri reddedilebilir. Operasyon ekibi dosyanın genel durumunun yanında her kaydın sonucunu da görebilmelidir.

Bu görünürlük, bir dosyayı bütünüyle yeniden göndermek yerine hangi işlemin incelemeye ihtiyaç duyduğunu anlamayı sağlar.

4. Zaman aşımını doğrudan başarısız işlem saymayın

Yanıt alınamaması, bankanın işlemi almadığını kanıtlamaz. Talimat kabul edilmiş fakat yanıt sisteme ulaşmamış olabilir.

Özellikle ödeme gönderiminde kontrolsüz tekrar, mükerrer işlem riski oluşturabilir. Sonucu belirsiz kaydı ayrı bir durumda tutun; önce durum sorgusu veya bankayla mutabakat üzerinden sonucu araştırın.

Bankanın desteklediği benzersiz referans ve güvenli tekrar mekanizmasını kullanın. Her bankanın aynı yaklaşımı desteklediğini varsaymayın. Open Banking ödeme teknik standardı, aynı isteğin tekrarında yeni işlem oluşmasını önleyen mekanizmayı örnekler.

Manuel yeniden gönderim yapılıyorsa önceki girişimle ilişkisi ve işlem gerekçesi de izlenebilir olmalıdır.

5. Testleri hata durumlarıyla zenginleştirin

Yalnızca başarılı örnek kayıtlarla yapılan testler, canlı operasyon için sınırlı güvence sağlar.

Bankanın hizmeti ve test ortamı kapsamında mümkün olan şu senaryoları değerlendirin:

  • Yetki veya erişim eksikliği
  • Yanlış hesap veya hatalı veri biçimi
  • Farklı para biriminde işlem
  • Dosyanın kısmen kabul edilmesi
  • Geciken veya belirsiz sonuç
  • Tekrar gönderim
  • Bağlantı kesintisinden sonra devam etme

Test ortamında doğrulanamayan noktaları açıkça kaydedin. Bunları canlıya geçişte hangi sınırlı ve kontrollü adımlarla doğrulayacağınızı bankayla birlikte belirleyin.

6. Mutabakatı operasyonun günlük işine yerleştirin

Kurum kayıtlarıyla banka sonuçlarını işlem referansı, hesap, para birimi, tutar ve durum üzerinden karşılaştırın.

Yalnızca toplam tutarların eşit olması yeterli değildir. Eksik bir işlemle mükerrer başka bir işlem toplamda birbirini dengeleyebilir.

Bekleyen işlemler, açıklanamayan farklar ve manuel müdahaleler görünür olmalıdır. Bunları kimin inceleyeceği, hangi durumda bankaya başvurulacağı ve sonucun nasıl kaydedileceği önceden belirlenmelidir.

Kontrol sıklığını işlem hacmine ve riske göre oluşturun. Canlı sonrası yoğun desteğin süresini de sabit bir takvimden çok sonuçların kararlılığına ve açık sorunlara göre değerlendirin.

Başlangıç için işlem referansı, beklenen sonuç, mevcut durum, doğrulama yöntemi, son kontrol zamanı ve sorumlu kişiden oluşan bir takip tablosu kullanabilirsiniz.

Sık sorulan sorular

Bankadan yanıt gelmezse işlem tekrar gönderilmeli mi?

Hemen gönderilmemelidir. Yanıt alınamaması, bankanın işlemi almadığını kanıtlamaz ve kontrolsüz tekrar mükerrer işlem riski doğurur. Sonucu belirsiz kayıt ayrı bir durumda tutulmalı, önce durum sorgusu veya mutabakatla araştırılmalı; bankanın desteklediği benzersiz referans ve güvenli tekrar mekanizması kullanılmalıdır.

Gönderildi, kabul edildi ve tamamlandı durumları neden ayrı izlenmeli?

Dosyanın SFTP ile bankaya ulaşması, içindeki talimatların işlendiğini göstermez; başarılı bir teknik yanıt da farklı aşamaları ifade edebilir. Çok kayıtlı dosyalarda bazı işlemler kabul edilirken diğerleri reddedilebileceği için her kaydın nihai sonucu ayrı görünmelidir.

Banka mutabakatında toplam tutarların eşit olması yeterli mi?

Hayır. Eksik bir işlemle mükerrer başka bir işlem toplamda birbirini dengeleyebilir. Mutabakat; işlem referansı, hesap, para birimi, tutar ve durum üzerinden kayıt bazında yapılmalıdır. Bekleyen işlemler ve açıklanamayan farklar da görünür olmalıdır.