vellTRDocs

BIN Sorgusu

GET/v1/bins/{bin}Recommended

Bir BIN için kart meta verilerini (kartı çıkaran banka, marka, tür, ülke) döndürür.

Kimlik Doğrulama

İmza Deseni

HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/bins/{bin}\n{sha256(\"\")}")
BaşlıkDeğerAçıklama
X-Api-Keypk_live_a1b2c3d4e5f6g7h8Merchant public API key
X-Signature{hmac_sha256_hex}Hex HMAC-SHA256 request signature
X-Timestamp2026-04-13T10:00:00ZISO 8601 UTC request time (±5 min)

Yanıt Parametreleri

AlanTürÖrnek
binstring"415565"
bankstring"Garanti BBVA"
brandstring"visa"
cardTypestring"credit"
countrystring"TR"

Yanıt Örneği

JSONYanıt
{
  "bin": "415565",
  "bank": "Garanti BBVA",
  "brand": "visa",
  "cardType": "credit",
  "country": "TR"
}

Durum Kodları

200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
DeneSahte
GEThttps://api.pay.sandbox.kvell.group