Cari Hareket Listeleme

Belirtilen cariye ait hesap hareketlerini listeler.

Endpoint

GET /kolaybi/v1/associates/{associate_id}/transactions

Parametreler

Parametre	Tip	Zorunlu	Açıklama
associate_id	integer	Evet	Hareketleri görüntülenecek cari ID'si

Örnekler

cURL

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

JavaScript

async function getAssociateTransactions(associateId) {
  const response = await fetch(
    `https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/associates/${associateId}/transactions`,
    {
      method: "GET",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        Channel: channel,
      },
    }
  );

  return await response.json();
}

// Kullanım
const transactions = await getAssociateTransactions(1);

PHP

function getAssociateTransactions($associateId) {
    $url = "https://ofis-sandbox-api.kolaybi.com/kolaybi/v1/associates/{$associateId}/transactions";

    $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
$transactions = getAssociateTransactions(1);

Python

import requests

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

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

# Kullanım
transactions = get_associate_transactions(1)

C#

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

async Task<dynamic> GetAssociateTransactionsAsync(int associateId)
{
    using var client = new HttpClient();

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

    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 transactions = await GetAssociateTransactionsAsync(1);

Yanıt

Başarılı Yanıt

{
  "data": [
    {
      "id": 1,
      "type": "invoice",
      "document_id": 123,
      "amount": 1000.0,
      "currency": "TRY",
      "description": "Fatura No: INV-001",
      "date": "2024-01-15T10:30:00Z",
      "balance": 1000.0
    },
    {
      "id": 2,
      "type": "payment",
      "document_id": 456,
      "amount": -500.0,
      "currency": "TRY",
      "description": "Ödeme",
      "date": "2024-01-16T14:20:00Z",
      "balance": 500.0
    }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
id	integer	Hareket ID
type	string	İşlem türü
document_id	integer	İlgili belge ID'si
amount	number	İşlem tutarı
currency	string	Para birimi
description	string	İşlem açıklaması
date	string	İşlem tarihi (ISO 8601)
balance	number	Güncel bakiye