Sık Sorulan Sorular

Bankamı panelde nereden bağlarım?

Banka Bağlantıları › Entegrasyonlar ekranında bankanın kartında Lunixi ile bağla'ya tıklayın. Bankalar ekranı yalnız bağlı bankalarınızı gösterir; henüz bağlı bankanız yoksa oradaki Entegrasyonlara git düğmesi sizi Entegrasyonlar ekranına götürür. Bağlanabilen bankalar: Bankalar › Bağlanabilen bankalar. → Panelden Banka Bağlama

Bankamın verdiği API bilgilerini nereye girerim?

Entegrasyonlar ekranında bankanın kartında Ayrıntılar'a tıklayın ve Bankanızın verdiği bilgiler bölümüne girin. Bilgiler şifreli saklanır ve bir daha gösterilmez. Bölüm, bağlantı Kurulum bekleniyor adımına geldiğinde görünür. → Panelden Banka Bağlama › Bankanızın verdiği bilgiler

Bağlantı aktif olduktan sonra hareketlerim ne zaman görünür?

İ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. İlk dakikalarda listenin eksik görünmesi olağandır. Sonrasında hesaplar düzenli olarak, en sık 5 dakikada bir okunur. → Panelden Banka Bağlama › İlk okuma

Hesap ekstresini nasıl indiririm?

Bankalar ekranında bankaya tıklayın, banka detayında hesabı ve süzgeçleri seçin, Excel ya da PDF'e tıklayın. Ekstre, süzgeçle eşleşen bütün hareketleri içerir; ekrandaki sayfayla sınırlı değildir. → Bankalar ve Ekstre › Hesap ekstresi

Ekstrede en çok kaç hareket olabilir?

En çok 10.000. Sonuç daha uzunsa ilk 10.000 hareket alınır ve ekranda belirtilir; bütün hareketler için tarih aralığını daraltıp birden çok ekstre alın.

Neden bazı hesaplarda IBAN görünmüyor?

IBAN ve hesap numarası bankanın paylaştığı bilgiden gelir. Bankanız bir hesap için IBAN ya da hesap numarası bildirmediyse bu alan panelde boş kalır; API'de de alan dönmez. Hesabın bakiyesi ve hareketleri bundan etkilenmez.

Hareket ne kadar sürede görünür?

Hesaplar bankadan belirli aralıklarla okunur; hareket, banka bildirdikten sonraki ilk okumada görünür. Aralık hesaba göre freshness.minSyncIntervalSeconds alanındadır. → Sınırlar › Tazelik ve okuma aralığı

Bankamı API'den bağlayabilir miyim?

Hayır. Bağlama yalnız panelden yapılır; API anahtarına bağlama yetkisi verilemez. → Panelden Banka Bağlama

Neden IBAN maskeli?

Tam IBAN, hesap numarası ve karşı taraf bilgileri API'de ve webhook'ta hiç dönmez; yalnız maskeli biçimleri döner. → Kavramlar › Maskeleme

Bağlantı DEGRADED ise ne yapmalıyım?

Son okumalar başarısız olmuştur; okumalar kendiliğinden yeniden denenir. O sürede veri eski kalabilir; lastSuccessfulSyncAt alanını izleyin. → Kavramlar › Bağlantı durumları

Yenileme isteği neden hemen çalışmadı?

Yenileme okuma aralığını kısaltmaz. Aralık dolmadıysa yanıt SCHEDULED döner ve okuma scheduledAt zamanında yapılır. → Şimdi Yenile

Webhook'u kaçırırsam?

Teslimat yeniden denenir; yine de kaçan hareketleri liste ucundan tamamlayın. → Hareketleri senkron tutma

Aynı hareket iki kez gelir mi?

Aynı hareket bir kez kaydedilir. Webhook teslimatı ise en az bir kez yapılır; aynı olay tekrar gelebilir. x-lunixi-event-id ya da transactionId ile tekilleştirin. → Webhook Olayları

Bağlantı kurulduğunda geçmiş hareketler için webhook gelir mi?

Hayır. İlk kurulumda geriye dönük okunan hareketler liste ucunda görünür, ama olay doğurmaz. → Webhook Olayları › Ne zaman gönderilir

Bakiye ve hareketleri okurken neden 403 alıyorum?

Bakiye ve hareketler ayrı yetki ister: bank-connect:transactions:view. bank-connect:view yetmez. → API'ye Giriş › Yetkiler

API ile para gönderebilir miyim?

Bağlantınız transfer destekliyorsa evet. Bağlantının capabilities alanında OUTGOING_TRANSFER olmalı, API anahtarınız bank-connect:transfer yetkisini ve bir IP izin listesini taşımalıdır. API anahtarıyla gönderilen transferde e-posta doğrulama kodu yoktur. → Para Transferi

Transfer isteğinde neden 403 bank_connect.auth.ip_allowlist_required alıyorum?

Para hareketi uçları yalnız IP izin listesi tanımlı anahtarla çağrılabilir. Panelde anahtarınıza sunucunuzun çıkış IP adreslerini ekleyin. Listeye eklenmiş ama isteğin geldiği adres listede değilse 403 bank_connect.auth.ip_not_allowed alırsınız. → API'ye Giriş › IP izin listesi

Zaman aşımı aldım; transferi yeniden göndermeli miyim?

Aynı isteği aynı Idempotency-Key ve aynı gövdeyle yeniden gönderin. Transfer oluştuysa mevcut transfer replayed: true ile döner, ikinci transfer açılmaz. Yeni bir anahtarla göndermeyin. → Para Transferi › Idempotency-Key

Transferim neden SUBMITTED durumunda bekliyor?

Transfer bankaya iletildi ve bankanın cevabı bekleniyor. outcomeUnknown true ise sonuç bankadan henüz doğrulanamamıştır; transferi yeniden göndermeyin, Lunixi sonucu bankayla doğrular ve sonuç bank_transfer.completed ya da bank_transfer.failed olayıyla gelir. → Para Transferi › Sonucu doğrulanamayan transfer

Döviz teklifim neden geçersiz oldu?

Teklifin geçerlilik süresini banka belirler ve kısadır. Teklifteki expiresAt zamanı geçtiyse 409 bank_connect.fx.quote_expired alırsınız; yeni teklif alıp hemen işlem açın. → Döviz İşlemi

"Banka bağlantınız yenilendi" bildirimi ne anlama gelir?

Lunixi ekibi, bankanızın daha güncel ya da daha fazla özelliği olan bir bağlantı yoluna geçmesi gerektiğinde bağlantınızı yeniler. Sizin bir şey yapmanız gerekmez. Geçmiş hesap hareketleriniz korunur; son 30 günün hareketleri yeniden yüklenir ve iki kez gelen kayıtlar tek gösterilir. Yenileme sırasında bağlantının yetenekleri (örneğin para transferi) değişebilir; güncel durumu bağlantının capabilities alanından okuyun. → Bağlantılar