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

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

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

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

Шаги

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

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

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

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

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

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) автоматически помечает сессию как бизнес-сессию.

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

Передайте url администратору компании по электронной почте или в мессенджере. Он откроет ссылку, заполнит данные из реестра, добавит ключевых лиц и UBO и загрузит документы.Размещённую страницу можно настроить под себя: добавить брендинг, логотип и домен. См. White label.

Получите webhook о статусе

Когда компания завершит процесс, а KYB-обработка достигнет финального статуса, Didit отправит POST-запрос с событием status.updated на ваш endpoint для webhook. События бизнес-сессий содержат session_kind: "business" внутри data. Фильтруйте по этому полю, чтобы направлять событие в ваш обработчик KYB.Проверьте HMAC-подпись X-Signature-V2 перед тем, как доверять событию (см. webhooks), и только после этого запускайте последующую логику. Сохраните secret_shared_key адреса назначения webhook (он возвращается при регистрации webhook) как DIDIT_WEBHOOK_SECRET в вашем .env.Пример payload:

{
  "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" }
}

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

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

curl https://verification.didit.me/v3/session/bs_01H.../decision/ \
  -H "x-api-key: YOUR_API_KEY"

Решение включает данные реестра, ключевых лиц (UBO, акционеров, директоров и представителей), результаты AML-проверок, документы и результаты по каждой функции. Полное описание payload см. в схеме ответа.

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

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

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

Пример на Node.js

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 документов и перекрёстная сверка данных.
Создание и агрегация профиля компании с использованием vendor_data в качестве ключа.

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

Руководство по интеграции

Сквозная архитектура, сравнение опроса и webhook, логика повторных попыток.

Webhook для KYB

Все события KYB и структуры их payload.

Статусы

Справочник статусов сессии, функций и реестра.

Схема ответа

Полный payload решения KYB.

Компании

Как профили агрегируются по сессиям.

Начало работы

Функции

Профили компаний

Справочник

Консоль

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

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

Шаги

Пример на Node.js

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

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

Руководство по интеграции

Webhook для KYB

Статусы

Схема ответа

Компании

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

​Шаги

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

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

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

Руководство по интеграции

Webhook для KYB

Статусы

Схема ответа

Компании

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

Шаги

Пример на Node.js

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

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