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

# Верификация личности при регистрации и повторная проверка перед выплатами

> Didit: проверка живости или полная верификация личности до создания аккаунта, повторная проверка перед выплатами и подтверждённые данные в токенах.

Didit Authentication's verified identity просит людей подтвердить, кто они, в те моменты, которые вы выбираете: до создания аккаунта и повторно перед чувствительным действием, например, выплатой.
Ваше приложение получает результат и выбранные вами проверенные данные, например `over_18` или подтверждённое имя, в токенах пользователя. Документы и фотографии пользователя ваше приложение не получает никогда.

Настройте это в консоли в разделе **Authentication > Verified identity** или через API с помощью [`verified/`](#настройка-через-api).

![Страница Verified identity в Didit Business Console с уровнями проверки при регистрации и их ценами, а также правилами усиленной проверки перед чувствительными действиями](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-verified-identity.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=98544caeedf5ffaf68484cace19f9b3f)

Authentication > Verified identity: проверка при регистрации и правила перед чувствительными действиями.

## Как это работает

Каждая проверка выполняется как сессия верификации вашего приложения, созданная с `vendor_data` пользователя. Поэтому она появляется в ваших верификациях и у того же пользователя рядом с его входами и транзакциями, передаётся на ручную проверку, как любая другая верификация, и тарифицируется по цене этой верификации.

| Проверка | Что делает пользователь | Цена по тарифной таблице |
| - | - | - |
| Проверка живости | Делает одно селфи, которое проверяется на живость. | \$0.10 |
| Вход по селфи | Делает селфи, которое Didit сравнивает с лицом, уже сохранённым для этого пользователя. | \$0.10 |
| Полная проверка ID | Сканирует документ, удостоверяющий личность, и делает селфи: проверка документа, живости и сравнение лиц. | \$0.33 |

Didit выполняет каждую проверку по сценарию по умолчанию или по одному из ваших собственных сценариев, который вы выбираете для этой проверки. Цены на каждую верификацию см. в разделе [Цены](https://docs.didit.me/ru/getting-started/pricing.md).

## При регистрации

Выберите уровень проверки, который должен пройти человек, прежде чем будет создана его учётная запись:

| Уровень | Значение | Описание |
| - | - | - |
| Без верификации | `none` | Регистрироваться может любой, у кого есть адрес эл. почты, телефон или ключ доступа. Значение по умолчанию. |
| Проверка живости | `liveness` | Регистрируется реальный человек: одно селфи, проверенное на живость. |
| Полная верификация | `full_id` | Документ, проверка живости и сравнение лиц до создания учётной записи. |

Новый уровень применяется только к людям, которые регистрируются после его включения, и никогда не применяется к существующим учётным записям.

На размещённых страницах верификации Didit проводит человека через процедуру проверки во время регистрации. На ваших собственных экранах запрос на регистрацию возвращает `verification_required` с `verification_url`, который действует 30 минут: направьте человека по этой ссылке.
Didit выдаёт код входа только после того, как проверка одобрена.

## Step-up перед чувствительными действиями

Step-up (повторная верификация) просит человека подтвердить личность снова, только когда действие достаточно рискованное.
Вы включаете правила, а ваше приложение перед каждым чувствительным действием спрашивает Didit, применяется ли какое-либо из них.

![Телефон с запросом step-up, который просит человека подтвердить, что это он, с помощью селфи](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/step-up-preview.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=dd5087d0ba5f20b49bbd4252149ef8ca)

Что видит человек, когда step-up запрашивает селфи.

| Правило | Запрашивает, когда | Проверка по умолчанию |
| - | - | - |
| `payout` | Вывод средств или перевод выше вашего порога, например 500 в вашей валюте. Выплата в другой валюте проверяется всегда. | Вход по селфи |
| `device` | Выплата выполняется в сессии на устройстве, с которого не была выполнена ни одна из предыдущих сессий этого человека. | Вход по селфи |
| `bank` | Человек добавляет или меняет банковский счёт. | Полная верификация личности |
| `contact` | Человек меняет адрес электронной почты или номер телефона. | Проверка живости |

Вы можете изменить проверку для каждого правила на проверку живости, вход по селфи или полную верификацию личности.
Когда применяются несколько правил, Didit запрашивает самую строгую проверку.
Если у Didit пока нет лица этого человека, вход по селфи заменяется полной верификацией личности.

### Запросите step-up

Ваше приложение вызывает `POST {issuer}/step-up/` с токеном доступа человека или метод `stepUp()` из SDK:

```bash theme={null}
curl --fail-with-body "${DIDIT_AUTH_ISSUER}/step-up/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "payout", "amount": "900.00", "currency": "USD", "return_to": "https://app.example.com/payouts/confirm"}'
```

| Поле | Правило |
| - | - |
| `action` | `payout`, `bank` или `contact`. Для выплаты также применяется правило `device`. |
| `amount` | Обязательно для `payout`, не более чем с двумя знаками после запятой. |
| `currency` | Код ISO 4217. По умолчанию используется валюта вашего правила для выплат. |
| `return_to` | Куда человек вернётся после верификации. Если применяется правило, это должен быть один из ваших зарегистрированных [URL перенаправления](https://docs.didit.me/ru/authentication/overview.md#url-перенаправления). |

* `200 {"required": false}`: ни одно правило не применяется, можно продолжать.
* `201` с `verification_url`: отправьте человека по этому адресу. Step-up остаётся открытым 30 минут (`expires_in: 1800`).

### Считайте результат на своём бэкенде

Человек возвращается на `return_to` с добавленными параметрами `step_up=<id>&status=approved`, но этот параметр запроса ничего не доказывает.
Ваш бэкенд получает данные о step-up с помощью запроса `GET {issuer}/step-up/{step_up_id}/` с токеном доступа той же сессии и действует только тогда, когда `status` равен `approved`.

| Статус | Значение |
| - | - |
| `pending` | Человек ещё не завершил проверку. |
| `approved` | Человек прошёл проверку. Можно продолжать действие. |
| `review` | Проверка ожидает просмотра вашей командой. |
| `declined` | Человек не прошёл проверку. Результат не окончательный, пока `verification_url` работает: человек может попробовать снова, и step-up возвращается в `pending`. |
| `expired` | Прошли 30 минут. Создайте новый step-up. |
| `superseded` | Его заменила другая проверка, либо результат не относился к этому step-up. Создайте новый. |

Step-up никогда не пропускает действие при сбое: если верификация недоступна, действие остаётся заблокированным.
В [JavaScript](https://docs.didit.me/ru/authentication/quickstarts/javascript.md#повышение-уровня-проверки-и-повторная-аутентификация), [Next.js](https://docs.didit.me/ru/authentication/quickstarts/nextjs.md#усиленная-проверка-перед-чувствительными-действиями) и [iOS](https://docs.didit.me/ru/authentication/quickstarts/ios.md#повышенная-проверка-перед-чувствительными-действиями) быстрых стартах показана сторона SDK, а в [Справочнике API](https://docs.didit.me/ru/authentication/api-reference/create-step-up.md) приведён полный контракт.

## Что получает ваше приложение

Выберите, какие подтверждённые клеймы попадут в токены пользователя:

| Клейм | Значение |
| - | - |
| `over_18`, `over_21` | Достиг ли человек как минимум 18 или 21 года, согласно подтверждённой дате рождения. |
| `given_name`, `family_name` | Подтверждённые имя и фамилия. |
| `birthdate` | Дата рождения из документа, `YYYY-MM-DD`. |
| `nationality` | Код ISO 3166-1 alpha-2. |
| `country` | Код ISO 3166-1 alpha-2 страны, выдавшей документ. |
| `document_verified` | Был ли подтверждён документ, удостоверяющий личность. |
| `liveness` | Пройдена ли проверка живости. |

Токен доступа и ID-токен содержат их в `verified`, а также `level`, то есть наивысший уровень, который пользователь прошёл: `liveness`, `liveness_face_match` или `full_id`.
Если пользователь не прошёл ни одной проверки, то значение `{}`, а `GET /session/` вместо этого возвращает `null`.

```json theme={null}
{
  "verified": {
    "level": "full_id",
    "over_18": true,
    "given_name": "Alex",
    "country": "ES"
  }
}
```

* Проверка, одобренная во время сессии, попадает в токены при следующем обновлении, в течение 5 минут.
* Любой, у кого есть токен, может прочитать эти клеймы, в том числе ваш фронтенд, поэтому выбирайте только те персональные клеймы, которые нужны вашему приложению.
* Ваше приложение получает только клеймы, но не документ, селфи или данные о лице.

## Настройка через API

`GET` и `PATCH` для `verified/` в [API управления аутентификацией](https://docs.didit.me/ru/authentication/set-up-by-api.md) вашего приложения читают и изменяют те же настройки, что и консоль:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}verified/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "signup_level": "liveness",
    "rules": [
      {"rule": "payout", "enabled": true, "method": "selfie", "threshold": "500.00", "currency": "USD"},
      {"rule": "bank", "enabled": true, "method": "full_id"}
    ],
    "claims": ["over_18", "given_name", "country"]
  }'
```

| Поле | Значения |
| - | - |
| `signup_level` | `none`, `liveness` или `full_id`. |
| `rules` | По одной записи на каждое изменяемое правило: `rule` (`payout`, `device`, `bank` или `contact`), `enabled`, `method` (`liveness`, `selfie` или `full_id`), а также `threshold` и `currency`, но только для `payout`. |
| `claims` | Утверждения (claims) для включения в токены из таблицы выше. |
| `workflows` | Необязательно: ваш собственный ID сценария для `liveness`, `selfie` или `full_id`, либо `null` для стандартного сценария Didit. |

Правило, которое вы не укажете, сохраняет текущие настройки.


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