> ## 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 проверки на мошенничество

> Проверка на мошенничество через API Didit: выбранные проверки личности, контактов, обогащения данных и сетевых связей в одном запросе.

Отправляйте введённые вручную идентификаторы и заявленные атрибуты личности, выбирайте проверки для запуска и изучайте результат каждой отдельно.
Сначала воспользуйтесь [Планированием проверки на мошенничество](https://docs.didit.me/ru/standalone-apis/fraud-check-plan.md), чтобы уточнить требования к входным данным и ожидаемую стоимость.

## Выбор профиля

Закрепите `profile_version`, чтобы выбранные значения по умолчанию и политика принятия решений были явными.
Профиль по умолчанию: `standard`, версия `2026-08-27`.
Версия `2026-09-14` добавляет необязательное социальное обогащение данных по email и телефону и фиксирует каждую завершённую проверку как нативную сессию Проверки пользователей.
В этой версии платные дополнения подключаются только по явному выбору.
Версия `2026-09-14.1` также включает поиск по идентификаторам в глобальной сети мошенничества для организаций на тарифе Enterprise, которые участвуют в глобальном обмене данными.
Версия `2026-09-14.2` добавляет необязательную проверку соответствия селфи и CPF для Бразилии.
Более ранние версии сохраняют исходное поведение.

Текущие профили поддерживают проверку риска по email, телефону и IP, проверку по базам данных там, где она доступна, и историю по приватной сети вашего приложения.
Биометрическая привязка по селфи требует версии `2026-09-14.2`.
При выборе этой версии в более ранних версиях возвращается `not_available_in_profile_version`.

## Заявленная личность и контекст

Передавайте email, телефон и государственные идентификаторы в `subject.identifiers`.
Для государственных идентификаторов необходимо указать страну выдачи; в регионах, где номера уникальны только в пределах региона, может потребоваться и орган выдачи.
Имена, дату рождения, гражданство и адрес передавайте в `subject.attributes`.
Это заявления, которые сверяются с данными выбранного источника, если он их поддерживает, а не проверенные факты только потому, что они были переданы.

Используйте `context` для IP-адреса попытки, пользовательского агента, цели, страны и любого обязательного подтверждения согласия.
Так информация о попытке верификации отделяется от информации о человеке.
Для поддерживаемых биометрических проверок передавайте `subject.selfie` как JPEG, PNG или WebP в кодировке base64, размером до 6 МБ.
Также принимается соответствующий URI данных изображения.
Не отправляйте эталонное изображение, удалённый URL или ключ хранилища.

## Селфи и заявленный идентификатор

Выберите `biometric_identity`, передайте бразильский идентификатор `tax_number` и селфи и подтвердите `context.consent_obtained`.
Проверка определяет, принадлежит ли это селфи заявленному владельцу CPF.
При отсутствии согласия возвращается `consent_required`, а для неподдерживаемых стран `unsupported_region`.
Модуль имеет цену за проверку, основанную на ставке проверки по базам данных вашей организации; перед запуском проверьте тариф.

Когда проверка возвращает ответ, `identity_relationship.result` принимает значение `match`, `mismatch` или `inconclusive`.
Неокончательный ответ требует ручной проверки и никогда не трактуется как несовпадение.
Результат лишь устанавливает связь между селфи и CPF.
Он не подтверждает переданные имя или дату рождения, не доказывает живость и не выполняет поиск лица в интернете или в глобальной сети мошенничества.
Имена и дата рождения остаются заявлениями, если только другой выбранный источник не предоставляет доказательства для этих полей.
Тайм-ауты и ошибки источников являются недоступными результатами и не тарифицируются.
Завершённые неокончательные ответы тарифицируются по той же ставке за проверку.
Селфи не включается в результат и не сохраняется этой проверкой в качестве медиафайла сессии.

## Выбор проверок

`checks.include` выбирает модули, а `checks.exclude` имеет приоритет.
Явно пустой список `include` отключает все необязательные операции; нормализация при этом выполняется.
Если `include` не указан, используются значения по умолчанию закреплённого профиля.
Социальное обогащение по email и телефону выбирается отдельно через `email_social` и `phone_social`.
Для них требуется корректный идентификатор, соответствующий переданным данным, и оно не отправляет OTP-код.

```json theme={null}
{
  "profile_version": "2026-09-14.1",
  "client_reference": "review-attempt-001",
  "subject": {
    "identifiers": [
      { "type": "email", "value": "applicant@example.com" }
    ],
    "attributes": { "first_name": "Alex", "last_name": "Example" }
  },
  "checks": { "include": ["networks_same_org", "networks_cross_org", "email_risk"] }
}
```

## Чтение результатов без их смешения

Каждый модуль сообщает свой статус выполнения, причину и тарифицируемые единицы.
`not_requested`, `excluded_by_caller`, `missing_required_input` и `source_unavailable` описывают разные исходы.
Отсутствие источника не означает несовпадения личности и не является результатом с нулевым риском.

`attribute_evidence` описывает доказательства на уровне полей, а `risk` отдельно учитывает аспекты личности, контакта, устройства, поведения и сети мошенничества.
Общий email, устройство или другой идентификатор является наблюдаемой связью, а не доказательством того, что два аккаунта принадлежат одному человеку или что владельцы этих аккаунтов совершили мошенничество.
`recommendation` является рекомендацией проверки; она не меняет статус другой записи.
Результаты социального обогащения выводятся в `enrichment`, при этом недоступные результаты отделены от завершённых.

## Глобальная сеть мошенничества

Выберите `networks_cross_org`, чтобы проверять поддерживаемые адреса электронной почты, номера телефонов и идентификаторы документов с корректно указанными пространствами имён по общей сети.
Для этого поиска нужен тариф Enterprise и режим обмена данными вашей организации `global`.
Без них тариф возвращает модуль с `available: false` и `availability_reason: "entitlement_required"`, а проверка, которая выбирает этот модуль, пропускает его со статусом `skipped` и причиной `entitlement_required`.
Та же причина применяется, если Networks не включен для вашей организации.
Песочница не ограничивается тарифом или режимом обмена данными: при поддерживаемом идентификаторе модуль выполняется и возвращает пустой пример результата.
Поиск использует существующий бюджет чтения организации и записывает в аудит факт чтения.
За каждый поиск отдельной оплаты нет.
Планирование проверки не запрашивает общий индекс и не расходует его бюджет чтения.

`network.cross_organization` содержит `signals_checked` и раскрытые агрегированные `insights` после завершения проверки.
Каждый инсайт содержит тип сигнала, классы исходов, количество источников, предоставивших данные, временной интервал давности и отраслевые категории, но только если раскрытие включено.
Он никогда не указывает на другую организацию, аккаунт, человека или верификацию.
Результаты ниже порога раскрытия не показываются; пустой список не доказывает отсутствие истории мошенничества.
Раскрытый общий сигнал приводит к рекомендации проверки, но никогда не ведет к автоматическому отклонению или к признанию совпадения личности.

Недоступный поиск сообщает свою причину отдельно от пустого завершенного поиска.
Если ваша организация позже теряет доступ к межорганизационной сети, например после смены тарифа или когда режим обмена данными перестает быть `global`, получение результатов, повторные попытки и данные сессии скрывают общие агрегаты и производные данные о риске, основанные на них.
Исходная рекомендация остается историческим решением; чтение не меняет статус верификации.

## Сессии, повторные попытки и списания

`check_id` получает сохраненный результат через [Get a Fraud Check](https://docs.didit.me/ru/standalone-apis/fraud-check-result.md).
Если `request_id` присутствует, он указывает на нативную сессию верификации этой проверки.
Версии `2026-09-14`, `2026-09-14.1` и `2026-09-14.2` всегда создают эту сессию, в том числе когда выбрана только история частной сети.

Повторное использование `client_reference` с тем же телом запроса возвращает исходный результат без повторного выполнения и без списания, пока эта проверка существует.
Другое тело запроса с тем же референсом возвращает `409`.
Если выполнение еще идет, повторите тот же запрос после интервала из заголовка ответа `Retry-After`.
Удаление связанной верификации также удаляет результат Fraud Check; после этого получение возвращает `404`.
Проверка, удаленная во время выполнения, не может опубликовать завершенный результат.

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


## OpenAPI

````yaml ru/openapi-25.json POST /v3/fraud/checks/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: >-
    API верификации личности. Аутентификация выполняется с помощью заголовка
    x-api-key.
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/fraud/checks/:
    post:
      tags:
        - Fraud Check
      summary: Запустить проверку на мошенничество
      description: >-
        Отправьте один или несколько типизированных идентификаторов и получите
        нормализацию, актуальное обогащение, авторитетную валидацию при
        поддержке страны и типа идентификатора, независимые измерения риска и
        рекомендацию в одном ответе.


        Эти профили поддерживают проверку идентификаторов. Привязка личности на
        основе селфи (`biometric_identity`) требует версии профиля
        `2026-09-14.2` и бразильского CPF; она выполняется только с согласия
        пользователя и при наличии прав у вашей организации. Более ранние версии
        возвращают статус `not_available_in_profile_version`. Модули, выполнение
        которых невозможно, отмечаются как пропущенные с детерминированной
        причиной; источник, который не смог ответить, никогда не
        интерпретируется как несовпадение данных личности.
      operationId: create_fraud_check
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/FraudCheckRequestRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/FraudCheckRequestRequest'
            example:
              client_reference: review-attempt-001
              subject:
                identifiers:
                  - type: email
                    value: applicant@example.com
                attributes:
                  first_name: Alex
                  last_name: Example
              checks:
                include:
                  - networks_same_org
                  - networks_cross_org
                  - email_risk
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/FraudCheckRequestRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FraudCheckResponse'
          description: ''
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FraudClientCredentialsErrorMessage'
          description: ''
        '403':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/FraudClientCredentialsForbiddenErrorMessage
          description: ''
        '409':
          description: >-
            Конфликт, возвращается без списания средств: `client_reference` уже
            использовался с другим телом запроса; проверка с таким же
            `client_reference` всё ещё выполняется (повторите попытку через
            количество секунд, указанное в `Retry-After`, с тем же референсом);
            либо верификация, к которой привязана эта проверка, была удалена до
            её завершения.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
              examples:
                different_body:
                  summary: Идентификатор повторно использован с другим телом запроса
                  value:
                    error: >-
                      client_reference has already been used with a different
                      request body.
                still_running:
                  summary: Проверка с этим идентификатором всё ещё выполняется
                  value:
                    error: >-
                      A check with this client_reference is already running.
                      Retry with the same reference later.
                verification_deleted:
                  summary: Верификация была удалена до завершения проверки
                  value:
                    error: This verification was deleted before the check completed.
          headers:
            Retry-After:
              description: >-
                Количество секунд ожидания перед повторной попыткой;
                отправляется, когда проверка с тем же `client_reference` всё ещё
                выполняется.
              schema:
                type: integer
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
      x-codeSamples:
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.fraud_checks.create(
                client_reference="review-attempt-001",
                subject={
                    "identifiers": [{
                        "type": "email",
                        "value": "applicant@example.com",
                    }],
                    "attributes": {
                        "first_name": "Alex",
                        "last_name": "Example",
                    },
                },
                checks={
                    "include": ["networks_same_org", "networks_cross_org", "email_risk"],
                },
            )
            print(result)
        - lang: javascript
          label: Node.js
          source: |-
            import Didit from "@didit-protocol/sdk-node";

            // Reads DIDIT_API_KEY.
            const didit = new Didit();

            const result = await didit.fraudChecks.create({
              client_reference: "review-attempt-001",
              subject: {
                identifiers: [{
                  type: "email",
                  value: "applicant@example.com",
                }],
                attributes: {
                  first_name: "Alex",
                  last_name: "Example",
                },
              },
              checks: {
                include: ["networks_same_org", "networks_cross_org", "email_risk"],
              },
            });
            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.FraudChecks.Create(ctx, didit.FraudCheckRequestRequest{\n\tClientReference: didit.String(\"review-attempt-001\"),\n\tSubject: didit.FraudCheckSubjectRequest{\n\t\tIdentifiers: []didit.FraudCheckIdentifierRequest{{\n\t\t\tType:  didit.FraudTypeEnum(\"email\"),\n\t\t\tValue: \"applicant@example.com\",\n\t\t}},\n\t\tAttributes: didit.Some(didit.FraudCheckAttributesRequest{\n\t\t\tFirstName: didit.String(\"Alex\"),\n\t\t\tLastName:  didit.String(\"Example\"),\n\t\t}),\n\t},\n\tChecks: didit.Some(didit.FraudCheckModuleSelectionRequest{\n\t\tInclude: didit.Some([]didit.FraudExcludeEnum{didit.FraudExcludeEnum(\"networks_same_org\"), didit.FraudExcludeEnum(\"networks_cross_org\"), didit.FraudExcludeEnum(\"email_risk\")}),\n\t}),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)"
        - lang: java
          label: Java
          source: >-
            import java.util.List;

            import me.didit.Didit;

            import me.didit.types.FraudCheckAttributesRequest;

            import me.didit.types.FraudCheckIdentifierRequest;

            import me.didit.types.FraudCheckModuleSelectionRequest;

            import me.didit.types.FraudCheckRequestRequest;

            import me.didit.types.FraudCheckSubjectRequest;

            import me.didit.types.FraudExcludeEnum;

            import me.didit.types.FraudTypeEnum;


            // Reads DIDIT_API_KEY.

            Didit client = new Didit();


            var result =
            client.fraudChecks().create(FraudCheckRequestRequest.builder()
                    .clientReference("review-attempt-001")
                    .subject(FraudCheckSubjectRequest.builder()
                            .identifiers(List.of(FraudCheckIdentifierRequest.builder()
                                    .type(FraudTypeEnum.of("email"))
                                    .value("applicant@example.com")
                                    .build()))
                            .attributes(FraudCheckAttributesRequest.builder()
                                    .firstName("Alex")
                                    .lastName("Example")
                                    .build())
                            .build())
                    .checks(FraudCheckModuleSelectionRequest.builder()
                            .include(List.of(FraudExcludeEnum.of("networks_same_org"), FraudExcludeEnum.of("networks_cross_org"), FraudExcludeEnum.of("email_risk")))
                            .build())
                    .build());
            System.out.println(result);
        - lang: php
          label: PHP
          source: |-
            <?php

            require 'vendor/autoload.php';

            use Didit\DiditClient;

            // Reads DIDIT_API_KEY.
            $didit = new DiditClient();

            $result = $didit->fraudChecks->create([
                'client_reference' => 'review-attempt-001',
                'subject' => [
                    'identifiers' => [[
                        'type' => 'email',
                        'value' => 'applicant@example.com',
                    ]],
                    'attributes' => [
                        'first_name' => 'Alex',
                        'last_name' => 'Example',
                    ],
                ],
                'checks' => [
                    'include' => ['networks_same_org', 'networks_cross_org', 'email_risk'],
                ],
            ]);
            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: |-
            require "didit"

            # Reads DIDIT_API_KEY.
            didit = Didit::Client.new

            result = didit.fraud_checks.create(
              client_reference: "review-attempt-001",
              subject: {
                identifiers: [{
                  type: "email",
                  value: "applicant@example.com",
                }],
                attributes: {
                  first_name: "Alex",
                  last_name: "Example",
                },
              },
              checks: {
                include: ["networks_same_org", "networks_cross_org", "email_risk"],
              }
            )
            puts result.to_h
        - lang: csharp
          label: .NET
          source: >-
            using System;

            using System.Text.Json;

            using Didit;


            // Reads DIDIT_API_KEY.

            using var client = new DiditClient();


            var result = await client.FraudChecks.CreateAsync(new
            FraudCheckRequestRequest

            {
                ClientReference = "review-attempt-001",
                Subject = new()
                {
                    Identifiers = new FraudCheckIdentifierRequest[]
                    {
                        new()
                        {
                            Type = "email",
                            Value = "applicant@example.com",
                        },
                    },
                    Attributes = new FraudCheckAttributesRequest
                    {
                        FirstName = "Alex",
                        LastName = "Example",
                    },
                },
                Checks = new FraudCheckModuleSelectionRequest
                {
                    Include = new FraudExcludeEnum[] { "networks_same_org", "networks_cross_org", "email_risk" },
                },
            });

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    FraudCheckRequestRequest:
      type: object
      properties:
        client_reference:
          type: string
          minLength: 1
          description: >-
            Ваш собственный идентификатор этой проверки. Также служит ключом
            идемпотентности: повторное использование с тем же телом запроса
            возвращает исходную проверку без повторного запуска или списания
            средств за модули; повторное использование с другим телом запроса
            возвращает 409.
          maxLength: 255
        profile:
          type: string
          minLength: 1
          default: standard
          description: >-
            Идентификатор профиля оркестрации. По умолчанию используется профиль
            Didit `standard`.
          maxLength: 64
        profile_version:
          type: string
          minLength: 1
          description: >-
            Закрепить зафиксированную версию профиля. По умолчанию используется
            текущая версия профиля.
          maxLength: 32
        subject:
          $ref: '#/components/schemas/FraudCheckSubjectRequest'
        context:
          $ref: '#/components/schemas/FraudCheckContextRequest'
        checks:
          $ref: '#/components/schemas/FraudCheckModuleSelectionRequest'
        vendor_data:
          type: string
          maxLength: 1000
        metadata: {}
      required:
        - subject
    FraudCheckResponse:
      type: object
      properties:
        check_id:
          type: string
          format: uuid
        request_id:
          type: string
          format: uuid
          description: Нативная сессия верификации, созданная для этой проверки.
        client_reference:
          type: string
          nullable: true
        processing_status:
          $ref: '#/components/schemas/FraudProcessingStatusEnum'
        profile_id:
          type: string
        profile_version:
          type: string
        created_at:
          type: string
          format: date-time
        completed_at:
          type: string
          format: date-time
          nullable: true
        inputs:
          type: array
          items:
            $ref: '#/components/schemas/FraudCheckInput'
        modules:
          type: array
          items:
            $ref: '#/components/schemas/FraudCheckModuleReport'
        attribute_evidence:
          type: array
          items:
            type: object
            additionalProperties: {}
        compound_evidence:
          type: array
          items:
            type: object
            additionalProperties: {}
        risk:
          type: array
          items:
            $ref: '#/components/schemas/FraudCheckRisk'
        network:
          type: object
          additionalProperties: {}
        enrichment:
          type: object
          additionalProperties: {}
        identity_relationship:
          allOf:
            - $ref: '#/components/schemas/FraudCheckIdentityRelationship'
          nullable: true
        recommendation:
          $ref: '#/components/schemas/FraudRecommendationEnum'
        next_action:
          $ref: '#/components/schemas/FraudNextActionEnum'
        decision_reasons:
          type: array
          items:
            type: string
        coverage:
          type: object
          additionalProperties: {}
        usage:
          type: array
          items:
            type: object
            additionalProperties: {}
        vendor_data:
          type: string
          nullable: true
        metadata:
          nullable: true
      required:
        - attribute_evidence
        - check_id
        - client_reference
        - completed_at
        - compound_evidence
        - coverage
        - created_at
        - decision_reasons
        - inputs
        - modules
        - network
        - next_action
        - processing_status
        - profile_id
        - profile_version
        - recommendation
        - risk
        - usage
    FraudClientCredentialsErrorMessage:
      type: object
      properties:
        detail:
          type: string
          default: 'Authentication failed: Invalid client access token.'
    FraudClientCredentialsForbiddenErrorMessage:
      type: object
      properties:
        detail:
          type: string
          default: Forbidden - User doesn't have permission
    FraudCheckSubjectRequest:
      type: object
      properties:
        selfie:
          type: string
          minLength: 1
          description: >-
            Селфи в формате Base64 JPEG, PNG или WebP размером до 6 МБ. Без
            эталонного изображения или URL.
          maxLength: 8388672
        identifiers:
          type: array
          items:
            $ref: '#/components/schemas/FraudCheckIdentifierRequest'
          description: >-
            Один или несколько типизированных идентификаторов. Достаточно
            одного.
          maxItems: 10
          minItems: 1
        attributes:
          $ref: '#/components/schemas/FraudCheckAttributesRequest'
      required:
        - identifiers
    FraudCheckContextRequest:
      type: object
      properties:
        ip_address:
          type: string
          minLength: 1
        user_agent:
          type: string
          maxLength: 512
        country:
          type: string
          description: >-
            Страна, в которой субъект заявляет о своём нахождении. Используется
            только как контекст и никогда не является доказательством того, что
            эта личность принадлежит данному субъекту.
          maxLength: 3
        purpose:
          type: string
          maxLength: 128
        consent_obtained:
          type: boolean
    FraudCheckModuleSelectionRequest:
      type: object
      properties:
        include:
          type: array
          items:
            $ref: '#/components/schemas/FraudExcludeEnum'
        exclude:
          type: array
          items:
            $ref: '#/components/schemas/FraudExcludeEnum'
    FraudProcessingStatusEnum:
      enum:
        - pending
        - running
        - completed
        - failed
      type: string
      description: |-
        * `pending` - В ожидании
        * `running` - Выполняется
        * `completed` - Завершено
        * `failed` - Не выполнено
    FraudCheckInput:
      type: object
      properties:
        reference:
          type: string
          description: Замаскированное значение переданного идентификатора.
        type:
          $ref: '#/components/schemas/FraudTypeEnum'
        namespace:
          type: object
          additionalProperties: {}
        quality:
          type: string
        normalization:
          type: object
          additionalProperties: {}
        availability:
          $ref: '#/components/schemas/FraudAvailabilityEnum'
      required:
        - availability
        - namespace
        - normalization
        - quality
        - reference
        - type
    FraudCheckModuleReport:
      type: object
      properties:
        module:
          $ref: '#/components/schemas/FraudExcludeEnum'
        status:
          $ref: '#/components/schemas/FraudStatusEnum'
        reason:
          type: string
          nullable: true
        latency_ms:
          type: integer
        freshness:
          type: string
          nullable: true
        billable_units:
          type: integer
      required:
        - billable_units
        - freshness
        - latency_ms
        - module
        - reason
        - status
    FraudCheckRisk:
      type: object
      properties:
        dimension:
          $ref: '#/components/schemas/FraudDimensionEnum'
        score:
          type: integer
          nullable: true
        band:
          $ref: '#/components/schemas/FraudBandEnum'
        availability:
          $ref: '#/components/schemas/FraudAvailabilityEnum'
        requested_but_unavailable:
          type: boolean
          description: >-
            True, когда в запросе было передано всё необходимое для данного
            измерения, но платформа всё равно не смогла предоставить ответ.
            Такая проверка никогда не рекомендуется к одобрению только на
            основании тех измерений, по которым был получен ответ.
        reason_codes:
          type: array
          items:
            type: string
        evidence_indexes:
          type: array
          items:
            type: integer
      required:
        - availability
        - band
        - dimension
        - evidence_indexes
        - reason_codes
        - requested_but_unavailable
        - score
    FraudCheckIdentityRelationship:
      type: object
      properties:
        result:
          $ref: '#/components/schemas/FraudResultEnum'
        reference_type:
          type: string
        country:
          type: string
        availability:
          $ref: '#/components/schemas/FraudAvailabilityEnum'
        reason_codes:
          type: array
          items:
            type: string
      required:
        - availability
        - country
        - reason_codes
        - reference_type
        - result
    FraudRecommendationEnum:
      enum:
        - approve
        - review
        - reject
      type: string
      description: |-
        * `approve` - Одобрить
        * `review` - На проверку
        * `reject` - Отклонить
    FraudNextActionEnum:
      enum:
        - none
        - manual_review
        - step_up
        - resubmit_capture
      type: string
      description: |-
        * `none` - Нет
        * `manual_review` - Ручная проверка
        * `step_up` - Дополнительная проверка
        * `resubmit_capture` - Повторная отправка снимка
    FraudCheckIdentifierRequest:
      type: object
      properties:
        type:
          allOf:
            - $ref: '#/components/schemas/FraudTypeEnum'
          description: >-
            Тип идентификатора. Определяет, какие поля пространства имён
            являются обязательными.


            * `email` - Электронная почта

            * `phone` - Телефон

            * `national_id` - Национальный идентификатор

            * `tax_number` - Налоговый номер

            * `passport_number` - Номер паспорта

            * `driving_licence_number` - Номер водительского удостоверения

            * `residence_permit_number` - Номер вида на жительство

            * `voter_id` - Идентификатор избирателя

            * `external_id` - Внешний идентификатор
        value:
          type: string
          minLength: 1
          description: Значение идентификатора в любом привычном формате.
          maxLength: 255
        country:
          type: string
          description: >-
            Страна выдачи в формате ISO-3166 alpha-2 или alpha-3. Обязательно
            для государственных идентификаторов: одинаковые цифры соответствуют
            разным людям в разных странах.
          maxLength: 3
        issuer:
          type: string
          description: >-
            Необязательный орган выдачи или субнациональный эмитент, если одной
            страны недостаточно для однозначной идентификации.
          maxLength: 128
      required:
        - type
        - value
    FraudCheckAttributesRequest:
      type: object
      description: Подтверждающие атрибуты. Все опциональны; они расширяют охват модулей.
      properties:
        first_name:
          type: string
          maxLength: 128
        last_name:
          type: string
          maxLength: 128
        full_name:
          type: string
          maxLength: 256
        date_of_birth:
          type: string
          format: date
        nationality:
          type: string
          maxLength: 3
        gender:
          type: string
          maxLength: 16
        address:
          type: string
          maxLength: 512
        city:
          type: string
          maxLength: 128
        state:
          type: string
          maxLength: 128
        postal_code:
          type: string
          maxLength: 32
    FraudExcludeEnum:
      enum:
        - normalization
        - email_risk
        - email_social
        - phone_social
        - phone_risk
        - ip_risk
        - database_validation
        - networks_same_org
        - networks_cross_org
        - biometric_identity
      type: string
      description: |-
        * `normalization` - Нормализация
        * `email_risk` - Риск электронной почты
        * `email_social` - Социальные профили электронной почты
        * `phone_social` - Социальные профили телефона
        * `phone_risk` - Риск телефона
        * `ip_risk` - Риск IP
        * `database_validation` - Проверка по базам данных
        * `networks_same_org` - Сети внутри организации
        * `networks_cross_org` - Межорганизационные сети
        * `biometric_identity` - Биометрическая идентификация
    FraudTypeEnum:
      enum:
        - email
        - phone
        - national_id
        - tax_number
        - passport_number
        - driving_licence_number
        - residence_permit_number
        - voter_id
        - external_id
      type: string
      description: |-
        * `email` - Электронная почта
        * `phone` - Телефон
        * `national_id` - Национальный идентификатор
        * `tax_number` - Налоговый номер
        * `passport_number` - Номер паспорта
        * `driving_licence_number` - Номер водительского удостоверения
        * `residence_permit_number` - Номер вида на жительство
        * `voter_id` - Удостоверение избирателя
        * `external_id` - Внешний идентификатор
    FraudAvailabilityEnum:
      enum:
        - available
        - not_requested
        - no_reference
        - insufficient_history
        - unsupported_region
        - source_unavailable
      type: string
      description: |-
        * `available` - Доступно
        * `not_requested` - Не запрашивалось
        * `no_reference` - Нет эталонных данных
        * `insufficient_history` - Недостаточно истории
        * `unsupported_region` - Регион не поддерживается
        * `source_unavailable` - Источник недоступен
    FraudStatusEnum:
      enum:
        - planned
        - completed
        - skipped
        - failed
      type: string
      description: |-
        * `planned` - Запланировано
        * `completed` - Завершено
        * `skipped` - Пропущено
        * `failed` - Не удалось
    FraudDimensionEnum:
      enum:
        - identity
        - contact
        - device_network
        - behavioral
        - fraud_network
      type: string
      description: |-
        * `identity` - Личность
        * `contact` - Контактные данные
        * `device_network` - Сеть и устройство
        * `behavioral` - Поведенческие факторы
        * `fraud_network` - Мошенническая сеть
    FraudBandEnum:
      enum:
        - low
        - medium
        - high
        - unknown
      type: string
      description: |-
        * `low` - Низкий
        * `medium` - Средний
        * `high` - Высокий
        * `unknown` - Неизвестно
    FraudResultEnum:
      enum:
        - match
        - mismatch
        - inconclusive
        - no_reference
      type: string
      description: |-
        * `match` - Совпадение
        * `mismatch` - Несовпадение
        * `inconclusive` - Неопределённый результат
        * `no_reference` - Нет эталонных данных
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в
        Business Console. Основной ключ имеет полный доступ. Именованный ключ
        может иметь ограниченную область действия: без доступа, чтение или
        запись для каждого ресурса, ограничение определенными сценариями или
        одобренными сессиями, списком IP-адресов и сроком действия. 401
        означает, что ключ неверен, отозван или его срок действия истек; 403
        означает, что ключ не был передан, у ключа нет доступа к этому ресурсу
        или действию, либо запрос поступил с адреса вне его списка IP-адресов;
        404 на маршруте сессии означает, что сессия не входит в сценарии или
        статусы ключа. Ключ без доступа к медиа получает URL изображений, видео
        и PDF как null, а ключ без прав на запись сессий получает ссылки на
        сессии и токены как null. См. https://docs.didit.me/console/api-keys.
    BearerAuth:
      type: http
      scheme: bearer
      description: Токен доступа приложения, полученный по учётным данным клиента.

````

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