Hareketler

Hareket, hesap ekstresindeki tek satırdır. Bu uçlar bağlı hesaplarınızın hareketlerini döner. Hareket yönü ve tipleri: Kavramlar › Hareket yönü ve tipi.

Hareketleri listeleme

GET /api/v1/bank-connect/transactions

Tarih aralığı kuralları

• bookedFrom ve bookedTo arası tek istekte en çok 92 gün olabilir.
• Yalnız bookedFrom gönderirseniz üst sınır istek anıdır; aralık yine en çok 92 gündür.
• Yalnız bookedTo gönderilemez; bookedFrom da gerekir.
• İkisini de göndermezseniz tarih süzgeci uygulanmaz ve bütün hareketler sayfalanır.

Bu kurallara uymayan istek 400 bank_connect.validation.invalid döner; sebep details.errors[].reason alanındadır:

Süzgeç örnekleri

Açıklama metninde arama yapan bir süzgeç yoktur; tanımlanmamış her parametre 400 VALIDATION_ERROR döner.

source lunixi-sign.sh
REQ_PATH="/api/v1/bank-connect/transactions?direction=CREDIT&canonicalType=TRANSFER_IN&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.

Sıralama

Hareketler kayda alınma anına (receivedAt) göre en yeniden eskiye sıralanır. receivedAt, hareketin bankadan okunup Lunixi'de kaydedildiği andır ve sonradan değişmez. İşlem tarihi (bookedAt) yalnız süzgeçtir, sıralama anahtarı değildir.

Bu yüzden banka bir hareketi geç bildirirse, işlem tarihi eski olsa da listenin başında görünür.

Yanıt

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "items": [
      {
        "transactionId": "00000000-0000-0000-0000-000000001000",
        "accountId": "00000000-0000-0000-0000-000000000100",
        "direction": "CREDIT",
        "amountMinor": 150000,
        "currency": "TRY",
        "bookedAt": "2026-01-01T07:00:00.000Z",
        "canonicalType": "TRANSFER_IN",
        "description": "ORNEK ACIKLAMA",
        "counterpartyNameMasked": "Ö**** A****",
        "counterpartyIbanMasked": "TR00 **** **** **** **** **00 00",
        "receivedAt": "2026-01-01T07:05:00.000Z"
      }
    ]
  },
  "pageInfo": { "hasMore": true, "nextCursor": "eyJ0IjoiMjAyNi0wMS0wMVQwNzowNTowMFoifQ", "totalCount": null },
  "statusCode": 200,
  "requestId": "00000000-0000-0000-0000-000000000000"
}

Tek hareket

GET /api/v1/bank-connect/transactions/{transactionId} tek bir hareketi döner. Liste alanlarına ek olarak hareketten sonraki bakiyeyi, belge numarasını ve bankayı içerir. Bilinmeyen, başka bir organizasyona ya da diğer ortama ait hareket 404 bank_connect.transaction.not_found döner.

{
  "status": "success",
  "code": "SUCCESS",
  "data": {
    "transactionId": "00000000-0000-0000-0000-000000001000",
    "accountId": "00000000-0000-0000-0000-000000000100",
    "direction": "CREDIT",
    "amountMinor": 150000,
    "currency": "TRY",
    "bookedAt": "2026-01-01T07:00:00.000Z",
    "canonicalType": "TRANSFER_IN",
    "description": "ORNEK ACIKLAMA",
    "counterpartyNameMasked": "Ö**** A****",
    "counterpartyIbanMasked": "TR00 **** **** **** **** **00 00",
    "receivedAt": "2026-01-01T07:05:00.000Z",
    "counterpartyBankCode": "0000",
    "counterpartyBankName": "ÖRNEK BANKA",
    "balanceAfterMinor": 990000,
    "documentNo": "0000000",
    "bank": { "bankId": "00000000-0000-0000-0000-000000000001", "eftCode": "0000", "name": "ÖRNEK BANKA" }
  },
  "statusCode": 200,
  "requestId": "00000000-0000-0000-0000-000000000000"
}

Hareket nesnesi

Hareketleri senkron tutma

Yeni hareketleri öğrenmenin birincil yolu webhook olayıdır. Liste ucu, webhook'u kaçırdığınız ya da ilk kez veri çektiğiniz durumlar için güvenilir kaynaktır. İkisini birlikte şöyle kullanın:

1. İlk yükleme. Süzgeçsiz (ya da yalnız accountId ile) ilk sayfayı isteyin ve pageInfo.hasMore false olana kadar nextCursor ile sayfalayın. Her hareketi transactionId ile kaydedin ve gördüğünüz en yeni receivedAt değerini saklayın.
2. Düzenli tamamlama. Belirli aralıklarla aynı süzgeçlerle ilk sayfadan (imleçsiz) başlayın. Liste en yeniden eskiye sıralı olduğundan, sakladığınız en yeni receivedAt değerinin gerisine düşene kadar sayfalayın ve sonra durun.
3. Tekilleştirin. Durma noktasını sakladığınız receivedAt değerinin biraz gerisine koyun ve gelen her hareketi transactionId ile tekilleştirin; aynı hareketi webhook'tan ve listeden iki kez almak böylece sorun olmaz.

Süzgeçleri değiştirdiğinizde imleci sıfırlayıp ilk sayfadan başlayın.

Hatalar