Banka hesapları

Banka hesapları kaynağı, şirketin gerçek banka hesaplarını (bank=true; kasa/pos/kredi hesapları hariç) bakiye ve son sorgu bilgisiyle sunar.

`GET /v1/bank-accounts` — hesap listesi

Örnek istek

curl 'https://api.sarraf.pro/v1/bank-accounts?pageSize=25' \
  -u 'apiUserId:secretKey'

Sorgu parametreleri

Ortak parametreler için Genel Bakış.

Parametre	Tür	Açıklama
`archived`	boolean	Verilmezse yalnız arşivsiz hesaplar döner
`currency`	string	Para birimi (büyük harfe normalize edilir)
`bankCode`	string	Banka kodu
`isApi`	boolean	`true`: yalnız banka entegrasyonu bağlı hesaplar
`q`	string	Hesap adında arama
`updatedSince`	date-time	Yalnız bu tarihte/sonra güncellenen hesaplar (`updatedAt >=`)

Sıralama whitelist’i: createdDate, name, balance, updatedAt. Varsayılan createdDate:asc.

updatedAt bakiye/banka senkronu güncellemelerinde de ilerler; incremental senkronizasyonda updatedSince + sort=updatedAt:asc kullanın. Bakiyenin son sorgu zamanını ayrıca lastCheckAt alanı verir.

Cevap alanları (liste öğesi)

Alan	Anlam
`id`	Hesap kimliği
`name`, `bankName`, `bankCode`, `code`	Hesap ve banka tanımları
`iban`, `currency`	IBAN ve para birimi
`type`	`cash`, `bank`, `pos`, `credit` (bu kaynakta her zaman `bank` ağırlıklı)
`default`	Varsayılan hesap mı
`isApi`	Banka entegrasyonu bağlı mı
`isDemo`	Demo hesap mı
`limit`	Sorgulama limiti
`balance`	Güncel bakiye (son sorgudaki)
`lastCheckAt`	Son banka sorgusu zamanı
`lastTransactionAt`	Son çekilen hareketin zamanı
`lastCheckStatus` / `lastCheckMessage`	Son sorgunun başarı durumu ve banka cevabı
`lastCheckSize`	Son sorguda çekilen hareket sayısı
`updatedAt`	Son güncelleme zamanı (bakiye/senkron güncellemesi de ilerletir)

Cevap — `200`

{
  "success": true,
  "data": [
    {
      "id": "6a5f1bb8e2883761a7c61301",
      "name": "TİCARİ HESAP",
      "bankName": "ÖRNEK BANKASI",
      "bankCode": "0012",
      "iban": "TR000000000000000000000000",
      "currency": "TRY",
      "type": "bank",
      "default": true,
      "isApi": true,
      "isDemo": false,
      "balance": 1284530.44,
      "lastCheckAt": "2026-09-20T08:45:00.000Z",
      "lastTransactionAt": "2026-09-20T08:31:00.000Z",
      "lastCheckStatus": true,
      "createdDate": "2025-02-04T09:00:00.000Z",
      "updatedAt": "2026-09-20T08:45:00.000Z"
    }
  ],
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z",
    "page": 1,
    "limit": 25,
    "total": 114,
    "pages": 5
  }
}

`GET /v1/bank-accounts/{id}` — hesap detayı

Liste alanlarına ek olarak:

Alan	Anlam
`subAccounts`	Alt hesaplar (kendi bakiye bilgileriyle)
`expiryDay`	POS ise bloke, kredi ise son ödeme günü
`commission`	POS komisyon tutarı
`archived`	Arşiv durumu

Banka entegrasyon kimlik bilgileri (integrationsData) ve iç kilit alanları hiçbir uçta dönmez.

Bakiyeleri tazelemek için Banka sorgusu tetikleme ucunu kullanın; ardından hesap listesini yeniden okuyun.

archived: true olan bir hesaba bağlı geçmiş hareketleri salt-okunur uçlardan görebilirsiniz. Ancak bu hareketleri source: "bankTransaction" ile fatura veya gider pusulası kaynağı olarak kullanamazsınız. Hesap yeniden aktifleştirildiğinde işlenmemiş hareketler tekrar kullanılabilir.

Örnek istek

curl 'https://api.sarraf.pro/v1/bank-accounts/6a5f1bb8e2883761a7c61301' \
  -u 'apiUserId:secretKey'

Cevap — `200`

{
  "success": true,
  "data": {
    "id": "6a5f1bb8e2883761a7c61301",
    "name": "TİCARİ HESAP",
    "bankName": "ÖRNEK BANKASI",
    "bankCode": "0012",
    "iban": "TR000000000000000000000000",
    "currency": "TRY",
    "balance": 1284530.44,
    "lastCheckAt": "2026-09-20T08:45:00.000Z",
    "lastCheckStatus": true,
    "subAccounts": [],
    "expiryDay": 0,
    "commission": 0,
    "archived": false,
    "updatedAt": "2026-09-20T08:45:00.000Z"
  },
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z"
  }
}

Başlangıç

API'ye Giriş

Müşteriler

Banka

Faturalar

Giderler

KMTS

`GET /v1/bank-accounts` — hesap listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/bank-accounts/{id}` — hesap detayı

Örnek istek

Cevap — `200`

​GET /v1/bank-accounts — hesap listesi

​Örnek istek

​Sorgu parametreleri

​Cevap alanları (liste öğesi)

​Cevap — 200

​GET /v1/bank-accounts/{id} — hesap detayı

​Örnek istek

​Cevap — 200

`GET /v1/bank-accounts` — hesap listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/bank-accounts/{id}` — hesap detayı

Örnek istek

Cevap — `200`