---
title: "Taksit Sorgulama"
method: POST
path: "/payment/iyzipos/installment"
tags: ["Installment"]
---

# Taksit Sorgulama

`POST /payment/iyzipos/installment`

API, taksit sayısı, oranları ve tutarlarının yanı sıra; kartın bankası, kart ailesi ve kart şeması gibi özelliklerini sağlar. Belirtilen BIN ve tutar bilgisine göre uygun taksit seçeneklerini listeler. Ayrıca yalnızca BIN veya yalnızca tutar bilgisiyle de taksit oranları sorgulanabilir.

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- InstallmentRequest
  - `locale` 'tr' | 'en' — İstek ve dönüş mesajlarında kullanılacak dil bilgisi.
  - `price` number, required — Taksit hesaplaması yapılacak tutar.
  - `binNumber` string — 8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir.
  - `conversationId` string — İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

## Response `200`

Başarılı yanıt

- InstallmentResponse
  - `status` 'success' | 'failure' — Yapılan isteğin sonucu.
  - `locale` string — Yanıt dili.
  - `systemTime` integer — İşlem zamanı (epoch ms).
  - `conversationId` string — İstek ile eşleşen ID.
  - `installmentDetails` InstallmentDetail[] — BIN ve tutara göre hesaplanan taksit seçenekleri.
    - `binNumber` string — Hesaplamada kullanılan BIN.
    - `price` number — Hesaplama yapılan tutar.
    - `cardType` 'CREDIT_CARD' | 'DEBIT_CARD' | 'PREPAID_CARD' — Kart tipi.
    - `cardAssociation` 'VISA' | 'MASTER_CARD' | 'AMERICAN_EXPRESS' | 'TROY' — Kart kuruluşu.
    - `cardFamilyName` 'Bonus' | 'Axess' | 'World' | 'Maximum' | 'Paraf' | 'CardFinans' | 'Advantage' — Kart ailesi.
    - `force3ds` 0 | 1 — 3DS zorunluluğu (0; Hayır, 1; Evet).
    - `bankCode` integer — Banka kodu.
    - `bankName` string — Banka adı.
    - `forceCvc` 0 | 1 — CVC zorunluluğu (0; Hayır, 1; Evet).
    - `commercial` 0 | 1 — Ticari kart bilgisi (0; Bireysel, 1; Ticari).
    - `dccEnabled` 0 | 1 — DCC (Dynamic Currency Conversion) desteği (0; Hayır, 1; Evet).
    - `agricultureEnabled` 0 | 1 — Tarım kart bilgisi (0; Hayır, 1; Evet).
    - `installmentPrices` InstallmentPrice[] — Taksit seçenekleri ve fiyatları.
      - `installmentPrice` number — Her bir taksit tutarı.
      - `totalPrice` number — Taksitli toplam tutar.
      - `installmentNumber` integer — Taksit sayısı.

## Other responses

- `400` — Başarısız yanıt

---

[API](https://skmtc.net/iyzico/apis/bin-and-installment.md) · [All operations](https://skmtc.net/iyzico/apis/bin-and-installment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iyzico/bin-and-installment/versions/46976ce5eed9/schema)