Installment & BIN Service
The API provides installment counts, rates and amounts, as well as attributes such as issuing bank, card family and card scheme. It lists available installment options based on the given BIN and amount. You can also query installment rates with only the BIN or only the amount.
Authorization header that starts with IYZWSv2 and contains a Base64-encoded signed hash.
IYZWSv2 aXBzaWduYXR1cmU...Content-Type value.
application/jsonLanguage preference used in requests and responses.
enPossible values: Amount for installment calculation.
1008-digit card BIN. If provided, suitability is returned per card/bank. If omitted, installment rates can be returned based on the amount only.
54308100Request/response correlation ID. The value sent in the request is returned as-is in the response.
123456789Successful response
Error response
POST https://sandbox-api.iyzipay.com/payment/iyzipos/installment
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtcU43VzljOXI3aWhZZUs5Z2ZqbFhRWFlPUUZteEQyNkEmcmFuZG9tS2V5OjE3NTY0NjkyMjgyMzQxMjM0NTY3ODkmc2lnbmF0dXJlOmRmMzEwNjI2MTI0OGNhZTcxMDJlZDQxMjhjODA4MmIwOTlhMzU4OWNmZDc3MTNkODNlODk5YWEzMDg0NDBkZDg=
Content-Type: application/json
{
  "locale": "en",
  "price": 100.0,
  "binNumber": "54308100",
  "conversationId": "123456789"
}
{
  "status": "success",
  "locale": "en",
  "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
        }
      ]
    }
  ]
}Retrieves card attributes in BIN inquiries such as issuing bank, card family, and card scheme. To obtain the desired information, simply include the required parameters in your request. The API will respond with comprehensive details.
Authorization header that starts with IYZWSv2 and contains a Base64-encoded signed hash.
IYZWSv2 aXBzaWduYXR1cmU...Content-Type value.
application/jsonLanguage preference used in requests and responses.
enPossible values: BIN to query (8 digits).
41579200Request/response correlation ID. The value sent in the request is returned as-is in the response.
1a2b3c4d5e6fSuccessful response
Error response
POST https://sandbox-api.iyzipay.com/payment/bin/check
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtNE9hdVQwRX....cwZWMxZWIzZGU5Y2IwNTRkMjk4Zjc1NThlNmRiMmQwYTQ2NjA4NzJmYzY0NGFjNg==
Content-Type: application/json
{
  "locale": "en",
  "binNumber": "41579200",
  "conversationId": "1a2b3c4d5e6f"
}
{
  "binNumber": "41579200",
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "World",
  "bankName": "Vakıfbank",
  "bankCode": 15,
  "commercial": 0,
  "status": "success",
  "locale": "en",
  "systemTime": 1755547712091,
  "conversationId": "1a2b3c4d5e6f"
}Last updated
