---
title: "Turkish Airlines TKCONNECT NDC Entegrasyon Rehberi"
description: "TKCONNECT NDC entegrasyonunu access, direct/aggregator topology, offer/order lifecycle, servicing ve source lineage açısından modelleyin."
slug: "turkish-airlines-tkconnect-ndc"
translationKey: "integration-turkish-airlines-tkconnect-ndc"
locale: "tr"
type: "guide"
category: "flight"
tags: ["turkish-airlines","tkconnect","ndc","flight","direct-connect"]
publishedAt: "2026-09-26"
updatedAt: "2026-09-26"
reviewedAt: "2026-09-26"
technicalVerifiedAt: "2026-09-26"
sourceVersion: "Turkish Airlines Developer Portal and TKCONNECT public surfaces reviewed 2026-09-26"
testedAgainst: "Official public documentation; not a provisioned TKCONNECT production account"
codeExampleStatus: "illustrative"
sources:
  - title: "Turkish Airlines Developer Portal"
    url: "https://developer.turkishairlines.com/"
  - title: "IATA NDC"
    url: "https://www.iata.org/en/programs/airline-distribution/retailing/ndc/"
---
TKCONNECT, Turkish Airlines'ın NDC/direct distribution modelini agency UI, aggregator ve direct API seçenekleriyle sunar. Entegrasyon tasarımında “THY flight search API” gibi tek endpoint abstraction yerine **offer/order ownership + servicing capability** esas alınmalıdır.

## Topology

```text
Seller
  -> direct TKCONNECT NDC
  -> aggregator
  -> agency UI
        |
        v
Turkish Airlines offer/order lifecycle
```

Direct API ve aggregator aynı airline supply'a erişebilir ama auth, certification, capability ve servicing davranışı aynı olmak zorunda değildir.

## Canonical boundary

Core model en az şunları ayırmalıdır:

- itinerary,
- offer,
- fare family/brand,
- baggage,
- ancillary,
- provider offer reference,
- order/booking reference,
- ticket/document state,
- servicing capability.

Airline source identity normalize edilirken kaybedilmemelidir.

## Search → Offer → Order

```text
SEARCH
 -> OFFER
 -> SELECT
 -> REVALIDATE if required
 -> ORDER/BOOK
 -> PAYMENT/TICKET
 -> RETRIEVE
 -> CHANGE/CANCEL/SERVICE
```

Search sonucu booking guarantee değildir. Offer expiry ve price/fare conditions booking öncesi tekrar doğrulanmalıdır.

## Idempotency

Order/create timeout'u proven failure değildir:

```text
CREATING -> CONFIRMED
         -> REJECTED
         -> UNKNOWN -> retrieve/reconcile
```

UNKNOWN durumda duplicate create uygulanmamalıdır.

## Observability

- search latency,
- offer count,
- offer expiry,
- revalidation change rate,
- order unknown-state age,
- ticketing success,
- servicing failure,
- reconciliation drift.

## Production checklist

- access/certification path doğrulandı
- direct vs aggregator source explicit
- offer/reference korunuyor
- fare family + baggage normalize ediliyor
- order UNKNOWN recovery var
- servicing capability matrix var
- ticket/document state booking state'ten ayrı