Online Banka Hareket Detay

Bir banka hareketinin detayını döner.

Endpoint

GET /kolaybi/v1/online_bank/transactions/{transaction_id}

Parametreler

Parametre	Tip	Açıklama
transaction_id	string	Kaydı görüntülenmek istenen hareketin ID değeri

Örnekler

cURL

curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/transactions/66d0a9b1c2d3e4f5a6b70819" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

async function getOnlineBankTransactionDetail(transactionId) {
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/transactions/${transactionId}`,
    {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel
      }
    }
  );
  return await response.json();
}

// Kullanım
const transaction = await getOnlineBankTransactionDetail("66d0a9b1c2d3e4f5a6b70819");

PHP

function getOnlineBankTransactionDetail($transactionId) {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/transactions/' . $transactionId;

    $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
$transaction = getOnlineBankTransactionDetail('66d0a9b1c2d3e4f5a6b70819');

Python

import requests

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

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

# Kullanım
transaction = get_online_bank_transaction_detail("66d0a9b1c2d3e4f5a6b70819")

C#

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

async Task<dynamic> GetOnlineBankTransactionDetailAsync(string transactionId)
{
    using var client = new HttpClient();

    var request = new HttpRequestMessage(HttpMethod.Get,
        $"https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/transactions/{transactionId}");

    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 transaction = await GetOnlineBankTransactionDetailAsync("66d0a9b1c2d3e4f5a6b70819");

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,
    "receipt_status": {
      "code": "APPROVED",
      "label": "Approved"
    },
    "bank": {
      "id": "64e7b3d1c0a9f8e7d6c50421",
      "code": "0064"
    },
    "bank_account": {
      "iban": "TR330006100519786457841326",
      "currency": "TRY"
    },
    "correspondent_tax_number": "1234567890",
    "correspondent_iban": "TR120006701000000012345678",
    "mapped_transaction_id": 90312
  },
  "message": "Online banka hareketi başarıyla getirildi.",
  "success": true
}

Yanıt Alanları

Alan	Tip	Açıklama
data	object	Hareket bilgisi
message	string	Yanıt mesaj kodu
success	boolean	İşlem başarı durumu

Hareket Alanları (data)

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
receipt_status	object	Hareket durumu (code, label)
bank	object	Hareketin ait olduğu banka (id, code)
bank_account	object	Hareketin ait olduğu hesap (iban, currency)
correspondent_tax_number	string | null	Karşı tarafın VKN/TCKN'si
correspondent_iban	string | null	Karşı tarafın IBAN'ı
mapped_transaction_id	integer | null	Eşleştirme sonucu oluşan Ofis işlem kaydının ID'si; Hareket Eşleştirme endpoint'i ile atanır, eşleştirilmemişse null