Taksit ve BIN Sorgulama

Taksit Sorgulama

post

Sorgulanmak istenen BIN ve tutara göre uygun taksit seçeneklerini listeler. BIN özelinde veya sadece tutar bilgisi ile taksit oranlarını listelenebilir.

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
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
post
POST https://api.iyzipay.com/payment/iyzipos/installment
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
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

Sorgulanmak istenen BIN numarasına göre kart ve banka bilgisini döner.

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
localestring · enumOptional

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

Example: trPossible values:
binNumberstringRequired

Sorgulanacak BIN (8 hane).

Example: 542119
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
post
POST https://api.iyzipay.com/payment/bin/check
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

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

Last updated