> ## 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): API для документов Didit

> Didit собирает и проверяет корпоративные документы для KYB: сертификаты, устав, отчётность, OCR и сверка с реестрами. Цены отдельно.

Бизнес-верификация включает структурированный сбор документов, который позволяет проверять данные о компании сверх того, что есть в реестрах.

## Цены

Сбор документов KYB стоит **\$0.20 за шаг сценария** независимо от того, сколько документов загружено на этом шаге. Повторная загрузка документа на том же шаге не добавляет ещё одну оплату. Отдельный шаг сбора документов тарифицируется отдельно.

## Группы документов

Документы разделены на четыре структурированные группы, каждая из которых соответствует категории доказательств, необходимых для верификации бизнеса; кроме того, предусмотрена группа для всего, что Didit не может классифицировать:

| Группа (`document_group`) | Описание | Распознаваемые подтипы документов |
| - | - | - |
| **Юридическое существование** (`LEGAL_PRESENCE`) | Документы, подтверждающие, что компания юридически существует | `CERTIFICATE_OF_INCORPORATION`, `CERTIFICATE_OF_GOOD_STANDING`, `CERTIFICATE_OF_INCUMBENCY`, `REGISTRY_EXCERPT`, `BUSINESS_LICENSE`, `TAX_REGISTRATION` |
| **Данные компании** (`COMPANY_DETAILS`) | Документы, описывающие текущие данные компании | `CONFIRMATION_STATEMENT`, `ANNUAL_RETURN`, `STATEMENT_OF_INFORMATION` |
| **Структура собственности** (`OWNERSHIP_STRUCTURE`) | Документы, подтверждающие цепочку владения | `SHAREHOLDER_REGISTRY`, `MEMORANDUM_OF_ASSOCIATION`, `ARTICLES_OF_ASSOCIATION` |
| **Полномочия представителей** (`REPRESENTATIVES_AUTHORIZATION`) | Документы, подтверждающие право действовать от имени компании | `DIRECTOR_REGISTRY`, `POWER_OF_ATTORNEY`, `TRUST_AGREEMENT` |
| **Другое** (`OTHER`) | Всё, что Didit не может уверенно классифицировать | `UNKNOWN` |

Каждая группа отслеживает свой прогресс с помощью счётчиков по группам: `total`, `approved`, `pending`, `declined`, `in_review`, `other` и `missing`. Общий статус документов сессии компании агрегирует данные по всем группам.

## Типы документов

| Категория | Примеры |
| - | - |
| **Документы о создании компании** | Свидетельство о регистрации, устав, учредительный договор |
| **Документы о владении** | Реестр акционеров, акционерные сертификаты, декларации UBO |
| **Документы об адресе** | Счета за коммунальные услуги, банковские выписки или договоры аренды для юридического адреса |
| **Финансовые документы** | Годовая отчётность, аудиторские заключения, финансовые отчёты |
| **Налоговые документы** | Свидетельства о налоговой регистрации, справки о налоговом соответствии |
| **Нормативные документы** | Лицензии, разрешения, одобрения регулирующих органов |
| **Пользовательские документы** | Любые дополнительные документы, требуемые вашим комплаенс-процессом |

## Процесс работы с документами

**1. Автоматические запросы**

На основании конфигурации сценария Didit автоматически определяет, какие документы нужны для верификации бизнеса. Бизнесу предлагаются для загрузки требуемые типы документов.

**2. Загрузка**

Документы загружаются через размещённый процесс проверки, в Business Console или из собственного интерфейса с помощью endpoint [загрузки документов](https://docs.didit.me/ru/sessions-api/kyb-upload-documents.md). Принимаются форматы PDF, JPG, JPEG, PNG, TIFF и WebP, а также ZIP-архив с ними. Размер PDF может быть до 50 МБ, размер фотографий до 6 МБ до сжатия. Для PDF с паролем передайте пароль в `document_passwords` при загрузке через API.

**3. Извлечение данных с помощью OCR**

Didit извлекает структурированные данные из загруженных документов с помощью OCR:

* Название компании и регистрационный номер из свидетельств
* Данные об адресе из счетов за коммунальные услуги
* Финансовые показатели из отчётов
* Имена и роли из реестров акционеров

**4. Перекрёстная сверка**

Извлечённые данные сверяются с:

* Данными реестра из поиска компании
* Информацией, переданной при создании сессии
* Данными из других загруженных документов

Несоответствия отмечаются для проверки аналитиком.

**5. Проверка**

Аналитики проверяют загруженные документы в консоли, подтверждают их подлинность и одобряют или отклоняют каждый документ отдельно.

## Запросы документов от аналитиков

В ходе проверки аналитики могут запросить дополнительные документы:

1. Перейдите к сессии компании в консоли.
2. Нажмите **Запросить документ** и укажите тип документа и описание.
3. Бизнес получает уведомление и может загрузить запрошенный документ.
4. Документ появляется в сессии со статусом **Запрошен**, пока он не будет загружен.

Это позволяет аналитикам собирать дополнительные доказательства, не отклоняя всю сессию компании.

## Статусы документов

Каждый документ и агрегированная проверка `document_verifications[]` используют стандартный набор статусов функции KYB:

| Статус | Описание |
| - | - |
| `"Not Finished"` | Документ ещё обрабатывается (загрузка, работа OCR или ожидание перекрёстной сверки). |
| `"Approved"` | Документ проверен и принят. |
| `"Declined"` | Документ проверен и отклонён. |
| `"In Review"` | Документ требует ручной проверки аналитиком. |
| `"Resub Requested"` | Аналитик запросил повторную отправку: бизнес должен заново загрузить этот документ, прежде чем сессия сможет продвинуться дальше. |

## Результаты перекрёстной проверки

При обработке документа Didit сопоставляет данные, извлечённые с помощью OCR, с **данными, предоставленными пользователем**, которые переданы в процессе Key People (а также с данными, подтверждёнными при проверке реестра), и с другими загруженными документами. По итогам проверки формируются структурированные результаты:

| Категория | Описание |
| - | - |
| **Критичные поля** | Поля, в которых данные документа не совпадают с данными, предоставленными пользователем. Такие поля требуют проверки аналитиком. Для каждого поля показаны значение из документа, значение, предоставленное пользователем, и оценка уверенности. |
| **Некритичные поля** | Поля с незначительными расхождениями или различиями в форматировании, которые могут не требовать действий (например, различия в сокращениях названия компании). |
| **Пересечение списков лиц** | Анализ людей, упомянутых в документе, и людей, указанных пользователем. Выделяет отсутствующих и дополнительных лиц. |

Результаты перекрёстной проверки выводятся в [Business Console](https://docs.didit.me/ru/business-verification/console.md) рядом с предпросмотром документа. Это даёт аналитикам понятную картину: что совпадает и что требует внимания.

## Получение документов через API

Документы прикрепляются к сессии верификации бизнеса (KYB). Получите их через решение по сессии:

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

Ответ содержит массив `document_verifications[]`. Каждый элемент включает `status`, `node_id`, `items[]` (каждый с подписанной ссылкой `file_url`, `document_group`, `document_subtype` и извлечёнными данными OCR), `groups` и `required_groups`. Полную структуру см. в [схеме ответа](https://docs.didit.me/ru/business-verification/response-schema.md#document_verifications).

## Следующие шаги

> [card] [Схема ответа](https://docs.didit.me/ru/business-verification/response-schema.md)
>
> Где документы находятся в payload.

> [card] [Business Console](https://docs.didit.me/ru/business-verification/console.md)
>
> Просмотр документов аналитиком.


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