Banka Hesapları
Banka Hesapları, işletmenizin kendi banka hesaplarını Lunixi'ye bağlamanızı ve bu hesapların listesini, bakiyelerini ve hareketlerini (ekstre satırlarını) tek yerden okumanızı sağlar. Veriyi panelden görebilir, API anahtarınızla kendi sunucunuzdan okuyabilir ve yeni hareketleri webhook ile alabilirsiniz.
Ne sunar
| Yetenek | Açıklama |
|---|---|
| Hesap listesi | Bağlı bankalarınızdaki hesaplar; IBAN ve hesap numarası maskeli döner. |
| Bakiye | Her hesabın en son okunan bakiyesi. |
| Hareketler | Gelen ve giden hareketler; bankadan bağımsız ortak bir hareket tipiyle (canonicalType). |
| Yeni hareket bildirimi | Yeni okunan her hareket için bank_account.transaction.received webhook olayı. |
| Tazelik bilgisi | Verinin en son ne zaman okunduğu ve bir sonraki okumanın ne zaman mümkün olduğu. |
| Panel ekranları | Bağlı bankalarınız, para birimi başına toplam varlıklarınız, banka detayında hesaplar ve hareketler. |
| Hesap ekstresi | Süzdüğünüz hareketleri panelden Excel ya da PDF ekstre olarak indirme. |
| Para transferi | Bağlantınız transfer destekliyorsa bağlı hesabınızdan bir IBAN'a para gönderme; panelden ya da API'den. → Para Transferi |
| Döviz işlemi | Bağlantınız destekliyorsa aynı bankadaki iki hesabınız arasında döviz alım satımı. → Döviz İşlemi |
| Transfer bildirimi | Transfer oluştuğunda ve sonuçlandığında bank_transfer.* webhook olayları. |
Para transferi ve döviz işlemi her bağlantıda bulunmaz. Bağlantınızın hangi işlemleri desteklediğini bağlantının capabilities alanından okursunuz. → Bağlantılar
Ne sunmaz
- Bankanızı API'den bağlayamazsınız; bağlama yalnız panelden yapılır.
- Banka hesabınızın ayarlarını, limitlerini ya da yetkililerini değiştiremezsiniz.
- Transfer desteklemeyen bağlantılardan para gönderemezsiniz; bu bağlantılarda ürün yalnız okuma yapar.
Nasıl çalışır
Bankanızı panelden bağlayın
Panelde Banka Bağlantıları › Entegrasyonlar ekranında bankanızı seçip Lunixi ile bağla'ya tıklayın. Banka başvuru belgesi istiyorsa ıslak imzalı başvuruyu şubenize verirsiniz; bankanız size API bilgilerini iletince bunları bağlantı ayrıntısına girersiniz ve kurulumu Lunixi tamamlar. Bağlanabilen bankalar: Bankalar › Bağlanabilen bankalar. → Panelden Banka Bağlama
API anahtarınıza yetki verin
Anahtarınızda Banka Bağlantıları ürünü (BANK_CONNECT) ve bank-connect:view yetkisi olmalıdır. Bakiye ve hareket okuyacaksanız bank-connect:transactions:view yetkisini de ekleyin. API'den para transferi ya da döviz işlemi yapacaksanız bank-connect:transfer yetkisi gerekir; bu yetki yalnız IP izin listesi tanımlı anahtara verilir. → API'ye Giriş
Okuyun ve abone olun
Hesapları, bakiyeleri ve hareketleri API'den okuyun; yeni hareketler için webhook olayına abone olun. → Hesaplar · Hareketler · Webhook Olayları
Bankanızı API'den bağlayamazsınız. Bağlama yalnız panelden yapılır. Banka bilgileriniz ve başvuru belgeleriniz sunucunuzdan geçmez. API anahtarınız verileri okur; bank-connect:transfer yetkisi verdiğiniz ve IP izin listesi tanımladığınız anahtar ayrıca transfer ve döviz işlemi yapabilir.
Paneldeki ekranlar
Bağlantı aktif olduktan sonra verinizi panelde Banka Bağlantıları altında görürsünüz:
| Ekran | Ne gösterir |
|---|---|
| Bankalar | Üstte para birimi başına toplam kartları (ör. Tüm TL Varlıklarım · 4 hesap · tutar); altında her bağlı bankanın kartı: para birimi bakiyeleri, hesap sayısı ve son güncelleme zamanı. |
| Banka detayı | Bankalar ekranında bir bankaya tıklayınca açılır. Solda para birimi toplamları ve hesap seçimi; sağda hareketler, süzgeçler, hareket ayrıntısı ve Şimdi yenile. |
| Hesap ekstresi | Banka detayından Excel ya da PDF; süzgeçle eşleşen bütün hareketler, en çok 10.000 hareket. |
| Entegrasyonlar | Bankayı seçip bağlantı ya da başvuru başlattığınız yer. |
| Hesaplar ve Hareketler | Bütün bankalarınızdaki hesaplar ve hareketler tek listede. |
| Para gönder ve Döviz çevir | Bağlantısı destekleyen bankalarda transfer ve döviz işlemi; e-posta doğrulama koduyla onaylanır. |
Ayrıntılar: Bankalar ve Ekstre