Online Banka Hesap Hareketleri

Bir online banka hesabının hareketlerini listeler.

Endpoint

GET /kolaybi/v1/online_bank/accounts/{account_id}/transactions

Parametreler

Parametre	Tip	Zorunlu	Açıklama
account_id	string	Evet	Hareketleri görüntülenecek online banka hesabının ID'si
start_date	string	Hayır	Başlangıç tarihi (YYYY-MM-DD, varsayılan: bitiş tarihinden 92 gün öncesi)
end_date	string	Hayır	Bitiş tarihi (YYYY-MM-DD). start_date ile arası en fazla 92 gün olabilir
min_amount	number	Hayır	Minimum tutar
max_amount	number	Hayır	Maksimum tutar
receipt_no	string	Hayır	Dekont/işlem numarası ile filtreleme
explanation	string	Hayır	Açıklama içinde arama
direction	string	Hayır	Hareket yönü (in, out, all)
is_mapped	boolean	Hayır	Ofis işlem kaydıyla eşleştirilmiş (true/1) ya da eşleştirilmemiş (false/0) hareketlere göre filtreleme

Örnekler

cURL

# Hesabın tüm hareketleri (varsayılan tarih aralığı)
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/64f1c2e9a1b2c3d4e5f60718/transactions" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Tarih aralığı ile filtreleme
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/64f1c2e9a1b2c3d4e5f60718/transactions?start_date=2026-09-01&end_date=2026-09-09" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

# Eşleştirilmemiş gelen hareketler
curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/64f1c2e9a1b2c3d4e5f60718/transactions?direction=in&is_mapped=false" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getOnlineBankTransactions(accountId, filters = {}) {
  const params = new URLSearchParams(filters);
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/${accountId}/transactions?${params}`,
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel
      }
    }
  );
  return await response.json();
}

// Kullanım
const allTransactions = await getOnlineBankTransactions("64f1c2e9a1b2c3d4e5f60718");
const filtered = await getOnlineBankTransactions("64f1c2e9a1b2c3d4e5f60718", {
  start_date: "2026-09-01",
  end_date: "2026-09-09",
  direction: "in"
});

PHP

function getOnlineBankTransactions($accountId, $filters = []) {
    $url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/{$accountId}/transactions";
    if (!empty($filters)) {
        $url .= '?' . http_build_query($filters);
    }

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => $url,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $accessToken,
            'Channel: ' . $channel
        ],
        CURLOPT_RETURNTRANSFER => true
    ]);

    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

// Kullanım
$allTransactions = getOnlineBankTransactions('64f1c2e9a1b2c3d4e5f60718');
$filtered = getOnlineBankTransactions('64f1c2e9a1b2c3d4e5f60718', [
    'start_date' => '2026-09-01',
    'end_date' => '2026-09-09',
    'direction' => 'in',
]);

Python

import requests

def get_online_bank_transactions(account_id, filters=None):
    url = f"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/{account_id}/transactions"
    headers = {
        "Authorization": f"Bearer {access_token}",
        "Channel": channel
    }

    response = requests.get(url, headers=headers, params=filters)
    return response.json()

# Kullanım
all_transactions = get_online_bank_transactions("64f1c2e9a1b2c3d4e5f60718")
filtered = get_online_bank_transactions("64f1c2e9a1b2c3d4e5f60718", {
    "start_date": "2026-09-01",
    "end_date": "2026-09-09",
    "direction": "in"
})

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;
using Newtonsoft.Json;

async Task<dynamic> GetOnlineBankTransactionsAsync(string accountId, Dictionary<string, string> filters = null)
{
    using var client = new HttpClient();

    var url = $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/{accountId}/transactions";
    if (filters != null && filters.Count > 0)
    {
        var query = await new FormUrlEncodedContent(filters).ReadAsStringAsync();
        url += "?" + query;
    }

    var request = new HttpRequestMessage(HttpMethod.Get, url);
    request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);
    request.Headers.Add("Channel", channel);

    var response = await client.SendAsync(request);
    var content = await response.Content.ReadAsStringAsync();
    return JsonConvert.DeserializeObject<dynamic>(content);
}

// Kullanım
var allTransactions = await GetOnlineBankTransactionsAsync("64f1c2e9a1b2c3d4e5f60718");
var filtered = await GetOnlineBankTransactionsAsync("64f1c2e9a1b2c3d4e5f60718", new Dictionary<string, string>
{
    { "start_date", "2026-09-01" },
    { "end_date", "2026-09-09" },
    { "direction", "in" }
});

Yanıt

Başarılı Yanıt

{
  "data": [
    {
      "id": "66d0a9b1c2d3e4f5a6b70819",
      "direction": "in",
      "receipt_date": "2026-09-05 14:32:10",
      "receipt_no": "2026090500123",
      "explanation": "ABC TICARET LTD STI EFT",
      "opcode": "EFT Gelen",
      "receipt_amount": 15000.5,
      "currency": "TRY",
      "receipt_balance": 140431.25,
      "is_mapped": true
    }
  ],
  "message": "Online banka hareketleri başarıyla listelendi.",
  "success": true
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Hareket kayıtları (data[n])
message	string	Yanıt mesaj kodu
success	boolean	İşlem başarı durumu

Kayıt Alanları (data[n])

Alan	Tip	Açıklama
id	string	Hareket kimliği
direction	string	Hareket yönü (in, out)
receipt_date	string	Hareket tarihi (Europe/Istanbul, YYYY-MM-DD HH:mm:ss)
receipt_no	string	Dekont/işlem numarası
explanation	string	Hareket açıklaması
opcode	string	İşlem kodu etiketi
receipt_amount	number	Hareket tutarı
currency	string	Para birimi (örn. TRY)
receipt_balance	number	Hareket sonrası hesap bakiyesi
is_mapped	boolean	Hareketin bir Ofis işlemiyle eşleştirilip eşleştirilmediği