Bankalar

Bu uçları kim çağırır?Dış API (s2s)

Taban yol: /api/v1/bank-connect
Kimlik: Her istekte Ed25519 istek imzası — X-Key-Id, X-Date, X-Nonce, X-Signature. Zaman penceresi ±5 dk, nonce tek kullanımlık. Bearer jetonu ya da panel oturumu bu uçlarda kabul edilmez (401 AUTH_HEADERS_MISSING).
Yetki: Anahtarınız Banka Bağlantıları ürününü (BANK_CONNECT) ve bu sayfadaki uçların yetkisini taşımalıdır: bank-connect:view. Ürünü olmayan anahtar 403 PRODUCT_NOT_ENABLED, yetkisi olmayan anahtar 403 API_INSUFFICIENT_SCOPE alır. Bkz. API'ye Giriş › Yetkiler.
Çapraz yüzey: Bu uçlar s2s yüzeyindedir; kendi sunucunuzdan imzalı istekle çağırırsınız. Aynı verinin panelde ekranları var, ama panel uçları API anahtarıyla çağrılamaz; bu uçlar da panel oturumuyla çağrılamaz. Bankayı bağlama ve kesme yalnız panelde yapılır.

GET /api/v1/bank-connect/banks katalogdaki bankaları ve her bankanın anahtarınızın ortamında bağlanabilir olup olmadığını döner. Bağlantıyı bu listeye bakarak panelden başlatırsınız; hangi bankalara zaten bağlı olduğunuzu Bağlantılar ucu gösterir.

İstek

Sorgu parametresi	Tip	Açıklama
`limit`	integer	Sayfa başına kayıt, 1–100. Varsayılan 25.
`cursor`	string	Önceki yanıttaki `pageInfo.nextCursor`.

source lunixi-sign.sh
REQ_PATH="/api/v1/bank-connect/banks?limit=50"
lunixi_sign GET "$REQ_PATH"
 
curl "https://api-gateway.lunixi.com$REQ_PATH" \
  -H "X-Key-Id: $LUNIXI_KEY_ID" \
  -H "X-Date: $DATE" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

PHP örneğindeki $bankConnect: API'ye Giriş › PHP SDK.

İmzalama yardımcısı: API'ye Giriş › Kimlik doğrulama.

Yanıt

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "bankId": "00000000-0000-0000-0000-000000000001",
        "eftCode": "0000",
        "name": "ÖRNEK BANKA",
        "country": "TR",
        "availability": "AVAILABLE",
        "capabilities": ["ACCOUNT_LIST", "BALANCE", "TRANSACTIONS"]
      },
      {
        "bankId": "00000000-0000-0000-0000-000000000002",
        "eftCode": "0001",
        "name": "ÖRNEK KATILIM BANKASI",
        "country": "TR",
        "availability": "COMING_SOON",
        "capabilities": []
      }
    ]
  },
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": null },
  "statusCode": 200,
  "requestId": "00000000-0000-0000-0000-000000000000"
}

Alan	Tip	Açıklama
`bankId`	string (UUID)	Bankanın kimliği; diğer uçlarda `bankId` süzgeci bu değeri alır.
`eftCode`	string	Bankanın EFT kodu.
`name`	string	Bankanın adı.
`shortName`	string	Kısa ad. Değer yoksa alan yoktur.
`bic`	string	BIC (SWIFT) kodu. Değer yoksa alan yoktur.
`country`	string	Ülke kodu (ISO 3166-1 alpha-2). Değer yoksa alan yoktur.
`availability`	string	Bu ortamda bağlanabilir mi; aşağıdaki tabloya bakın.
`capabilities`	string[]	Bu bankanın bağlantısında kullanılabilen veri türleri ve işlemler; aşağıdaki tabloya bakın.

`availability`

Değer	Anlamı
`AVAILABLE`	Bu bankayı anahtarınızın ortamında Lunixi ile bağlayabilirsiniz. Bağlantıyı panelden başlatırsınız.
`COMING_SOON`	Bu ortamda bu banka için henüz bağlantı desteği yok. `capabilities` boş döner.

`capabilities`

Değer	Anlamı
`ACCOUNT_LIST`	Hesap listesi okunur.
`BALANCE`	Bakiye okunur.
`TRANSACTIONS`	Hesap hareketleri okunur.
`OUTGOING_TRANSFER`	Bağlı hesaplardan para transferi yapılabilir. → Para Transferi
`FX_EXCHANGE`	Aynı bankadaki hesaplar arasında döviz işlemi yapılabilir. → Döviz İşlemi

Kendi bağlantınızda hangi işlemlerin açık olduğunu bağlantının capabilities alanından okuyun. → Bağlantılar

Bağlanabilen bankalar

Canlı ortamda aşağıdaki 30 bankayı Lunixi ile bağlayabilirsiniz. Liste zamanla genişler; güncel durumu her zaman bu uçtan, availability alanından okuyun. Listede olmayan bir banka COMING_SOON döner.

Banka	EFT kodu
Akbank	`0046`
Aktif Bank	`0143`
Albaraka Türk	`0203`
Alternatif Bank	`0124`
Anadolubank	`0135`
Burgan Bank	`0125`
DenizBank	`0134`
Dünya Katılım	`0214`
Emlak Katılım	`0211`
Enpara Bank	`0157`
Fibabanka	`0103`
Garanti BBVA	`0062`
Halkbank	`0012`
Hayat Finans Katılım	`0212`
ING Bank	`0099`
İstanbul Takas ve Saklama Bankası	`0132`
Kuveyt Türk	`0205`
Misyon Yatırım Bankası	`0153`
Odeabank	`0146`
QNB Finansbank	`0111`
Şekerbank	`0059`
TEB	`0032`
Türk Ticaret Bankası	`0060`
Türkiye Finans	`0206`
Türkiye İş Bankası	`0064`
Vakıf Katılım	`0210`
VakıfBank	`0015`
Yapı Kredi	`0067`
Ziraat Bankası	`0010`
Ziraat Katılım	`0209`

Test ortamındaki simülatör bankalar için Test Ortamı sayfasına bakın.

Hatalar

HTTP	`code`	Ne yapmalı
`400`	`VALIDATION_ERROR`	`limit` 1–100 dışında ya da tanımlanmamış bir parametre gönderdiniz.
`400`	`bank_connect.cursor.invalid`	İmleci değiştirmeden gönderin ya da ilk sayfadan başlayın.

API'ye Giriş Bağlantılar