Запрос информации о карте

В системе есть возможность получения детальной информации о платежной карте из базы данных системы. Для запроса используется BIN или PAN карты и авторизация по секретному ключу магазина торговца.

Метод запроса информации о транзакции

POST https://{api-url}/credit-cards/bins/info

Запрос

Авторизация

В запросе используется авторизация типа Basic с id и secret_key магазина.

Параметры заголовка запроса

Параметр	Обязательность	Тип	Описание
`Content-Type`	обязательный	`string (20)`	`application/json`

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

Параметр	Обязательность	Тип	Описание
`number`	обязательный	`string (6–19)`	BIN (первые 6–12 символов номера карты) или PAN карты (Personal Account Number, до 19 символов).

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

{ "number": "420000" }

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

Параметр	Тип	Описание
`response`	`object`
`code`	`string`	Код обработки транзакции.
`message`	`string`	Сообщение с результатом запроса.
`friendly_message`	`string`	Сообщение для покупателя с описанием кода ошибки из параметра `code`.
`data`	`array`	Массив данных

Параметры объектов массива data[]

Если по указанному BIN/PAN не было найдено карт, массив будет пустым.

Параметр	Тип	Описание
`id`	`integer`	Уникальный идентификатор записи данных о карте в базе данных системы.
`issuer_name`	`string`	Наименование эмитента карты.
`issuer_country`	`string`	Страна эмитента карты.
`brand`	`string`	Название бренда платежной карты. Например, `visa`, `mastercard`.
`sub_brand`	`string`	Название кобренда платежной карты.
`currency`	`string`	Валюта карты. Параметр возвращается только для карт отдельных банков.
`product`	`object`	Секция с параметрами описания карточного продукта.

Параметры product{}

Параметр	Тип	Описание
`code`	`string`	Код продукта банковской карты.
`name`	`string`	Наименование продукта банковской карты, используется для программ лояльности, например, `Gold MasterCard`
`category`	`string`	Категория продукта: дебетовая или кредитовая карта

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

{
    "response": {
        "code": "S.0000",
        "message": "The request was successful.",
        "friendly_message": "The request was successful.",
        "data": [
            {
                "id": 796,
                "issuer_name": "VISA Demo Bank",
                "issuer_country": "US",
                "product": {
                    "code": "F",
                    "name": "Visa Classic"
                }
            }
        ]
    }
}