# Получение информации по BIN карты

```json
GET https://unitpay.ru/api

method            = getBinInfo
params[login]     = partner@example.com
params[bin]       = 477964
params[secretKey] = ключ

```

<table data-header-hidden><thead><tr><th width="173.77779134114581"></th><th width="191.4444580078125">Значение</th><th>Описание</th></tr></thead><tbody><tr><td><strong>login</strong></td><td>строка</td><td>Email аккаунта в системе UnitPay</td></tr><tr><td><strong>secretKey</strong></td><td>строка</td><td>Секретный ключ аккаунта, доступен в <a href="https://unitpay.ru/partner/profile/edit">настройках профиля</a></td></tr><tr><td><strong>bin</strong></td><td>число</td><td>Первые 6 цифр номера карты</td></tr></tbody></table>

#### Пример успешного запроса:

```
https://unitpay.ru/api?method=getBinInfo&params[login]=partner@example.com&params[bin]=477964&params[secretKey]=11122233F11-1F2220E3344-11122233D2
```

#### Пример успешного ответа:

```json
{
    "result": {
        "bin": "477964",
        "bank": "Alfa Bank",
        "countryCode": "RU",
        "brand": "VISA",
        "category": "CLASSIC",
        "bankUrl": "http://alfabank.com/russia/",
        "bankPhone": "7 495 620-91-91"
    }
}
```

<table><thead><tr><th width="233.4444580078125">Параметр</th><th width="168.22224934895831">Значение</th><th>Описание</th></tr></thead><tbody><tr><td><strong><code>bin</code></strong></td><td>строка</td><td>Первые 6 цифр номера карты</td></tr><tr><td><strong><code>bank</code></strong></td><td>строка</td><td>Название банка, в котором была выпущена карта</td></tr><tr><td><strong><code>countryCode</code></strong></td><td>строка</td><td>Код страны в формате Alpha-2 (ISO 3166-1)</td></tr><tr><td><strong><code>brand</code></strong></td><td>строка</td><td>Название международной системы, в которой обслуживается карта.</td></tr><tr><td><strong><code>category</code></strong></td><td>строка</td><td>Категория карты</td></tr><tr><td><strong><code>type</code></strong></td><td>строка</td><td>Тип карты</td></tr><tr><td><strong><code>bankUrl</code></strong></td><td>строка</td><td>Url банка</td></tr><tr><td><strong><code>bankPhone</code></strong></td><td>строка</td><td>Телефон банка</td></tr></tbody></table>

#### Пример ошибочного ответа:

```json
{
    "error": {
        "message": "По вашему запросу ничего не нашлось.",
        "code": 100
    }
}
```

<table><thead><tr><th width="179.33333333333331">Параметр</th><th width="198.4444580078125">Значение</th><th>Описание</th></tr></thead><tbody><tr><td><strong><code>message</code></strong></td><td>строка</td><td>Информация с описанием ошибки запроса</td></tr><tr><td><strong><code>code</code></strong></td><td>строка</td><td>Код ошибки, подробная расшифровка в таблице ниже</td></tr></tbody></table>

**Ошибки:**

| Код ошибки | Описание                            |
| ---------- | ----------------------------------- |
| **`100`**  | По вашему запросу ничего не нашлось |

**Технические ошибки:**

| Код ошибки   | Описание                      |
| ------------ | ----------------------------- |
| **`-32000`** | Ошибка авторизации            |
| **`-32602`** | Ошибочные параметры запроса   |
| **`-32603`** | Внутренняя техническая ошибка |