Online Banka Hesap Detay

Bir online banka hesabının detayını döner.

Endpoint

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

Parametreler

Parametre	Tip	Açıklama
account_id	string	Kaydı görüntülenmek istenen online banka hesabının ID değeri

Örnekler

cURL

curl -X GET "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/64f1c2e9a1b2c3d4e5f60718" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Channel: YOUR_CHANNEL"

JavaScript

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

// Kullanım
const account = await getOnlineBankAccountDetail("64f1c2e9a1b2c3d4e5f60718");

PHP

function getOnlineBankAccountDetail($accountId) {
    $url = 'https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/online_bank/accounts/' . $accountId;

    $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
$account = getOnlineBankAccountDetail('64f1c2e9a1b2c3d4e5f60718');

Python

import requests

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

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

# Kullanım
account = get_online_bank_account_detail("64f1c2e9a1b2c3d4e5f60718")

C#

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

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

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

    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 account = await GetOnlineBankAccountDetailAsync("64f1c2e9a1b2c3d4e5f60718");

Yanıt

{
  "data": {
    "id": "64f1c2e9a1b2c3d4e5f60718",
    "bank_id": "64e7b3d1c0a9f8e7d6c50421",
    "bank_code": "0064",
    "bank_name": "İş Bankası",
    "branch_name": "Merkez Şube",
    "account_alias": "İşletme Hesabı",
    "account_type": "vadesiz",
    "iban": "TR330006100519786457841326",
    "currency": "TRY",
    "balance": 125430.75
  },
  "message": "Online banka hesabı başarıyla getirildi.",
  "success": true
}

Yanıt Alanları

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

Hesap Alanları (data)

Alan	Tip	Açıklama
id	string	Sağlayıcı hesap kimliği
bank_id	string	Sağlayıcı banka kimliği; banka endpoint'lerinde bank_id olarak kullanılır
bank_code	string	Banka kodu
bank_name	string	Banka adı
branch_name	string | null	Şube adı
account_alias	string	Hesap takma adı
account_type	string	Hesap türü
iban	string	IBAN
currency	string	Para birimi (örn. TRY)
balance	number	Hesap bakiyesi