Bağlantılar

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.

Bağlantı, sizin bir bankayla kurduğunuz okuma bağlantısıdır. Bağlantıyı panelden kurarsınız; bu uçlar bağlantılarınızın durumunu okur. Durumların anlamı: Kavramlar › Bağlantı durumları.

Bağlantıları listeleme

GET /api/v1/bank-connect/connections

Sorgu parametresi	Tip	Açıklama
`status`	string	Virgülle ayrılmış durumlar, ör. `ACTIVE,DEGRADED`. Değerler: `PENDING_DOCUMENTS`, `UNDER_REVIEW`, `PENDING_SETUP`, `ACTIVE`, `DEGRADED`, `SUSPENDED`, `DISCONNECTED`.
`bankId`	string (UUID)	Yalnız bu bankanın bağlantıları.
`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/connections?status=ACTIVE,DEGRADED"
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.

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "connectionId": "00000000-0000-0000-0000-000000000010",
        "bank": { "bankId": "00000000-0000-0000-0000-000000000001", "eftCode": "0000", "name": "ÖRNEK BANKA" },
        "status": "ACTIVE",
        "statusReasonCode": "activated",
        "createdAt": "2026-01-01T06:00:00.000Z",
        "activatedAt": "2026-01-01T07:00:00.000Z",
        "lastSuccessfulSyncAt": "2026-01-01T07:05:00.000Z",
        "accountCount": 1,
        "capabilities": ["ACCOUNT_LIST", "BALANCE", "TRANSACTIONS"]
      }
    ]
  },
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": null },
  "statusCode": 200,
  "requestId": "00000000-0000-0000-0000-000000000000"
}

Tek bağlantı

GET /api/v1/bank-connect/connections/{connectionId} tek bir bağlantıyı döner. data bağlantı nesnesinin kendisidir; alanlar listeyle aynıdır. Bilinmeyen, başka bir organizasyona ya da diğer ortama ait bağlantı 404 bank_connect.connection.not_found döner.

Bağlantı nesnesi

Alan	Tip	Açıklama
`connectionId`	string (UUID)	Bağlantının kimliği.
`bank`	object	`bankId`, `eftCode` ve varsa `name`.
`status`	string	Bağlantının durumu. → Bağlantı durumları
`statusReasonCode`	string	Durumun gerekçesi; aşağıdaki tabloya bakın. Değer yoksa alan yoktur.
`createdAt`	string	Bağlantının (başvurunun) oluşturulma zamanı.
`activatedAt`	string	Bağlantının aktif olduğu zaman. Henüz aktif olmadıysa alan yoktur.
`lastSuccessfulSyncAt`	string	Bu bağlantıda bankadan en son başarılı okumanın zamanı. Henüz okuma yoksa alan yoktur.
`accountCount`	integer	Bağlantı altında bulunan hesap sayısı.
`capabilities`	string[]	Bu bağlantıda kullanılabilen işlemler. `OUTGOING_TRANSFER` varsa para transferi, `FX_EXCHANGE` varsa döviz işlemi yapılabilir. Değerler: Bankalar › capabilities.

Durum gerekçe kodları

statusReasonCode kısa ve sabit bir koddur; ekranda göstereceğiniz metni bu koda göre kendiniz seçin. Yeni kodlar eklenebilir; tanımadığınız bir kodu hata saymayın, yalnız status alanına göre davranın.

Kod	Anlamı
`documents_required`	Başvuru belgeleri bekleniyor.
`documents_submitted`	Belgeleriniz Lunixi tarafından inceleniyor.
`document_rejected`	Bir belge reddedildi; gerekçeyi panelde inceleyip belgeyi yeniden iletin.
`application_approved`	Başvurunuz onaylandı; kurulum yapılıyor.
`manual_setup_required`	Kurulum Lunixi tarafından tamamlanıyor.
`credential_required`	Kurulum için gereken bağlantı bilgileri bekleniyor.
`action_required`	Kurulumun tamamlanması için ek işlem gerekiyor; panelde bağlantı ayrıntısına bakın.
`activated`	Bağlantı etkin.
`setup_failed`	Kurulum tamamlanamadı.
`sync_failures_threshold`	Son okumalar art arda başarısız oldu (bağlantı `DEGRADED`).
`sync_recovered`	Okumalar yeniden başarılı.
`credential_invalid`	Bağlantı bilgileri geçersiz; panelde güncellenmesi gerekiyor.
`disconnected_by_owner`	Bağlantıyı siz kestiniz.
`disconnected_by_operator`	Bağlantı Lunixi tarafından kesildi.

Hatalar

HTTP	`code`	Ne yapmalı
`400`	`VALIDATION_ERROR`	`status` ya da `bankId` geçersiz, `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.
`404`	`bank_connect.connection.not_found`	Kimliği ve anahtarınızın ortamını kontrol edin.

Bankalar Hesaplar