# Быстрый старт с KYB API

Данный раздел описывает минимальный сценарий интеграции: получение KYB API-ключа, создание ссылки верификации для компании и отправка её представителю. Представитель проходит KYB-поток на странице OneKYC, после чего результат поступает через вебхук или API.

## Шаг 1. Получение KYB API-ключа [#шаг-1-получение-kyb-api-ключа]

В разделе **API-ключи** панели администратора выполните следующие действия:

1. Нажмите «Создать ключ».
2. Выберите тип: **KYB**.
3. Выберите окружение: Production или Sandbox.
4. Скопируйте `api_key` (формат `kyb_live_...`) и `api_secret`. Секретный ключ отображается однократно — сохраните его в надёжном месте.

> KYB-ключи предназначены исключительно для эндпоинтов `/tenant/v1/kyb/*`. Использование KYC-ключей (`kyc_live_*`) для работы с KYB API не допускается.

## Шаг 2. Создание ссылки верификации [#шаг-2-создание-ссылки-верификации]

С вашего сервера направьте запрос к Tenant KYB API (HMAC-подпись обязательна — схема аналогична KYC, см. [Аутентификация](/ru/api/authentication)):

API operations:

- `POST /v1/kyb/verification-links`

**Пример запроса (JavaScript / Node.js):**

```javascript
const crypto = require("crypto");
const https = require("https");

const body = JSON.stringify({
  flow_id: "ваш_kyb_flow_id",
  external_user_id: "company-001",
  expires_in: 259200, // 72 часа в секундах
  locale: "ru",
});

const timestamp = Math.floor(Date.now() / 1000).toString();
const bodyHash = crypto.createHash("sha256").update(body).digest("hex");
const stringToSign = `${timestamp}\nPOST\n/tenant/v1/kyb/verification-links\n${bodyHash}`;
const signature = crypto
  .createHmac("sha256", "ваш_api_secret")
  .update(stringToSign)
  .digest("hex");

// Заголовки запроса
const headers = {
  "Content-Type": "application/json",
  "X-Timestamp": timestamp,
  Authorization: `HMAC-SHA256 Credential=kyb_live_ваш_ключ, Signature=${signature}`,
};
```

Схема ответа (поля `id`, `url`, `status`, `expires_at` и др.) описана в блоке OpenAPI выше.

Направьте значение `url` из ответа представителю компании (по электронной почте, SMS или в виде QR-кода). При переходе по ссылке автоматически создаётся KYB-сессия.

## Шаг 3. Прохождение KYB-потока пользователем [#шаг-3-прохождение-kyb-потока-пользователем]

Представитель компании открывает ссылку в браузере и последовательно проходит следующие шаги:

1. **Данные компании** — наименование, регистрационный номер, страна регистрации.
2. **Данные руководителя и бенефициарных владельцев** — ФИО, доля участия.
3. **Загрузка документов** — устав, свидетельство о государственной регистрации.
4. **ИИ-проверка** — автоматический анализ (ориентировочное время — 2–3 минуты; пользователь видит экран ожидания).

## Шаг 4. Получение результата [#шаг-4-получение-результата]

**Через вебхук** (рекомендуемый способ): настройте endpoint в разделе **Вебхуки** панели администратора. Система OneKYC направит событие `kyb.business.verified`, `kyb.business.rejected` или `kyb.business.review_required`.

**Через API:** выполните запрос результата по внешнему идентификатору компании:

API operations:

- `GET /v1/kyb/businesses/external/{external_id}`

Структура ответа (`success`, `data` с полями компании) полностью описана в спецификации Swagger — см. блок OpenAPI выше или раздел [KYB API — Справочник](/ru/kyb/api-reference).

## Дальнейшие шаги [#дальнейшие-шаги]

- [KYB API — Справочник](/ru/kyb/api-reference) — полный перечень эндпоинтов с параметрами
- [KYB Вебхуки](/ru/kyb/webhooks) — типы событий и форматы payload
- [Аутентификация](/ru/api/authentication) — порядок вычисления HMAC-подписи