> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Быстрый старт KYB: верификация бизнеса за 10 минут

> Верифицируйте бизнес в Didit за 10 минут: реестр, UBO, руководители, AML и webhooks. От $2.00 за проверку, без контрактов.

Это руководство проведёт вас через полную KYB-верификацию менее чем за 10 минут. Вы создадите сценарий, запустите сессию, передадите ссылку на размещённую страницу верификации контакту в компании, дождётесь webhook и получите итоговое решение.

## Предварительные требования

* Приложение Didit с включённым KYB. При необходимости создайте его на [business.didit.me](https://business.didit.me).
* API-ключ из раздела *Настройки разработчика → API-ключи*.
* Endpoint для webhook, доступный из интернета (для webhook с решением).

## Шаги

**1. Создайте KYB-сценарий в консоли**

Перейдите в *Сценарии → Создать сценарий*. В качестве типа сценария выберите **Верификация бизнеса**.

Включите нужные функции:

* **Проверка реестра компаний** (обязательно)
* **AML компании** (рекомендуется)
* **Ключевые лица** (обязательно для большинства регулируемых отраслей)
* **Документы** (необязательно: выберите типы документов, которые будете требовать)

Сохраните и скопируйте `workflow_id`: он понадобится на следующем шаге.

**2. Создайте сессию «Верификация бизнеса (KYB)» через API**

```bash theme={null}
curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "YOUR_KYB_WORKFLOW_ID",
    "vendor_data": "biz-acme-001"
  }'
```

Ответ содержит `session_id`, `session_number` и `url`, то есть ссылку на размещённую страницу верификации, которую вы передаёте контакту в компании. Тип сценария (KYB) автоматически помечает сессию как бизнес-сессию.

**3. Отправьте ссылку контакту в компании**

Передайте `url` администратору компании по электронной почте или в мессенджере. Он откроет ссылку, заполнит данные из реестра, добавит ключевых лиц и UBO и загрузит документы.

Размещённую страницу можно настроить под себя: добавить брендинг, логотип и домен. См. [White label](https://docs.didit.me/ru/console/white-label.md).

**4. Получите webhook о статусе**

Когда компания завершит процесс, а KYB-обработка достигнет финального статуса, Didit отправит POST-запрос с событием `status.updated` на ваш endpoint для webhook. События бизнес-сессий содержат `session_kind: "business"` внутри `data`. Фильтруйте по этому полю, чтобы направлять событие в ваш обработчик KYB.

Проверьте HMAC-подпись `X-Signature-V2` перед тем, как доверять событию (см. [webhooks](https://docs.didit.me/ru/integration/webhooks.md)), и только после этого запускайте последующую логику. Сохраните `secret_shared_key` адреса назначения webhook (он возвращается при регистрации webhook) как `DIDIT_WEBHOOK_SECRET` в вашем `.env`.

Пример payload:

```json theme={null}
{
  "event_id": "7f3c2c1e-6a1d-4c36-9d8e-0d3b5f4e2a10",
  "webhook_type": "status.updated",
  "session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "business_session_id": "a1b2c3d4-5678-4abc-9def-1234567890ab",
  "session_kind": "business",
  "vendor_data": "biz-acme-001",
  "status": "Approved",
  "created_at": 1776515400,
  "timestamp": 1776515401,
  "decision": { "...": "full KYB decision" }
}
```

**5. Получите решение (необязательно)**

> [!NOTE]
>
> Payload webhook `status.updated` уже содержит полное решение. Этот endpoint нужен, только если вы не подписались на webhook или хотите получить решение позже по запросу.

```bash theme={null}
curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"
```

Решение включает данные реестра, ключевых лиц (UBO, акционеров, директоров и представителей), результаты AML-проверок, документы и результаты по каждой функции. Полное описание payload см. в [схеме ответа](https://docs.didit.me/ru/business-verification/response-schema.md).

**6. Действуйте по решению**

В зависимости от `status`:

* `"Approved"`: проведите онбординг компании.
* `"Declined"`: откажите компании в онбординге и запишите в журнал теги из `warnings[]` решения.
* `"In Review"`: дождитесь решения аналитика. Когда оно будет принято, вы получите ещё один webhook.

## Пример на Node.js

```typescript theme={null}
import fetch from 'node-fetch';

const API_KEY = process.env.DIDIT_API_KEY!;
const WORKFLOW_ID = process.env.DIDIT_KYB_WORKFLOW_ID!;
const BASE_URL = 'https://verification.didit.me';

async function startKybVerification(vendorData: string) {
  const res = await fetch(`${BASE_URL}/v3/session/`, {
    method: 'POST',
    headers: {
      'x-api-key': API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ workflow_id: WORKFLOW_ID, vendor_data: vendorData }),
  });
  if (!res.ok) throw new Error(`Session create failed: ${res.status}`);
  return res.json();
}

async function getDecision(sessionId: string) {
  const res = await fetch(`${BASE_URL}/v3/session/${sessionId}/decision/`, {
    headers: { 'x-api-key': API_KEY },
  });
  return res.json();
}

// Kick off the flow
const { session_id, url } = await startKybVerification('biz-acme-001');
console.log('Deliver this URL to your contact:', url);

// ... later, after the webhook confirms completion:
const decision = await getDecision(session_id);
console.log('KYB status:', decision.status);
```

## Что происходит автоматически

* Проверка реестра компаний в 190+ юрисдикциях.
* Извлечение UBO и должностных лиц из данных реестра.
* AML-скрининг на уровне компании (санкции, PEP, негативные публикации в СМИ).
* AML-проверка каждого выявленного участника.
* OCR документов и перекрёстная сверка данных.
* Создание и агрегация [профиля компании](https://docs.didit.me/ru/business-verification/business-profiles.md) с использованием `vendor_data` в качестве ключа.

## Дальнейшие шаги

> [card] [Руководство по интеграции](https://docs.didit.me/ru/business-verification/integration-guide.md)
>
> Сквозная архитектура, сравнение опроса и webhook, логика повторных попыток.

> [card] [Webhook для KYB](https://docs.didit.me/ru/business-verification/webhooks.md)
>
> Все события KYB и структуры их payload.

> [card] [Статусы](https://docs.didit.me/ru/business-verification/statuses.md)
>
> Справочник статусов сессии, функций и реестра.

> [card] [Схема ответа](https://docs.didit.me/ru/business-verification/response-schema.md)
>
> Полный payload решения KYB.

> [card] [Компании](https://docs.didit.me/ru/entities/businesses/overview.md)
>
> Как профили агрегируются по сессиям.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.