---
title: Принцип работы 2FA: на стороне платформы
description: 2FA на стороне платформы — генерация и проверка кода платформой
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

# Принцип работы 2FA: на стороне платформы

> **Коротко:** при интеграции «на стороне платформы» код генерируется и проверяется платформой. Вы получаете результат проверки.

## Кому подходит

- Роль: Разработчик
- Уровень: Опытный

## Что это

Платформа сама:

1. Генерирует код.
2. Отправляет код через канал.
3. Проверяет код, который ввёл пользователь.
4. Возвращает результат: код верный или нет.

Вам не нужно ни генерировать, ни проверять код.

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

### Шаг 1. Отправка кода

Вы отправляете запрос на URL интеграции. В ответе — **requestId**.

Формат запроса:

- Метод: POST
- URL: значение из поля URL для интеграции
- Авторизация: API key
- Параметр: number — номер телефона получателя

### Шаг 2. Платформа генерирует и отправляет код

Платформа создаёт код, отправляет его через канал и сохраняет в своей базе.

### Шаг 3. Пользователь вводит код

На вашем сайте пользователь вводит код в поле.

### Шаг 4. Вы отправляете код на проверку

Формат запроса:

- Метод: POST
- URL: https://<домен клиентского портала>/api/v1/2fa/verify
- Авторизация: API key
- Параметры:
  - requestId — из шага 1
  - code — код, который ввёл пользователь

### Шаг 5. Платформа возвращает результат

В ответе:

- number — номер телефона.
- verifiedAt — время успешной проверки.

Если код неверный — вернётся ошибка.

## Пример сценария

1. Пользователь хочет войти в ваш сервис.
2. Ваш сервис отправляет запрос в OTP-платформу.
3. Платформа отправляет код по SMS.
4. Пользователь вводит код.
5. Ваш сервис отправляет код на проверку.
6. Платформа отвечает: код верный.
7. Пользователь вошёл в ваш сервис.

## Что нужно от вас

- Создать интеграцию в 2FA Service.
- Указать URL для результата верификации.
- Обрабатывать ответы от платформы.

## Что делает платформа

- Генерирует код.
- Отправляет его.
- Хранит код.
- Проверяет введённый код.

## Что дальше

- [Как настроить 2FA-интеграцию](/02-otp/01-turnkey/otp-102-setup-2fa)
- [Принцип работы 2FA: на стороне клиента](/02-otp/01-turnkey/otp-107-client-side)
- [Получение обратных вызовов при 2FA](/02-otp/01-turnkey/otp-108-callbacks)
- [Проверка 2FA-запроса](/02-otp/01-turnkey/otp-109-check-request)

## См. также

- [Как работает 2FA-сервис](/02-otp/01-turnkey/otp-101-how-2fa-works)
- [Как создать API-ключ](/02-otp/03-for-developers/otp-302-api-key)
- [Базовый URL и аутентификация](/02-otp/03-for-developers/otp-303-base-url)

## Нужна помощь?

- OTP-коды: support@otpcod.ru