Banka hareketleri

curl --get https://api.tahsil.dev/banks/transactions \
  --header "x-api-key: $TAHSIL_API_KEY" \
  --header "x-api-secret: $TAHSIL_API_SECRET" \
  --header "x-company-id: 66b0f09a8f10000000000001" \
  --data-urlencode "accountId=66b0f09a8f10000000000101" \
  --data-urlencode "bankCode=aktifbank" \
  --data-urlencode "currency=TRY" \
  --data-urlencode "incoming=true" \
  --data-urlencode "minAmount=40000" \
  --data-urlencode "from=2026-07-01T00:00:00.000Z" \
  --data-urlencode "to=2026-07-15T23:59:59.999Z" \
  --data-urlencode "dateField=transactionDate" \
  --data-urlencode "q=INV-2026-1042" \
  --data-urlencode "includeAssignments=true" \
  --data-urlencode "sortBy=transactionDate" \
  --data-urlencode "direction=desc" \
  --data-urlencode "page=1" \
  --data-urlencode "pageSize=25"

{
  "status": true,
  "result": [
    {
      "id": "66b0f09a8f10000000000501",
      "accountId": "66b0f09a8f10000000000101",
      "subAccountKey": "sub_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "providerStamp": "txn-aktifbank-202607150001",
      "transactionDate": "2026-07-15T10:24:18.000Z",
      "fetchedAt": "2026-07-15T10:25:02.000Z",
      "bankCode": "aktifbank",
      "currency": "TRY",
      "incoming": true,
      "amount": 42750.5,
      "balance": 318420.75,
      "idNo": "1111111111",
      "iban": "TR330006100519786457841326",
      "nameSurname": "Mavi Rota Müşterisi",
      "description": "INV-2026-1042 hizmet bedeli",
      "assignments": []
    }
  ],
  "paginate": {
    "total": 1,
    "size": 25,
    "page": 1,
    "totalPage": 1
  }
}

const transactionId = '66b0f09a8f10000000000501';
const response = await fetch(
  `https://api.tahsil.dev/banks/transactions/${transactionId}`,
  {
    headers: {
      'x-api-key': process.env.TAHSIL_API_KEY,
      'x-api-secret': process.env.TAHSIL_API_SECRET,
      'x-company-id': '66b0f09a8f10000000000001',
    },
  },
);

const payload = await response.json();
if (!response.ok || payload.status !== true) {
  throw new Error(payload.code ?? `HTTP_${response.status}`);
}
console.log(payload.result.providerStamp, payload.result.assignments);

<?php
$transactionId = '66b0f09a8f10000000000501';
$body = [
    'reference' => [
        'source' => 'mavi-rota-erp',
        'entityType' => 'invoice',
        'externalId' => 'INV-2026-1042',
        'label' => 'Temmuz hizmet faturası',
    ],
    'tags' => ['otomatik-tahsilat', 'temmuz-2026'],
];

$curl = curl_init(
    "https://api.tahsil.dev/banks/transactions/$transactionId/assignments"
);
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'x-api-key: ' . getenv('TAHSIL_API_KEY'),
        'x-api-secret: ' . getenv('TAHSIL_API_SECRET'),
        'x-company-id: 66b0f09a8f10000000000001',
        'content-type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($body, JSON_THROW_ON_ERROR),
]);

$responseBody = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
$payload = json_decode($responseBody, true, 512, JSON_THROW_ON_ERROR);

if ($status >= 400 || ($payload['status'] ?? false) !== true) {
    throw new RuntimeException($payload['code'] ?? "HTTP_$status");
}

{
  "status": false,
  "code": "TRANSACTION_AMOUNT_RANGE_INVALID",
  "message": "minAmount, maxAmount değerinden büyük olamaz."
}