Panelden Banka Bağlama

Bankanızı bağlamak yalnız panelden yapılır. Bu sayfa paneldeki adımları anlatır. Bağlantı aktif olduktan sonra hesaplarınızı panelde görebilir ve API'den okuyabilirsiniz.

Bankalar panelde Banka Bağlantıları ürününün altındadır:

Ekran	Ne için
Bankalar	Bağlı bankalarınız, toplam varlıklarınız, banka detayı ve ekstre. → Bankalar ve Ekstre
Entegrasyonlar	Bankayı seçip bağlantı ya da başvuru başlatmak.
Başvuru formu	Birden çok bankaya birlikte başvurmak.
Hesaplar	Bütün hesaplarınız.
Hareketler	Bütün hesaplarınızın hareketleri.

Bağlanabilen bankaların listesi: Bankalar › Bağlanabilen bankalar.

Gereken panel yetkileri

İşlem	Panel yetkisi
Bankaları, başvuru formunu ve hesapları görmek	`bank-connect:view`
Bağlantı ya da başvuru başlatmak, banka bilgilerini girmek, bağlantıyı kesmek	`bank-connect:manage`
Bakiyeleri ve hareketleri görmek, ekstre indirmek	`bank-connect:transactions:view`

Yetkiniz yoksa ekranda hangi yetkinin gerektiği yazar; organizasyon yöneticinizden isteyebilirsiniz.

Ortamı seçin

Ekranların üstündeki Ortam seçicisiyle Test ya da Canlı ortamı seçin. Bağlantı seçili ortamda açılır ve yalnız o ortamın API anahtarıyla okunur. Test ortamında yalnız simülatör bankalar listelenir; gerçek bir bankaya bağlanılmaz. → Test Ortamı

Entegrasyonlar ekranı

Banka bağlamaya Banka Bağlantıları › Entegrasyonlar ekranından başlarsınız. Henüz bağlı bankanız yoksa Bankalar ekranındaki Entegrasyonlara git düğmesi de sizi buraya getirir.

Bu ekranda bankaları adıyla ya da EFT koduyla arayabilirsiniz. Her bankanın kartında bağlantınızın durumu görünür:

Kart durumu	Anlamı	API'deki bağlantı durumu
Bağlanabilir	Bu bankayı Lunixi ile bağlayabilirsiniz.	— (bağlantı yok)
Yakında	Bu ortamda bu banka için henüz bağlantı desteği yok.	—
Belge bekleniyor	Başvuru belgeleriniz bekleniyor.	`PENDING_DOCUMENTS`
İncelemede	Belgeleriniz inceleniyor.	`UNDER_REVIEW`
Kurulum bekleniyor	Kurulum Lunixi tarafından tamamlanıyor.	`PENDING_SETUP`
Bağlı	Hesaplarınız düzenli olarak okunuyor.	`ACTIVE`
Okuma gecikiyor	Son okumalar başarısız oldu; veri güncel olmayabilir.	`DEGRADED`
Askıya alındı	Okuma yapılmıyor.	`SUSPENDED`

Bir bankayı bağlayın

Bankayı seçin ve başvurun

Entegrasyonlar ekranında bağlamak istediğiniz bankanın kartında Lunixi ile bağla'ya tıklayın. Açılan pencerede bankaya göre ek bilgiler istenebilir; örneğin bu bankadaki IBAN'larınız (her satıra bir IBAN). İstenen alanlar bankaya göre değişir. Lunixi ile bağla ile başvurunuz oluşturulur.

Başvuru belgesini şubenize verin

Banka başvuru belgesi istiyorsa belgeler pencerede ve bağlantının ayrıntısında listelenir. Her belge için Örnek formu indir ile formu indirin, doldurun ve imzalayın. Islak imzalı başvuru belgesini şubenize verin; her belgenin altındaki teslim talimatı belgenin nereye iletileceğini yazar. Belgeleriniz alındığında panelde işaretlenir.

Bir belge reddedilirse gerekçesi bağlantının ayrıntısında görünür; belgeyi düzeltip yeniden iletin.

Bankanızın verdiği bilgileri girin

Bankanız başvurunuzu işleme aldıktan sonra size bağlantı için API bilgilerini iletir. Bu bilgileri bağlantı ayrıntısındaki Bankanızın verdiği bilgiler bölümüne girin. → Bankanızın verdiği bilgiler

Kurulumu bekleyin

Lunixi ekibi kurulumu tamamlar. Banka okunmaya başladığında bağlantı aktif olur, kart Bağlı görünür ve hesaplarınız Bankalar ve Hesaplar ekranlarında kendiliğinden listelenir. Bankanız okunur hâle gelirse bağlantı, başvuru adımları tamamlanmamış olsa da aktif olur.

Bankanızın verdiği bilgiler

Şubenize ıslak imzalı başvuruyu verdikten sonra bankanız size bağlantı için API bilgilerini iletir. Bu bilgileri şöyle girersiniz:

Entegrasyonlar ekranında bankanın kartında Ayrıntılar'a tıklayın.
Bankanızın verdiği bilgiler bölümünde Bilgileri gir'e tıklayın.
Bankanızın ilettiği alanları doldurup Kaydet'e tıklayın.

Bilmeniz gerekenler:

İstenen alanlar bankaya göre değişir; bölüm yalnız bu bilgileri isteyen bankalarda görünür.
Bölüm, bağlantı Kurulum bekleniyor adımına geldiğinde açılır; bağlantı Bağlı ya da Okuma gecikiyor durumundayken de bilgileri güncelleyebilirsiniz.
Bilgiler şifreli saklanır. Kaydettikten sonra değerler güvenlik nedeniyle bir daha gösterilmez; bölümde yalnız Girildi ve giriş zamanı görünür.
Bilgileri değiştirmek için Bilgileri güncelle'ye tıklayın. Boş bıraktığınız alan mevcut değerini korur; yalnız değiştirdiğiniz alanları girmeniz yeterlidir.
Bilgileri girmek için bank-connect:manage yetkisi gerekir.

İlk okuma

Bağlantı aktif olduğunda hesaplarınız, bakiyeleriniz ve hareketleriniz bankadan okunmaya başlar.

İlk bağlantıda son 30 günün hareketleri okunur. Bu geçmiş hareketler birkaç dakika içinde parça parça yüklenir; ilk dakikalarda listenin henüz tamamlanmamış olması olağandır.
Sonrasında hesaplar bankadan düzenli olarak, en sık 5 dakikada bir okunur. → Sınırlar › Tazelik ve okuma aralığı
İlk bağlantıda okunan geçmiş hareketler için webhook gönderilmez. → Webhook Olayları

Birden çok bankaya birlikte başvurun

Birden çok bankayı aynı anda bağlamak için Banka Bağlantıları › Başvuru formu ekranını kullanın:

Bankaları seçin. Bağlantınız ya da başvurunuz olan bankalar ve bu ortamda desteklenmeyen bankalar seçilemez. Bağlantı bilgisi (ör. IBAN listesi) isteyen bankaları Entegrasyonlar ekranından tek tek bağlayın.
Gereken belgeleri inceleyin. Seçtiğiniz bankaların istediği belgeler tek listede gösterilir; aynı belge birden çok banka için isteniyorsa bir kez listelenir ve hangi bankalar için istendiği yazar. Örnek formları indirip doldurun ve teslim talimatına göre iletin.
Başvuruyu başlatın. Seçtiğiniz her banka için ayrı bir bağlantı açılır. Sonuç ekranında kaç başvurunun oluşturulduğu ve hangilerinin neden açılamadığı gösterilir.

Sonraki adımlar her banka için ayrı yürür: belgeyi şubeye verme, bankanızın verdiği bilgileri girme ve kurulum.

Başvuru süreci

Başvuru, bağlantı aktif olana kadar şu adımlardan geçer. Aynı durum API'de bağlantının status alanında görünür:

Paneldeki adım ile API’deki status aynı şeyin iki adıdır. Belge istemeyen bankalarda başvuru Kurulum bekleniyor adımında başlar.

Belge istenmeyen bankalarda başvuru doğrudan kurulum adımından başlar. Durumların anlamı ve ne yapmanız gerektiği: Kavramlar › Bağlantı durumları.

Bağlantı ayrıntısı

Entegrasyonlar ekranında bir bankanın kartında Ayrıntılar'a tıklayın. Ayrıntıda bağlantının durumu, başvuru süreci, başvuru belgeleri, Bankanızın verdiği bilgiler bölümü, başvuru ve açılış tarihleri, son başarılı okuma zamanı, ardışık başarısız okuma sayısı ve hesap sayısı görünür. Hesapları görüntüle ile bu bankadaki hesaplarınıza geçersiniz.

Bağlı bir bankanın bakiyelerini ve hareketlerini görmek için Bankalar ekranında bankanın kartına tıklayın. → Bankalar ve Ekstre › Banka detayı

Bağlantıyı kesin

Bağlantı ayrıntısında Bağlantıyı kes'e tıklayıp onaylayın.

Bağlantının durumu DISCONNECTED olur ve bu bankadan yeni hareket okunmaz.
Bağlantının hesapları silinmez; durumları INACTIVE olur.
Bankayı yeniden okumak için yeniden bağlamanız gerekir; yeni bağlantı yeni bir connectionId alır.
Başvuru aşamasındaki bir bağlantıyı keserseniz başvuru sonlanır; yeniden bağlanmak için baştan başvurursunuz.

Bankanızı neden API'den bağlayamazsınız

Bağlama, banka bilgilerinizi ve başvuru belgelerinizi içerir. Bu bilgiler yalnız panelde, panel oturumunuzla girilir ve sunucunuzdan geçmez. Bir API anahtarına bağlama ya da kesme yetkisi verilemez; anahtarlar verileri okur ve yetki verildiyse transfer ile döviz işlemi yapar.

Panel oturumu ve API anahtarı ayrı kimliklerdir: panel ekranlarının kullandığı istekler API anahtarıyla çağrılamaz, API anahtarlı uçlar da panel oturumuyla çağrılamaz. → API'ye Giriş

Kavramlar Bankalar ve Ekstre