BIN Kontrol

BIN Kontrol servisi, girilen kart numarasına ait BIN bilgilerini sorgulamak için kullanılır.

Bu servis ile:

• Kartın bağlı olduğu banka

• Kart tipi (kredi / banka / ön ödemeli)

• Kart markası (Visa, Mastercard vb.)

• Kartın ticari olup olmadığı

gibi temel kart özellikleri öğrenilebilir.

ℹ️ BIN sorgulama işlemi finansal bir işlem değildir ve ödeme başlatmaz.

---

Endpoint

POST /v1/BinList/CheckBin

---

Headers

Anahtar	Tür	Açıklama	Örnek
x-ClientID	String	API istemcisi için benzersiz tanımlayıcı	sizin-istemci-id'niz
x-ClientSecret	String	API istemcisi için gizli anahtar	sizin-gizli-anahtarınız
x-GrantType	String	Kullanılan erişim tokeni türü	istemci_kimlik_bilgileri
x-Scope	String	API kapsamı	pf_write, pf_read
x-Timestamp	String	İstek zaman damgası	2024-12-17T12:34:56Z

---

Request Body

Alan	Zorunlu	Tür	Açıklama	Örnek
bin	✅	Integer	4 veya 6 haneli BIN numarası	402940
language	✅	String	İşlem dili	tr
sign	✅	String	İsteğin doğrulanması için dijital imza	AAVWY3RZKJVVCEAD8LDQB4K

---

Response Body

BIN kontrol servisi, sorgulanan karta ait banka ve kart bilgilerini döner.

Örnek Request

POST /v1/BinList/CheckBin
Content-Type: application/json
x-ClientID: sizin-istemci-id'niz
x-ClientSecret: sizin-gizli-anahtarınız
x-GrantType: istemci_kimlik_bilgileri
x-Scope: pf_write, pf_read
x-Timestamp: 2024-12-17T12:34:56Z

{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "2025-02-05T17:26:54.3277205+03:00",
  "conversationId": "BSR29715509646227267",
  "bin": "402940",
  "cardType": "B",
  "cardBrand": "VISA / World",
  "bankName": "T.VAKIFLAR BANKASI T.A.O.",
  "bankCode": "0015",
  "commercial": "0"
}

Örnek Response

{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "2025-02-05T17:26:54.3277205+03:00",
  "conversationId": "BSR29715509646227267",
  "bin": "402940",
  "cardType": "B",
  "cardBrand": "VISA / World",
  "bankName": "T.VAKIFLAR BANKASI T.A.O.",
  "bankCode": "0015",
  "commercial": "0"
}