BIN Installment Query
GET
/v1/installmentsRecommendedReturn the eligible installment (taksit) plans and commission rates for a card BIN and amount. Only plans allowed for the BIN/amount are returned.
Authentication
Signature Pattern
HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/installments\n{sha256(\"\")}")| Header | Value | Description |
|---|---|---|
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) |
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
bin | string | Required | First 6 digits of the card |
amount | integer | Required | Transaction amount in kuruş |
Response Parameters
| Field | Type | Example |
|---|---|---|
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 |
Response Example
JSONResponse
{
"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
}
]
}Status Codes
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMock
GEThttps://api.pay.sandbox.kvell.group