> ## 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.

# API верификации личности Didit: 14,000+ документов

> Didit: AI-верификация личности в 220+ странах, 14,000+ типах документов и 54 языках. $0.15 за проверку, $10 бесплатно в месяц, ответ за 2s.

Didit ID Verification считывает и аутентифицирует удостоверения личности, выданные государством, включая паспорта, ID-карты, водительские удостоверения и виды на жительство, в 220+ странах и 14,000+ типах документов. Система проверяет документ на признаки вмешательства и мошенничества, затем извлекает его данные с помощью AI OCR. Там, где это разрешено законодательством страны, пользователи могут пройти верификацию без документа: через проверку по базам данных или цифровой ID-кошелёк ([три способа верификации](#три-способа-верификации)).В уроке Academy о том, как читать результат верификации, тема верификации личности начинается на отметке 3:47. Там показано, почему проверка подлинности выполняется до извлечения данных.[Верификация личности: сначала подлинность, затем данные | Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=227\&rel=0\&playsinline=1)

Промпт для интеграции верификации личности
        Скопировать промпт в буфер обмена



      
      

\<pre>

\````# Goal
Integrate Didit ID Verification (OCR + document authenticity) into your app. Pick ONE of the two delivery modes below.

\# Mode A — Session-based (recommended for user-facing flows)
Use this when the user uploads / photographs their document in a hosted Didit flow. The feature is configured on a workflow and runs as part of /v3/session/.

1\. Create a workflow with the ID_VERIFICATION feature (Business Console or POST /v3/workflows/). Canonical feature enum: "OCR" (legacy) or "ID_VERIFICATION".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open the returned session.url for the user OR mount the Web/Mobile SDK.
4\. After completion fetch the decision — GET /v3/session/{sessionId}/decision/ (or subscribe to the session.status.updated webhook).

The decision response surfaces the result under the plural array `id_verifications[]` (one entry per document collected in the workflow).

\# Mode B — Standalone API (server-to-server)
Use when you already have one or two document images and want a one-shot OCR + checks call.

POST https://verification.didit.me/v3/id-verification/
multipart/form-data — x-api-key: YOUR_API_KEY

Required: front_image. Required for dual-sided docs (ID cards, driver licences): back_image.
Allowed extensions: tiff/jpg/jpeg/png/webp/pdf. Max 5 MB per file. Images must be uncropped — all 4 corners visible.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/id-verification/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'front_image=@./id_front.jpg' \
-F 'back_image=@./id_back.jpg' \
-F 'perform_document_liveness=true' \
-F 'minimum_age=18' \
-F 'expiration_date_not_detected_action=DECLINE' \
-F 'invalid_mrz_action=DECLINE' \
-F 'inconsistent_data_action=DECLINE' \
-F 'preferred_characters=latin' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, id_verification: { status, full_name, document_type, document_number, date_of_birth, expiration_date, parsed_address, mrz, barcodes, portrait_image, front_document_image, back_document_image, warnings: [...] } }.

\# Status enum (per id_verifications[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.ID_VERIFICATION)
The warnings[] array on each id_verification carries risk codes including:
DOCUMENT_EXPIRED, INVALID_MRZ, INCONSISTENT_DATA, COULD_NOT_RECOGNIZE_DOCUMENT, DOCUMENT_LIVENESS_FAILED, MIN_AGE_NOT_REACHED, MAX_AGE_EXCEEDED, EXPIRATION_DATE_NOT_DETECTED, DUPLICATED_DOCUMENT, FRAUD_RISK_FROM_OCR, COUNTRY_NOT_ALLOWED, DOCUMENT_TYPE_NOT_ALLOWED.
Full catalogue: /core-technology/id-verification/warnings-id-verification.

\# Failure modes to handle
\- HTTP 403 "You don't have enough credits..." — insufficient balance.
\- HTTP 400 with multipart validation errors (missing back_image on dual-sided docs, file > 5 MB, unsupported extension).
\- status="Declined" with one or more terminal warnings (DOCUMENT_EXPIRED, DOCUMENT_LIVENESS_FAILED, COULD_NOT_RECOGNIZE_DOCUMENT, etc.) — surface the first warning's long_description to the user and stop the flow.
\- status="In Review" with a DOCUMENT_LIVENESS_NOT_COMPUTED warning — the requested forgery check produced no usable score (provider error or crash); treat the document as unchecked and route it to your manual-review queue.
\- status="In Review" — route to your manual-review queue; do not approve the user.

\# See also
\- Canonical schema: /reference/data-models#id-verification
\- Full integration playbook: /integration/integration-prompt
\- Risk catalogue: /core-technology/id-verification/warnings-id-verification
\- Per-feature report: /core-technology/id-verification/report-id-verification````

\</pre>



      
      

Вставьте в

![Этапы верификации личности Didit: от съёмки документа до AI-анализа и решения](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-verification-steps.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=42c64546f3495000d7ea3b10c4b5fa50)**1. Интеллектуальная съёмка**Начните процесс верификации без усилий с помощью нашей интуитивной системы съёмки на базе AI. Пользователи загружают или фотографируют документы, удостоверяющие личность, и получают подсказки в реальном времени:* **Автоопределение** типа документа и страны выдачи
* **Визуальные подсказки в реальном времени** для правильного положения, освещения и фокуса
* **Автоматическая съёмка**, когда условия идеальны, без необходимости повторять попытки вручную
* Поддерживаются **паспорта**, **водительские удостоверения**, **национальные ID-карты** и **виды на жительство**> [!NOTE]
>
> *Почему это важно*: Интеллектуальная съёмка упрощает процесс для пользователя и обеспечивает высокое качество материалов уже с первой попытки, что повышает коэффициент конверсии и доверие.**2. Расширенная обработка данных**Извлечение и проверка данных, удостоверяющих личность, с беспрецедентной точностью.**Извлечение данных**: современная технология обрабатывает все ключевые поля:| Возможность | Подробности |
| - | - |
| **Извлечение полей** | Полное имя, дата рождения, номер документа, даты выдачи и окончания срока действия, гражданство и другие данные |
| **OCR** | Высокоточное распознавание текста |
| **Разбор MRZ** | Декодирование машиносчитываемой зоны |
| **Декодирование штрихкодов** | Автоматическое извлечение данных из штрихкода |**Проверка данных**:* Перекрёстная сверка данных визуальных зон, MRZ и штрихкодов для проверки согласованности
* Криптографическая проверка штрихкодов, подписанных эмитентом, там, где орган публикует сертификаты, необходимые для проверки. Сейчас поддерживаются французские национальные ID-карты: их штрихкод ANTS 2D-Doc проверяется по сертификату подписанта, который ведёт к доверенному списку ANTS. Поэтому штрихкод, не подписанный органом, выявляется, даже если его содержимое выглядит согласованным
* Проверка формата и шаблонов для выявления аномалий
* Запросы в реальном времени к государственным базам данных (где это разрешено) для авторитетной проверки> [!NOTE]
>
> *Почему это важно*: Полная обработка данных обеспечивает точность, исключает ошибки и даёт уверенность в каждой верификации.**3. Расширенный анализ**Наша система на базе AI выполняет полный набор проверок, чтобы подтвердить целостность и подлинность документа:- Проверка **подлинности документа**
- **Обнаружение вмешательства** и анализ целостности изображения
- **Проверка живости документа** для предотвращения мошенничества, связанного со следующим:
  * Снимков экрана цифровых документов
  * Фотографий документов, показанных на экране
  * Печатных копий документов
  * Подделанных документов с изменёнными портретами
- **Проверка защитных элементов** (голограмм, водяных знаков и других)
- **Сопоставление с шаблонами** в сертифицированной базе данных**4. Результаты и интеграция**Мгновенно получайте результаты, на основе которых можно действовать, с гибкими вариантами доставки.**Результаты в реальном времени**:- Мгновенные обновления через понятную панель управления
- Мгновенные уведомления webhook для автоматизированных сценариев
- RESTful API для бесшовной интеграции в ваши существующие системы**Полная отчётность**:* Подробные PDF-отчёты с результатами верификации и доказательствами
* Журналы аудита для соответствия требованиям и ведения записей
* Настраиваемые параметры в соответствии с вашими операционными потребностями> [!NOTE]
>
> *Почему это важно*: Быстрые и доступные результаты позволяют вашей команде действовать оперативно, сохраняя безопасный и поддающийся аудиту процесс.***## Три способа верификацииОдним из трёх [методов верификации личности](https://docs.didit.me/ru/core-technology/id-verification/verification-methods.md) является съёмка документа. Для каждой страны можно также позволить людям подтвердить личность без документа вовсе:- **[Проверка без документа](https://docs.didit.me/ru/core-technology/id-verification/non-doc-lookup.md)**: пользователь вводит номер национального ID и несколько персональных данных, а мы сверяем их с государственным реестром или другим авторитетным источником, название которого зависит от страны. Если этот источник возвращает портрет, в проверку входят селфи, пассивная проверка живости и сравнение лиц.
- **[Цифровые ID-кошельки](https://docs.didit.me/ru/core-technology/id-verification/digital-id-wallets.md)**: пользователь входит с помощью государственной или банковской цифровой идентичности, например MitID, BankID или itsme, и кошелёк передаёт подписанный набор атрибутов.Всё, что описано на этой странице, относится к съёмке документа, и это не меняется. Сценарий, в котором не сказано о методах, остаётся только со съёмкой документа.***## Требования к документамДля успешной верификации документы должны соответствовать этим стандартам:#### Общие требования- Выданы государством и действительны в пределах настроенного срока действия
- Физически целы (без повреждений, царапин или пятен, скрывающих данные)
- Вся важная информация (полное имя, дата рождения, MRZ и др.) чётко читаема
- Данные согласованы во всех предоставленных документах#### Требования к изображениям- Оригинальное фото, сделанное в реальном времени (без скриншотов, сканов или цифровых копий)
- Поддерживаемые форматы: JPG, JPEG, PNG, PDF
- Максимальный размер файла: 5 МБ
- Цветное изображение, на котором видны все углы документа
- Без бликов, теней, цифровой правки или манипуляций
- Требуются физические документы (цифровые ID поддерживаются только в отдельных регионах, где они официально признаны)## Дополнительные настройки по стране и типу документаНастраивайте детальные правила для каждой страны и типа документа прямо в консоли. Эти параметры позволяют адаптировать критерии приёмки и предпочтения при транскрибации под требования вашего комплаенса.![Панель дополнительных настроек верификации документов Didit с правилами истечения срока и приёмки по странам](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/id-additional-settings.jpeg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=4238b10a404795a61926fbdf1a3adc20)* **Expiration mode**: выберите, как обрабатывать документы с истёкшим сроком действия.

  * **Reject expired**: если срок действия документа раньше сегодняшней даты, документ помечается как истёкший и отклоняется.
  * **Allow expired**: документы с истёкшим сроком действия не помечаются и не блокируются.

  Эта настройка также управляет мониторингом после одобрения, который включён по умолчанию. При **Reject expired** одобренная сессия переходит в статус `"Kyc Expired"`, когда срок действия документа истекает, и срабатывает событие `status.updated`. При **Allow expired** сессия остаётся одобренной и не отслеживается. См. [мониторинг документов](https://docs.didit.me/ru/core-technology/id-verification/document-monitoring-id-verification.md).
  В API сценариев настройка `expiration_check_mode` для документа конкретной страны принимает значения `strict` (**Reject expired**), `allow_expired` (**Allow expired**) и `local_regulation`.
  Значение `local_regulation` применяет правило страны, если Didit его знает, а во всех остальных случаях отклоняет истёкшие документы.
  Любое другое значение отклоняется.
* **Preferred character format**: выберите, как нормализовать извлечённые имена и поля.
  * **Prefer Latin characters (A–Z)**: пример: "Mohammed"
  * **Prefer original script (non‑Latin)**: пример: "محمد"
* **Regional support & subtypes**: включайте документы по регионам и указывайте допустимые подтипы, если у типа документа много вариантов.
  * Пример: для водительских прав Соединённых Штатов выберите точные подтипы, которые вы принимаете (например, Arizona Commercial Driver License, Indiana Operator License (REAL ID), New York Enhanced Driver License и т. д.).
  * Используйте элемент управления **Accepted subtypes**, чтобы быстро включить или исключить множество вариантов (например, «выбрано 128»).> Совет: эти настройки применяются для каждой страны и типа документа, поэтому на одних рынках можно задать строгие правила, а на других более мягкие.## Возрастные ограничения по странамЗадавайте минимальное и максимальное возрастное ограничение для каждой страны во время верификации личности. Система извлекает дату рождения пользователя из представленного документа и сверяет её с возрастными границами, настроенными для страны выдачи документа.### НастройкаВозрастные ограничения настраиваются в виде таблицы по странам прямо в консоли:| Столбец | Описание |
| - | - |
| **Страна** | Страна выдачи документа (ISO 3166-1 alpha-3). Отображаются только страны, включённые в список разрешённых документов. |
| **Мин. возраст** | Минимально допустимый возраст. Для пользователей младше этого значения выполняется настроенное действие (**Отклонить** или **Ручная проверка**). |
| **Макс. возраст** | Максимально допустимый возраст. Для пользователей старше этого значения выполняется настроенное действие. Оставьте поле пустым, если верхнего ограничения нет. |
| **Переопределения для штатов/регионов** | Для стран с возрастными различиями внутри страны (например, Соединённые Штаты, Мексика) откройте значок настроек, чтобы задать минимальный и максимальный возраст для каждого штата. Эти значения переопределяют настройки на уровне страны. |### Значения по умолчанию: совершеннолетиеВ консоли есть кнопка **"Apply age of majority"**, которая автоматически заполняет минимальный возраст каждой страны установленным законом возрастом совершеннолетия (в большинстве стран 18 лет, с исключениями, например 19 лет в Южной Корее, 21 год в ОАЭ, 20 лет в Новой Зеландии и т. д.). Затем вы можете изменить значения для отдельных стран или добавить переопределения для штатов по мере необходимости.### Переопределения для штатов и регионовВ некоторых странах законные возрастные пороги зависят от штата или региона. Когда документ сканируется, система OCR извлекает из него регион (например, "Mississippi", "Alabama", "Jalisco"). Если для этого региона настроено переопределение, оно имеет приоритет над возрастной настройкой на уровне страны.Например, если для Соединённых Штатов задан минимальный возраст 18 лет, а для Миссисипи переопределение составляет 21 год, пользователь, предъявивший водительские права штата Миссисипи, будет проверен на соответствие минимальному возрасту 21 год.### Настраиваемые действияЕсли возраст пользователя выходит за пределы настроенного диапазона для страны (или штата) его документа, можно выбрать действие:* **Отклонить**: сессия автоматически отклоняется.
* **Проверка**: сессия отмечается для ручной проверки.> [!NOTE]
>
> Возрастные ограничения по странам также работают в сценариях **Adaptive Age Verification**. Когда пограничный случай запускает резервную верификацию личности, проверка возраста использует эти настройки для каждой страны и принимает окончательное решение на основе страны выдачи документа и региона.


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