# Ссылки верификации

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

## Создание ссылки [#создание-ссылки]

Для создания новой ссылки верификации нажмите **«Создать ссылку»** и укажите следующие параметры:

- **Флоу** — сценарий верификации, по которому будет создана сессия при переходе по ссылке.
- **Срок действия** — временной интервал, в течение которого ссылка остаётся активной. По истечении срока ссылка становится недействительной.
- **Внешний ID пользователя** (необязательно) — идентификатор пользователя в вашей системе (external_user_id) для привязки сессии к конкретному аппликанту.
- **Локаль** (необязательно) — языковые параметры интерфейса верификации.
- **Redirect URL** (необязательно) — адрес для перенаправления пользователя после завершения верификации (например, `https://myapp.com/dashboard`).

После создания система генерирует:

- **URL ссылки** — полный адрес с токеном для передачи пользователю.
- **Короткий код** — при необходимости используется для альтернативного доступа.

Сформированную ссылку можно направить пользователю любым удобным способом: электронная почта, SMS, личный кабинет вашего приложения.

### Redirect URL [#redirect-url]

Параметр `redirect_url` определяет адрес, на который пользователь будет перенаправлен после завершения верификации. Поведение экрана завершения (кнопка перехода или автоматический редирект) настраивается в параметрах сценария — см. [Флоу — настройки редиректа](/ru/admin/flows#настройки-редиректа).

Если `redirect_url` не указан, экран завершения отображается без элементов перенаправления.

### Создание через API [#создание-через-api]

Ссылки верификации доступны для программного создания через Tenant API, что позволяет интегрировать выдачу ссылок в бизнес-процессы вашего приложения (например, из CRM-системы):

API operations:

- `POST /v1/kyc/verification-links`

## Список ссылок [#список-ссылок]

В реестре ссылок отображаются следующие данные:

| Поле              | Описание                           |
| ----------------- | ---------------------------------- |
| **ID**            | Уникальный идентификатор ссылки    |
| **Флоу**          | Привязанный сценарий верификации   |
| **Статус**        | Активна, использована или отозвана |
| **Срок действия** | Дата и время истечения ссылки      |
| **Дата создания** | Дата и время генерации ссылки      |

При переходе к детальному просмотру ссылки доступны: полный URL, информация об использовании (дата, устройство — при наличии данных), привязанная сессия.

## Отзыв ссылки [#отзыв-ссылки]

Для аннулирования ссылки (ошибка при создании, отмена верификации, изменение условий):

1. Найдите ссылку в списке.
2. Нажмите **«Отозвать»**.
3. Подтвердите действие.

После отзыва переход по ссылке не приводит к созданию сессии — пользователь получит уведомление о недействительности ссылки.

## QR-код [#qr-код]

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

Генерация QR-кода доступна как в админ-панели, так и через Tenant API:

API operations:

- `GET /v1/kyc/verification-links/{id}/qr`

## Дополнительные операции в админ-панели [#дополнительные-операции-в-админ-панели]

Помимо стандартных действий (создание, отзыв, QR-код), админ-панель предоставляет следующие возможности:

- **Дублирование ссылки** — создание копии существующей ссылки с теми же параметрами (флоу, срок действия, локаль), но новым токеном. Полезно для повторной отправки тем же пользователям с актуальным сроком жизни.
- **Массовые действия** — одновременное выполнение действий (например, отзыв) над набором ссылок: отметьте нужные строки в таблице и выберите действие из контекстного меню.
- **Отправка ссылки по email / SMS** — прямая отправка ссылки заявителю выбранным каналом из админ-панели (без необходимости копировать URL и формировать сообщение вручную). Канал зависит от настроек тенанта (наличие подключённого SMS-провайдера, корпоративного SMTP).