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

# Сравнение лиц 1:1 (Face Match API): селфи и документ

> Didit сравнивает селфи с фото в документе на базе ИИ. Оценка совпадения < 2 с, $0.05 за запрос, $10 бесплатно каждый месяц для KYC и онбординга.

Didit Сравнение лиц выполняет сопоставление двух лиц 1:1, как правило, селфи из проверки живости с портретом в документе, удостоверяющем личность пользователя, и возвращает оценку совпадения от 0 до 100. Настроенные вами пороги определяют, пройдена ли проверка; отдельный API `POST /v3/face-match/` по умолчанию отклоняет результат с оценкой 30 или ниже.В уроке Академии, посвящённом разбору результатов верификации, на отметке 6:16 рассматривается проверка сравнения лиц внутри реальной сессии.[Сравнение лиц — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=376\&rel=0\&playsinline=1)

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



      
      

\<pre>

\````# Goal
Integrate Didit Face Match (1:1 — compare two faces) into your app. Pick ONE mode.

\# Mode A — Session-based
Use this when the user goes through a hosted Didit flow. Face Match runs alongside ID Verification (uses the document portrait as ref) and Liveness (uses the live selfie as user_image).

1\. Add the FACE_MATCH feature to a workflow that also runs ID_VERIFICATION + LIVENESS (Business Console or POST /v3/workflows/).
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user (or mount the Web/Mobile SDK).
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

Decision surface: `face_matches[]` array on the decision payload.

\# Mode B — Standalone API (server-to-server)
Use when you already have two images and want a one-shot 1:1 similarity score.

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

Required: `user_image` (live capture) and `ref_image` (reference portrait). JPEG/PNG/WebP/TIFF, max 5 MB each.

curl example:
\```bash
curl -X POST 'https://verification.didit.me/v3/face-match/' \
-H 'x-api-key: YOUR_API_KEY' \
-F 'user_image=@./selfie.jpg' \
-F 'ref_image=@./id_portrait.jpg' \
-F 'save_api_request=true' \
-F 'vendor_data=user-123'
\```
Returns: { request_id, face_match: { status, score (0-100), user_image: {entities}, ref_image: {entities}, warnings: [...] } }. `status` is "Approved" when score > face_match_score_decline_threshold (default 30), else "Declined".

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

\# Warnings (LogWarningChoices.FACEMATCH)
warnings[] risk codes include:
LOW_FACE_MATCH_SIMILARITY, NO_REFERENCE_IMAGE, NO_FACE_DETECTED, MULTIPLE_FACES_DETECTED.
Full catalogue: /core-technology/face-match/warnings-face-match.

\# Failure modes to handle
\- HTTP 403 — out of credits.
\- HTTP 400 — missing user_image or ref_image, file too large, unsupported extension.
\- status="Declined" with LOW_FACE_MATCH_SIMILARITY — the two faces do not match; do not approve.
\- NO_REFERENCE_IMAGE / NO_FACE_DETECTED — capture problems; ask the user to retry.

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

\</pre>



      
      

Вставьте в

![Обзор шагов верификации личности](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)## Повторные попытки и понятная обратная связьВ сессии Didit сравнение лиц, завершившееся неудачей по **устранимой причине съёмки** (селфи слишком тёмное, размытое, не по центру или сходство находится на грани), не приводит к немедленному отклонению. Пользователю предлагается **повторить попытку с подсказками** в пределах настраиваемого числа попыток — точно так же, как и при [Проверке живости](https://docs.didit.me/ru/core-technology/liveness/overview.md).* **Лимит попыток** — параметр `face_match_max_attempts` управляет общим количеством попыток сравнения лиц за сессию. По умолчанию **3** (одна начальная попытка плюс две повторные), настраивается для каждого узла сценария (диапазон от 1 до 3).

* **Обратная связь при повторной попытке** — пока остаются попытки, ошибка, допускающая исправление, оставляет пользователя на текущем шаге и возвращает `feedback_codes` (Web и Mobile SDK автоматически отображают их в виде подсказок):

  ```json theme={null}
  {
    "detail": "Make sure your face matches your document photo, improve lighting and try again.",
    "error": "LOW_FACE_MATCH_SIMILARITY",
    "feedback_codes": ["LOW_FACE_MATCH_SIMILARITY"],
    "attempts_used": 1,
    "max_attempts": 3
  }
  ```

* **Исчерпание лимита** — как только лимит попыток исчерпан, применяется рассчитанный статус (`Declined` или `In Review`).> [!NOTE]
>
> Повторные попытки действуют только в **потоке сессии**. Отдельный endpoint `POST /v3/face-match/` работает без сохранения состояния и выполняется за один раз — он возвращает оценку совпадения напрямую без лимита повторных попыток.## Как это работает**1. Интеллектуальная съёмка**Легко начните процесс верификации с помощью нашей интуитивно понятной системы съёмки на базе ИИ.Пользователи загружают или фотографируют свои документы, удостоверяющие личность, с подсказками в реальном времени:| Функция | Описание |
| - | - |
| **Автоопределение** | Автоматически определяет тип документа и страну выдачи |
| **Подсказки в реальном времени** | Визуальные подсказки для оптимального положения, освещения и фокуса |
| **Умная съёмка** | Автоматическая съёмка при идеальных условиях — никаких ручных повторных попыток |
| **Широкая поддержка** | Паспорта, водительские удостоверения, национальные ID-карты и виды на жительство |> [!NOTE]
>
> *Почему это важно*: наша интеллектуальная съёмка упрощает процесс для пользователей и обеспечивает высокое качество снимков с первой попытки, повышая коэффициент конверсии и доверие.**2. Продвинутая обработка данных**Извлекайте и проверяйте идентификационные данные с непревзойдённой точностью.**Извлечение данных** — передовые технологии обрабатывают все ключевые поля:| Возможность | Подробности |
| - | - |
| **Извлечение полей** | Полное имя, дата рождения, номер документа, даты выдачи/истечения срока действия, гражданство и многое другое |
| **OCR** | Высокоточное оптическое распознавание символов для текста |
| **Парсинг MRZ** | Парсинг машиносчитываемой зоны (MRZ) и декодирование штрихкодов |**Проверка данных**:* Перекрёстная сверка данных между визуальными зонами, MRZ и штрихкодами на согласованность
* Проверка формата и шаблонов для выявления аномалий
* Запросы в реальном времени к государственным базам данных (где разрешено) для достоверной проверки> [!NOTE]
>
> *Почему это важно*: комплексная обработка данных гарантирует точность и исключает ошибки, обеспечивая уверенность в каждой верификации.**3. Глубокий анализ**Наша система на базе ИИ выполняет комплексные проверки:- Проверка подлинности документов
- Обнаружение признаков подделки и анализ целостности изображения
- Проверка защитных элементов (голограммы, водяные знаки и т. д.)
- Сверка шаблонов с сертифицированной базой данных**Проверка живости документов предотвращает мошенничество** при следующих атаках:| Тип атаки | Описание |
| - | - |
| **Снимки с экрана** | Цифровые документы, сфотографированные с экрана |
| **Повторное воспроизведение с экрана** | Фотографии документов, отображаемых на экранах |
| **Печатные копии** | Физические копии оригинальных документов |
| **Изменённые портреты** | Подделанные документы с заменёнными или отредактированными фотографиями |**4. Удобные результаты и интеграция**Мгновенно получайте практические выводы, на основе которых можно действовать, благодаря гибким вариантам доставки.**Результаты в реальном времени**:| Канал | Описание |
| - | - |
| **Панель управления** | Мгновенные обновления через интуитивно понятную панель управления |
| **Webhook** | Мгновенные уведомления через webhook для автоматизированных сценариев |
| **REST API** | Бесшовная интеграция в ваши существующие системы |**Подробная отчётность**:* Детальные PDF-отчёты с результатами верификации и подтверждающими материалами
* Журналы аудита для комплаенса и ведения учёта
* Настраиваемые параметры в соответствии с вашими операционными потребностями> [!NOTE]
>
> *Почему это важно*: быстрые и доступные результаты позволяют вашей команде действовать оперативно, сохраняя при этом безопасность и возможность аудита процесса.***## Требования к документамДля успешной верификации документы должны соответствовать следующим стандартам:#### Общие требования- Выданы государственным органом и действительны в пределах настроенного срока действия
- Физически целы (без повреждений, царапин или пятен, скрывающих детали)
- Вся важная информация (полное имя, дата рождения, MRZ и т. д.) отчётливо читаема
- Согласованность данных во всех предоставленных документах#### Требования к изображениям- Оригинальная фотография, сделанная в реальном времени (без скриншотов, сканов или цифровых копий)
- Поддерживаемые форматы: JPG, JPEG, PNG, PDF
- Максимальный размер файла: 5MB
- Полноцветное изображение, на котором видны все углы документа
- Отсутствие бликов, теней, цифрового редактирования или следов манипуляций
- Требуются физические документы (цифровые удостоверения личности поддерживаются только в отдельных регионах, где они официально признаны)## Дополнительные настройки по странам и типам документовНастраивайте точечные правила для каждой страны и типа документа прямо в консоли. Эти параметры позволяют адаптировать критерии приёма и предпочтения транскрипции под ваши комплаенс-требования.![Панель расширенных настроек 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**: не отмечать и не блокировать документы с истёкшим сроком действия.
* **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 selected").> Совет: эти настройки применяются для каждой страны и типа документа отдельно, поэтому вы можете задать строгие правила на одних рынках и более мягкие на других.


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