Bakiyeler

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:transactions: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/balances her hesabın en son okunan bakiyesini döner. Geçmiş bakiyeler bu uçtan dönmez; bir hareketten sonraki bakiye için hareket detayındaki balanceAfterMinor alanına bakın.

Liste yalnız ACTIVE durumdaki ve en az bir kez bakiyesi okunmuş hesapları içerir.

İstek

Sorgu parametresi	Tip	Açıklama
`accountId`	string	Virgülle ayrılmış hesap kimlikleri (UUID), en çok 100. Verilmezse anahtarınızın ortamındaki bütün aktif hesaplar döner.
`currency`	string	ISO 4217 para birimi, ör. `TRY`.
`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/balances?currency=TRY"
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.

Yanıt

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "accountId": "00000000-0000-0000-0000-000000000100",
        "currency": "TRY",
        "balanceMinor": 1250000,
        "availableMinor": 1200000,
        "blockedMinor": 50000,
        "asOf": "2026-01-01T07:05:00.000Z",
        "availableWithoutOverdraftMinor": 1000000,
        "overdraftAvailableMinor": 200000
      }
    ]
  },
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": null },
  "statusCode": 200,
  "requestId": "00000000-0000-0000-0000-000000000000"
}

Alan	Tip	Açıklama
`accountId`	string (UUID)	Hesabın kimliği.
`currency`	string	Bakiyenin para birimi (ISO 4217).
`balanceMinor`	integer	Bakiye, minor birimde (kuruş). Eksi olabilir.
`availableMinor`	integer	Kullanılabilir bakiye. Banka bildirmiyorsa alan yoktur.
`blockedMinor`	integer	Bloke tutar. Banka bildirmiyorsa alan yoktur.
`asOf`	string	Bakiyenin geçerli olduğu an. Değer yoksa alan yoktur.
`availableWithoutOverdraftMinor`	integer	Kredili mevduat hesabı (KMH) limiti hariç kullanılabilir bakiye. Banka ayrı bildirmiyorsa alan yoktur.
`overdraftAvailableMinor`	integer	Kullanılabilir KMH limiti. Banka bildirmiyorsa alan yoktur.

availableMinor, blockedMinor, availableWithoutOverdraftMinor ve overdraftAvailableMinor her bankada gelmez. Alan yoksa değeri sıfır saymayın; bankanın bu bilgiyi bildirmediği anlamına gelir.

Bakiye, hesabın okunduğu son anki değerdir. Ne zaman okunduğunu hesabın freshness nesnesinden görebilirsiniz.

Hatalar

HTTP	`code`	Ne yapmalı
`400`	`VALIDATION_ERROR`	`accountId` UUID değil ya da 100'den fazla, `currency` 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.
`403`	`API_INSUFFICIENT_SCOPE`	Anahtarınıza `bank-connect:transactions:view` yetkisini ekleyin; `bank-connect:view` yetmez.

Hesaplar Hareketler