Перейти к содержанию

Получение данных по карте (BIN)

Получение информации о банке-эмитенте, типе карты и платежной системе по номеру карты.

URL

Метод: GET

  • Production: https://registry.wallet.kvell.group/reg2/validation/bin

Параметры запроса

Название Тип данных Обязательно Описание
card string Да Номер карты

Пример запроса

GET https://registry.wallet.kvell.group/reg2/validation/bin?card=220025******0049

Заголовки запроса

Название Тип данных Обязательно Описание
X-Api-Key string Да Уникальный идентификатор (UUID)

Ответ запроса

Пример ответа

{
  "card": "220025******0049",
  "bin": "220025",
  "paymentSystem": "MIR",
  "bank": "SDM-BANK PUBLIC JOINT-STOCK COMPANY",
  "bankPhone": "9641112233",
  "bankUrl": "test.ru",
  "cardType": "DEBIT",
  "country": "RUSSIAN FEDERATION",
  "countryCode": "RUS",
  "brand": "NSPK MIR",
  "message": "Корректный номер карты",
  "valid": true
}

Параметры ответа

Название Тип данных Описание
card string Номер карты
bin string BIN карты
paymentSystem string Платежная система (VISA, MASTERCARD, MIR, MAESTRO, AMEX, UNIONPAY, UNKNOWN)
bank string Банк-эмитент
bankPhone string Телефон банка-эмитента
bankUrl string Сайт банка-эмитента
cardType string Тип карты (DEBIT, CREDIT, PREPAID, UNKNOWN)
country string Страна
countryCode string Код страны ISO3
brand string Бренд карты
message string Информация о прохождении валидации
valid boolean Статус прохождения валидации