API Referansına Dön TaksitlerBIN Taksit Sorgusu

BIN Taksit Sorgusu

GET/v1/installmentsRecommended

Bir kart BIN'i ve tutar için uygun taksit planlarını ve komisyon oranlarını döndürür. Yalnızca ilgili BIN/tutar için izin verilen planlar döner.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/installments\n{sha256(\"\")}")

Başlık	Değer	Açıklama
`X-Api-Key`	pk_live_a1b2c3d4e5f6g7h8	Merchant public API key
`X-Signature`	{hmac_sha256_hex}	Hex HMAC-SHA256 request signature
`X-Timestamp`	2026-04-13T10:00:00Z	ISO 8601 UTC request time (±5 min)

İstek Parametreleri

Ad	Tür	Zorunlu	Açıklama
`bin`	string	Zorunlu	First 6 digits of the card
`amount`	integer	Zorunlu	Transaction amount in kuruş

Yanıt Parametreleri

Alan	Tür	Örnek
`bin`	string	"415565"
`bank`	string	"Garanti BBVA"
`brand`	string	"visa"
`cardType`	string	"credit"
`country`	string	"TR"
`eligiblePlans`	array	[…]
`eligiblePlans[].count`	integer	1
`eligiblePlans[].commissionRate`	number	0.019

Yanıt Örneği

JSONYanıt

{
  "bin": "415565",
  "bank": "Garanti BBVA",
  "brand": "visa",
  "cardType": "credit",
  "country": "TR",
  "eligiblePlans": [
    {
      "count": 1,
      "commissionRate": 0.019
    },
    {
      "count": 3,
      "commissionRate": 0.035
    },
    {
      "count": 6,
      "commissionRate": 0.065
    }
  ]
}

Durum Kodları

200Success

201Created

400Bad Request

401Unauthorized

404Not Found

429Rate Limited

DeneSahte

GEThttps://api.pay.sandbox.kvell.group

BIN Sorgusu→