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

Определение банка-эмитента, платёжной системы, типа карты и страны по номеру карты (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)

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

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

200: OK

{
  "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	Банк-эмитент
`cardType`	string	`DEBIT`, `CREDIT`, `PREPAID`, `UNKNOWN`
`country`	string	Страна
`valid`	boolean	Статус валидации