BIN Check / Get Installments
POST https://uygulama.vomsis.com/api/vpos/v3/bin-check
Bu metod, kart numarasının ilk 6 hanesini (BIN) kullanarak kart bilgilerini ve o karta özel uygulanabilecek taksit seçeneklerini getirir.
Headers
| Field | Type | Description |
|---|---|---|
Authorization | String | Zorunlu. authenticate metodundan alınan token. Bearer {access_token} formatında gönderilmelidir. |
Request Body
| Field | Type | Description |
|---|---|---|
cc_number | Integer | Zorunlu. Sorgulanacak kart numarasının ilk 6 hanesi (BIN). |
Response Parameters
Dönen cevap, kart bilgilerini (card_info) ve taksit seçeneklerini (installments) doğrudan içeren bir nesne döner.
| Alan | Type | Description |
|---|---|---|
card_info | Object | Kartın temel bilgilerini içeren nesne. |
card_info.bin_check_company | Integer | BIN kontrolünü yapan şirketin ID'si. |
card_info.bank_name | String | Kartın ait olduğu bankanın adı. |
card_info.card_type | String | Kart tipi (Örn: CREDIT_CARD, DEBIT). |
card_info.card_association | String | Kart şeması (Örn: master_card, visa). |
card_info.card_family_name | String | Kartın ailesi (Örn: Bonus, Axess). |
installments | Array | Girilen karta uygulanabilecek taksit bilgilerini içeren dizi. |
installments[].pos_id | Integer | Taksitin geçerli olduğu POS ID'si. |
installments[].block_rate | String | Bloke oranı. |
installments[].currency | String | Taksitli işlemin para birimi. |
installments[].installment | Integer | Taksit sayısı. 1 tek çekimi ifade eder. |
installments[].title | String | Taksit seçeneğinin metinsel ifadesi (Örn: "Tek Çekim", "2 Taksit"). |
installments[].amount | String | İlgili taksitte ödenecek tutar. |
installments[].ratio | String | İlgili taksitteki oran. |
Response Example
{
"data": {
"card_info": {
"bin_check_company": 2,
"bank_name": "T.GARANTİ BANKASI A.Ş.",
"card_type": "CREDIT_CARD",
"card_association": "master_card",
"card_family_name": "Bonus"
},
"installments": [
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 1,
"title": "1 Taksit",
"amount": "1",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 2,
"title": "2 Taksit",
"amount": "2",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 3,
"title": "3 Taksit",
"amount": "3",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 4,
"title": "4 Taksit",
"amount": "4",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 5,
"title": "5 Taksit",
"amount": "5",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 6,
"title": "6 Taksit",
"amount": "6",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 7,
"title": "7 Taksit",
"amount": "7",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 8,
"title": "8 Taksit",
"amount": "8",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 9,
"title": "9 Taksit",
"amount": "9",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 10,
"title": "10 Taksit",
"amount": "10",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 11,
"title": "11 Taksit",
"amount": "11",
"ratio": "0"
},
{
"pos_id": 22,
"block_rate": "0",
"currency": "TRY",
"installment": 12,
"title": "12 Taksit",
"amount": "12",
"ratio": "0"
}
]
}
}