Taksit ve BIN Sorgulama

Taksit Sorgulama

post

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.

Header parameters

AuthorizationstringRequired

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type değeri.

Example: application/json

Body

application/json

localestring · enumOptional

İstek ve dönüş mesajlarında kullanılacak dil bilgisi.

Example: trPossible values:

pricenumber · decimalRequired

Taksit hesaplaması yapılacak tutar.

Example: 100

binNumberstringOptional

8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir.

Example: 54308100

conversationIdstringOptional

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Example: 123456789

Responses

200

Başarılı yanıt

application/json

statusstring · enumOptional

Yapılan isteğin sonucu.

Example: successPossible values:

localestringOptional

Yanıt dili.

Example: tr

systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1755547819061

conversationIdstringOptional

İstek ile eşleşen ID.

Example: 123456789

400

Başarısız yanıt

application/json

post

/payment/iyzipos/installment

HTTPcurl

POST https://sandbox-api.iyzipay.com/payment/iyzipos/installment
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtcU43VzljOXI3aWhZZUs5Z2ZqbFhRWFlPUUZteEQyNkEmcmFuZG9tS2V5OjE3NTY0NjkyMjgyMzQxMjM0NTY3ODkmc2lnbmF0dXJlOmRmMzEwNjI2MTI0OGNhZTcxMDJlZDQxMjhjODA4MmIwOTlhMzU4OWNmZDc3MTNkODNlODk5YWEzMDg0NDBkZDg=
Content-Type: application/json

{
  "locale": "tr",
  "price": 100.0,
  "binNumber": "54308100",
  "conversationId": "123456789"
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1755547819061,
  "conversationId": "123456789",
  "installmentDetails": [
    {
      "binNumber": "54308100",
      "price": 100,
      "cardType": "CREDIT_CARD",
      "cardAssociation": "MASTER_CARD",
      "cardFamilyName": "Paraf",
      "force3ds": 0,
      "bankCode": 12,
      "bankName": "Halkbank",
      "forceCvc": 0,
      "commercial": 0,
      "dccEnabled": 0,
      "agricultureEnabled": 0,
      "installmentPrices": [
        {
          "installmentPrice": 100,
          "totalPrice": 100,
          "installmentNumber": 1
        },
        {
          "installmentPrice": 51.61,
          "totalPrice": 103.22,
          "installmentNumber": 2
        },
        {
          "installmentPrice": 35.08,
          "totalPrice": 105.25,
          "installmentNumber": 3
        },
        {
          "installmentPrice": 18.7,
          "totalPrice": 112.22,
          "installmentNumber": 6
        },
        {
          "installmentPrice": 13.35,
          "totalPrice": 120.19,
          "installmentNumber": 9
        },
        {
          "installmentPrice": 10.77,
          "totalPrice": 129.2,
          "installmentNumber": 12
        }
      ]
    }
  ]
}

BIN Sorgulama

post

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.

Header parameters

AuthorizationstringRequired

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type değeri.

Example: application/json

Body

application/json

localestring · enumOptional

İstek ve dönüş mesajlarında kullanılacak dil bilgisi.

Example: trPossible values:

binNumberstringRequired

Sorgulanacak BIN (8 hane).

Example: 41579200

conversationIdstringOptional

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Example: 1a2b3c4d5e6f

Responses

200

Başarılı yanıt

application/json

binNumberstringOptional

Sorgulanan BIN.

Example: 46034500

cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:

cardAssociationstring · enumOptional

Kart kuruluşu.

Example: MASTER_CARDPossible values:

cardFamilystring · enumOptional

Kart ailesi.

Example: WorldPossible values:

bankNamestringOptional

Banka adı.

Example: Vakıfbank

bankCodeintegerOptional

Banka kodu.

Example: 15

commercialinteger · enumOptional

Ticari kart bilgisi (0; Bireysel, 1; Ticari).

Example: 0Possible values:

statusstring · enumOptional

Gönderilen isteğin sonucu.

Example: successPossible values:

localestringOptional

Yanıt dili.

Example: tr

systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1755547712091

conversationIdstringOptional

İstek ile eşleşen ID.

Example: 1a2b3c4d5e6f

400

Başarısız yanıt

application/json

post

/payment/bin/check

HTTPcurl

POST https://sandbox-api.iyzipay.com/payment/bin/check
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtNE9hdVQwRXNSUjk3bmlqZVBRTWxGMTNrVHA2Rk9lNjkmcmFuZG9tS2V5OjEyMzQ1Njc4OSZzaWduYXR1cmU6MTZmMmEwZTJiZjU4ZmZkZTcwZWMxZWIzZGU5Y2IwNTRkMjk4Zjc1NThlNmRiMmQwYTQ2NjA4NzJmYzY0NGFjNg==
Content-Type: application/json

{
  "locale": "tr",
  "binNumber": "41579200",
  "conversationId": "1a2b3c4d5e6f"
}

{
  "binNumber": "41579200",
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "World",
  "bankName": "Vakıfbank",
  "bankCode": 15,
  "commercial": 0,
  "status": "success",
  "locale": "tr",
  "systemTime": 1755547712091,
  "conversationId": "1a2b3c4d5e6f"
}