# Taksit ve BIN Sorgulama iyzico, BIN ve taksit sorgulama işlemleri için uygun bir yol sunar. ## Taksit Sorgulama > 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. ```json {"openapi":"3.0.3","info":{"title":"BIN ve Taksit Sorgulama","version":"1.0.0"},"servers":[{"url":"https://sandbox-api.iyzipay.com"}],"paths":{"/payment/iyzipos/installment":{"post":{"summary":"Taksit Sorgulama","description":"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.","tags":["Installment"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstallmentRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstallmentResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"Content-Type değeri.","schema":{"type":"string"}}},"schemas":{"InstallmentRequest":{"type":"object","required":["price"],"properties":{"locale":{"type":"string","description":"İstek ve dönüş mesajlarında kullanılacak dil bilgisi.","enum":["tr","en"]},"price":{"type":"number","format":"decimal","description":"Taksit hesaplaması yapılacak tutar."},"binNumber":{"type":"string","description":"8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner."}}},"InstallmentResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucu.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."},"installmentDetails":{"type":"array","description":"BIN ve tutara göre hesaplanan taksit seçenekleri.","items":{"$ref":"#/components/schemas/InstallmentDetail"}}}},"InstallmentDetail":{"type":"object","properties":{"binNumber":{"type":"string","description":"Hesaplamada kullanılan BIN."},"price":{"type":"number","format":"decimal","description":"Hesaplama yapılan tutar."},"cardType":{"type":"string","description":"Kart tipi.","enum":["CREDIT_CARD","DEBIT_CARD","PREPAID_CARD"]},"cardAssociation":{"type":"string","description":"Kart kuruluşu.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS","TROY"]},"cardFamilyName":{"type":"string","enum":["Bonus","Axess","World","Maximum","Paraf","CardFinans","Advantage"],"description":"Kart ailesi."},"force3ds":{"type":"integer","description":"3DS zorunluluğu (0; Hayır, 1; Evet).","enum":[0,1]},"bankCode":{"type":"integer","description":"Banka kodu."},"bankName":{"type":"string","description":"Banka adı."},"forceCvc":{"type":"integer","description":"CVC zorunluluğu (0; Hayır, 1; Evet).","enum":[0,1]},"commercial":{"type":"integer","description":"Ticari kart bilgisi (0; Bireysel, 1; Ticari).","enum":[0,1]},"dccEnabled":{"type":"integer","description":"DCC (Dynamic Currency Conversion) desteği (0; Hayır, 1; Evet).","enum":[0,1]},"agricultureEnabled":{"type":"integer","description":"Tarım kart bilgisi (0; Hayır, 1; Evet).","enum":[0,1]},"installmentPrices":{"type":"array","description":"Taksit seçenekleri ve fiyatları.","items":{"$ref":"#/components/schemas/InstallmentPrice"}}}},"InstallmentPrice":{"type":"object","properties":{"installmentPrice":{"type":"number","format":"decimal","description":"Her bir taksit tutarı."},"totalPrice":{"type":"number","format":"decimal","description":"Taksitli toplam tutar."},"installmentNumber":{"type":"integer","description":"Taksit sayısı."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}}}}} ``` #### Örnek Kodlar
PHP
Java
.Net
Node.Js
Python
Postman
## BIN Sorgulama > BIN sorgulamada kartın bankası, kart ailesi, kart şeması gibi kart özelliklerini sağlar. İstenen bilgileri elde etmek için, talebinize gerekli parametreleri eklemeniz yeterlidir. API, kapsamlı ayrıntılarla yanıt verecektir. ```json {"openapi":"3.0.3","info":{"title":"BIN ve Taksit Sorgulama","version":"1.0.0"},"servers":[{"url":"https://sandbox-api.iyzipay.com"}],"paths":{"/payment/bin/check":{"post":{"summary":"BIN Sorgulama","description":"BIN sorgulamada kartın bankası, kart ailesi, kart şeması gibi kart özelliklerini sağlar. İstenen bilgileri elde etmek için, talebinize gerekli parametreleri eklemeniz yeterlidir. API, kapsamlı ayrıntılarla yanıt verecektir.","tags":["BIN"],"parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BINCheckRequest"}}}},"responses":{"200":{"description":"Başarılı yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BINCheckResponse"}}}},"400":{"description":"Başarısız yanıt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"Content-Type değeri.","schema":{"type":"string"}}},"schemas":{"BINCheckRequest":{"type":"object","required":["binNumber"],"properties":{"locale":{"type":"string","description":"İstek ve dönüş mesajlarında kullanılacak dil bilgisi.","enum":["tr","en"]},"binNumber":{"type":"string","description":"Sorgulanacak BIN (8 hane)."},"conversationId":{"type":"string","description":"İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner."}}},"BINCheckResponse":{"type":"object","properties":{"binNumber":{"type":"string","description":"Sorgulanan BIN."},"cardType":{"type":"string","description":"Kart tipi.","enum":["CREDIT_CARD","DEBIT_CARD","PREPAID_CARD"]},"cardAssociation":{"type":"string","description":"Kart kuruluşu.","enum":["VISA","MASTER_CARD","AMERICAN_EXPRESS","TROY"]},"cardFamily":{"type":"string","description":"Kart ailesi.","enum":["Bonus","Axess","World","Maximum","Paraf","CardFinans","Advantage"]},"bankName":{"type":"string","description":"Banka adı."},"bankCode":{"type":"integer","description":"Banka kodu."},"commercial":{"type":"integer","description":"Ticari kart bilgisi (0; Bireysel, 1; Ticari).","enum":[0,1]},"status":{"type":"string","description":"Gönderilen isteğin sonucu.","enum":["success","failure"]},"locale":{"type":"string","description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","description":"Yapılan isteğin sonucu.","enum":["success","failure"]},"errorCode":{"type":"string","description":"Hata kodu."},"errorMessage":{"type":"string","description":"Hata mesajı."},"locale":{"type":"string","description":"Yanıt dili."},"systemTime":{"type":"integer","description":"İşlem zamanı (epoch ms)."},"conversationId":{"type":"string","description":"İstek ile eşleşen ID."}}}}}} ``` #### Örnek Kodlar
PHP
Java
.Net
Node.Js
Python
Postman
### Öneriler Servis tarafından verilen cevaba göre aşağıdaki kurallar dikkate alınabilir; * `card_type` parametresi `DEBIT_CARD` olarak döndüğünde 3DS ödeme yöntemi kullanılması önerilir. * Önyüzde `card_family` alanındaki değerlere göre taksit seçenekleri görüntülenebilir. Taksitli ödemeye uygun kart aileleri arasında Bonus, World, Maximum, Axess, Cardfinans, Paraf ve Advantage yer almaktadır. * `force3ds` değeri 1 olarak dönerse, işlemin 3DS ile işlenmesi gerektiği anlamına gelir. 0 ise tercihlere göre işlem yapılabilir. İşyeri hesabında 3DS zorunlu olarak ayarlanmışsa, bu değer sürekli olarak 1 döndürür. * Talepte BIN numarası belirtilmemişse, mevcut tüm taksit seçenekleri görüntülenecektir. Ancak, BIN numarası verilirse, yalnızca ilgili ve o karta özel taksit seçeneklerini içerecektir. * Taksit sorgulama, iyzico üye iş yeri kontrol panelindeki "Taksit ve Komisyon Ayarları" bölümünde tanımlanan taksit oranlarını getirir. Bu bölümde yapılan değişiklikler otomatik olarak taksit hizmetine yansıtılacaktır. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.iyzico.com/ek-servisler/taksit-ve-bin-sorgulama.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.