Начните с проверки всей цепочки: запрос на сайте, отправка звонка, появление вызова на телефоне и ввод кода. Срок действия OTP должен учитывать время на эти действия, но при этом ограничивать период, когда код можно использовать. Универсальное значение без проверки вашего сценария выбирать не стоит. Ниже разберём, от какого события отсчитывать срок, как согласовать таймер с сервером и что показывать клиенту при задержке звонка. Эти правила помогут настроить авторизацию на сайте без путаницы с просроченными кодами.
Что проверить перед настройкой срока действия кода?
Сначала уточните, как именно клиент подтверждает номер. Верификация номера телефона проверяет, что у пользователя есть доступ к нему; для этого применяют код, звонок или Flash Call. Такая проверка сама по себе не устанавливает личность человека. Общее описание способов подтверждения есть в материале «Верификация номера телефона: как работает подтверждение через код, звонок и Flash Call» (SMSBLOG).
Для голосового OTP клиенту нужно принять звонок, услышать код и ввести его на сайте. В сценарии Flash Call действия зависят от реализации: например, пользователь вводит часть номера входящего вызова. Поэтому сначала опишите путь клиента в вашей форме. Инструкция на экране должна точно соответствовать тому, какой звонок он получит и какие цифры потребуется ввести.
Проведите пробную авторизацию с телефона и с компьютера. Во втором случае человек смотрит на сайт, берёт телефон, а затем возвращается к форме. Учтите этот переход при проверке таймера: время до появления вызова и время до ввода кода — разные интервалы.
Попросите разработчика отметить в техническом журнале момент создания попытки, ответ сервиса на запрос и результат проверки кода. Если сервис сообщает о ходе звонка, добавьте эти события отдельно. Статус «запрос принят» ещё не означает, что телефон клиента уже звонит.
От какого события отсчитывать срок действия OTP?
Назначьте один источник времени, по которому система принимает или отклоняет код. Обычно эту задачу выполняет сервер: он связывает попытку авторизации с моментом её окончания и проверяет срок при вводе. Таймер в браузере лишь показывает оставшееся время. Обновление страницы не должно продлевать действие кода.
Точку отсчёта согласуйте с правилами сервиса звонков. Если сервис сам проверяет OTP и отсчитывает срок с момента создания попытки, сайт должен учитывать именно это ограничение. Локальный таймер с более поздним окончанием создаст ошибочное обещание: форма ещё предлагает ввести код, а сервис уже его отклоняет.
Если код проверяет ваш сервер, опишите правило явно: какое событие запускает срок и какое завершает попытку. Не привязывайте начало отсчёта к появлению вызова на телефоне, если интеграция не даёт достоверного события об этом. Иначе часть попыток останется без понятного срока окончания.
Разделите два таймера: срок действия текущего кода и ожидание до повторного запроса. Они решают разные задачи. Первый ограничивает приём кода, второй регулирует отправку новых звонков. Подробности выбора параметров разобраны в статье о том, как выбрать длину и срок действия OTP-кода для авторизации по звонку.
Как учесть задержку звонка без чрезмерного продления кода?
Проверьте, где именно проходит ожидание. Звонок может задержаться до поступления на телефон, а клиенту затем понадобится время на ответ или поиск нужных цифр. Если весь запас уходит ещё до вызова, увеличивать только время на ввод недостаточно: нужно проверить отправку звонка и обработку статусов.
Для интернет-магазина или сервиса записи в Беларуси начните с тестов на тех устройствах и подключениях, которыми пользуется ваша аудитория. Не переносите настройки из другого проекта без проверки. Одинаковая форма на компьютере и телефоне требует разных действий от человека, особенно когда на мобильном устройстве экран звонка закрывает браузер.
- Пройдите авторизацию целиком и отметьте, сколько времени занимает каждый этап до успешного ввода.
- Повторите проверку с задержкой вызова и убедитесь, что клиент успевает выполнить инструкцию до окончания срока.
- Проверьте ввод после истечения срока: сервер должен отклонить код, а форма — предложить понятное продолжение.
- Проверьте поздний звонок после нового запроса и убедитесь, что он не создаёт путаницу между попытками.
По результатам выберите срок, который покрывает проверенный сценарий, затем проверьте его на реальных попытках без раскрытия кодов в журналах. Отдельно смотрите на случаи, когда звонок пришёл, но пользователь не успел завершить ввод. Они помогают отличить задержку доставки от непонятной инструкции.
Если звонок не приходит вовремя, предусмотрите другой способ подтверждения. Условие переключения нужно согласовать с состоянием текущей попытки: старый код не должен неожиданно конкурировать с новым. Для такого перехода полезна схема каскада Flash Call → Voice OTP → SMS. Возможность каждого канала сначала проверьте у поставщика интеграции.
Что показывать при истечении срока и повторном запросе?
Пока попытка активна, показывайте инструкцию и оставшееся время. После окончания срока замените её сообщением: «Срок действия кода истёк. Запросите новый звонок». Не оставляйте пользователя перед полем, которое выглядит рабочим, но уже не принимает ответ.
Если клиент успел нажать кнопку отправки рядом с окончанием таймера, решение должен принять сервер по правилам текущей попытки. Браузер затем показывает результат этой проверки. Не обещайте успех только потому, что в момент нажатия на экране ещё оставалось время: запрос тоже проходит путь до сервера.
Повторный запрос оформите как отдельную попытку. Для простой и понятной схемы заранее определите, что новый запрос отменяет предыдущий, если это поддерживает сервис. Сообщите об этом рядом с кнопкой: «После нового запроса используйте только новый код». Поздний вызов от предыдущей попытки тогда не должен давать доступ.
Кнопку повторного запроса включайте по отдельному правилу, а ограничения проверяйте на сервере. Одной блокировки в браузере недостаточно: пользователь может обновить страницу или открыть другую вкладку. Практические варианты описаны в материале о том, как настроить лимиты повторов авторизации по звонку.
При подготовке API-интеграции составьте короткое описание состояний: ожидание звонка, ожидание ввода, успешная проверка, истечение срока и новая попытка. Для каждого состояния укажите текст на экране и доступное действие. Такой документ помогает обсуждать с поставщиком авторизации конкретное поведение системы, включая задержки и повторные запросы.
Типичные ошибки при настройке срока действия OTP
- Запускать таймер только в браузере. После обновления страницы он сбрасывается; исправление — получать актуальное состояние попытки с сервера.
- Считать ответ API подтверждением доставки звонка. Разделите принятие запроса и события вызова, которые действительно передаёт сервис.
- Продлевать срок при каждом неверном вводе. Сохраните исходный момент окончания попытки и отдельно ограничьте число проверок.
- Принимать несколько старых кодов без понятного правила. Заранее определите, какие попытки остаются действительными после повторного запроса.
- Показывать одинаковую ошибку при неверном коде и истёкшем сроке. В первом случае предложите проверить ввод, во втором — запросить новый звонок.
Начните с одного контрольного прохода: откройте форму авторизации и за две минуты проверьте, объясняет ли экран, что делать после истечения срока кода. Если следующего действия нет, добавьте сообщение и кнопку повторного запроса в задачу разработчику.



